mzj / doctrine-orm-provider
为 Silex 提供的 Doctrine ORM
Requires
- php: >=5.3.2
- doctrine/common: 2.1.*
- doctrine/dbal: 2.1.*
- doctrine/orm: 2.1.*
Suggests
- symfony/console: Necessary if you would like to use the Doctrine CLI tools
This package is not auto-updated.
Last update: 2024-09-28 12:28:40 UTC
README
此扩展通过重用与 DBAL 扩展(Silex 内置的默认 DoctrineServiceProvider)建立的数据库连接来为 Silex 设置 Doctrine ORM。
在 README 中你可以找到以下主题
依赖
- Silex (在 composer.json 中未提及,因为 -在我看来- 它是您自己项目的直接依赖,因此您应该将其放在自己的 JSON 文件中。)
- PHP 5.3.2 及以上
- Doctrine 2 对象关系映射器
- Doctrine 数据库抽象层
- Doctrine 的通用库
安装
将此扩展添加到您的 Silex 项目中有三种基本方法。我们强烈建议您选择第一种方法!
composer.json
https://packagist.org.cn/packages/nutwerk/doctrine-orm-provider
将 'nutwerk/doctrine-orm-provider' 添加到项目 composer.json 文件中的依赖项,并更新您的依赖项。这是迄今为止最简单的方法,因为它会自动添加 Doctrine 依赖项,并将所有内容添加到 Composer 提供的自动加载机制中。
有关 Composer 的更多信息,请访问 getcomposer.org。
Git
另一种选择是克隆项目
cd /path/to/your_project/vendor
git clone git@github.com:mjakubowski/nutwerk-orm-extension.git
或者,如果您的项目也在 git 仓库中,您可以将它作为子模块添加
cd /path/to/your_project
git submodule add git@github.com:mjakubowski/nutwerk-orm-extension.git vendor/nutwerk-orm-extension
这将需要您手动安装所有依赖项。另外,请注意,您需要手动将提供程序添加到 Silex 自动加载器(或任何自动加载机制)。更多关于这两个主题的信息可以在下面找到。
下载存档
GitHub 还提供下载 ZIP 存档 的选项,您可以在 vendor 文件夹中提取它。此方法也需要您手动安装所有依赖项并将所有内容添加到您的自动加载器中。
配置
首先,您应该配置 Doctrine DBAL 连接。有关配置 DoctrineServiceProvider 的更多信息,我建议您阅读 Silex 文档中的此页。
注册 Doctrine ORM 服务提供者是相当直接的
<?php /* ... */ $app['autoloader']->registerNamespace('Nutwerk', __DIR__ . '/vendor/nutwerk-orm-extension/lib'); $app->register(new Nutwerk\Provider\DoctrineORMServiceProvider(), array( 'db.orm.class_path' => __DIR__.'/vendor/doctrine2-orm/lib', 'db.orm.proxies_dir' => __DIR__.'/var/cache/doctrine/Proxy', 'db.orm.proxies_namespace' => 'DoctrineProxy', 'db.orm.auto_generate_proxies' => true, 'db.orm.entities' => array(array( 'type' => 'annotation', 'path' => __DIR__.'/app', 'namespace' => 'Entity', )), )); /* ... */
注意:如果您不想使用 Silex 的内部自动加载器(因为您正在使用其他自动加载器,例如由 composer 生成的自动加载器),则可以省略以 $app['autoloader']
开头的行和 db.orm.class_path 参数。
参数(及其默认值)
以下将列出所有参数及其默认值(它们也可以在 DoctrineORMServiceProvider::setOrmDefaults 中找到)。
-
db.orm.auto_generated_proxies
默认值:
true
设置 Doctrine 是否在运行时自动生成代理类。如果设置为
false
,则必须手动使用 Doctrine 命令行工具生成代理类。建议在生产环境中禁用自动生成。 -
db.orm.cache
默认值:
new ArrayCache
定义了应使用哪种缓存方法。在开发过程中,默认的(ArrayCache)应该足够好,但在生产环境中,你可能希望将其更改为APC或Memcache之类的选项。更多详细信息,请参阅Doctrine 2 ORM 2.1文档的《第22章 缓存》部分:Chapter 22. Caching。
-
db.orm.class_path
只有当你想使用Silex自动加载器自动加载Doctrine 2 ORM类时才需要使用此配置。它应指向存储类的文件夹(Doctrine仓库中的lib文件夹)。
-
db.orm.entities
默认
array( array( 'type' => 'annotation', 'path' => 'Entity', 'namespace' => 'Entity', ) )
An array of arrays which should contain:
* ``type``: Type of metadata driver used (``annotation``, ``yml``, ``xml``)
* ``path``: Path to where the metadata is stored
* ``namespace``: Namespace used for the entities
The Doctrine ORM Service Provider uses a _DriverChain_ internally to configure Doctrine 2 ORM.
This allows you to use mixed types of metadata drivers in a single project.
-
db.orm.proxies_dir
默认:
cache/doctrine/Proxy
设置Doctrine生成任何代理类的目录。有关代理类的详细说明以及它们如何在Doctrine中使用,请参阅Doctrine ORM文档的《3.5 代理对象》部分:section 3.5 Proxy Objects。
-
db.orm.proxies_namespace
默认:
DoctrineProxy
设置用于生成代理类的命名空间。有关代理类的详细说明以及它们如何在Doctrine中使用,请参阅Doctrine ORM文档的《3.5 代理对象》部分:section 3.5 Proxy Objects。
使用
你可以通过调用$app['db.orm.em']
来访问EntityManager。