From 0b566b7e7d5fe8e6ca7aadb257282c14f06424a3 Mon Sep 17 00:00:00 2001 From: Benoît <b.destrube@gmail.com> Date: Tue, 7 Oct 2014 17:29:23 +0200 Subject: [PATCH] Create structure-entry-scripts.md --- docs/guide-fr/structure-entry-scripts.md | 117 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 docs/guide-fr/structure-entry-scripts.md diff --git a/docs/guide-fr/structure-entry-scripts.md b/docs/guide-fr/structure-entry-scripts.md new file mode 100644 index 0000000..2ddc67f --- /dev/null +++ b/docs/guide-fr/structure-entry-scripts.md @@ -0,0 +1,117 @@ +Scripts d'entrée +============= + +Les scripts d'entrée sont la première chaîne dans le processus de d'amorçage de l'application. Une application (qu'elle +soit une application Web ou une application console) a un unique script de démarrage. Les utilisateurs font des +requêtes au scripts de démarrage qui instancient des instances d'application et leur transmettent les requêtes. + +Les scripts d'entrée pour application Web doivent être placés dans des dossiers accessibles par le Web pour que les +utilisateurs puissent y accéder. Ils sont souvent nommés `index.php`, mais peuvent également avoir tout autre nom, +du moment que les serveurs Web peuvent les trouver. + +Les scripts d'entrée pour les applications console sont généralement placés dans le [répertoire de base](structure-applications.md) +des applications et sont nommés `yii` (avec le suffixe `.php`). Ils doivent être rendus exécutables afin que les +utilisateurs puissent lancer des applications console grâce à la commande `./yii <route> [arguments] [options]`. + +Les scipts de démarrage effectuent principalement les tâches suivantes : + +* Définir des constantes globales; +* Enregistrer l'[autoloader Composer](http://getcomposer.org/doc/01-basic-usage.md#autoloading); +* Inclure le fichier de classe de [[Yii]]; +* Charger la configuration de l'application; +* Créer et configurer une instance d'[application](structure-applications.md); +* Appeler [[yii\base\Application::run()]] pour traiter la requête entrante. + + +## Applications Web <a name="web-applications"></a> + +Ce qui suit est le code du script de démarrage du [Modèle Basique d'Application Web](start-installation.md). + +```php +<?php + +defined('YII_DEBUG') or define('YII_DEBUG', true); +defined('YII_ENV') or define('YII_ENV', 'dev'); + +// register Composer autoloader +require(__DIR__ . '/../vendor/autoload.php'); + +// include Yii class file +require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php'); + +// load application configuration +$config = require(__DIR__ . '/../config/web.php'); + +// create, configure and run application +(new yii\web\Application($config))->run(); +``` + + +## Applications Console <a name="console-applications"></a> + +De même, le code qui suit est le code du script de démarrage d'une application console : + +```php +#!/usr/bin/env php +<?php +/** + * Yii console bootstrap file. + * + * @link http://www.yiiframework.com/ + * @copyright Copyright (c) 2008 Yii Software LLC + * @license http://www.yiiframework.com/license/ + */ + +defined('YII_DEBUG') or define('YII_DEBUG', true); + +// fcgi doesn't have STDIN and STDOUT defined by default +defined('STDIN') or define('STDIN', fopen('php://stdin', 'r')); +defined('STDOUT') or define('STDOUT', fopen('php://stdout', 'w')); + +// register Composer autoloader +require(__DIR__ . '/vendor/autoload.php'); + +// include Yii class file +require(__DIR__ . '/vendor/yiisoft/yii2/Yii.php'); + +// load application configuration +$config = require(__DIR__ . '/config/console.php'); + +$application = new yii\console\Application($config); +$exitCode = $application->run(); +exit($exitCode); +``` + + +## Définir des Constantes <a name="defining-constants"></a> + +Les scripts de démarrage sont l'endroit idéal pour définir des constantes globales. Yii supporte les trois constantes suivantes : + +* `YII_DEBUG` : spécifie si une application tourne en mode de débogage. Si elle est en mode de débogage, une + application loguera plus d'informations, et révélera des piles d'appels d'erreurs détaillées si des exceptions + sont lancées. C'est pour cette raison que le mode de débogage doit être utilisé principalement pendant la phase + de développement. La valeur par défaut de `YII_DEBUG` est faux. +* `YII_ENV` : spécifie sur quel environnement l'application est en train de tourner. Cela a été décrit plus en détails + dans la section [Configurations](concept-configurations.md#environment-constants). La valeur par défaut de `YII_ENV` + est `'prod'`, ce qui signifie que l'application tourne en environnement de production. +* `YII_ENABLE_ERROR_HANDLER` : spécifie si le gestionnaire d'erreurs fourni par Yii doit être activé. La valeur par + défaut de cette constantes est vrai. + +Quand on définit une constant, on utilise souvent le code suivant : + +```php +defined('YII_DEBUG') or define('YII_DEBUG', true); +``` + +qui est l'équivalent du code suivant : + +```php +if (!defined('YII_DEBUG')) { + define('YII_DEBUG', true); +} +``` + +Clairement, le premier est plus succinct et plus aisé à comprendre. + +Les définitions de constantes doit être fait au tout début d'un script de démarrage pour qu'elles puissent prendre +effet quand d'autres fichiers PHP sont inclus. -- libgit2 0.27.1