Submit a Pull Request Report a Bug

    is_a

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

    is_a — Sprawdza czy obiekt jest instancją tej klasy lub ma tę klasę jako jednego z rodziców

    Opis

    is_a ( mixed $obiekt , string $nazwa_klasy [, bool $dopusc_string = FALSE ] ) : bool

    Sprawdza czy podany obiekt jest instancją danej klasy lub ma tę klasę jako jedną z klas nadrzędnych.

    Parametry

    obiekt

    Nazwa klasy lub instancja obiektu

    nazwa_klasy

    Nazwa klasy

    dopusc_string

    Jeżeli ten parametr ustawiono na FALSE, to łańcuch z nazwą klasy jako obiekt nie jest dozwolony. Zapobiega to też przed wywołaniem autoloadera, jeżeli klasa nie istnieje.

    Zwracane wartości

    Zwraca TRUE jeżeli obiekt jest tej klasy lub ma tę klasę jako jednego jej rodziców, a FALSE w przeciwnym wypadku.

    Rejestr zmian

    Wersja Opis
    5.3.9 Dodano parametr dopusc_string
    5.3.0 Ta funkcja nie jest dłużej zdeprecjonowana, a więc nie generuje więcej błędu E_STRICT.
    5.0.0 Ta funkcja została uznana za zdeprecjonowaną na rzecz operatora instanceof. Wywołanie tej funkcji spowoduje wygenerowanie błędu E_STRICT.

    Przykłady

    Przykład #1 Przykład użycia is_a()

    <?php
    // zdefiniuj klasę
    class WidgetFactory
    {
      var     $oink = 'moo';
    }

    // stwórz nowy obiekt
    $WF = new WidgetFactory();

    if (    is_a($WF, 'WidgetFactory')) {
      echo     "Tak, \$WF jest obiektem WidgetFactory\n";
    }
    ?>

    Przykład #2 Użycie operatora instanceof w PHP 5

    <?php
    if ($WF instanceof WidgetFactory) {
        echo     'Tak, $WF jest obiektem WidgetFactory';
    }
    ?>

    Zobacz też:

    add a note add a note

    User Contributed Notes 7 notes

    up
    44
    Ronald Locke
    7 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.

    <?php
    namespace foo\bar;

    class     A {};
    class     B extends A {};
    ?>

    <?php
    namespace har\var;

    use     foo\bar\A;
    $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.
    up
    33
    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:
    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
    13
    p dot scheit at zweipol dot net
    17 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
    7
    cesoid at yahoo dot com
    18 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
    1
    dkrupyanskiy[at]gmail
    6 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

    <?php

    class Foo{}

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

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

    ?>
    up
    0
    eitan at mosenkis dot net
    12 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.
    up
    -20
    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:
    <?php
    $object     = 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:
    <?php
    $object     = new \stdClass();
    var_dump($object instanceof '\stdClass'); // Parse error: syntax error, unexpected ''\stdClass'' (T_CONSTANT_ENCAPSED_STRING)
    ?>
    add a note add a note
    To Top