mzj/doctrine-orm-provider

该包最新版本(dev-master)没有可用的许可证信息。

为 Silex 提供的 Doctrine ORM

dev-master / 1.0.x-dev 2012-09-21 14:02 UTC

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

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。