thecsea / mysqltcs
访问mysql数据库最简单且功能最强大的库,优化连接并允许您立即高效地执行常见数据库操作
Requires
- php: >=5.3.0
Requires (Dev)
README
用php编写的mysql最简单且功能最强大的库
- 可以在多个实例中使用相同的数据库连接(优化mysql物理连接)
- 此库允许您立即高效地执行常见数据库操作,返回简单的数据结构
- 记录在数据库上执行的所有操作
- 所有mysql错误均作为异常处理
- 支持克隆
- 支持事务
下载、安装和使用
下载
通过git
克隆仓库
git clone https://github.com/thecsea/mysqltcs.git
通过composer
在此下载composer https://getcomposer.org.cn/
在composer.json
中添加以下依赖项
"thecsea/mysqltcs": "3.0.*"
或者
php composer.phar require thecsea/mysqltcs
##安装/更新 更新composer(在此下载composer https://getcomposer.org.cn/)
php composer.phar self-update
以下命令必须在项目根目录下执行
###安装 mysqltcs
php composer.phar install
###更新 mysqltcs
如果您已将mysqltcs添加为composer依赖项,则可以进行更新
php composer.phar update
当发布新版本时,您必须进行更新
##如何使用
当composer安装完成后,您将看到vendor/autoload.php
文件,这是由composer生成的autoload文件。如果您已将mysqltcs
设置为composer依赖项,则autoload将加载mysqltcs和其他依赖项。因此,您只需在希望使用mysqltcs的每个文件中包含autoload,并按以下方式创建mysqtcs对象:
$connection = new it\thecsea\mysqltcs\Mysqltcs(...);
或者
use it\thecsea\mysqltcs\Mysqltcs;
和 $connection = new Mysqltcs(...);
您可以通过查看示例来了解如何使用该库
您还可以查看wiki以查看详细描述,或转到生成的phpdoc文档(所有类的文档)
测试
Mysqltcs使用自动测试:phpunit测试。因此,我们有很高的概率没有错误,但不是确定性。但我们已经用以下百分比覆盖了语句:[代码覆盖率图片链接]
- 在
tests/config.php
中更改数据库数据 - 导入
tests/mysqltcs.sql
- 执行单元测试
- 进入根目录
- 输入
phpunit
,或者如果您已下载phar,则输入php phpunit-xxx.phar
实际上,phpunit.xml
包含正确的测试配置
注意:每次执行测试时,数据库必须处于初始状态,就像刚刚执行导入一样(您应该有一个空表,只有数据库结构)
示例:您可以在examples
目录下找到一些示例以运行它
- 在
examples/config.php
中更改数据库数据 - 导入
examples/mysqltcs.sql
有一个简单的示例simpleExample.php
,它展示了如何以最简单的方式使用该库
目前还没有关于事务的示例(您在使用事务后必须记住将autocommit设置为true)
注意:如果您已将mysqltcs添加为composer依赖项,您将在vendor/thecsea/mysqltcs/examples
下找到示例