Introduction au Zend Framework

 Apprendre Zend Framework

appendix

 Guide de référence Zend Framework


  •  Zend_Gdata
  •  Zend_Http
  •  Zend_InfoCard
  •  Zend_Json
  •  Zend_Layout
  •  Zend_Ldap
  •  Zend_Loader
  •  Zend_Locale
  •  Zend_Log
  •  Zend_Mail
  •  Zend_Markup
  •  Zend_Measure
  •  Zend_Memory
  •  Zend_Mime
  •  Zend_Navigation
  •  Zend_Oauth
  •  Zend_OpenId
  •  Zend_Paginator
  •  Zend_Pdf
  •  Zend_ProgressBar
  •  Zend_Queue
  •  Zend_Reflection
  •  Zend_Registry
  •  Zend_Rest

  •  Zend_Search_Lucene
  •  Zend_Serializer
  •  Zend_Server
  •  Zend_Service
  •  Zend_Session
  •  Zend_Soap
  •  Zend_Tag
  •  Zend_Test
  •  Zend_Text
  •  Zend_TimeSync
  •  Zend_Tool
  •  Zend_Tool_Framework
  •  Zend_Tool_Project
  •  Zend_Translate
  •  Zend_Uri
  •  Zend_Validate
  •  Zend_Version
  •  Zend_View
  •  Zend_Wildfire
  •  Zend_XmlRpc
  • ZendX_Console_Process_Unix
  • ZendX_JQuery
  • Translation 61.2% Update 2010-11-28 - Revision 23149 - Version ZF 1.11.x

    14.6. Plugins de ressources disponibles

    Vous trouverez ci-après la documentation de type API concernant tous les plugins disponibles par défaut dans Zend_Application.

    14.6.1. Zend_Application_Resource_Cachemanager

    Zend_Application_Resource_Cachemanager peut être utilisé pour configurer un jeu d'ensemble d'options Zend_Cache permettant de paramétrer des caches à chargement tardifs ("lazy loading") avec Zend_Cache_Manager

    Comme le gestionnaire de cache est un mécanisme à chargement tardif, les options sont traduites en modèle d'options utilisé pour instancier un objet de cache à la demande.

    Exemple 14.1. Exemple de configuration d'une ressource de gestionnaire de cache

    Ci-dessous vous trouverez un extrait de fichier INI montrant comment Zend_Cache_Manager peut être configuré. Le format est le préfixe de la ressource Cachemanager (resources.cachemanager) suivi par le nom d'un modèle (par exemple resources.cachemanager.database) et finalement suivi par une option habituelle de Zend_Cache.

    resources.cachemanager.database.frontend.name Core
    resources
    .cachemanager.database.frontend.customFrontendNaming false
    resources
    .cachemanager.database.frontend.options.lifetime 7200
    resources
    .cachemanager.database.frontend.options.automatic_serialization true
    resources
    .cachemanager.database.backend.name File
    resources
    .cachemanager.database.backend.customBackendNaming false
    resources
    .cachemanager.database.backend.options.cache_dir "/path/to/cache"
    resources.cachemanager.database.frontendBackendAutoload false

    Ensuite récupérer ce cache à partir du gestionnaire est aussi simple que d'accéder à une instance de gestionnaire (Zend_Cache_Manager) récupéré à partir de Zend_Application_Resource_Cachemanager et d'appeler $cacheManager->getCache('database'). L'exemple ci-dessous est extrait d'un contrôleur dans lequel la classe de bootstrap est accessible via un paramètre du contrôleur frontal (qui est automatiquement assigné lors de l'amorçage). Comme vous pouvez le voir, la ressource de gestionnaire de cache implémente la méthode getCacheManager() pour récupérer l'instance de Zend_Cache_Manager préparée dans le bootstrap.

    $manager $this->getFrontController()
                    ->
    getParam('bootstrap')
                    ->
    getResource('cachemanager')
                    ->
    getCacheManager();
    $dbCache $manager->getCache('database');

    Reportez-vous à la méthode Zend_Cache::factory() pour avoir une description des valeurs par défaut que vous pouvez affecter lors de la configuration du cache via un fichier de configuration comme le fichier INI de l'exemple ci-dessus.


    14.6.2. Zend_Application_Resource_Db

    Zend_Application_Resource_Db initialisera un adaptateur Zend_Db basé sur les options qui lui seront fournis. Par défaut, il spécifiera aussi cet adaptateur comme adaptateur par défaut à utiliser avec Zend_Db_Table. Si vous souhaitez utiliser simultanément de multiples bases de données, vous pouvez utiliser la plugin de ressource Multidb.

    Les clés de configuration suivantes sont reconnues :

    • adapter : le type de l'adaptateur Zend_Db.

    • params : un tableau associatif des paramètres de configuration à utiliser pour la récupération de l'instance de l'adaptateur.

    • isDefaultTableAdapter : spécifie si l'adaptateur est celui par défaut des tables.

    • defaultMetadataCache : spécifie le nom du modèle de cache ou une instance de Zend_Cache_Core à utiliser en tant que cache de métadonnées pour Zend_Db_Table.

    Exemple 14.2. Exemple de configuration d'une ressource d'adaptateur de base données

    Voici un exmple de configuration INI qui peut-être utilisé pour initialiser une ressource de base de données.

    [production]
    resources.db.adapter "pdo_mysql"
    resources.db.params.host "localhost"
    resources.db.params.username "webuser"
    resources.db.params.password "XXXXXXX"
    resources.db.params.dbname "test"
    resources.db.isDefaultTableAdapter true

    Optionnellementon peut utiliser un modèle du gestionnaire de cache :
    resources.db.defaultMetadataCache "database"

    [Note] Récupération de l'instance de l'adaptateur

    Si vous choisissez de ne pas utiliser l'adaptateur instancié avec cette ressource comme adaptateur par défaut pour les tables, comment pourrez-vous récupérer l'instance ?

    Comme tout plugin de ressource, vous pouvez extraire votre plugin de ressource de votre fichier d'initialisation :

    $resource $bootstrap->getPluginResource('db');

    Une fois que vous avez l'objet ressource, vous pouvez récupérer l'adaptateur de base de données en utilisant la méthode getDbAdapter() :

    $db $resource->getDbAdapter();

    14.6.3. Zend_Application_Resource_Dojo

    Zend_Application_Resource_Dojo peut être utiliser pour configurer les aides de vue Zend_Dojo.

    Exemple 14.3. Exemple de configuration de ressource Dojo

    Ci-dessous vous trouverez un exemple de fichier INI montrant comment Zend_Dojo peut être activé.

    resources.dojo.enable true Toujours charger les fichiers Javascript Dojo

    Le plugin de ressource Zend_Dojo utilise les options de Zend_Dojo_View_Helper_Dojo_Container::setOptions() pour configurer les aides de vue. Regardez le chapitre Zend_Dojo pour plus d'informations.


    14.6.4. Zend_Application_Resource_Frontcontroller

    Probablement la ressource que vous allez le plus communément charger avec Zend_Application sera la ressource de contrôleur frontal qui fournit la possibilité de configurer Zend_Controller_Front. Cette ressource permet de spécifier n'importe quel paramètre du contrôleur frontal, de spécifier les plugins à initialiser, et bien plus...

    Une fois initialisée, la ressource assigne la propriété $frontController du fichier d'initialisation à l'instance Zend_Controller_Front.

    Les clés de configuration disponibles incluent les suivantes et sont sensibles à la casse :

    • controllerDirectory : une chaîne de caractères spécifiant un seul dossier de contrôleurs, ou un tableau associant un nom de module et un dossier de contrôleurs.

    • moduleControllerDirectoryName : une chaîne de caractères indiquant un sous-dossier dans ce module qui contient les contrôleurs.

    • moduleDirectory : un dossier dans lequel tous les modules peuvent être trouvés.

    • defaultControllerName : nom du contrôleur par défaut (normalement "index").

    • defaultAction : nom de l'action par défaut (normalement "index").

    • defaultModule : nom du module par défaut (normalement "default").

    • baseUrl : URL de base explicite vers l'application (normalement auto-détecté).

    • plugins : tableau de nom de classe de plugins de contrôleurs. La ressource instanciera chaque classe (sans arguments de contructeur) et les enregistrera dans le contrôleur frontal. Si vous souhaitez enregistrer un plugin avec un index particulier dans la pile des plugins, vous devez fournir un tableau avec deux clés class et stackIndex.

    • params : tableau de paires clés / valeurs à enregistrer dans le contrôleur frontal.

    • returnresponse : active ou non le retour de l'objet de réponse après la distribution du contrôleur frontal. Cette valeur devrait être booléenne ; par défaut, ceci est désactivé.

    Si une clé non-connue est fournie, elle sera enregistrée comme paramètre du contrôleur frontal en la fournissant à setParam().

    Exemple 14.4. Exemple de configuration d'une ressource de contrôleur frontal

    Voici un extrait de configuration INI montrant comment configurer la ressource de contrôleur frontal.

    [production]
    resources.frontController.controllerDirectory APPLICATION_PATH "/controllers"
    resources.frontController.moduleControllerDirectoryName "actions"
    resources.frontController.moduleDirectory APPLICATION_PATH "/modules"
    resources.frontController.defaultControllerName "site"
    resources.frontController.defaultAction "home"
    resources.frontController.defaultModule "static"
    resources.frontController.baseUrl "/subdir"
    resources.frontController.plugins.foo "My_Plugin_Foo"
    resources.frontController.plugins.bar "My_Plugin_Bar"
    resources.frontController.plugins.baz.class = "My_Plugin_Baz"
    resources.frontController.plugins.baz.stackIndex 123
    resources
    .frontController.returnresponse 1
    resources
    .frontController.env APPLICATION_ENV

    ;Ce qui suit proxie vers :
    ;
    Zend_Controller_Action_HelperBroker::addPath('Helper_Path'$helperPrefix);
    resources.frontController.actionHelperPaths.HELPER_Prefix "My/Helper/Path"

    Exemple 14.5. Récupération de votre contrôleur frontal à partir de votre initialiseur

    Une fois la ressource de contrôleur frontal initialisée, vous pouvez récupérer l'instance via la propriété $frontController de votre initialiseur.

    $bootstrap->bootstrap('frontController');
    $front $bootstrap->frontController;

    14.6.5. Zend_Application_Resource_Layout

    Zend_Application_Resource_Layout peut être utilisé pour configurer Zend_Layout. Les options de configurations sont les mêmes que celles de Zend_Layout.

    Exemple 14.6. Exemple de configuration de layout

    Ci-dessous un exemple de code INI montrant comment configurer la ressource layout.

    resources.layout.layout "NomDuLayoutParDefaut"
    resources.layout.layoutPath "/chemin/vers/layouts"

    14.6.6. Zend_Application_Resource_Locale

    Zend_Application_Resource_Locale peut être utilisé pour paramétrer de manière globale la région dans une application qui sera alors utilisée par toutes les classes et les composants qui travaille avec la localisation et l'internationalisation. Par défaut la locale est sauvegardée dans une entrée de Zend_Registry avec la clé 'Zend_Locale'.

    Il y a basiquement trois cas d'utilisation du plugin de ressource Locale. Chacun pouvant être utilisé suivant les besoins de votre application.

    14.6.6.1. Autodétection de la locale à utiliser

    Sans spécifier d'options pour Zend_Application_Resource_Locale, Zend_Locale va détecter automatiquement la locale, que votre application va utiliser.

    Cette détection fonctionne car votre client émet la langue souhaitée à l'intérieur de sa requête HTTP. Normalement le navigateur client envoie les langues qu'il accepte de voir, et Zend_Locale utilise cette information pour la détection.

    Mais il y a deux problèmes avec cette approche :

    • Le navigateur pourrait ne paramétrer aucune langue

    • L'utilisateur pourrait avoir manuellement paramétrer une locale qui n'existe pas

    Dans ces deux cas Zend_Locale reviendra vers d'autres mécanismes pour détecter la locale :

    • Quand une locale inexistante a été fournie, Zend_Locale essaie de réduire la chaîne.

      Quand, par exemple, fr_ZZ a été paramétré, il est automatiquement réduit en fr. Dans ce cas fr sera utilisé en tant que locale pour votre application.

    • Quand la locale ne peut pas non plus être reconnue même après réduction, la locale de votre environnement (serveur Web) sera utilisée. La plupart des environnements des hébergeurs utilise en en tant que locale.

    • Quand la locale de l'environnement ne peut pas non plus être détectée, Zend_Locale utilisera sa locale par défaut, qui est par défaut en.

    Pour de plus amples informations concernant la détection des locales, lisez le chapitre sur la déctection automatique avec Zend_Locale.

    14.6.6.2. Autodétection de la locale avec ajout de votre propre valeur par défaut

    L'autodétection ci-dessus peut entraîner des problèmes quand la locale ne peut pas être détectée et que vous souhaitez une autre locale par défaut que en. Pour empêcher ceci, Zend_Application_Resource_Locale vous permet de paramétrer votre propre locale qui sera utilisée si aucune locale ne peut être détectée.

    Exemple 14.7. Autodétecter la locale et paramétrer une valeur par défaut

    L'extrait suivant montre comment spécifier sa propre locale utilisée si le client n'envoie pas lui-même une locale.

    tentative de détection automatique,
    si impossible alors on prend fr_FR.
    resources.locale.default = "fr_FR"

    14.6.6.3. Forcer l'utilisation d'une locale

    Parfois il peut être pratique de définir la locale qui devra être utilisée. Ceci peut être fait en utilisant l'option force.

    Dasn ce cas, cette locale seule sera utilisée et la détection automatique sera désactivée.

    Exemple 14.8. Définition de la locale à utiliser

    L'extrait suivant montre comment spécifier la locale à utiliser pour toute votre application.

    dans tous les casfr_FR doit être utilisé
    resources
    .locale.default = "fr_FR"
    resources.locale.force true

    14.6.7. Zend_Application_Resource_Log

    Zend_Application_Resource_Log permet d'instancier une instance Zend_Log avec une nombre quelconque de rédacteurs. La configuration sera fournie à la méthode Zend_Log::factory() vous permettant de spécifier les combinaisons de rédacteurs et de filtres. L'instance de journalisation peut ensuite être récupérée à partir du bootstrap afin d'enregistrer les événements.

    Exemple 14.9. Exemple de configuration d'une ressource de journalisation

    Ci-dessous, vous avez un extrait de fichier INI montrant comment configurer la ressource de journalisation.

    resources.log.stream.writerName "Stream"
    resources.log.stream.writerParams.stream APPLICATION_PATH "/../data/logs/application.log"
    resources.log.stream.writerParams.mode "a"
    resources.log.stream.filterName "Priority"
    resources.log.stream.filterParams.priority 4

    Pour plus d'informations concernant les options disponibles, vous pouvez consulter la documentation de Zend_Log::factory().


    14.6.8. Zend_Application_Resource_Multidb

    Zend_Application_Resource_Multidb est utilisé pour initialiser de multiples connexions vers des bases de données. Vous pouvez utiliser les mêmes options qu'avec le plugin de ressource Db. Cependant, pour spécifier une connexion par défaut, vous pouvez aussi utiliser la directive 'default'.

    Exemple 14.10. Paramétrer de multiples connexions vers des bases de données

    Ci-dessous vous avez un exemple de configuration INI montrant l'initialisation de deux connexions.

    [production]
    resources.multidb.db1.adapter "pdo_mysql"
    resources.multidb.db1.host "localhost"
    resources.multidb.db1.username "webuser"
    resources.multidb.db1.password "XXXX"
    resources.multidb.db1.dbname "db1"

    resources.multidb.db2.adapter "pdo_pgsql"
    resources.multidb.db2.host "example.com"
    resources.multidb.db2.username "dba"
    resources.multidb.db2.password "notthatpublic"
    resources.multidb.db2.dbname "db2"
    resources.multidb.db2.default = true

    Exemple 14.11. Récupérer un adaptateur de bases de données spécifique

    Lorsque vous utilisez ce plugin de ressource, vous aurez sans doute besoin de récupérer un adaptateur spécifique. Ceci peut être réalisé en utilisant la méthode getDb(). La méthode getDb() retourne l'instance d'une classe qui étend Zend_Db_Adapter_Abstract. Si vous n'avez pas activé un adaptateur par défaut, une exception sera levée lorsque vous appelerez cette méthode sans lui fournir de paramètre.

    $resource $bootstrap->getPluginResource('multidb');
    $db1 $resource->getDb('db1');
    $db2 $resource->getDb('db2');
    $defaultDb $resource->getDb();

    Exemple 14.12. Récupérer l'adaptateur de base de données par défaut

    De plus, vous pouvez récupérer l'adaptateur par défaut en utilisant la méthode getDefaultDb(). Si vous n'avez pas activé d'adaptateur par défaut, le premier configuré sera retourné. Si vous spécifiez FALSE en tant que premier paramètre, alors vous récupérez NULL si adaptateur par défaut n'est configuré.

    Ci-dessous vous avez un exemple qui suppose que le plugin de ressource Multidb a été configuré avec l'exemple INI ci-dessus :

    $resource $bootstrap->getPluginResource('multidb');
    $db2 $resource->getDefaultDb();

    // Même config, mais maintenant sans adaptateur par défaut :
    $db1 $resource->getDefaultDb();
    $null $resource->getDefaultDb(false); // null

    14.6.9. Zend_Application_Resource_Mail

    Zend_Application_Resource_Mail peut être utilisé pour instancier un transport pour Zend_Mail ou pour paramétrer le nom par défaut et l'adresse, ainsi que le nom et l'adresse de réponse par défaut.

    Lors de l'instanciation d'un transport, il est automatiquement enregistré avec Zend_Mail. Cependant en paramétrant la directive transport.register à FALSE, ce comportement n'apparait pas.

    Exemple 14.13. Exemple de configuration de la ressource Mail

    Ci-dessous, vous avez un extrait d'un fichier INI montrant comment configurer le plugin de ressource Mail.

    resources.mail.transport.type smtp
    resources
    .mail.transport.host "smtp.example.com"
    resources.mail.transport.auth login
    resources
    .mail.transport.username myUsername
    resources
    .mail.transport.password myPassword
    resources
    .mail.transport.register true True by default
    resources.mail.defaultFrom.email john@example.com
    resources
    .mail.defaultFrom.name "John Doe"
    resources.mail.defaultReplyTo.email Jane@example.com
    resources
    .mail.defaultReplyTo.name "Jane Doe"

    14.6.10. Zend_Application_Resource_Modules

    Zend_Application_Resource_Modules est utilisé pour initialiser les modules de votre application. Si votre module possède un fichier Bootstrap.php à sa racine, et que celui-ci contient une classe nommée Module_Bootstrap (où "Module" est le nom du module), alors celle-ci sera utiliser pour lancer votre module.

    Par défaut, une instance de Zend_Application_Module_Autoloader sera créée pour le module en question, utilisant le nom du module et son dossier pour s'initialiser.

    Puisque la ressource Modules ne prend pas d'argument par défaut, pour l'activer via la configuration, vous devez créer un tableau vide. Since the Modules resource does not take any arguments by default, in order to enable it via configuration, you need to create it as an empty array. En configuration de type INI cela ressemblerait à ceci :

    resources.modules[] =

    En configuration de type XML cela ressemblerait à ceci :

    <resources>
        <
    modules>
            <!-- 
    Emplacement pour s'assurer qu'un tableau est créé -->
            <
    placeholder />
        </
    modules>
    </
    resources>

    En utilisant un tableau PHP, il suffit de le créer comme un tableau vide :

    $options = array(
        
    'resources' => array(
            
    'modules' => array()
        )
    );
    [Note] Dépendance envers le contrôleur frontal

    La ressource Modules possède une dépendance envers la ressource Front Controller. Vous pouvez bien sûr proposer votre propre implémentation de la ressource du contrôleur frontal, si tant est que sa classe se termine par "Frontcontroller", ou, si vous choisissez d'utiliser une méthode d'initialisation, celle-ci doit être "_initFrontController".

    Exemple 14.14. Configurer les modules

    Vous pouvez spécifier la configuration en utilisant le nom du module comme préfixe de section dans le fichier de configuration.

    Par exemple, supposons que vous possédiez un module appelé "news". Voici des exemples INI et XML de fichiers de configuration pour ce module.

    [production]
    news.resources.db.adapter "pdo_mysql"
    news.resources.db.params.host "localhost"
    news.resources.db.params.username "webuser"
    news.resources.db.params.password "XXXXXXX"
    news.resources.db.params.dbname "news"
    <?xml version="1.0"?>
    <config>
        <production>
            <news>
                <resources>
                    <db>
                        <adapter>pdo_mysql</adapter>
                        <params>
                            <host>localhost</host>
                            <username>webuser</username>
                            <password>XXXXXXX</password>
                            <dbname>news</dbname>
                        </params>
                        <isDefaultAdapter>true</isDefaultAdapter>
                    </db>
                </resources>
            </news>
        </production>
    </config>

    Exemple 14.15. Récupérer un bootstrap de module

    Il peut être utile de pouvoir récupérer l'objet bootstrap de votre module, pour en exécuter par exemple des méthodes spécifiques, ou encore pour en récupérer l'autoloader. La méthode getExecutedBootstraps() peut être utilisée dans ce cas là, elle s'applique sur un objet ressource de modules.

    $resource $bootstrap->getPluginResource('modules');
    $moduleBootstraps $resource->getExecutedBootstraps();
    $newsBootstrap $moduleBootstraps['news'];

    14.6.11. Zend_Application_Resource_Navigation

    Zend_Application_Resource_Navigation peut être utilisé pour configurer une instance de Zend_Navigation. Les options de configurations sont les mêmes que celles de Zend_Navigation.

    Une fois configuré, l'objet de navigation est ajouté à Zend_View_Helper_Navigation par défaut.

    Exemple 14.16. Exemple de configuration de la ressource Navigation

    Voici un exemple de syntaxe INI concernant la configuration de la ressource navigation.

    resources.navigation.pages.page1.label "Nom de la première page"
    resources.navigation.pages.page1.route "Route concernant la première page"

    Page 2 est une sous-page de page 1
    resources
    .navigation.pages.page1.pages.page2.type "Zend_Navigation_Page_Uri"
    resources.navigation.pages.page1.pages.page2.label "Nom de la seconde page"
    resources.navigation.pages.page1.pages.page2.uri "/url/to/page/2"

    14.6.12. Zend_Application_Resource_Router

    Zend_Application_Resource_Router est utilisé pour configurer le routeur enregistré grâce aux options du contrôleur frontal. Les options sont identiques à celles de Zend_Controller_Router_Route.

    Exemple 14.17. Exemple de configuration du routeur

    Voici l'exemple d'un fichier INI qui configure une ressource de type routeur.

    resources.router.routes.route_id.route "/login"
    resources.router.routes.route_id.defaults.module "user"
    resources.router.routes.route_id.defaults.controller "login"
    resources.router.routes.route_id.defaults.action "index"

    Optionnellementun séparateur de chaînes peut être précisé :
    resources.router.chainNameSeparator "_"

    Pour plus d'informations sur le séparateur de chaînes, voyez sa section.


    14.6.13. Zend_Application_Resource_Session

    Zend_Application_Resource_Session est utilisé pour configurer Zend_Session et éventuellement un support de sauvegarde sessions (SaveHandler).

    Pour créer un support de sauvegarde session, passez la clé saveHandler (case insensitive) à la ressource. La valeur d'une telle option peut être :

    • String : cette chaîne indique le nom d'une classe implémentant Zend_Session_SaveHandler_Interface.

    • Array : avec les clés "class" et optionnellement "options", indiquant une classe à instancier (implémentant Zend_Session_SaveHandler_Interface) et un tableau d'options à passer à son constructeur.

    • Zend_Session_SaveHandler_Interface : un objet implémentant cette interface.

    Toute autre option non reconnue sera alors passée à Zend_Session::setOptions() pour configurer Zend_Session.

    Exemple 14.18. Exemple de ressource session

    Voici un fichier INI permettant de configurer une session via la ressource. Il affecte des options à Zend_Session et configure une instance de Zend_Session_SaveHandler_DbTable.

    resources.session.save_path APPLICATION_PATH "/../data/session"
    resources.session.use_only_cookies true
    resources
    .session.remember_me_seconds 864000
    resources
    .session.saveHandler.class = "Zend_Session_SaveHandler_DbTable"
    resources.session.saveHandler.options.name "session"
    resources.session.saveHandler.options.primary.session_id "session_id"
    resources.session.saveHandler.options.primary.save_path "save_path"
    resources.session.saveHandler.options.primary.name "name"
    resources.session.saveHandler.options.primaryAssignment.sessionId "sessionId"
    resources.session.saveHandler.options.primaryAssignment.sessionSavePath "sessionSavePath"
    resources.session.saveHandler.options.primaryAssignment.sessionName "sessionName"
    resources.session.saveHandler.options.modifiedColumn "modified"
    resources.session.saveHandler.options.dataColumn "session_data"
    resources.session.saveHandler.options.lifetimeColumn "lifetime"

    [Note] Configurez votre base de données avant !

    Si vous configurez le gestionnaire Zend_Session_SaveHandler_DbTable, vous devez configurer votre base de données avant. Pour cela, servez vous de la ressource Db et assurez vous que la clé "resources.db" apparaît bien avant la clé "resources.session". Vous pouvez aussi utiliser votre propre ressource qui initialise la base de données et affecte l'adaptateur Zend_Db_Table par défaut.

    14.6.14. Zend_Application_Resource_Translate

    Zend_Application_Resource_Translate initialisera un adaptateur Zend_Translate basé sur les options qui lui seront fourni.

    Les clés de configuration suivantes sont reconnues :

    • adapter : le type de l'adaptateur Zend_Translate. S'il n'est pas précisé, l'adaptateur par défaut est de type tableau (array).

    • data : le chemin d'accès aux sources de traduction.

    • locale : la locale à utiliser pour choisir la traduction. Ce paramètre est optionnel, car la langue de l'utilisateur peut être soit détectée automatiquement soit forcée avec une instance Zend_Locale placée dans Zend_Registry avec une langue choisie.

    • options : les options varient en fonction de l'adaptateur choisi. Veuillez vous reporter à la section Section 73.3.7, « Options pour les adaptateurs » de ce dernier pour plus de détails.

    • registry : spécifie la clé du registre pour stocker l'instance de Zend_Translate. Ce paramètre est optionnel, car il sera mis par défaut dans le registre avec la clé Zend_Translate.

    • cache : spécifie le nom d'un modèle du gestionnaire de cache ou l'objet de cache pour les sources de traduction. Cela permet d'améliorer les performances en particulier pour les formats XML.

    Exemple 14.19. Exemple de configuration d'une ressource multilingue

    Voici un extrait de configuration INI montrant comment configurer une ressource multilingue.

    resources.translate.adapter tmx
    resources
    .translate.content APPLICATION_PATH "/../data/locales"
    resources.translate.scan Zend_Translate::LOCALE_DIRECTORY

    Optionnellementon peut utiliser un modèle du gestionnaire de cache :
    resources.translate.cache "languages"

    14.6.15. Zend_Application_Resource_View

    Zend_Application_Resource_View peut être utilisée pour configurer une instance Zend_View. Les clés de configurations sont celles de Zend_View.

    Dès que l'instance est configurée, ceci crée une instance de Zend_Controller_Action_Helper_ViewRenderer et enregistre le ViewRenderer avec Zend_Controller_Action_HelperBroker - à partir duquel vous pourrez le récupérer plus tard.

    Exemple 14.20. Exemple de configuration d'une ressource de vue

    Voici un extrait de configuration INI montrant comment configurer une ressource de vue.

    resources.view.encoding "UTF-8"
    resources.view.basePath APPLICATION_PATH "/views"

    14.6.15.1. Définir une doctype

    Pour obtenir plus d'informations à propos des valeurs de l'aide de vue Doctype, veuillez la section dédiée.

    Exemple 14.21. Exemple de configuration d'une doctype

    L'extrait suivant montre comment spécifier la doctype de son choix.

    resources.view.doctype "HTML5"

    14.6.15.2. Définir le type de contenu, et l'encodage

    Pour obtenir plus d'informations à propos des valeurs de l'aide de vue headMeta, veuillez la section dédiée.

    Exemple 14.22. Exemple de configuration du type de contenu, et l'encodage

    L'extrait suivant montre comment spécifier un méta Content-Type.

    resources.view.contentType "text/html; charset=UTF-8"

    Exemple 14.23. Exemple de configuration de l'encodage pour un document HTML5

    L'extrait suivant montre comment spécifier un méta charset.

    resources.view.doctype "HTML5"
    resources.view.charset "UTF-8"

    digg delicious meneame google twitter technorati facebook

    Comments

    Loading...