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 — Comprueba si un objeto es de una clase o tiene esta clase como uno de sus padres
Descripción
bool is_a
( object
$object
, string $class_name
[, bool $allow_string = FALSE
] )
Comprueba si el objeto dado por object es de esta clase o tiene
esta clase como uno de sus padres.
Parámetros
-
object -
El objeto evaluado
-
class_name -
El nombre de la clase
-
allow_string -
Si este parámetro se establece a false, la cadena del nombre de la clase como
objectno está permitida. Esto también previene de llamar al autocargador si la clase no existe.
Valores devueltos
Devuelve TRUE si el objeto es de esta clase o tiene esta clase como una de sus
padres, FALSE si no.
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.3.9 |
Se añadió el parámetro allow_string
|
| 5.3.0 |
Esta función ya no es obsoleta, y por lo tanto
ya no lanza advertencias de tipo E_STRICT.
|
| 5.0.0 |
Esta funcion se volvió obsoleta en favor del operador
instanceof.
Llamar a esta función resultará en una
advertencia de tipo E_STRICT.
|
Ejemplos
Ejemplo #1 Ejemplo de is_a()
<?php
// definir una clase
class FábricaTrastos
{
var $oink = 'moo';
}
// crear un nuevo objeto
$WF = new FábricaTrastos();
if (is_a($WF, 'FábricaTrastos')) {
echo "Sí, \$WF es todavía un FábricaTrastos\n";
}
?>
Ejemplo #2 Usar el operador instanceof en PHP 5
<?php
if ($WF instanceof FábricaTrastos) {
echo 'Sí, $WF es un FábricaTrastos';
}
?>
Ver también
- get_class() - Devuelve el nombre de la clase de un objeto
- get_parent_class() - Recupera el nombre de la clase padre de un objeto o clase
- is_subclass_of() - Verifica si el objeto tiene esta clase como uno de sus padres
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.