Doctrine ORM 使用教程

1. 项目的目录结构及介绍

Doctrine ORM 项目的目录结构如下：

doctrine/orm/
├── bin/
├── build/
├── docs/
├── lib/
│   ├── Doctrine/
│   │   ├── Common/
│   │   ├── DBAL/
│   │   └── ORM/
│   └── vendor/
├── tests/
├── tools/
├── CONTRIBUTING.md
├── LICENSE
├── README.md
└── composer.json

目录介绍

• bin/: 包含可执行文件，如命令行工具。
• build/: 包含构建脚本和配置文件。
• docs/: 包含项目文档。
• lib/: 核心库文件，包含 Doctrine 的各个模块。
  • Doctrine/: 主要的 Doctrine 库。
    • Common/: 包含通用功能。
    • DBAL/: 数据库抽象层。
    • ORM/: 对象关系映射核心库。
  • vendor/: 第三方依赖库。
• tests/: 包含测试文件。
• tools/: 包含一些辅助工具。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 许可证文件。
• README.md: 项目介绍和使用说明。
• composer.json: Composer 配置文件。

2. 项目的启动文件介绍

Doctrine ORM 的启动文件通常位于 bin/ 目录下，例如 bin/doctrine。这个文件是一个命令行脚本，用于执行各种 Doctrine 命令。

启动文件示例

#!/usr/bin/env php
<?php

use Doctrine\ORM\Tools\Console\ConsoleRunner;
use Doctrine\ORM\Tools\Setup;
use Doctrine\ORM\EntityManager;

require_once "vendor/autoload.php";

$paths = array("src/Entity");
$isDevMode = true;

$dbParams = array(
    'driver'   => 'pdo_mysql',
    'user'     => 'root',
    'password' => '',
    'dbname'   => 'test',
);

$config = Setup::createAnnotationMetadataConfiguration($paths, $isDevMode);
$entityManager = EntityManager::create($dbParams, $config);

return ConsoleRunner::createHelperSet($entityManager);

启动文件说明

• require_once "vendor/autoload.php": 引入 Composer 自动加载文件。
• $paths: 指定实体类所在的目录。
• $isDevMode: 开发模式开关。
• $dbParams: 数据库连接参数。
• $config: 配置元数据。
• $entityManager: 创建实体管理器。
• ConsoleRunner::createHelperSet($entityManager): 创建命令行辅助集。

3. 项目的配置文件介绍

Doctrine ORM 的配置文件通常是 config/cli-config.php 或 config/config.php。这些文件用于配置 Doctrine 的各种设置，包括数据库连接、实体映射等。

配置文件示例

<?php

use Doctrine\ORM\Tools\Setup;
use Doctrine\ORM\EntityManager;

require_once "vendor/autoload.php";

$paths = array("src/Entity");
$isDevMode = true;

$dbParams = array(
    'driver'   => 'pdo_mysql',
    'user'     => 'root',
    'password' => '',
    'dbname'   => 'test',
);

$config = Setup::createAnnotationMetadataConfiguration($paths, $isDevMode);
$entityManager = EntityManager::create($dbParams, $config);

return $entityManager;

配置文件说明

• require_once "vendor/autoload.php": 引入 Composer 自动加载文件。
• $paths: 指定实体类所在的目录。
• $isDevMode: 开发模式开关。
• $dbParams: 数据库连接参数。
• $config: 配置元数据。
• $entityManager: 创建实体管理器并返回。

通过以上配置，你可以使用 Doctrine ORM 进行数据库操作和实体管理。