数据库操作工具。

0.1.2 2021-06-19 13:04 UTC

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']);