interface_exists
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.
is_a
(PHP 4 >= 4.2.0, PHP 5)
is_a — Vérifie si l'objet fait parti d'une classe ou a cette classe comme parents
Description
bool is_a
( object
$object
, string $class_name
[, bool $allow_string = FALSE
] )
Vérifie si l'objet object fait
partie de cette classe 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ètreobjectn'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 fait parti de cette classe ou a cette classe comme parents,
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 lance 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
- get_class() - Retourne la classe d'un objet
- get_parent_class() - Retourne le nom de la classe parente d'un objet
- is_subclass_of() - Détermine si un objet est une sous-classe
add a note
User Contributed Notes
is_a
eitan at mosenkis dot net
12-Jan-2012 01:09
Aron Budinszky
07-Sep-2011 04:21
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...
p dot scheit at zweipol dot net
16-Jan-2007 01:44
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
martin dunisch
13-Feb-2006 12:02
Workaround for older PHP-Versions:
function is_a($anObject, $aClass) {
return get_class($anObject) == strtolower($aClass)
or is_subclass_of($anObject, $aClass);
}
dead dot screamer at seznam dot cz
06-Feb-2006 11:44
Why I test if class `A` inherit class `B` or implements interface `C` before I create class `A`?
<?
//That isn't work:
//1. function is_A()
if(is_A('A','B'))$a=new A;
if(is_A('A','C'))$a=new A;
//2. operator instanceOf
if(A instanceOf B)$a=new A;
if(A instanceOf C)$a=new A;
?>
zabmilenko at hotmail dot com
07-Oct-2005 05:18
Lazy Instantiation using is_a() and php5
<?php
class ObjectA
{
public function print_line($text)
{
print $text . "\n";
}
}
class ObjectB
{
public function ObjectA()
{
static $objecta;
if (!is_a($objecta, 'ObjectA'))
{
$objecta = new ObjectA;
}
return $objecta;
}
}
$obj = new ObjectB;
$obj->ObjectA()->print_line('testing, 1 2 3');
?>
In the above example, ObjectA is not instantiated until needed by ObjectB. Then ObjectB can continually use it's creation as needed without reinstantiating it.
There are other ways, but I like this one :-)
cesoid at yahoo dot com
05-Oct-2005 07:01
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.