Merge pull request #5407 from Benn/patch-1

docs/guide-fr/README.md

@@ -31,7 +31,7 @@ Structure Application
 ---------------------
 
 * [Vue d'ensemble](structure-overview.md)
-* [Script d'entrée](structure-entry-scripts.md)
+* [Scripts d'entrée](structure-entry-scripts.md)
 * [Applications](structure-applications.md)
 * [Composants application](structure-application-components.md)
 * [Contrôleurs](structure-controllers.md)

docs/guide-fr/structure-entry-scripts.md

+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 faite au tout début d'un script de démarrage pour qu'elles puissent prendre 
+effet quand d'autres fichiers PHP sont inclus.