# Autochargement

> Mécanisme PHP qui charge automatiquement le fichier contenant une classe au moment où elle est utilisée, sans nécessiter d'instruction require manuelle.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/autochargement/

Écrire des dizaines de `require` en haut d'un fichier pour s'assurer que chaque classe utilisée est bien chargée : voilà exactement ce que l'autochargement évite, en laissant PHP retrouver lui-même le bon fichier au moment où une classe est réellement sollicitée.

## PSR-4 et Composer, le duo standard

Composer génère un autochargeur (`vendor/autoload.php`) conforme à la norme PSR-4, qui relie un espace de noms à une arborescence de dossiers. Un plugin WordPress orienté objet moderne déclare cette correspondance dans son fichier `composer.json`, plutôt que d'utiliser la fonction historique `spl_autoload_register` directement.

## Exemple

```
{
  "autoload": {
    "psr-4": {
      "MonPlugin\\": "src/"
    }
  }
}
```

Avec cette configuration, la classe `MonPlugin\Reservation\Panier` est automatiquement recherchée dans le fichier `src/Reservation/Panier.php`, sans qu'aucun `require` explicite ne soit nécessaire dans le code.

## Bon à savoir

- Après avoir ajouté une nouvelle classe conforme à PSR-4, il n'est généralement pas nécessaire de régénérer l'autochargeur ; Composer résout le chemin dynamiquement selon la convention de nommage.
- La fonction native `spl_autoload_register()` reste disponible pour écrire un autochargeur maison, utile pour un petit plugin sans dépendance à Composer.
- Un espace de noms mal aligné avec l'arborescence des dossiers déclarée dans `composer.json` provoque une erreur « Class not found » à l'exécution, souvent déroutante pour un développeur débutant.