{"id":1100,"date":"2025-06-12T12:56:35","date_gmt":"2025-06-12T04:56:35","guid":{"rendered":"https:\/\/www.zhaozhao123.cn\/php\/php-application-manual\/symfony\/1100.html"},"modified":"2025-06-12T12:56:35","modified_gmt":"2025-06-12T04:56:35","slug":"doctrine%ef%bc%9a%e5%a6%82%e4%bd%95%e5%ae%9a%e4%b9%89%e4%b8%80%e4%b8%aa%e5%ae%9e%e4%bd%93","status":"publish","type":"my1js","link":"https:\/\/www.zhaozhao123.cn\/php\/my1js\/1100.html","title":{"rendered":"Doctrine\uff1a\u5982\u4f55\u5b9a\u4e49\u4e00\u4e2a\u5b9e\u4f53"},"content":{"rendered":"
\r\n
\r\n
\r\n
\r\n
\r\n
\"Bug编译狮\"<\/figure>\r\n\r\n\r\n\r\n

Bug编译狮<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
\r\n
\r\n

Doctrine 是一个用于 PHP 的 ORM（对象关系映射）框架，它允许开发者将数据库表映射到类中，并提供了一种声明式的方式来操作数据库数据。要定义一个实体，你需要遵循以下几个步骤：<\/p>\n

    \n
  1. \n

    安装 Doctrine<\/strong>：\n首先，确保你已经安装了 Doctrine。你可以通过 Composer 来安装：<\/p>\n

    composer require doctrine\/orm<\/code><\/pre>\n<\/li>\n
  2. \n
    创建实体类<\/strong>：\n在你的项目目录下创建一个新的文件夹来存放你的实体类。例如，src\/Entity<\/code>。<\/p>\n<\/li>\n
  3. \n
    定义实体类<\/strong>：\n在 src\/Entity<\/code> 文件夹中创建一个新的 PHP 文件，例如 User.php<\/code>。在这个文件中，定义你的实体类。<\/p>\n
    <?php\n\nnamespace AppEntity;\n\nuse DoctrineORMMapping as ORM;\n\n\/**\n* @ORMEntity(repositoryClass=\"AppRepositoryUserRepository\")\n*\/\nclass User\n{\n   \/**\n    * @ORMId\n    * @ORMGeneratedValue(strategy=\"AUTO\")\n    * @ORMColumn(type=\"integer\")\n    *\/\n   private $id;\n\n   \/**\n    * @ORMColumn(type=\"string\", length=255)\n    *\/\n   private $username;\n\n   \/**\n    * @ORMColumn(type=\"string\", length=255)\n    *\/\n   private $email;\n\n   \/\/ Getters and Setters\n   public function getId(): ?int\n   {\n       return $this->id;\n   }\n\n   public function setUsername(string $username): self\n   {\n       $this->username = $username;\n       return $this;\n   }\n\n   public function getEmail(): ?string\n   {\n       return $this->email;\n   }\n\n   public function setEmail(string $email): self\n   {\n       $this->email = $email;\n       return $this;\n   }\n}<\/code><\/pre>\n<\/li>\n
  4. \n
    配置实体类<\/strong>：\n为了使 Doctrine 能够识别和管理你的实体类，你需要在 config\/doctrine.yaml<\/code> 文件中进行配置。<\/p>\n
    doctrine:\n   orm:\n       mappings:\n           AppEntity:\n               is_bundle: false\n               type: annotation\n               dir: '%kernel.project_dir%\/src\/Entity'\n               prefix: 'AppEntity'<\/code><\/pre>\n<\/li>\n
  5. \n
    运行迁移命令<\/strong>：\n生成数据库表的 SQL 语句并应用它们。<\/p>\n
    php bin\/console doctrine:migrations:generate\nphp bin\/console doctrine:migrations:migrate<\/code><\/pre>\n<\/li>\n<\/ol>\n
    现在，你已经成功地定义了一个 Doctrine 实体。你可以使用这个实体类来创建、读取、更新和删除数据库记录。例如，以下是如何创建一个新用户的示例代码：<\/p>\n
    <?php\n\nnamespace AppController;\n\nuse AppEntityUser;\nuse DoctrineORMEntityManagerInterface;\nuse SymfonyBundleFrameworkBundleControllerAbstractController;\nuse SymfonyComponentHttpFoundationRequest;\n\nclass UserController extends AbstractController\n{\n    private $entityManager;\n\n    public function __construct(EntityManagerInterface $entityManager)\n    {\n        $this->entityManager = $entityManager;\n    }\n\n    public function createUser(Request $request)\n    {\n        $user = new User();\n        $form = $this->createForm(UserType::class, $user);\n        $form->handleRequest($request);\n\n        if ($form->isSubmitted() && $form->isValid()) {\n            $this->entityManager->persist($user);\n            $this->entityManager->flush();\n\n            return $this->redirectToRoute('user_show', ['id' => $user->getId()]);\n        }\n\n        return $this->render('user\/create.html.twig', [\n            'form' => $form->createView(),\n        ]);\n    }\n}<\/code><\/pre>\n
    这个示例展示了如何在控制器中使用实体类来处理用户创建请求。<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
    \r\n
    \r\n
    \r\n
    \r\n
    \r\n
    \"黑板Bug讲师\"<\/figure>\r\n\r\n\r\n\r\n
    黑板Bug讲师<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
    \r\n
    \r\n
    概述<\/h2>
    Doctrine 是一个强大的 PHP 对象关系映射器（ORM），主要用于与 Symfony 框架结合使用，但也可以作为独立的库使用。在这篇教程中，我们将探索如何在 Doctrine 中定义实体，包括从基础到高级的各种用法示例。实体代表 Doctrine 中的业务对象，可以在数据库中持久化存储。<\/p>
    在深入定义实体之前，您应该对PHP和面向对象编程(OOP)有一个基本的理解。此外，您需要有一个Doctrine ORM的安装，并且配置了数据库连接。<\/p>
    定义基本实体。<\/h2>
    在最基本的层次上，Doctrine中的实体就是一个映射到数据库表的PHP类。以下是一个表示产品的简单示例：<\/p>
    <?php\nuse DoctrineORMMapping as ORM;\n\n\/** \n * @ORMEntity\n * @ORMTable(name=\"products\")\n *\/\nclass Product\n{\n    \/** \n     * @ORMId\n     * @ORMGeneratedValue\n     * @ORMColumn(type=\"integer\")\n     *\/\n    private $id;\n\n    \/** \n     * @ORMColumn(type=\"string\")\n     *\/\n    private $name;\n\n    \/\/ Getters and setters\n    public function getId()\n    {\n        return $this->id;\n    }\n\n    public function setName($name)\n    {\n        $this->name = $name;\n    }\n\n    public function getName()\n    {\n        return $this->name;\n    }\n}\n<\/code><\/pre>
    这段代码片段定义了一个简单的实体，包含两个属性：ID和名称。在ORMEntity注解上声明的类告诉Doctrine这个类是一个实体。在ORM@Table注解上定义了数据库表名。<\/p>
    利用关系<\/h2>
    实体通常与其他实体有关系。让我们在我们的Product实体上添加一个多对一的关系，将其与Category实体关联起来：<\/p>
    \/\/ ... existing Product class\n\n\/**\n * @ORMManyToOne(targetEntity=\"Category\")\n * @ORMJoinColumn(name=\"category_id\", referencedColumnName=\"id\")\n *\/\nprivate $category;\n\n\/\/ ... Getters and setters for category\n<\/code><\/pre>
    @ORMManyToMany(targetEntity=”Category”) 表示Product和Category之间的多对多关系，而@ORMJoinColumn(name=”category_id”, referencedColumnName=”id”) 则指定了关联的外键列名和对应的主键字段名。<\/p>
    处理复杂的人际关系<\/h2>
    Doctrine提供了多种关系类型，如一对一、一对多和多对多。让我们添加一个双向的一对多关系，映射产品到多个评论：<\/p>
    \/**\n * @ORMOneToMany(targetEntity=\"Review\", mappedBy=\"product\")\n *\/\nprivate $reviews;\n\npublic function __construct() {\n    $this->reviews = new DoctrineCommonCollectionsArrayCollection();\n}\n\n\/\/ ... Getters and setters for reviews \n<\/code><\/pre>
    这建立了“一对一”关系，即一个产品可以有多个评论。mappedBy 属性指向关系的一侧。<\/p>
    高级地图选项<\/h2>
    实体可以进一步自定义，使用高级选项。例如，告诉Doctrine只加载关联实体时延迟加载，或者指定唯一约束：<\/p>
    \/**\n * @ORMEntity\n * @ORMTable(name=\"products\", uniqueConstraints={@ORMUniqueConstraint(name=\"product_name_unique\", columns={\"name\"})})\n *\/\nclass Product\n{\n    \/\/ ... Class content remains the same\n}\n\n\/\/Specify lazy loading for the relationship\n\/**\n * @ORMManyToOne(targetEntity=\"Category\", fetch=\"LAZY\")\n * @ORMJoinColumn(name=\"category_id\", referencedColumnName=\"id\")\n *\/\nprivate $category;\n<\/code><\/pre>
    唯一约束选项确保产品名称在products表内是唯一的。ManyToOne关系中的fetch设置为LAZY，意味着Doctrine只有当访问Category实体时才会加载它。<\/p>
    Doctrina Callbacks Lifecycle<\/h2>
    Doctrine 提供了生命周期回调，这些方法可以在实体的生命周期中的特定点被自动调用，例如在保存到数据库之前或从数据库加载之后。要利用这些功能，请在您的实体中定义它们并配置 Doctrine 使用它们：<\/p>
    \/**\n * @ORMHasLifecycleCallbacks()\n *\/\nclass Product\n{\n    \/\/ ...\n\n    \/**\n     * @ORMPrePersist\n     *\/\n    public function setCreatedAtValue()\n    {\n        if(!$this->createdAt) {\n            $this->createdAt = new DateTime();\n        }\n    }\n    \/\/ ...\n}\n<\/code><\/pre>
    在上述示例中，setCreatedAtValue() 方法将在 Doctrine 持久化实体之前被调用，自动设置一个创建时间戳（如果该字段为 NULL）。<\/p>
    与索引工作<\/h2>
    你可以为实体定义索引以提高性能。在这里，我们在产品表的名称列上添加了一个索引：<\/p>
    \/**\n * @ORMEntity\n * @ORMTable(name=\"products\", indexes={@ORMIndex(name=\"product_name_index\", columns={\"name\"})})\n *\/\nclass Product\n{\n    \/\/ ... Existing content\n}\n<\/code><\/pre>
    索引在处理大型数据集或频繁搜索或连接列的场景尤其重要。<\/p>
    结论。<\/h2>
    定义实体是使用Doctrine ORM进行工作的重要基础。在本教程中，我们已经讨论了创建实体、处理关系、添加高级映射选项、使用生命周期回调以及索引等内容。Doctrine的实体使您能够以面向对象的PHP方式与数据库交互，从而获得结构化和强大的方法来操作数据。记住，每个实体都应该有一个明确的目的，并且应该反映您的数据库结构。有了这些概念和示例，您就可以掌握定义Doctrine实体的艺术了。<\/p><\/body>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
    \r\n
    \r\n
    \r\n
    \r\n
    \r\n
    \"长工码奴1523\"<\/figure>\r\n\r\n\r\n\r\n
    长工码奴1523<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
    \r\n
    \r\n
    要在 Doctrine 中定义一个实体，你需要遵循以下步骤：<\/p>\n
      \n
    1. 首先确保已经安装了 Doctrine 和 Doctrine 2 的 PHP 版本。<\/li>\n
    2. 在你的项目中创建一个新的 Doctrine 表格映射文件（通常命名为 doctrine.php<\/code>），并在其中添加你的实体类。<\/li>\n<\/ol>\n
      <?php\n\nnamespace AppEntity;\n\nuse DoctrineORMMapping as ORM;\nuse SymfonyComponentValidatorConstraints as Assert;\n\n\/**\n * @ORMEntity(repositoryClass=\"AppRepositoryUserRepository\")\n *\/\nclass User\n{\n    \/**\n     * @ORMId\n     * @ORMGeneratedValue\n     * @ORMColumn(type=\"integer\")\n     *\/\n    private $id;\n\n    \/**\n     * @ORMColumn(type=\"string\", length=50)\n     * @AssertNotBlank(message=\"Username is required.\")\n     *\/\n    private $username;\n\n    \/**\n     * @ORMColumn(type=\"string\", length=50, nullable=true)\n     *\/\n    private $email;\n\n    \/**\n     * @ORMColumn(type=\"string\", length=150, nullable=true)\n     *\/\n    private $password;\n\n    \/**\n     * @ORMColumn(type=\"datetime\")\n     *\/\n    private $createdAt;\n\n    public function getId(): ?int\n    {\n        return $this->id;\n    }\n\n    public function getUsername(): ?string\n    {\n        return $this->username;\n    }\n\n    public function setUsername(string $username): self\n    {\n        $this->username = $username;\n\n        return $this;\n    }\n\n    public function getEmail(): ?string\n    {\n        return $this->email;\n    }\n\n    public function setEmail(?string $email): self\n    {\n        $this->email = $email;\n\n        return $this;\n    }\n\n    public function getPassword(): ?string\n    {\n        return $this->password;\n    }\n\n    public function setPassword(?string $password): self\n    {\n        $this->password = $password;\n\n        return $this;\n    }\n\n    public function getCreatedAt(): ?DateTimeInterface\n    {\n        return $this->createdAt;\n    }\n\n    public function setCreatedAt(DateTimeInterface $createdAt): self\n    {\n        $this->createdAt = $createdAt;\n\n        return $this;\n    }\n}<\/code><\/pre>\n
      在这个例子中，我们定义了一个名为 User<\/code> 的实体，并使用了 @ORMEntity<\/code> 注解来指示它是 Doctrine 表格的主体。我们还设置了表字段，如 ID、用户名、电子邮件和密码等。注意，我们还提供了验证约束来检查这些字段是否为非空。<\/p>\n
      示例代码<\/h3>\n
      假设你有一个用户模型需要保存到数据库中，你可以这样做：<\/p>\n
      \/\/ Model\/User.php\nnamespace AppModel;\n\nuse DoctrineCommonCollectionsArrayCollection;\nuse DoctrineORMMapping as ORM;\n\n\/**\n * Class User\n * @package AppModel\n * @ORMEntity(repositoryClass=\"AppRepositoryUserRepository\")\n *\/\nclass User\n{\n    \/\/ ...\n}\n\n\/\/ Repository\/UserRepository.php\nnamespace AppRepository;\n\nuse DoctrineBundleDoctrineBundleRepositoryServiceEntityRepository;\nuse DoctrinePersistenceManagerRegistry;\n\n\/**\n * Class UserRepository\n * @package AppRepository\n * @method User|null find($id, $lockMode = null, $lockVersion = null)\n * @method User|null findOneBy(array $criteria, array $orderBy = null)\n * @method User[]    findAll()\n * @method User[]    findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)\n *\/\nclass UserRepository extends ServiceEntityRepository\n{\n    public function __construct(ManagerRegistry $registry)\n    {\n        parent::__construct($registry, 'app_user');\n    }\n}\n\n\/\/ Controller\/Controller.php\nnamespace AppController;\n\nuse AppEntityUser;\nuse AppFormUserType;\nuse AppRepositoryUserRepository;\nuse SymfonyBundleFrameworkBundleControllerAbstractController;\nuse SymfonyComponentHttpFoundationRequest;\nuse SymfonyComponentHttpFoundationResponse;\nuse SymfonyComponentRoutingAnnotationRoute;\n\n\/**\n * @Route(\"\/users\")\n *\/\nclass UserController extends AbstractController\n{\n    \/**\n     * @Route(\"\/\", name=\"users_index\", methods={\"GET\"})\n     *\/\n    public function index(UserRepository $userRepository): Response\n    {\n        $users = $userRepository->findAll();\n\n        return $this->render('users\/index.html.twig', [\n            'users' => $users,\n        ]);\n    }\n}<\/code><\/pre>\n
      以上就是在 Doctrine 中定义实体的基本步骤。这只是一个基本的例子，实际应用可能会根据具体需求进行修改。<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\n","protected":false},"excerpt":{"rendered":"
      Bug编译狮 Doctrine 是一个用于 PHP 的 ORM（对象关系映射）&#..<\/p>\n","protected":false},"author":1,"featured_media":0,"menu_order":0,"template":"","meta":{"_acf_changed":false},"tags":[],"my1js2nav":[45],"tuisongtax":[],"class_list":["post-1100","my1js","type-my1js","status-publish","hentry","my1js2nav-symfony"],"acf":{"qian_art_seotitle":"","qian_art_seotitle_source":{"label":"SEO\u6807\u9898","type":"text","formatted_value":""},"qian_art_seokws":"","qian_art_seokws_source":{"label":"SEO\u5173\u952e\u8bcd","type":"text","formatted_value":""},"qian_art_stzhong":"","qian_art_stzhong_source":{"label":"\u4e2d | \u77ed\u6807\u9898","type":"text","formatted_value":""}},"_links":{"self":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js\/1100","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js"}],"about":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/types\/my1js"}],"author":[{"embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/media?parent=1100"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tags?post=1100"},{"taxonomy":"my1js2nav","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js2nav?post=1100"},{"taxonomy":"tuisongtax","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tuisongtax?post=1100"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}