Doctrine Bridge 技术文档

2024-12-25 10:16:11作者：明树来

1. 安装指南

环境要求

在安装 Doctrine Bridge 之前，请确保您的系统已经安装了以下环境：

PHP 7.2 或更高版本
Composer

使用 Composer 安装

在您的项目根目录下，运行以下命令来初始化 Composer：
```
composer init
```

在 composer.json 文件中，添加以下依赖：

{
  "require": {
    "symfony/symfony": "^5.4|^6.0",
    "doctrine/doctrine-bundle": "^2.4"
  }
}

安装依赖：
```
composer install
```

配置doctrine的数据库连接信息，在 config/packages/doctrine.yaml 文件中：

doctrine:
  dbal:
    driver: pdo_mysql
    host: '%database_host%'
    port: '%database_port%'
    user: '%database_user%'
    password: '%database_password%'
    charset: utf8mb4
    # 其他数据库配置...

在 config/services.yaml 文件中，启用 Doctrine 服务：

services:
  _defaults:
    autowire: true
    autoconfigure: true

  App\Doctrine\:
    resource: '../src/Doctrine/'
    exclude: '../src/Doctrine/{Entity,Migrations}'

2. 项目的使用说明

Doctrine Bridge 项目提供了对 Doctrine 的集成，使得开发者可以在 Symfony 项目中方便地使用 Doctrine 的 ORM 和 DBAL 功能。

基础使用

创建实体类：

namespace App\Doctrine\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity()
 * @ORM\Table(name="users")
 */
class User
{
    /**
     * @ORM\Id()
     * @ORM\GeneratedValue()
     * @ORM\Column(type="integer")
     */
    private $id;

    // 其他属性和方法...
}

创建仓储类：

namespace App\Doctrine\Repository;

use App\Doctrine\Entity\User;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;

class UserRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, User::class);
    }

    // 其他方法...
}

使用仓储类进行数据库操作：

namespace App\Controller;

use App\Doctrine\Repository\UserRepository;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

class UserController extends AbstractController
{
    private $userRepository;

    public function __construct(UserRepository $userRepository)
    {
        $this->userRepository = $userRepository;
    }

    public function list(): Response
    {
        $users = $this->userRepository->findAll();

        // 返回响应...
    }
}