hyperf/docs/zh-tw/db/db.md

極簡的 DB 元件

hyperf/database 功能十分強大，但也不可否認效率上確實些許不足。這裡提供一個極簡的 hyperf/db 元件，支援 PDO 和 Swoole Mysql。

安裝

composer require hyperf/db

釋出元件配置

該元件的配置檔案位於 config/autoload/db.php，如果檔案不存在，可通過下面的命令來將配置檔案釋出到骨架去：

php bin/hyperf.php vendor:publish hyperf/db

元件配置

預設配置 config/autoload/db.php 如下，資料庫支援多庫配置，預設為 default。

配置項	型別	預設值	備註
driver	string	無	資料庫引擎 支援 pdo 和 mysql
host	string	localhost	資料庫地址
port	int	3306	資料庫地址
database	string	無	資料庫預設 DB
username	string	無	資料庫使用者名稱
password	string	null	資料庫密碼
charset	string	utf8	資料庫編碼
collation	string	utf8_unicode_ci	資料庫編碼
fetch_mode	int	PDO::FETCH_ASSOC	PDO 查詢結果集型別
pool.min_connections	int	1	連線池內最少連線數
pool.max_connections	int	10	連線池內最大連線數
pool.connect_timeout	float	10.0	連線等待超時時間
pool.wait_timeout	float	3.0	超時時間
pool.heartbeat	int	-1	心跳
pool.max_idle_time	float	60.0	最大閒置時間
options	array		PDO 配置

元件支援的方法

具體介面可以檢視 Hyperf\DB\ConnectionInterface。

方法名	返回值型別	備註
beginTransaction	void	開啟事務 支援事務巢狀
commit	void	提交事務 支援事務巢狀
rollBack	void	回滾事務 支援事務巢狀
insert	int	插入資料，返回主鍵 ID，非自增主鍵返回 0
execute	int	執行 SQL，返回受影響的行數
query	array	查詢 SQL，返回結果集列表
fetch	array, object	查詢 SQL，返回結果集的首行資料
connection	self	指定連線的資料庫

使用

使用 DB 例項

<?php

use Hyperf\Utils\ApplicationContext;
use Hyperf\DB\DB;

$db = ApplicationContext::getContainer()->get(DB::class);

$res = $db->query('SELECT * FROM `user` WHERE gender = ?;', [1]);

使用靜態方法

<?php

use Hyperf\DB\DB;

$res = DB::query('SELECT * FROM `user` WHERE gender = ?;', [1]);

使用匿名函式自定義方法

此種方式可以允許使用者直接操作底層的 PDO 或者 MySQL，所以需要自己處理相容問題

比如我們想執行某些查詢，使用不同的 fetch mode，則可以通過以下方式，自定義自己的方法

<?php
use Hyperf\DB\DB;

$sql = 'SELECT * FROM `user` WHERE id = ?;';
$bindings = [2];
$mode = \PDO::FETCH_OBJ;
$res = DB::run(function (\PDO $pdo) use ($sql, $bindings, $mode) {
    $statement = $pdo->prepare($sql);

    $this->bindValues($statement, $bindings);

    $statement->execute();

    return $statement->fetchAll($mode);
});