README

此包包含为Doctrine ORM和MongoDB ODM提供新功能或工具的扩展，以更高效地使用Doctrine。这些行为可以轻松附加到Doctrine的事件系统中，并以行为方式处理被刷新的记录。

Doctrine Extensions 3.0 发布 🎉

3.0侧重于为今天的PHP刷新此包。这包括

• 提高PHP、Doctrine和其他依赖项的最低版本要求
• 实现对最新Doctrine MongoDB & Common包的支持
• 更新测试套件，添加代码和样式标准，以及其他需要的构建工具
• 清理文档、代码、注释等。

阅读升级文档以获取更多信息。

安装

composer require gedmo/doctrine-extensions

• Symfony
• Laravel
• Laminas

升级

• 从2.4.x升级到3.0

扩展

ORM & MongoDB ODM

• 可追踪的 - 在创建、更新以及属性变更时更新字符串或引用字段，例如用户。
• 可记录的 - 帮助跟踪对象的变化和历史，也支持版本管理。
• 可缩略的 - 将指定的字段转换为唯一的缩略名。
• 可时间戳的 - 在创建、更新以及属性变更时更新日期字段。
• 可翻译的 - 提供了一种非常方便的解决方案，可以将记录翻译成不同的语言。易于设置，更易于使用。
• 树形结构 - 自动化树处理过程，并在存储库上添加一些特定的树函数。（闭包，嵌套集或物化路径） （MongoDB ODM仅支持物化路径）

仅ORM

• IP可追踪的 - 从Timestampable继承，设置IP地址而不是时间戳
• 软删除的 - 允许隐式删除记录
• 可排序的 - 使任何文档或实体可排序
• 可上传的 - 在实体字段中提供文件上传处理

仅MongoDB ODM

• 参考 - 支持在文档中链接实体，反之亦然
• ReferenceIntegrity - 限制ODM MongoDB文档引用

所有扩展都支持 属性、XML 和（已弃用）注解 映射。可以通过使用映射扩展轻松实现额外的映射驱动程序来处理额外的元数据映射。

版本兼容性

• DBAL: ^3.2
• ORM: ^2.14 或 ^3.0
• MongoDB ODM: ^2.3

如果您在没有框架的情况下设置实体管理器，请参阅 示例 以防止出现类似于 #1310 的问题

XML 映射

XML 映射需要不同的命名空间，Doctrine 扩展声明的命名空间为 http://gediminasm.org/schemas/orm/doctrine-extensions-mapping 因此根节点现在看起来像这样

<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
                 xmlns:gedmo="http://gediminasm.org/schemas/orm/doctrine-extensions-mapping">
...
</doctrine-mapping>

XML 映射 xsd 架构也是分版本的，可以使用版本后缀使用

• 最新版本 - http://gediminasm.org/schemas/orm/doctrine-extensions-mapping
• 2.2.x 版本 - http://gediminasm.org/schemas/orm/doctrine-extensions-mapping-2-2
• 2.1.x 版本 - http://gediminasm.org/schemas/orm/doctrine-extensions-mapping-2-1

运行测试

要设置和运行测试，请按照以下步骤操作

• 安装 Docker 并确保您有 docker compose
• 从项目根目录，运行 docker compose up -d 以在守护进程模式下启动容器
• 通过 docker compose exec php bash 进入容器（您现在位于根目录：/var/www）
• 通过 composer install 安装 Composer 依赖项
• 运行测试：vendor/bin/phpunit

运行示例

要设置和运行示例，请按照以下步骤操作

• 转到扩展的根目录
• 下载 composer
• 安装开发库： composer install
• 编辑 example/em.php 并在文件顶部配置您的数据库
• 运行： php example/bin/console 或 php example/bin/console 以运行控制台命令
• 运行： php example/bin/console orm:schema-tool:create 以创建模式
• 运行： php example/bin/console app:print-category-translation-tree 以运行示例并打印类别翻译树

贡献者

感谢所有参与这些优秀 Doctrine 扩展开发的人！

特别是创建和维护新扩展的人

• Lukas Botsch lbotsch
• Gustavo Adrian comfortablynumb
• Boussekeyt Jules gordonslondon
• Kudryashov Konstantin everzet
• David Buchmann dbu