Auto-chargement de classes

De nombreux développeurs qui écrivent des applications orientées objet créent un fichier source par définition de classe. Un des plus gros inconvénients de cette méthode est d'avoir à écrire une longue liste d'inclusions de fichier de classes au début de chaque script : une inclusion par classe.

La fonction spl_autoload_register() enregistre un nombre quelconque de chargeurs automatiques, ce qui permet aux classes et aux interfaces d'être automatiquement chargées si elles ne sont pas définies actuellement. En enregistrant des autochargeurs, PHP a une dernière chance de charger la classe ou l'interface avant d'échouer avec une erreur.

Toute construction similaire à une classe peut être autochargée de la même manière. Cela inclut les classes, interfaces, traits et énumérations.

Attention

Avant PHP 8.0.0, il était possible d'utiliser __autoload() pour autocharger les classes et interfaces. Cependant, c'est une alternative moins flexible à spl_autoload_register() et __autoload() est obsolète à partir de PHP 7.2.0, et supprimée à partir de PHP 8.0.0.

Note:
spl_autoload_register() peut être appelée plusieurs fois pour enregistrer plusieurs autochargeurs. Lancer une exception depuis une fonction d'autochargement interrompra ce processus et empêchera les fonctions d'autochargement suivantes de s'exécuter. Pour cette raison, lancer des exceptions depuis une fonction d'autochargement est fortement découragé.

Exemple #1 Exemple d'autochargement

Cet exemple tente de charger les classes MaClasse1 et MaClasse2, respectivement depuis les fichiers MaClasse1.php et MaClasse2.php.

<?php
spl_autoload_register(function ($class_name) {
    include $class_name . '.php';
});

$obj  = new MaClasse1();
$obj2 = new MaClasse2();
?>

Exemple #2 Autre exemple d'autochargement

Cet exemple tente de charger l'interface ITest.

<?php

spl_autoload_register(function ($name) {
    var_dump($name);
});

class Foo implements ITest {
}

/*
string(5) "ITest"

Fatal error: Interface 'ITest' not found in ...
*/
?>

Exemple #3 Utilisation de l'autoloader de Composer

» Composer génère un fichier vendor/autoload.php configuré pour charger automatiquement les packages gérés par Composer. En incluant ce fichier, ces packages peuvent être utilisés sans travail supplémentaire.

<?php
require __DIR__ . '/vendor/autoload.php';

$uuid = Ramsey\Uuid\Uuid::uuid7();

echo "Nouvel UUID généré -> ", $uuid->toString(), "\n";
?>

Auto-chargement de classes

Voir aussi