Construire des applications web modernes avec des architectures séparées pour le frontend et le panneau d’administration nécessite une base solide. Le Template Avancé Yii2 est une solution structurée qui offre exactement cela, complète avec un système de gestion d’utilisateurs complet. Ce guide complet vous accompagnera à travers l’installation, la configuration et l’optimisation de votre environnement de développement pour ce template.
Dans le développement d’applications web à moyenne et grande échelle, le choix du bon framework est crucial. Le Template Avancé Yii2 apparaît comme une solution plus robuste que la version Basique. Ce template est spécifiquement conçu pour les projets nécessitant une séparation claire de la logique métier entre le frontend (application utilisateur final) et le backend (tableau de bord administrateur).
La raison principale pour laquelle les développeurs passent au Template Avancé Yii2 est la disponibilité d’un système de gestion d’utilisateurs complet et prêt à l’emploi. Celui-ci inclut les fonctionnalités d’inscription, de connexion, de déconnexion, de vérification d’email et de réinitialisation de mot de passe, toutes implémentées avec de bonnes normes de sécurité. De plus, son architecture modulaire permet une extension ultérieure, comme l’ajout d’applications séparées pour les rôles de modérateur, manager ou des services API isolés.
| Aspect | Template Basique Yii2 | Template Avancé Yii2 |
|---|---|---|
| Structure d’Application | Application Unique | Application Multi (Frontend, Backend, Console) |
| Gestion des Utilisateurs | Connexion/Déconnexion Basique uniquement | Système Complet (Inscription, Réinitialisation mot de passe, etc.) |
| Code de Base (Bootstrap) | Disponible | Disponible |
| Adéquation | Applications Simples, MVP | Applications Complexes, Entreprise |
| Niveau de Complexité | Faible à Moyen | Moyen à Élevé |
Préparatifs Obligatoires Avant l’Installation
Avant de commencer l’installation du Template Avancé Yii2, assurez-vous que votre environnement de développement répond à toutes les exigences techniques. Une préparation minutieuse prévient les erreurs et fait gagner du temps.
- Serveur Web : Vous avez besoin d’un serveur local comme XAMPP (Windows), Laragon (Windows), MAMP (Mac) ou LAMP (Linux). Assurez-vous que PHP version 7.4.0 ou supérieure est installée. PHP 8.0+ est fortement recommandé pour les dernières performances et sécurité. Téléchargez la dernière version de XAMPP depuis le site officiel d’Apache Friends.
- Composer : C’est un gestionnaire de dépendances PHP qui est obligatoire. Assurez-vous que Composer est installé globalement sur votre système. Vérifiez en exécutant la commande
composer --versiondans l’Invite de commandes ou le Terminal. Sinon, installez-le depuis GetComposer.org. - Extensions PHP : Assurez-vous que les extensions suivantes sont actives dans votre fichier
php.ini:pdo,pdo_mysql(oupdo_pgsqlpour PostgreSQL),mbstring,openssletintl. Elles sont généralement actives par défaut dans les packages XAMPP. - Base de Données : Préparez un serveur de base de données (MySQL/MariaDB recommandé) et créez une base de données vide qui sera utilisée par l’application Yii2.
Étape 1 : Installation de Yii2 Avancé via Composer
Le processus d’installation utilisant Composer est la méthode la plus recommandée car elle gérera toutes les dépendances de bibliothèques automatiquement et de manière structurée.
- Ouvrez l’Invite de commandes (Windows) ou le Terminal (Mac/Linux).
- Naviguez (
cd) vers le répertoirehtdocsde votre serveur local (par exemple,cd C:\xampp\htdocsoucd /Applications/MAMP/htdocs).
3. Exécutez la commande d’installation suivante. Cette commande créera un nouveau dossier nommé yii2-advanced contenant tout le code du template.
composer create-project --prefer-dist yiisoft/yii2-app-advanced yii2-advanced- Attendez que le processus se termine. Composer téléchargera tous les packages nécessaires, y compris le framework Yii2 lui-même, SwiftMailer et d’autres bibliothèques de support. Ce processus nécessite une connexion Internet stable et peut prendre quelques minutes.
Note Importante pour Composer 2.x : Contrairement aux anciens tutoriels, vous n’avez plus besoin d’exécuter la commande composer global require "fxp/composer-asset-plugin:~1.1.1". Ce plugin n’est plus supporté et a été remplacé par des méthodes natives dans Composer version 2. Vous pouvez donc exécuter directement la commande create-project.
Étape 2 : Initialisation et Configuration de Base
Une fois les fichiers du template téléchargés avec succès, l’étape suivante consiste à initialiser l’environnement et configurer l’application.
- Exécutez le Script d’Initialisation (Init) : Entrez dans le répertoire du projet (
cd yii2-advanced). À l’intérieur, exécutez le fichierinit.bat(Windows) ouinit(Linux/Mac) dans le terminal. Sélectionnez l’option[0] Developmentpour le mode développement. Si une confirmation est demandée, tapezyes. - Configurez la Base de Données : Ouvrez le fichier
common/config/main-local.phpavec votre éditeur de texte préféré. Recherchez la sectioncomponents['db']et ajustez les détails de connexion à votre base de données.
'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=votre_nom_de_base_de_données',
'username' => 'root', // votre nom d'utilisateur de base de données
'password' => '', // votre mot de passe de base de données
'charset' => 'utf8',
],- Exécutez la Migration de la Base de Données : Dans le terminal, toujours dans le répertoire du projet, exécutez la commande suivante pour créer automatiquement les schémas de table (y compris la table
user).
php yii migrateAppuyez sur Yes (Oui) lorsqu’on vous demande de confirmer l’exécution de la migration. Ce processus créera toutes les tables nécessaires, y compris celles pour la gestion des utilisateurs, les logs, et autres.
Étape 3 : Configuration de l’Hôte Virtuel (Recommandé)
Pour accéder au frontend et au backend avec des URL propres et séparées (par exemple, yii2-frontend.test et yii2-backend.test), il est fortement recommandé de configurer un hôte virtuel dans Apache. Cela reproduit un environnement de production et facilite le développement.
- Modifiez httpd-vhosts.conf : Ouvrez le fichier
C:\xampp\apache\conf\extra\httpd-vhosts.conf(ajustez le chemin si votre XAMPP est ailleurs). Ajoutez la configuration suivante à la fin du fichier :
<VirtualHost *:80>
ServerName yii2-frontend.test
DocumentRoot "C:/xampp/htdocs/yii2-advanced/frontend/web"
<Directory "C:/xampp/htdocs/yii2-advanced/frontend/web">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
# Configuration de routage pour Yii2 (URL Rewrite)
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php
</Directory>
</VirtualHost>
<VirtualHost *:80>
ServerName yii2-backend.test
DocumentRoot "C:/xampp/htdocs/yii2-advanced/backend/web"
<Directory "C:/xampp/htdocs/yii2-advanced/backend/web">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
# Même configuration de routage pour le backend
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php
</Directory>
</VirtualHost>- Modifiez le Fichier Hosts : Ouvrez le fichier
C:\Windows\System32\drivers\etc\hostsen tant qu’Administrateur (utilisez le Bloc-notes « Exécuter en tant qu’administrateur »). Ajoutez ces deux lignes à la fin du fichier :
127.0.0.1 yii2-frontend.test
127.0.0.1 yii2-backend.test- Redémarrez Apache via le panneau de contrôle XAMPP.
Accès et Test de l’Application Yii2
Après avoir terminé toutes les étapes ci-dessus, vous êtes prêt à accéder et à tester votre installation du Template Avancé Yii2.
- Accédez au Frontend : Ouvrez votre navigateur et visitez http://yii2-frontend.test. Vous verrez la page d’accueil de l’application.
- Accédez au Backend : Ouvrez http://yii2-backend.test. Vous serez dirigé vers la page de connexion du panneau d’administration.
Pour tester les fonctionnalités de gestion des utilisateurs, cliquez sur le lien « S’inscrire » sur la page du frontend. Remplissez le formulaire d’inscription avec un email, un nom d’utilisateur et un mot de passe. Après une inscription réussie, vous pouvez vous connecter immédiatement. Essayez également la fonctionnalité « Réinitialiser le mot de passe » pour vous assurer que son flux de travail fonctionne correctement.
Conclusion et Prochaines Étapes
En suivant ce guide, vous avez installé et configuré avec succès le Template Avancé Yii2 dans votre environnement de développement local. Ce template fournit une base très solide pour construire des applications web complexes, évolutives et sécurisées.
Les prochaines étapes logiques après l’installation sont d’apprendre le Contrôle d’Accès Basé sur les Rôles (RBAC) intégré à Yii2 pour une gestion plus détaillée des permissions utilisateur dans le backend, de configurer l’envoi d’emails pour les fonctionnalités de vérification, et de comprendre les structures de répertoires common, console, frontend et backend pour un développement optimal des fonctionnalités.

