Development

Documentation/fr_FR/book/1.0/trunk/02-Exploring-Symfony-s-Code (diff)

You must first sign up to be able to contribute.

Changes between Version 10 and Version 11 of Documentation/fr_FR/book/1.0/trunk/02-Exploring-Symfony-s-Code

Show
Ignore:
Author:
grunge (IP: 87.67.157.157)
Timestamp:
03/21/08 18:17:03 (10 years ago)
Comment:

Tableau

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/fr_FR/book/1.0/trunk/02-Exploring-Symfony-s-Code

    v10 v11  
    497497 
    498498Le tableau 2-1 décrit le contenu de ces répertoires 
    499  
    500499*Tableau 2-1 Répertoires racines* 
    501500 
    502 Répertoire | Description 
    503 -----------|------------- 
    504 `apps/`    | Contient un répertoire par applications du projet (communément `frontend` et `backend` pour le front et le back office) 
    505 `batch/`   | Contient les scripts PHP appelés par une ligne de commande ou un planificateur de tâches 
    506 `cache/`   | Contient le cache de la configuration et (si vous l’activez) le cache des actions et des gabarits du projet. Le cache (décrit au chapitre 12) utilise ces fichiers pour améliorer les temps de réponses des requêtes. Chaque applications y aura donc un sous-répertoire contenant des processus PHP ou HTML prétraité. 
    507 `config/`  | Contient la configuration générale du projet 
    508 `data/`    | Tout ce qui est relatif aux bases de données est conservé ici : le schéma de la base de donné, les fichiers SQL de création etc … 
    509 `doc/`     | Contient la documentation du projet y compris votre propre documentation et celle générée par PHPdoc 
    510 `lib/`     | Ce répertoire est réservé aux classes et librairies extérieures. Vous pouvez-y ajouter du code devant être partagé par toutes vos applications. Le répertoire `model/`contient le modèle objet du projet (cf. Chapitre 8) 
    511 `log/`     | Ici sont conservés les fichiers journaux générés par Symfony. Il peut aussi contenir les journaux du serveur web, des bases de données ou n’importe quels autres fichiers journaux du projet. Symfony crée un fichier journal par application et environnement (cf Chapitre 16) 
    512 `plugins/` | Ce répertoire contient les plugins installés pour cette application (cf Chapitre 17) 
    513 `test/`    | Il contient des jeux d’essai unitaires et fonctionnels écrit en php et compatibles avec le framework de test de Symfony (cf Chapitre 15). 
    514 `web/`     | La racine du serveur web. Seuls les fichiers se trouvant dans ce fichier sont accessible via Internet. 
     501 
     502<table style="border:1px solid;"><tr><td>Répertoire </td><td> Description 
     503</td></tr><tr><td><tt>apps/</tt>    </td><td> Contient un répertoire par applications du projet (communément <tt>frontend</tt> et <tt>backend</tt> pour le front et le back office) 
     504</td></tr><tr><td><tt>batch/</tt>   </td><td> Contient les scripts PHP appelés par une ligne de commande ou un planificateur de tâches 
     505 
     506</td></tr><tr><td><tt>cache/</tt>   </td><td> Contient le cache de la configuration et (si vous l’activez) le cache des actions et des gabarits du projet. Le cache (décrit au chapitre 12) utilise ces fichiers pour améliorer les temps de réponses des requêtes. Chaque applications y aura donc un sous-répertoire contenant des processus PHP ou HTML prétraité. 
     507</td></tr><tr><td><tt>config/</tt>  </td><td> Contient la configuration générale du projet 
     508</td></tr><tr><td><tt>data/</tt>    </td><td> Tout ce qui est relatif aux bases de données est conservé ici : le schéma de la base de donné, les fichiers SQL de création etc … 
     509</td></tr><tr><td><tt>doc/</tt>     </td><td> Contient la documentation du projet y compris votre propre documentation et celle générée par PHPdoc 
     510</td></tr><tr><td><tt>lib/</tt>     </td><td> Ce répertoire est réservé aux classes et librairies extérieures. Vous pouvez-y ajouter du code devant être partagé par toutes vos applications. Le répertoire <tt>model/</tt>contient le modèle objet du projet (cf. Chapitre 8) 
     511 
     512</td></tr><tr><td><tt>log/</tt>     </td><td> Ici sont conservés les fichiers journaux générés par Symfony. Il peut aussi contenir les journaux du serveur web, des bases de données ou n’importe quels autres fichiers journaux du projet. Symfony crée un fichier journal par application et environnement (cf Chapitre 16) 
     513</td></tr><tr><td><tt>plugins/</tt> </td><td> Ce répertoire contient les plugins installés pour cette application (cf Chapitre 17) 
     514</td></tr><tr><td><tt>test/</tt>    </td><td> Il contient des jeux d’essai unitaires et fonctionnels écrit en php et compatibles avec le framework de test de Symfony (cf Chapitre 15). 
     515</td></tr><tr><td><tt>web/</tt>     </td><td> La racine du serveur web. Seuls les fichiers se trouvant dans ce fichier sont accessible via Internet. 
     516</td></tr></table> 
    515517 
    516518 
    534536*Tableau 2-2 Répertoires d’une application* 
    535537 
    536 Répertoire   | Description 
    537 -------------|------------ 
    538 `config/`    | Contient l’ensemble des fichiers de configuration YAML. Le plus gros de la configuration de l’application se trouve ici mis à part les paramètres par défaut conservé  au sein du framwork lui-même. Remarque : les paramètres par défaut peuvent être écrasés ici si nécessaire. Vous en apprendrez plus sur la configuration d’une application au chapitre 5 
    539 `I18n/`      | Contient les fichiers d’internationalisation de l’application, des fichiers de traduction de l’interface la plus part du temps. (Cf Chapitre 13) Vous pouvez vous passer de ces fichiers si vous gérez l’internationalisation pas la base de donnée 
    540 `lib/`       | Contient les librairies et les classes spécifiques à l’application 
    541 `modules/`   | Contient tous les modules propres à l’application 
    542 `templates/` | Contient tous les gabarits de l’application, ceux partagé par tous les modules. Par défaut, il contient `layout.php` qui est la maquette dans laquelle tous les gabarits sont insérés. 
     538<table style="border:1px solid;"><tr><td>Répertoire </td><td> Description  
     539</td></tr><tr><td><tt>config/</tt>    </td><td> Contient l’ensemble des fichiers de configuration YAML. Le plus gros de la configuration de l’application se trouve ici mis à part les paramètres par défaut conservé  au sein du framwork lui-même. Remarque : les paramètres par défaut peuvent être écrasés ici si nécessaire. Vous en apprendrez plus sur la configuration d’une application au chapitre 5 
     540</td></tr><tr><td><tt>I18n/</tt>      </td><td> Contient les fichiers d’internationalisation de l’application, des fichiers de traduction de l’interface la plus part du temps. (Cf Chapitre 13) Vous pouvez vous passer de ces fichiers si vous gérez l’internationalisation pas la base de donnée 
     541</td></tr><tr><td><tt>lib/</tt>       </td><td> Contient les librairies et les classes spécifiques à l’application 
     542</td></tr><tr><td><tt>modules/</tt>   </td><td> Contient tous les modules propres à l’application 
     543 
     544</td></tr><tr><td><tt>templates/</tt> </td><td> Contient tous les gabarits de l’application, ceux partagé par tous les modules. Par défaut, il contient <tt>layout.php</tt> qui est la maquette dans laquelle tous les gabarits sont insérés. 
     545</td></tr></table> 
     546 
    543547 
    544548>**NOTE** 
    570574*Tableau 2-3 Répertoires du module* 
    571575 
    572 Répertoire | Description 
    573 -----------|------------ 
    574 `actions/`   | En règle générale, ce répertoire possède ne contient que la classe `actions.class.php` qui regroupe toutes les actions du modules. Il est aussi possible d’écrire plusieurs actions dans des fichiers séparés 
    575 `config/`    | Il peut contenir des fichiers de paramétrages locaux pour les modules 
    576 `lib/`       | Contient les classes et librairies spécifiques au module 
    577 `template/`  | Contient les gabarits correspondant aux actions du module. Un gabarit par défaut appelé `indexSucces.php`, est crée par défaut à l’installation du module 
    578 `validate/`  | Dédié à la configuration des fichiers utilisés par le formulaire de validation (cf Chapitre 10)  
     576 
     577<table style="border:1px solid;"><tr><td> Répertoire </td><td>  Description 
     578</td></tr><tr><td> <tt>actions/</tt>   </td><td>  En règle générale, ce répertoire possède ne contient que la classe <tt>actions.class.php</tt> qui regroupe toutes les actions du modules. Il est aussi possible d’écrire plusieurs actions dans des fichiers séparés 
     579</td></tr><tr><td> <tt>config/</tt>    </td><td>  Il peut contenir des fichiers de paramétrages locaux pour les modules 
     580 
     581</td></tr><tr><td> <tt>lib/</tt>       </td><td>  Contient les classes et librairies spécifiques au module 
     582</td></tr><tr><td> <tt>template/</tt>  </td><td>  Contient les gabarits correspondant aux actions du module. Un gabarit par défaut appelé <tt>indexSucces.php</tt>, est crée par défaut à l’installation du module 
     583</td></tr><tr><td> <tt>validate/</tt>  </td><td>  Dédié à la configuration des fichiers utilisés par le formulaire de validation (cf Chapitre 10)  
     584</td></tr></table> 
     585 
     586 
    579587 
    580588>**NOTE** 
    597605*Tableau 2-4 – Arborescence Web classique* 
    598606 
    599 Répertoire | Description 
    600 -----------|------------ 
    601 `css/`     | Contient les feuilles de styles avec l’extension `.css` 
    602 `images/`  | Contient les images aux formats `.jpg`, `.png` ou `.gif` 
    603 `js/`      | Contient les fichiers JavaScript avec l’extension `.js` 
    604 `uploads/` | Doit contenir les images uploadées par l’utilisateur. Même si le dossier contient des images, il est bien distinct du dossier des images afin que la synchronisation des serveurs de développement et de production, n’affecte pas les images uploadées. 
     607<table style="border:1px solid;"><tr><td>Répertoire </td><td> Description 
     608</td></tr><tr><td><tt>css/</tt>     </td><td> Contient les feuilles de styles avec l’extension <tt>.css</tt> 
     609</td></tr><tr><td><tt>images/</tt>  </td><td> Contient les images aux formats <tt>.jpg</tt>, <tt>.png</tt> ou <tt>.gif</tt> 
     610 
     611</td></tr><tr><td><tt>js/</tt>      </td><td> Contient les fichiers <a class="wiki" href="/wiki/JavaScript">JavaScript</a> avec l’extension <tt>.js</tt> 
     612</td></tr><tr><td><tt>uploads/</tt> </td><td> Doit contenir les images uploadées par l’utilisateur. Même si le dossier contient des images, il est bien distinct du dossier des images afin que la synchronisation des serveurs de développement et de production, n’affecte pas les images uploadées. 
     613</td></tr></table> 
     614 
    605615 
    606616>**NOTE**