(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

is_aComprueba si un objeto es de una clase o tiene esta clase como una de sus madres


is_a(mixed $object, string $class_name, bool $allow_string = false): bool

Comprueba si el objeto dado por object es de esta clase o tiene esta clase como una de sus madres.



Un nombre de clase o una instancia de objeto.


El nombre de la clase


Si este parámetro se establece a false, no se permite una cadena de nombre de la clase como object. Esto también evita 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 madres, 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 está 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.


Ejemplo #1 Ejemplo de is_a()

// definir una clase
class FábricaTrastos
$oink = 'moo';

// crear un nuevo objeto
$WF = new FábricaTrastos();

if (
is_a($WF, 'FábricaTrastos')) {
"Sí, \$WF es todavía un FábricaTrastos\n";

Ejemplo #2 Usar el operador instanceof en PHP 5

if ($WF instanceof FábricaTrastos) {
'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() - Comprueba si el objeto tiene esta clase como uno de sus padres o si la implementa

add a note add a note

User Contributed Notes 7 notes

Ronald Locke
6 years ago
Please note that you have to fully qualify the class name in the second parameter.

A use statement will not resolve namespace dependencies in that is_a() function.

namespace foo\bar;

A {};
B extends A {};

namespace har\var;

$foo = new foo\bar\B();

is_a($foo, 'A'); // returns false;
is_a($foo, 'foo\bar\A'); // returns true;

Just adding that note here because all examples are without namespaces.
Aron Budinszky
11 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:

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 years ago
At least in PHP 5.1.6 this works as well with Interfaces.

interface test {
  public function

TestImplementor implements test {
  public function
A () {

$testImpl = new TestImplementor();


will return true
cesoid at yahoo dot com
17 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.
5 years ago
Looks like the function signature given in description is wrong. Actually it can take a string  as a first parameter in the case if $allow_string is set to true.

It took some time to find out how the last parameter should be used. Please consider the following example


class Foo{}

printf('autoload has been triggered for %s%s', $classname, PHP_EOL);

var_dump(is_a('UndefinedClassName', Foo::class, true));

eitan at mosenkis dot net
11 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.
portugal {at} jawira {dot} com
7 years ago
I just want to point out that you can replace "is_a()" function with the "instanceof" operator, BUT you must use a variable to pass the class name string.

This will work:
= new \stdClass();
$class_name = '\stdClass';

var_dump(is_a($object, $class_name));     // bool(true)
var_dump(is_a($object, '\stdClass'));     // bool(true)
var_dump($object instanceof $class_name); // bool(true)

While this don't:
= new \stdClass();
var_dump($object instanceof '\stdClass'); // Parse error: syntax error, unexpected ''\stdClass'' (T_CONSTANT_ENCAPSED_STRING)
To Top