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

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


bool is_a ( object $object , string $class_name [, bool $allow_string = FALSE ] )

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

Elenco dei parametri


L'oggetto da testare


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 6 notes

Aron Budinszky
6 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...
Ronald Locke
11 months 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.
p dot scheit at zweipol dot net
10 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
eitan at mosenkis dot net
5 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.
cesoid at yahoo dot com
11 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.
portugal {at} jawira {dot} com
2 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