0

0

超轻的 PHP 数据库工具包

PHP中文网

PHP中文网

发布时间:2016-05-25 17:13:54

|

1278人浏览过

|

来源于php中文网

原创

一个很轻的 php 数据库工具包,诞生时间两天(足以证明很轻了 )。 

两个类,一个 Connection 管理 PDO 连接(支持多数据库),一个 QuickQuery 用来快速执行数据库操作(不用在 PDO 和 PDOStatement 之间来回折腾) 
不用下载,在线就能看完。

1. [代码]使用范例 

use Persistence\DbAccess;

// 在框架初始化的地方添加连接信息
DbAccess\Connection::add(
    'default', 
    'sqlite', 
    '/db/mydb.sqlite', 
    null, null, false
);

// 下面是使用
$conn = DbAccess\Connection::instance('default');

// 查询
$query = new DbAccess\QuickQuery($conn);
$query->prepare('select :name as name')->execute(array(':name'=>'tonyseek'));

// 对象直接作为迭代器产生数据数组
foreach($query as $i) {
    var_dump($i);
}

// 如果有偏执的话,输出响应之前手动断开连接
DbAccess\Connection::disconnectAll();

2. [代码]Persistence/DbAccess/QuickQuery.php 

connection = $connection;
    }
    
    /**
     * 预编译 SQL 语句
     * 
     * @param string $sqlCommand SQL语句
     * @return \Persistence\DbAccess\QuickQuery
     */
    public function prepare($sqlCommand)
    {
        // 从连接获取 PDO, 并对 SQL 语句执行 prepare, 产生 PDO Statement
        $this->stmt = $this->connection->getPDO()->prepare($sqlCommand);
        // 修改 PDO Statement 模式为关联数组数据
        $this->stmt->setFetchMode(PDO::FETCH_ASSOC);
        // 返回方法链
        return $this;
    }
    
    /**
     * 执行数据查询
     * 
     * @throws PDOException
     * @return \Persistence\DbAccess\QuickQuery
     */
    public function execute($params = array())
    {
        $stmt = $this->getStatement();
        
        // 参数检查
        $diff = array_diff($this->checkedParams, array_keys($params));
        if (count($this->checkedParams) && count($diff)) {
        	throw new InvalidArgumentException('缺少必备参数:'.implode(' | ', $diff));
        }
        
        // 将 PHP 数据类型对应到数据库数据类型
        foreach($params as $key => $value) {
        	$type = null;
        	switch(true) {
        		case is_int($value):
        			$type = PDO::PARAM_INT; 
        			break;
        		case is_bool($value):
        			$type = PDO::PARAM_BOOL; 
        			break;
        		case ($value instanceof DateTime):
        			$type = PDO::PARAM_STR; 
        			$value = $value->format(\DateTime::W3C);
        			break;
        		case is_null($value):
        			$type = PDO::PARAM_NULL; 
        			break;
        		default:
        			$type = PDO::PARAM_STR; 
        	}
        	
        	$stmt->bindValue($key, $value, $type);
        }
        
        $stmt->execute();
        $this->checkedParams = array(); // 清空参数检查
        return $this;
    }
    
    /**
     * 获取 Statement 对象
     * 
     * 返回对象可以被绑定参数重新执行, 也可以被当作迭代器遍历获取数据。
     * 
     * @return \PDOStatement
     */
    public function getStatement()
    {
        if (!$this->stmt) {
            throw new LogicException('SQL语句应该先被 QuickQuery.prepare 预处理');
        }
        
        return $this->stmt;
    }
    
    /**
     * getStatement 方法的替代名
     * 
     * 实现 PHP 标准库 中的 IteratorAggregate 接口, 外部可以直接将本对象作为迭代器遍
     * 历。和 getStatment 唯一不同之处, 是本方法不会抛出 LogicException 异常。如果
     * 没有事先使用 prepare 和 execute, 会返回一个空迭代器。
     * 
     * @return Traversable
     */
    public function getIterator()
    {
        try {
            return $this->getStatement();
        } catch (LogicException $ex) {
            return new \ArrayObject();
        }
    }
    
    /**
     * 设置查询参数检查
     * 
     * 通过此处导入的被检查查询参数, 如果没有得到赋值, 则查询时会抛出 LogicException 异常。
     * 
     * @param array $params
     * @return \Persistence\DbAccess\QuickQuery
     */
    public function setParamsCheck(array $params)
    {
    	$this->checkedParams = $params;
    	
    	return $this;
    }
    
    /**
     * 将结果集转换为数组
     * 
     * @return array
     */
    public function toArray()
    {
    	return iterator_to_array($this->getStatement());
    }
    
    /**
     * 获取最后一个插入结果(或序列)的 ID
     * 
     * @param string $name
     * @return int
     */
    public function getLastInsertId($name=null)
    {
    	return $this->connection->getPDO()->lastInsertId($name);
    }
}

3. [代码]Persistence/DbAccess/Connection.php 

disconnect();
		}
	}
	
	/**
	 * 添加数据库
	 * 
	 * 向实例群添加 Connector
	 * 
	 * @param string $name      标识名
	 * @param string $driver    驱动名
	 * @param string $dsn       连接字符串
	 * @param string $usr       数据库用户名
	 * @param string $pwd       数据库密码
	 * @param bool   $emulate   仿真预编译查询
	 * @param bool   $persisten 是否持久连接
	 */
	static public function registry($name, $driver, $dsn, $usr, $pwd, $emulate = false, $persisten = false)
	{
		if (isset(self::$instances[$name])) {
			// 如果添加的实例名已经存在则抛出异常
			throw new BadMethodCallException("[{$name}] 已被注册");
		}
		
		// 实例化自身,并推入数组中
		self::$instances[$name] = new self();
		self::$instances[$name]->dsn = $driver . ':' . $dsn;
		self::$instances[$name]->username = $usr;
		self::$instances[$name]->password = $pwd;
		self::$instances[$name]->driver = $driver;
		self::$instances[$name]->isPersisten = (bool)$persisten;
		self::$instances[$name]->isEmulate = (bool)$emulate;
	}
	
	/**
	 * 获取 PHP Database Object
	 * 
	 * @return \PDO
	 */
	public function getPDO()
	{
		if (!$this->pdo) {
			// 检查 PDO 是否已经实例化,否则先实例化 PDO
			$this->pdo = new PDO($this->dsn, $this->username, $this->password);
			// 错误模式为抛出 PDOException 异常
			$this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
			// 开启查询缓存
			$this->pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, $this->isEmulate);
			// 开启持久连接
			$this->pdo->setAttribute(PDO::ATTR_PERSISTENT, $this->isPersisten);
			
		}
		
		return $this->pdo;
	}
	
	/**
	 * 获取数据库驱动名
	 * 
	 * @return string
	 */
	public function getDriverName()
	{
		return $this->driver;
	}
	
	/**
	 * 开始事务
	 */
	public function transationBegin()
	{
		$this->isInTransation = $this->getPDO()->beginTransaction();
	}
	
	/**
	 * 提交事务
	 */
	public function transationCommit()
	{
		if ($this->isInTransation) {
			$this->getPDO()->commit();
		} else {
			trigger_error('transationBegin 应该先于 transationCommit 调用');
		}
	}
	
	/**
	 * 回滚事务
	 * @return bool
	 */
	public function transationRollback()
	{
		if ($this->isInTransation) {
			$this->getPDO()->rollBack();
		} else {
			trigger_error('transationBegin 应该先于 transationRollback 调用');
		}
	}
	
	/**
	 * 连接是否在事务中
	 * 
	 * @return bool
	 */
	public function isInTransation()
	{
		return $this->isInTransation;
	}
	
	/**
	 * 在事务中执行回调函数
	 * 
	 * @param function $callback 匿名函数或闭包函数
	 * @param bool $autoRollback 异常发生时是否自动回滚
	 * @throws \PDOException
	 * @return bool
	 */
	public function transationExecute($callback, $autoRollback = true)
	{
		try {
			// 开始事务
			$this->transationBegin();
			// 调用回调函数
			if (is_callable($callback)) {
				$callback();
			} else {
				throw new InvalidArgumentException('$callback应该为回调函数');
			}
			// 提交事务
			return $this->transationCommit();
		} catch(PDOException $pex) {
			// 如果开启了自动回滚, 则捕捉到 PDO 异常时先回滚再抛出
			if ($autoRollback) {
				$this->transationRollback();
			}
			throw $pex;
		}
	}
	
	/**
	 * 安全地断开数据库连接
	 */
	public function disconnect()
	{
		if ($this->pdo) {
			// 检查 PDO 是否已经实例化,是则设置为null
			$this->pdo = null;
		}
	}
	
	/**
	 * 阻止克隆
	 */
	public function __clone()
	{
		trigger_error('被阻止的 __clone 方法, Connector 是单例类');
	}
}

                   

ChuangxinCMS企业网站管理系统1.0
ChuangxinCMS企业网站管理系统1.0

欢迎使用ChuangxinCMS企业网站管理系统软件! ChuangxinCMS是一个采用PHP技术和MYSQL数据库开发的企业网站管理系统,使用ChuangxinCMS能在最短的时间内花费最少的成本来搭建一个功能完善的企业网站,ChuangxinCMS具有一系列完善的内容管理功能,包括文章发布、分类管理、产品发布展示、下载模块等,整个系统页面设计简洁大方,功能实用高效,是中小型企业建站的最佳选择

下载

                   

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
包子漫画网页版入口与全集阅读指南_正版免费漫画快速访问方法
包子漫画网页版入口与全集阅读指南_正版免费漫画快速访问方法

本专题汇总了包子漫画官网和网页版入口,提供最新章节抢先看方法、正版免费阅读指南,以及稳定访问方式,帮助用户快速直达包子漫画页面,无广告畅享全集漫画内容。

47

2026.02.10

MC.JS网页版快速畅玩指南_MC.JS官网在线入口及免安装体验方法
MC.JS网页版快速畅玩指南_MC.JS官网在线入口及免安装体验方法

本专题汇总了MC.JS官网入口和网页版快速畅玩方法,提供免安装访问、不同版本(1.8.8、1.12.8)在线体验指南,以及正版网页端操作说明,帮助玩家轻松进入MC.JS世界,实现即时畅玩与高效体验。

34

2026.02.10

谷歌邮箱网页版登录与注册全指南_Gmail账号快速访问与安全操作教程
谷歌邮箱网页版登录与注册全指南_Gmail账号快速访问与安全操作教程

本专题汇总了谷歌邮箱网页版的最新登录入口和注册方法,详细提供官方账号快速访问方式、网页版操作教程及安全登录技巧,帮助用户轻松管理Gmail邮箱账户,实现高效、安全的邮箱使用体验。

25

2026.02.10

铁路12306订票与退改全攻略_高效购票与座位选取技巧
铁路12306订票与退改全攻略_高效购票与座位选取技巧

本专题全面汇总铁路12306订票、退票、改签及候补订单操作技巧,提供车厢座位分布参考、抢票攻略和高铁安检注意事项,帮助新手用户快速掌握高效购票与退改流程,提高出行效率和体验。

31

2026.02.10

TensorFlow2深度学习模型实战与优化
TensorFlow2深度学习模型实战与优化

本专题面向 AI 与数据科学开发者,系统讲解 TensorFlow 2 框架下深度学习模型的构建、训练、调优与部署。内容包括神经网络基础、卷积神经网络、循环神经网络、优化算法及模型性能提升技巧。通过实战项目演示,帮助开发者掌握从模型设计到上线的完整流程。

0

2026.02.10

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

4

2026.02.10

Go语言微服务架构与gRPC实战
Go语言微服务架构与gRPC实战

本专题面向有 Go 基础的开发者,系统讲解微服务架构设计与 gRPC 的高效应用。内容涵盖服务拆分、RPC 通信、负载均衡、错误处理、服务注册与发现等关键技术。通过实战案例,帮助开发者搭建高性能、可扩展的 Go 微服务系统。

1

2026.02.10

React 18状态管理与Hooks高级实践
React 18状态管理与Hooks高级实践

本专题专注于 React 18 的高级开发技术,详细讲解 useState、useEffect、useReducer、useContext 等 Hooks 的使用技巧,以及 Redux、Zustand 等状态管理工具的集成与优化方法。通过真实案例,帮助前端开发者构建可维护、性能优良的现代 React 应用。

4

2026.02.10

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

2

2026.02.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 11.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号