abrahan-zarza / dbm
数据库操作工具。
0.1.2
2021-06-19 13:04 UTC
Requires
- vlucas/phpdotenv: ^5.2
This package is auto-updated.
Last update: 2024-09-19 20:30:40 UTC
README
这个工具提供了连接数据库和简单舒适地执行查询的机制,同时提供了PHP PDO扩展的所有优点。
目前,它支持与MySQL、Postgres、SQLServer和SQLite数据库的连接。
它是为了在简单的Web项目中使用而创建的,但也可以用作更复杂Web应用程序数据库层的底层。
使用说明
通过 composer 在我们的项目中安装库
composer require abrahan-zarza/dbm
然后,我们必须在项目的环境变量中设置以下值
$_ENV['DB'] = 'database_type';
$_ENV['DB_HOST'] = 'address';
$_ENV['DB_PORT'] = 'port';
$_ENV['DB_USER'] = 'user';
$_ENV['DB_PASSWORD'] = 'password';
$_ENV['DB_NAME'] = 'database';
或者,如果你愿意,可以在项目中创建一个 .env
文件,结构如下
DB=database_type
DB_HOST=address
DB_PORT=port
DB_USER=user
DB_PASSWORD=password
DB_NAME=database
有关如何在应用程序中加载此类 .env
文件的更多信息,请参阅库 vlucas/phpdotenv。
实例化一个连接
$conn = \Dbm\Dbm::getInstance();
关闭一个连接
$conn->destroy();
方法 executeS
此方法用于执行需要从数据库中获取多个记录的查询,通常是SELECT查询。
executeS(string $query, array $bindParams = null, bool $destroyInstance = true)
方法 getRow
此方法用于执行需要从数据库中获取单个记录的查询,例如SELECT查询。
getRow(string $query, array $bindParams = null, bool $destroyInstance = true)
方法 execute
此方法用于执行不需要从数据库中提取数据的查询,即INSERT、UPDATE或DELETE等操作。
execute(string $query, array $bindParams = null, bool $destroyInstance = true)
参数
$query
此参数是数据库查询。
$bindParams
如果查询需要动态值,则指定为关联数组,键是所需的值的名称,键的值是显示的值。
$destroyInstance
默认情况下,每次执行查询时都会关闭数据库实例。如果要保持实例打开,则使用此参数,并将其值传递为TRUE
。
示例
获取用户列表
$results = $conn->executeS('SELECT id, name FROM users');
通过id获取特定用户
$results = $conn->getRow('SELECT id, name FROM users WHERE id = :id', ['id' => 1]);
插入新用户
$lastInsertId = $conn->execute('INSERT INTO users (name, email) VALUES (:name, :email)', ['name' => 'John', 'email' => 'john@doe.com']);