README

DbLib是一个PHP库，旨在使您在项目中与MySQL/MariaDb数据库交互更加容易。

请注意，此项目处于初始开发阶段，因此某些文档可能不完整。

入门指南

DbLib旨在完全符合PSR-1、PSR-2和PSR-4

先决条件

DbLib与MySQL和MariaDb都兼容。

• PHP 7.1+
• PDO_MYSQL扩展
• PDO_JSON扩展 - 如果使用提供的Json配置适配器。

要检查上述PHP扩展是否启用，请在CLI中运行以下命令或在您的网站根目录中的页面中添加它...

phpinfo(); <-- Use with script in webroot.
php -i <-- Use with CLI

安装

要将DbLib添加到您的项目中，请运行

composer require geeshoe/dblib

如果您想使用dblib-php的开发分支，请在composer.json文件中使用以下代码行。

composer require geeshoe/dblib dev-develop

注意：DbLib的开发分支有时不稳定，因此不建议在生产环境中使用。

配置

可以使用各种格式设置DbLib的配置参数。但是，目前仅支持JSON格式。其他格式，如.env、yaml等，将很快支持。

在此期间，您可以使用AbstractConfigObject自行创建配置适配器。

将包含的dblibConfig_DIST.json复制到项目网站根目录之外的安全位置。

更改值以反映您的数据库配置。

{
  "dblibConfig" : {
    "hostName" : "127.0.0.1",
    "port" : "3306",
    "userName" : "myUsername",
    "password" : "SomePassword",
    "database" : "OptionalSeeDocumentation"
  }
}

"database"参数不是必需的。如果未在配置文件中指定数据库，则必须在SQL语句中显式声明要使用的数据库。

例如：'SELECT * FROM database.tableName';

当前版本中不支持PDO属性的全部功能。已提供使用属性的能力，但尚未在DbLib中自动实现。这是开发列表中的首要任务，旨在恢复PDO属性。计划在下一个主要版本中完全支持属性，如果可能，将提前实现。

可以在配置文件中设置PDO属性，如上所述。可以设置多个属性，如下所示

"pdoAttributes" : [
     {
       "PDO::ATTR_ERRMODE" : "PDO::ERRMODE_EXCEPTION"
     },
     {
       "PDO::ATTR_CASE" : "PDO::CASE_LOWER"
     }
]

计划在未来为DbLib添加持久连接，但目前尚不支持。因为DbLib没有显式关闭PDO连接，所以可以扩展DbLib类并重写connect()方法以设置PDO::ATTR_PERSISTENT => true。

文档

API和用法文档即将推出。

作者

• Jesse Rushlow - 主要开发者 - geeShoe Development

源代码可在(https://github.com/geeshoe)找到

有关问题、评论或抱怨，请给我发邮件：

jr (at) geeshoe (dot) com