downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

is_subclass_of> <interface_exists
[edit] Last updated: Fri, 17 May 2013

view this page in

is_a

(PHP 4 >= 4.2.0, PHP 5)

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

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 una de sus madres.

Parámetros

object

El objeto evaluado

class_name

El nombre de la clase

allow_string

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.

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



is_subclass_of> <interface_exists
[edit] Last updated: Fri, 17 May 2013
 
add a note add a note User Contributed Notes is_a - [7 notes]
up
1
p dot scheit at zweipol dot net
6 years ago
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
up
0
eitan at mosenkis dot net
1 year 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.
up
0
cesoid at yahoo dot com
7 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.
up
0
Aron Budinszky
1 year 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:
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...
up
-1
martin dunisch
7 years ago
Workaround for older PHP-Versions:

function is_a($anObject, $aClass) {
   return get_class($anObject) == strtolower($aClass)
     or is_subclass_of($anObject, $aClass);
}
up
-1
dead dot screamer at seznam dot cz
7 years ago
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;
?>
up
-2
zabmilenko at hotmail dot com
7 years ago
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 :-)

 
show source | credits | stats | sitemap | contact | advertising | mirror sites