PHP 5.4.31 Released

is_a

(PHP 4 >= 4.2.0, PHP 5)

is_aVérifie si l'objet est une instance d'une classe donnée ou a cette classe parmi ses parents

Description

bool is_a ( object $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.

Liste de paramètres

object

L'objet testé

class_name

Le 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.

Valeurs de retour

Retourne TRUE si l'objet est une instance de cette classe ou a cette classe comme parent, FALSE sinon.

Historique

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.

Exemples

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';
}
?>

Voir aussi

add a note add a note

User Contributed Notes 4 notes

up
6
Aron Budinszky
2 years ago
Be careful! Starting in PHP 5.3.7 the behavior of is_a() has changed slightly: when calling is_a() with a first argument that is not an object, __autoload() is triggered!

In practice, this means that calling is_a('23', 'User'); will trigger __autoload() on "23". Previously, the above statement simply returned 'false'.

More info can be found here:
https://bugs.php.net/bug.php?id=55475

Whether this change is considered a bug and whether it will be reverted or kept in future versions is yet to be determined, but nevertheless it is how it is, for now...
up
1
p dot scheit at zweipol dot net
7 years ago
At least in PHP 5.1.6 this works as well with Interfaces.

<?php
interface test {
  public function
A();
}

class
TestImplementor implements test {
  public function
A () {
    print
"A";
  }
}

$testImpl = new TestImplementor();

var_dump(is_a($testImpl,'test'));
?>

will return true
up
1
cesoid at yahoo dot com
8 years ago
is_a returns TRUE for instances of children of the class.

For example:

class Animal
{}

class Dog extends Animal
{}

$test = new Dog();

In this example is_a($test, "Animal") would evaluate to TRUE as well as is_a($test, "Dog").

This seemed intuitive to me, but did not seem to be documented.
up
0
eitan at mosenkis dot net
2 years ago
As of PHP 5.3.9, is_a() seems to return false when passed a string for the first argument. Instead, use is_subclass_of() and, if necessary for your purposes, also check if the two arguments are equal, since is_subclass_of('foo', 'foo') will return false, while is_a('foo', 'foo') used to return true.
To Top