Symfony
a SensioLabs product
DOWNLOAD NOW

Table of Contents

Creative Commons License
This work is licensed under a
Creative Commons
Attribution-Share Alike 3.0
Unported License.

Master Symfony2 fundamentals

Be trained by SensioLabs experts (2 to 6 day sessions -- French or English).
trainings.sensiolabs.com

Symfony hosting done right

ServerGrove, outstanding support at the right price for your Symfony hosting needs.
servergrove.com

Discover the SensioLabs Support

Access to the SensioLabs Competency Center for an exclusive and tailor-made support on Symfony
sensiolabs.com
Home » Documentation » Documenti di riferimento » Riferimento configurazione
master version

Riferimento configurazione

Riferimento configurazione

  • YAML
    doctrine:
    dbal:
        default_connection:   default
        types:
            # Un insieme di tipi personalizzati
            # Esempio
            some_custom_type:
                class:                Acme\HelloBundle\MioTipoPersonalizzato
                commented:            true

        connections:
            default:
                dbname:               database

            # Un insieme di nomi di connessioni (p.e. default, conn2, ecc.)
            default:
                dbname:               ~
                host:                 localhost
                port:                 ~
                user:                 root
                password:             ~
                charset:              ~
                path:                 ~
                memory:               ~

                # Il socket unix da usare per MySQL
                unix_socket:          ~

                # True per usare una connessione persistente per il driver ibm_db2
                persistent:           ~

                # Protocollo da usare per il driver ibm_db2 (se omesso, TCPIP)
                protocol:             ~

                # True per usare dbname come nome di servizio invece di SID per Oracle
                service:              ~

                # Modalità di sessione da usare per il driver oci8
                sessionMode:          ~

                # True per usare un pool di server con il driver oci8
                pooled:               ~

                # Configurazione di MultipleActiveResultSets per il driver pdo_sqlsrv
                MultipleActiveResultSets:  ~
                driver:               pdo_mysql
                platform_service:     ~
                logging:              %kernel.debug%
                profiling:            %kernel.debug%
                driver_class:         ~
                wrapper_class:        ~
                options:
                    # array di opzioni
                    key:                  []
                mapping_types:
                    # array di tipi di mappature
                    name:                 []
                slaves:

                    # insieme di nomi di connessioni slave (p.e. slave1, slave2)
                    slave1:
                        dbname:               ~
                        host:                 localhost
                        port:                 ~
                        user:                 root
                        password:             ~
                        charset:              ~
                        path:                 ~
                        memory:               ~

                        # Il socket unix da usare per MySQL
                        unix_socket:          ~

                        # True per usare una connessione persistente per il driver ibm_db2
                        persistent:           ~

                        # Protocollo da usare per il driver ibm_db2 (se omesso, TCPIP)
                        protocol:             ~

                        # True per usare dbname come nome di servizio invece di SID per Oracle
                        service:              ~

                        # Modalità di sessione da usare per il driver oci8
                        sessionMode:          ~

                        # True per usare un pool di server con il driver oci8
                        pooled:               ~

                        # Configurazione di MultipleActiveResultSets per il driver pdo_sqlsrv
                        MultipleActiveResultSets:  ~

    orm:
        default_entity_manager:  ~
        auto_generate_proxy_classes:    false
        proxy_dir:            %kernel.cache_dir%/doctrine/orm/Proxies
        proxy_namespace:                Proxies
        # cercare la classe "ResolveTargetEntityListener" per una ricetta a riguardo
        resolve_target_entities: []
        entity_managers:
            # Un insieme di nomi di gestori di entità (p.e. un_em, un_atrlo_em)
            some_em:
                query_cache_driver:
                    type:                 array # Obbligatorio
                    host:                 ~
                    port:                 ~
                    instance_class:       ~
                    class:                ~
                metadata_cache_driver:
                    type:                 array # Obbligatorio
                    host:                 ~
                    port:                 ~
                    instance_class:       ~
                    class:                ~
                result_cache_driver:
                    type:                 array # Obbligatorio
                    host:                 ~
                    port:                 ~
                    instance_class:       ~
                    class:                ~
                connection:           ~
                class_metadata_factory_name:    Doctrine\ORM\Mapping\ClassMetadataFactory
                default_repository_class:  Doctrine\ORM\EntityRepository
                auto_mapping:         false
                hydrators:

                    # An array of hydrator names
                    hydrator_name:                 []
                mappings:
                    # An array of mappings, which may be a bundle name or something else
                    mapping_name:
                        mapping:              true
                        type:                 ~
                        dir:                  ~
                        alias:                ~
                        prefix:               ~
                        is_bundle:            ~
                dql:
                    # un insieme di funzioni stringa
                    string_functions:
                        # esempio
                        # test_string: Acme\HelloBundle\DQL\StringFunction

                    # un insieme di funzioni numeriche
                    numeric_functions:
                        # esempio
                        # test_numeric: Acme\HelloBundle\DQL\NumericFunction

                    # un insieme di funzioni datetime
                    datetime_functions:
                        # esempio
                        # test_datetime: Acme\HelloBundle\DQL\DatetimeFunction

                # Registra filtri SQL nel gestore di entità
                filters:
                    # Un array di filtri
                    some_filter:
                        class:                ~ # Obbligatorio
                        enabled:              false
  • XML
    <container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
                        http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">

    <doctrine:config>
        <doctrine:dbal default-connection="default">
            <doctrine:connection
                name="default"
                dbname="database"
                host="localhost"
                port="1234"
                user="user"
                password="secret"
                driver="pdo_mysql"
                driver-class="MyNamespace\MyDriverImpl"
                path="%kernel.data_dir%/data.sqlite"
                memory="true"
                unix-socket="/tmp/mysql.sock"
                wrapper-class="MyDoctrineDbalConnectionWrapper"
                charset="UTF8"
                logging="%kernel.debug%"
                platform-service="MyOwnDatabasePlatformService"
            >
                <doctrine:option key="foo">bar</doctrine:option>
                <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
            </doctrine:connection>
            <doctrine:connection name="conn1" />
            <doctrine:type name="custom">Acme\HelloBundle\MyCustomType</doctrine:type>
        </doctrine:dbal>

        <doctrine:orm default-entity-manager="default" auto-generate-proxy-classes="false" proxy-namespace="Proxies" proxy-dir="%kernel.cache_dir%/doctrine/orm/Proxies">
            <doctrine:entity-manager name="default" query-cache-driver="array" result-cache-driver="array" connection="conn1" class-metadata-factory-name="Doctrine\ORM\Mapping\ClassMetadataFactory">
                <doctrine:metadata-cache-driver type="memcache" host="localhost" port="11211" instance-class="Memcache" class="Doctrine\Common\Cache\MemcacheCache" />
                <doctrine:mapping name="AcmeHelloBundle" />
                <doctrine:dql>
                    <doctrine:string-function name="test_string>Acme\HelloBundle\DQL\StringFunction</doctrine:string-function>
                    <doctrine:numeric-function name="test_numeric>Acme\HelloBundle\DQL\NumericFunction</doctrine:numeric-function>
                    <doctrine:datetime-function name="test_datetime>Acme\HelloBundle\DQL\DatetimeFunction</doctrine:datetime-function>
                </doctrine:dql>
            </doctrine:entity-manager>
            <doctrine:entity-manager name="em2" connection="conn2" metadata-cache-driver="apc">
                <doctrine:mapping
                    name="DoctrineExtensions"
                    type="xml"
                    dir="%kernel.root_dir%/../vendor/gedmo/doctrine-extensions/lib/DoctrineExtensions/Entity"
                    prefix="DoctrineExtensions\Entity"
                    alias="DExt"
                />
            </doctrine:entity-manager>
        </doctrine:orm>
    </doctrine:config>
</container>

Panoramica della configurazione

Il seguente esempio di configurazione mostra tutte le configurazioni predefinite, che l'ORM risolve:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
doctrine:
    orm:
        auto_mapping: true
        # la distribuzione standard sovrascrive a true in debug, false altrimenti
        auto_generate_proxy_classes: false
        proxy_namespace: Proxies
        proxy_dir: "%kernel.cache_dir%/doctrine/orm/Proxies"
        default_entity_manager: default
        metadata_cache_driver: array
        query_cache_driver: array
        result_cache_driver: array

Ci sono molte altre opzioni di configurazione che si possono usare per sovrascrivere determinate classi, ma sono solo per casi molto avanzati.

Driver per la cache

Per i driver della cache, si può specificare "array", "apc", "memcache" o "xcache".

L'esempio seguente mostra una panoramica delle configurazioni di cache:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
doctrine:
    orm:
        auto_mapping: true
        metadata_cache_driver: apc
        query_cache_driver:
            type: service
            id: my_doctrine_common_cache_service
        result_cache_driver:
            type: memcache
            host: localhost
            port: 11211
            instance_class: Memcache

Configurazioni della mappatura

La definizione esplicita di tutte le entità mappate è l'unica configurazione necessaria per l'ORM e ci sono diverse opzioni di configurazione controllabili. La mappatura dispone delle seguenti opzioni di configurazione:

  • type Uno tra annotation, xml, yml, php o staticphp. Specifica quale di tipo di meta-dati usa la mappatura.
  • dir Percorso per la mappatura o per i file entità (a seconda del driver). Se questo percorso è relativo, si assume sia relativo alla radice dei bundle. Funziona solo se il nome della propria mappatura è il nome di un bundle. Se si vuole usare questa opzione per specificare percorsi assoluti, si dovrebbe aggiungere al percorso un prefisso con i parametri del kernel nel DIC (per esempio %kernel.root_dir%).
  • prefix Un prefisso comune di spazio dei nomi che tutte le entità di questa mappatura condividono. Questo prefisso non deve essere in conflitto con i prefissi di altre mappature definite, altrimenti alcune entità non saranno trovate da Doctrine. Questa opzione ha come valore predefinito lo spazio dei nomi del bundle + Entity, per esempio per un bundle chiamato AcmeHelloBundle il prefisso sarebbe Acme\HelloBundle\Entity.
  • alias Doctrine offre un modo per avere alias di spazi dei nomi con nomi più corti e semplici, da usare nelle query DQL o per l'accesso al Repository. Quando si usa un bundle, l'alias predefinito è il nome del bundle.
  • is_bundle Questa opzione è un valore derivato da dir e ha true come valore predefinito, se la cartella è fornita da una verifica con file_exists() che restituisca false. È false se la verifica restituisce true. In questo caso, un percorso assoluto è stato specificato e i file dei meta-dati sono probabilmente in una cartella fuori da un bundle.

Configurazione Doctrine DBAL

DoctrineBundle supporta tutti i parametri che i driver predefiniti di Doctrine accettano, convertiti alla nomenclatura XML o YML di Symfony. Vedere la documentazione DBAL di Doctrine per maggiori informazioni. Il blocco seguente mostra tutte le voci di configurazione:

  • YAML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
    doctrine:
    dbal:
        dbname:               database
        host:                 localhost
        port:                 1234
        user:                 user
        password:             secret
        driver:               pdo_mysql
        # opzione driverClass di DBAL
        driver_class:         MyNamespace\MyDriverImpl
        # opzione driverOptions di DBAL
        options:
            foo: bar
        path:                 "%kernel.data_dir%/data.sqlite"
        memory:               true
        unix_socket:          /tmp/mysql.sock
        # the DBAL wrapperClass option
        wrapper_class:        MyDoctrineDbalConnectionWrapper
        charset:              UTF8
        logging:              "%kernel.debug%"
        platform_service:     MyOwnDatabasePlatformService
        mapping_types:
            enum: string
        types:
            custom: Acme\HelloBundle\MyCustomType
        # opzione keepSlave di DBAL
        keep_slave:           false
  • XML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
    <!-- xmlns:doctrine="http://symfony.com/schema/dic/doctrine" -->
<!-- xsi:schemaLocation="http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd"> -->

<doctrine:config>
    <doctrine:dbal
        name="default"
        dbname="database"
        host="localhost"
        port="1234"
        user="user"
        password="secret"
        driver="pdo_mysql"
        driver-class="MyNamespace\MyDriverImpl"
        path="%kernel.data_dir%/data.sqlite"
        memory="true"
        unix-socket="/tmp/mysql.sock"
        wrapper-class="MyDoctrineDbalConnectionWrapper"
        charset="UTF8"
        logging="%kernel.debug%"
        platform-service="MyOwnDatabasePlatformService"
    >
        <doctrine:option key="foo">bar</doctrine:option>
        <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
        <doctrine:type name="custom">Acme\HelloBundle\MyCustomType</doctrine:type>
    </doctrine:dbal>
</doctrine:config>

Se si vogliono configurare connessioni multiple in YAML, si possono mettere sotto la voce connections e dar loro un nome univoco:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
doctrine:
    dbal:
        default_connection:       default
        connections:
            default:
                dbname:           Symfony2
                user:             root
                password:         null
                host:             localhost
            customer:
                dbname:           customer
                user:             root
                password:         null
                host:             localhost

Il servizio database_connection fa sempre riferimento alla configurazione predefinita, che è la prima definita o l'unica configurata tramite il parametro default_connection.

Ogni connessione è anche accessibile tramite il servizio doctrine.dbal.[nome]_connection, in cui [nome] è il nome della connessione.

« Riferimento configurazione AsseticBundle | Riferimento configurazione sicurezza »

NEWS FROM THE BLOG

Visit Symfony's blog

IN THE NEWS

Announcing the next Symfony Live Conference 2013 in Portland

UPCOMING TRAINING SESSIONS

View all sessions

sf - Symfony is a trademark of Fabien Potencier. All rights reserved.

What is Symfony?

Get Started

Learn Symfony

Marketplace

Community

Services

Blog

About