(PHP 4 >= 4.2.0, PHP 5, PHP 7)
is_a — Vérifie si l'objet est une instance d'une classe donnée ou a cette classe parmi ses parents
$object
, string $class_name
[, bool $allow_string = FALSE
] )
Vérifie si l'objet object est une instance d'une classe donnée
ou a cette classe comme parent.
objectL'objet testé
class_nameLe nom de la classe
allow_string
Si ce paramètre vaut FALSE, le nom de la classe sous forme de chaîne de caractères
dans le paramètre object n'est pas autorisé. Ceci permet
d'éviter l'appel de l'autoloader si la classe n'existe pas.
Retourne TRUE si l'objet est une instance de cette classe ou a cette classe comme parent,
FALSE sinon.
| Version | Description |
|---|---|
| 5.3.9 |
Ajout du paramètre allow_string.
|
| 5.3.0 |
Cette fonction n'est plus obsolète, et ne lancera donc plus d'alerte
de type E_STRICT.
|
| 5.0.0 |
Cette fonction devient obsolète en faveur de l'opérateur
instanceof.
L'appel à cette fonction émettra une alerte de niveau
E_STRICT.
|
Exemple #1 Exemple avec is_a()
<?php
// Définit une classe
class WidgetFactory
{
var $oink = 'moo';
}
// Crée un nouvel objet
$WF = new WidgetFactory();
if (is_a($WF, 'WidgetFactory')) {
echo "oui, \$WF est toujours un objet WidgetFactory\n";
}
?>
Exemple #2 Utilisation de l'opérateur instanceof avec PHP 5
<?php
if ($WF instanceof WidgetFactory) {
echo 'Oui, $WF est un WidgetFactory';
}
?>