La PSR-4 est une spécification technique pour l'autochargement de classes en PHP. L'autochargement est le processus de chargement automatique des fichiers de classe PHP lorsqu'ils sont utilisés dans un script, sans avoir à utiliser manuellement require ou include.
Pourquoi l'autochargement est-il nécessaire ?
Dans un projet PHP structuré, les classes sont généralement organisées dans de nombreux fichiers. Sans autochargement, vous devriez inclure manuellement chaque fichier de classe nécessaire au début de votre script. Cela devient rapidement fastidieux et source d'erreurs. L'autochargement automatise ce processus, améliorant ainsi l'organisation du code et la productivité du développeur.
La PSR-4 établit une convention pour la façon dont les noms de classes doivent correspondre aux chemins de fichiers. Elle stipule que :
- Un espace de noms (namespace) de premier niveau correspond à un répertoire de base.
- Les sous-espaces de noms correspondent à des sous-répertoires.
- Le nom de la classe correspond au nom du fichier (avec l'extension .php).
Règles principales de la PSR-4
- Espace de noms de premier niveau : Chaque espace de noms doit avoir un espace de noms de premier niveau (ou un nom de fournisseur). Par exemple, MonProjet, Symfony, ou Doctrine.
- Répertoire de base : Un espace de noms de premier niveau correspond à un répertoire dans le système de fichiers.
- Sous-répertoires : Les sous-espaces de noms correspondent à des sous-répertoires dans le répertoire de base. Par exemple, l'espace de noms MonProjet\Utils correspondrait au sous-répertoire Utils dans le répertoire de base de MonProjet.
- Nom de fichier : Le nom de la classe doit correspondre au nom du fichier PHP. Par exemple, la classe MaClasse dans l'espace de noms MonProjet\Utils doit se trouver dans le fichier MaClasse.php.
- Chemin complet : Le chemin complet du fichier doit être composé du répertoire de base, des sous-répertoires de l'espace de noms et du nom du fichier de la classe.
Exemple de structure de répertoires et de correspondance avec la PSR-4
Supposons que vous ayez un projet avec la structure suivante :
monprojet/
├── src/
│ ├── Utils/
│ │ ├── MaClasse.php
│ │ └── AutreClasse.php
│ └── Modeles/
│ └── User.php
└── public/
└── index.php
Voici comment les classes et les fichiers correspondraient selon la PSR-4 :
- MonProjet\Utils\MaClasse se trouve dans monprojet/src/Utils/MaClasse.php
- MonProjet\Utils\AutreClasse se trouve dans monprojet/src/Utils/AutreClasse.php
- MonProjet\Modeles\User se trouve dans monprojet/src/Modeles/User.php
Pour que l'autochargement fonctionne, vous devez configurer un autoloader dans votre projet. Composer, le gestionnaire de dépendances de PHP, fournit un autoloader PSR-4 que vous pouvez facilement utiliser.
Dans le fichier composer.json de votre projet, ajoutez la configuration de l'autochargement PSR-4 :
{
"autoload": {
"psr-4": {
"MonProjet\\": "src/"
}
}
}
Installation des dépendances : Exécutez la commande composer install pour installer les dépendances et générer l'autoloader.
Dans votre fichier d'entrée (par exemple, public/index.php), incluez l'autoloader de Composer :
<?php
require __DIR__ . '/../vendor/autoload.php';
// Vous pouvez maintenant utiliser les classes sans les inclure manuellement
$maClasse = new MonProjet\Utils\MaClasse();
$user = new MonProjet\Modeles\User();
?>