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

is_aVerifica se l'oggetto è di questa classe o ha questa classe come una dei suoi genitori


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

Verifica se il dato object è di questa classe o ha questa classe come una dei suoi genitori.

Elenco dei parametri


Un nome di classe o un'istanza di oggetto.


Il nome della classe


Se questo parametro è impostato a false, il nome della classe stringa come object non è permesso. Questo impedisce anche di chiamare l'autoloader se la classe non esiste.

Valori restituiti

Restituisce true se l'oggetto è di questa classe o ha questa classe come una dei suoi genitori, false in caso contrario.

Log delle modifiche

Versione Descrizione
5.3.9 Aggiunto il parametro allow_string
5.3.0 Questa funzione non è più deprecata, e quindi non genererà warning E_STRICT.
5.0.0 Questa funzione venne deprecata in favore dell'operatore instanceof. La chiamata a questa funzione risulterà in un warning E_STRICT.


Example #1 Esempio di is_a()

// definisce una classe
class WidgetFactory
$oink = 'moo';

// crea un nuovo oggetto
$WF = new WidgetFactory();

if (
is_a($WF, 'WidgetFactory')) {
"yes, \$WF is still a WidgetFactory\n";

Example #2 Uso dell'operatore instanceof in PHP 5

if ($WF instanceof WidgetFactory) {
'Yes, $WF is a WidgetFactory';

Vedere anche:

  • get_class() - Restituisce il nome della classe di un oggetto
  • get_parent_class() - Restituisce il nome della classe genitrice di un oggetto o di una classe
  • is_subclass_of() - Verifica se l'oggetto ha questa classe come una dei suoi genitori o 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
12 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
8 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