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

相关专题

更多
Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

37

2026.01.14

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

19

2026.01.13

PHP 高性能
PHP 高性能

本专题整合了PHP高性能相关教程大全,阅读专题下面的文章了解更多详细内容。

37

2026.01.13

MySQL数据库报错常见问题及解决方法大全
MySQL数据库报错常见问题及解决方法大全

本专题整合了MySQL数据库报错常见问题及解决方法,阅读专题下面的文章了解更多详细内容。

19

2026.01.13

PHP 文件上传
PHP 文件上传

本专题整合了PHP实现文件上传相关教程,阅读专题下面的文章了解更多详细内容。

16

2026.01.13

PHP缓存策略教程大全
PHP缓存策略教程大全

本专题整合了PHP缓存相关教程,阅读专题下面的文章了解更多详细内容。

6

2026.01.13

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

3

2026.01.13

交互式图表和动态图表教程汇总
交互式图表和动态图表教程汇总

本专题整合了交互式图表和动态图表的相关内容,阅读专题下面的文章了解更多详细内容。

45

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

9

2026.01.13

热门下载

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

精品课程

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

共137课时 | 8.6万人学习

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

共6课时 | 7万人学习

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

共13课时 | 0.9万人学习

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

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