# Zend_Application

`Zend_Application` est la classe de base du composant et le point d'entrée de votre application Zend Framework. Ses buts sont multiples : configurer l'environnement PHP (incluant l'autoloading) et exécuter le bootstrap de votre application.

Typiquement, vous allez passer toute la configuration au constructeur de `Zend_Application`, mais vous pouvez aussi configurer l'objet via ses méthodes. Ce chapitre illustrera les deux aspects.

## Zend_Application options

Option | Description
--- | ---
phpSettings | Tableau de paramètres `php.ini` à utiliser. Les clés doivent être des clés reconnues dans `php.ini`.
includePaths | Chemins additionnels à ajouter à include_path. Ces chemins sont ajoutés avant l'include_path. L'option doit être un tableau de chemins.
autoloaderNamespaces | Tableau d'espaces de noms à enregistrer dans `Zend_Loader_Autoloader`.
bootstrap | Soit une chaîne vers le fichier contenant la classe de bootstrap, soit un tableau avec les clés 'path' et 'class' menant vers le bootstrap.

## Noms des options

Notez que les noms des options ne sont pas sensibles à la casse.

## Méthodes dans Zend_Application

Méthode | Valeur de retour | Paramètres | Description
--- | --- | --- | ---

`__construct($environment, $options = null)`

Void

- `$environment` : requis, Chaîne représentant l'environnement actuel dans lequel tourne l'application. Par exemple "development", "testing", "qa", ou "production". Les significations de ces chaînes sont à définir par la suite.

- `$options` : optionnel.

  - String : chemin vers un fichier `Zend_Config` à charger pour la configuration de votre application. `$environment` sera utilisé pour déterminer la section de configuration à charger depuis le fichier.

  - Array : tableau associatif de données de configuration pour votre application.

  - `Zend_Config` : un instance d'objet de configuration.

Une instance de `Zend_Loader_Autoloader` est enregistrée lors de l'instanciation. Les options passées au constructeur sont passées à `setOptions()`.

`getEnvironment()` | String | N/A | Récupère l'environnement passé au constructeur.
`getAutoloader()` | `Zend_Loader_Autoloader` | N/A | Récupère l'objet `Zend_Loader_Autoloader` enregistré lors de l'instanciation.

`setOptions(array $options)`

`Zend_Application`

- `$options` : requis. Un tableau d'options pour l'application.

Toutes les options sont stockées en interne, et appeler plusieurs fois la même méthode fusionnera les options qu'elle définit. Les options qui correspondent aux diverses méthodes setter seront passées à ces méthodes. Par exemple, l'option "phpSettings" sera passée à `setPhpSettings()`.

`getOptions()` | Array | N/A | Récupère toutes les options utilisées pour initialiser l'objet. Pourrait être utilisé pour mettre en cache les options `Zend_Config` entre chaque requête, par exemple.

`hasOption($key)`

Boolean

- `$key` : La clé de l'option à chercher

Indique si une option correspondant à une clé précise a été utilisée ou pas. Les clés sont insensibles à la casse.

`getOption($key)`

Mixed

- `$key` : La clé de l'option à récupérer

Récupère l'option correspondant à la clé passée, `NULL` si celle-ci n'existe pas.

`setPhpSettings(array $settings, $prefix = '')`

`Zend_Application`

- `$settings` : requis. Tableau associatif de paramètres PHP INI

- `$prefix` : optionnel. Préfixe pour construire la chaîne des clés d'options. Utilisée en interne pour faire correspondre les clés `php.ini` séparés par des points (".") avec des tableaux à plusieurs niveaux. En temps normal, cet argument ne devrait jamais être utilisé par l'utilisateur.

Affecte à la volée des paramètres de `php.ini`. Les paramètres séparés par des points peuvent être imbriqués hiérarchiquement (comme dans le cas des paramètres INI de `Zend_Config`).

`setAutoloaderNamespaces(array $namespaces)`

`Zend_Application`

- `$namespaces` : requis. Tableau de chaînes représentant les espaces de noms à enregistrer dans `Zend_Loader_Autoloader`.

Enregistre des espaces de noms dans `Zend_Loader_Autoloader`.

`setBootstrap($path, $class = null)`

`Zend_Application`

- `$path` : requis. Peut être soit un objet de `Zend_Application_Bootstrap_Bootstrapper`, soit une chaîne représentant le chemin vers la classe de bootstrap, soit un tableau associatif nom de classe => chemin de fichier, ou encore un tableau associatif avec les clés "class" et "path".

- `$class` : optionnel. Si `$path` est une chaîne, `$class` doit être indiqué et doit être une chaîne représentant le nom d'une classe contenue dans le fichier représenté par le chemin.

`getBootstrap()` | `NULL` | `Zend_Application_Bootstrap_Bootstrapper` | N/A | Récupère l'instance du bootstrap enregistrée.
`bootstrap()` | Void | N/A | Appelle la méthode `bootstrap()` du bootstrap pour lancer l'application.
`run()` | Void | N/A | Appelle la méthode `run()` du bootstrap pour lancer le dispatch de l'application.