La passion du libre

Le guide complet de Yii 2 (traduction du guide officiel)

Cliquez sur le bouton pour afficher les conseils de lecture.Cliquez à nouveau pour les masquer

Fenêtres surgissantes explicatives

Certains mots dans le texte, affichés en vert et en gras, sont précédés d'une étoile verte sur fond orange. Par exemple, ce mot : lien.

Si vous placez le pointeur de la souris sur un tel mot, une fenêtre surgissante – popup – s'ouvre alors que l'affichage du reste du documment s'atténue. Cette fenêtre contient une explication détaillée du mot en question

Une fois que vous avez pris connaissance de ce que vous affiche cette fenêtre surgissante, vous pouvez retourner à l'état normal en cliquant ailleurs dans le document.

Navigation

Pour naviguer, utilisez le menu vertical à gauche du texte. Les entrées de menu marquées d'une petite flèche vers le bas ouvrent un sous-menu lorsqu'on clique dessus.

Vous pouvez également choisir une lecture continue en cliquant sur un des liens proposés en bas de page.

Fonctionnement des applications

Après avoir installé Yii, vous obtenez une application Yii fonctionnelle accessible via l'URL http://hostname/basic/web/index.php ou http://hostname/index.php, en fonction de votre configuration. Cette section vous initiera aux fonctionnalités intégrées à l'application, à la manière dont le code est organisé, et à la gestion des requêtes par l'application.

Info: Par simplicité, au long de ce tutoriel de démarrage, nous supposerons que basic/web est la racine de votre serveur Web, et que vous avez configuré l'URL pour accéder à votre application comme suit ou similaire : http://hostname/index.php. Pour vos besoins, merci d'ajuster les URLs dans notre description comme il convient.

Fonctionnalité

L'application basique installée contient quatre pages :

  • La page d'accueil, affichée quand vous accédez à l'URL http://hostname/index.php,
  • la page "About" (A Propos),
  • la page "Contact", qui présente un formulaire de contact permettant aux utilisateurs finaux de vous contacter par email,
  • et la page "Login" (Connexion), qui présente un formulaire de connexion qui peut être utilisé pour authentifier des utilisateurs finaux. Essayez de vous connecter avec "admin/admin", et vous verrez l'élément "Login" du menu principal être remplacé par "Logout" (Déconnexion).

Ces pages ont en commun une entête et un pied de page. L'entête contient une barre de menu principal qui permet la navigation entre les différentes pages.

Vous devriez également voir une barre d'outils en bas de votre fenêtre de navigation. C'est un outil de débogage utile fourni par Yii pour enregistrer et afficher de nombreuses informations de débogage, telles que des messages de logs, statuts de réponses, les requêtes lancées vers la base de données, et ainsi de suite.

Structure de l'Application

Les répertoires et fichiers les plus importants de votre application sont (en supposant que le répertoire racine de l'application est basic) :

basic/                  chemin de base de l'application
    composer.json       utilisé par Composer, décrit les information de paquets
    config/             contient les configurations de l'application et autres
        console.php     configuration de l'application console
        web.php         configuration de l'application Web
    commands/           contient les classes de commandes console
    controllers/        contient les classes de contrôleurs
    models/             contient les classes de modèles
    runtime/            contient les fichiers générés par Yii au cours de l'exécution, tels que les fichiers de logs ou de cache and cache
    vendor/             contient les paquets Composer installés, y compris le framework Yii
    views/              contient les fichiers de vues
    web/                racine Web de l'application, contient les fichiers accessibles via le Web
        assets/         contient les fichiers assets (javascript et css) publiés par Yii
        index.php       le script de démarrage (ou bootstrap) pour l'application
    yii                 le script d'exécution de Yii en commande console

Dans l'ensemble, les fichiers de l'application peuvent être séparés en deux types : ceux situés dans basic/web et ceux situés dans d'autres répertoires. Les premiers peuvent être atteints directement en HTTP (c'est à dire dans un navigateur), tandis que les seconds doivent pas l'être.

Yii est implémenté selon le patron de conception modèle-vue-contrôleur (MVC), ce qui se reflète dans l'organisation des répertoires ci-dessus. Le répertoire models contient toutes les classes modèles, le répertoire views contient tous les scripts de vue, et le répertoire controllers contient toutes les classes contrôleurs.

Le schéma suivant présente la structure statique d'une application.

Structure Statique d'Application

Chaque application a un script de démarrage web/index.php qui est le seul script PHP de l'application accessible depuis le Web. Le script de démarrage reçoit une requête et créé une instance d'application pour la traiter. L'application résout la requête avec l'aide de ses composants, et distribue la requête aux éléments MVC. Les Widgets sont utilisés dans les vues pour aider à créer des éléments d'interface complexes et dynamiques.

Cycle de vie d'une requête

Le diagramme suivant présente la manière dont une application traite une requête.

Cycle de Vie d'une Requête

  1. Un utilisateur fait une requête au script de démarrage web/index.php.
  2. Le script de démarrage charge la configuration de l'application et créé une instance d'application pour traiter la requête.
  3. L'application résout la route requise avec l'aide du composant d'application requête.
  4. L'application créé une instance de contrôleur pour traiter la requête.
  5. Le contrôleur créé une instance d'action et effectue les filtres pour l'action.
  6. Si un filtre échoue, l'action est annulée.
  7. Si tous les filtres sont validés, l'action est exécutée.
  8. L'action charge un modèle de données, potentiellement depuis une base de données.
  9. L'action génère une vue, lui fournissant le modèle de données.
  10. Le résultat généré est renvoyé au composant d'application réponse.
  11. Le composant réponse envoie le résultat généré au navigateur de l'utilisateur.