Doctrine DBAL 技术文档

2024-12-20 10:31:54作者：戚魁泉Nursing

1. 安装指南

使用 Composer 安装

Doctrine DBAL 可以通过 Composer 进行安装。Composer 是 PHP 的依赖管理工具，确保你已经安装了 Composer。

在项目根目录下运行以下命令来安装 Doctrine DBAL：

composer require doctrine/dbal

手动安装

如果你不使用 Composer，也可以手动下载 Doctrine DBAL 的源代码，并将其包含在你的项目中。你需要确保所有依赖项都已正确配置。

2. 项目的使用说明

连接数据库

在使用 Doctrine DBAL 之前，首先需要连接到数据库。你可以通过配置文件或直接在代码中指定连接参数来实现。

使用配置文件连接

use Doctrine\DBAL\DriverManager;

$connectionParams = [
    'dbname' => 'your_database',
    'user' => 'your_username',
    'password' => 'your_password',
    'host' => 'localhost',
    'driver' => 'pdo_mysql',
];

$conn = DriverManager::getConnection($connectionParams);

使用 DSN 连接

你也可以使用 DSN（Data Source Name）来连接数据库：

$conn = DriverManager::getConnection(['url' => 'mysql://user:password@localhost/dbname']);

执行查询

连接成功后，你可以使用 $conn 对象来执行 SQL 查询。

$sql = "SELECT * FROM users";
$stmt = $conn->prepare($sql);
$result = $stmt->executeQuery();

while ($row = $result->fetchAssociative()) {
    print_r($row);
}

3. 项目 API 使用文档

获取连接

$conn = DriverManager::getConnection($connectionParams);

执行查询

$stmt = $conn->prepare($sql);
$result = $stmt->executeQuery();

插入数据

$conn->insert('users', ['username' => 'john_doe', 'email' => 'john@example.com']);

更新数据

$conn->update('users', ['email' => 'john_new@example.com'], ['id' => 1]);

删除数据

$conn->delete('users', ['id' => 1]);

事务处理

$conn->beginTransaction();
try {
    $conn->insert('users', ['username' => 'jane_doe', 'email' => 'jane@example.com']);
    $conn->commit();
} catch (Exception $e) {
    $conn->rollBack();
    throw $e;
}