Réflexion et introspection en PHP : écrire du code qui se voit lui-même

Réflexion et introspection en PHP : quand le code se regarde lui-même

Imaginez que vous écrivez un programme capable non seulement d'exécuter des actions, mais aussi de s'analyser lui-même. Cela ressemble à de la science-fiction ? Et pourtant non — en PHP, cela s'appelle réflexion et introspection. Ces mécanismes permettent à votre code de "connaître" sa propre structure : quelles classes sont chargées, quelles méthodes possède un objet, quels arguments une fonction accepte.

Si vous vous êtes déjà demandé comment fonctionnent les frameworks PHP populaires (Laravel, Symfony) ou les systèmes d'autochargement — la réponse se trouve ici. Aujourd'hui, nous allons décortiquer la réflexion en PHP avec des exemples concrets, afin que vous puissiez l'utiliser dans vos projets. C'est parti !

Qu'est-ce que la réflexion et l'introspection en PHP ?

Mettons tout de suite les points sur les i. En PHP, ces deux termes sont souvent utilisés comme synonymes, mais il existe une nuance subtile entre eux :

\n
• Introspection — c'est la capacité d'un objet à "regarder à l'intérieur de lui-même" : connaître le nom de la classe, la liste des méthodes, les propriétés. Exemple : get_class($obj) ou method_exists($obj, 'method').
\n
• Réflexion — un mécanisme plus puissant qui permet non seulement de regarder, mais aussi de modifier le comportement du code pendant l'exécution : créer des objets sans new, appeler des méthodes privées, obtenir des annotations à partir des blocs doc.
\n

Pour simplifier : l'introspection en PHP c'est "regarder", et la réflexion c'est "regarder et toucher". Pour la réflexion en PHP, il existe un ensemble spécial de classes — l'API de réflexion.

Pourquoi en avez-vous besoin ? Trois scénarios concrets

Avant de plonger dans le code, répondons à la question : "Est-ce que cela me servira un jour ?". Spoiler : oui, si vous :

\n
• Écrivez votre propre ORM ou validateur de formulaires ;
\n
• Souhaitez documenter automatiquement une API ;
\n
• Construisez un système de plugins ou de middleware ;
\n
• Travaillez avec des conteneurs DI (Dependency Injection).
\n

Sans la réflexion PHP, des frameworks comme Symfony ou Laravel ne pourraient tout simplement pas injecter automatiquement les dépendances dans les constructeurs. Mais procédons dans l'ordre.

Outils simples d'introspection : sans l'API de réflexion

Commençons par le plus basique. PHP fournit plusieurs fonctions intégrées pour l'introspection. Elles ne nécessitent pas de charger des classes et fonctionnent instantanément.

Déterminer le type et la classe

<?php\nclass User {\n    public $name;\n    private $email;\n}\n\n$user = new User();\n\n// Introspection : connaître la classe de l'objet\necho get_class($user); // User\n\n// Vérifier l'existence d'une propriété\nvar_dump(property_exists($user, 'email')); // true\n\n// Vérifier l'existence d'une méthode\nvar_dump(method_exists($user, 'getName')); // false\n?>

Ces fonctions sont vos premiers assistants. Mais que faire si vous avez besoin de connaître le modificateur d'accès d'une propriété (public, private, protected) ? Là, la simple introspection montre ses limites — c'est là qu'intervient ReflectionClass.

L'API de réflexion : toute la puissance de la réflexion en PHP

L'API de réflexion en PHP est un ensemble de classes (ReflectionClass, ReflectionMethod, ReflectionProperty, ReflectionParameter et autres) qui permettent de travailler avec le code comme avec des données. Analysons les plus utiles.

ReflectionClass : anatomie d'une classe

Avec ReflectionClass, vous pouvez apprendre littéralement tout sur une classe :

<?php\nclass Product {\n    public $title;\n    protected $price;\n    private $secret;\n\n    public function __construct($title, $price) {\n        $this->title = $title;\n        $this->price = $price;\n    }\n\n    public function getPrice() {\n        return $this->price;\n    }\n}\n\n$reflection = new ReflectionClass('Product');\n\n// Nom de la classe\necho