Submit a Pull Request Report a Bug

    is_callable

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

    is_callable — 引数が、関数としてコール可能な構造であるかどうかを調べる

    説明

    is_callable(mixed $value, bool $syntax_only = false, string &$callable_name = null): bool

    引数の内容が、callable かどうかを調べます。

    パラメータ

    value

    チェックする値。

    syntax_only

    true の場合、この関数は単に value が関数またはメソッドであるかどうかだけを調べます。 文字列以外の型の変数や不正な形式の配列は、 引数として受け付けられません。有効な配列の形式は、 最初のエントリがオブジェクトあるいは文字列で、2 番目のエントリが文字列である 2 つのエントリからなるものです。

    callable_name

    "呼び出し名" を受け取ります。下の例では "someClass::someMethod" です。これは someClass::SomeMethod() が static メソッドであるかのようにみえますが、 そうではないことに注意しましょう。

    返り値

    value がコール可能な場合に true、 それ以外の場合に false を返します。

    例

    例1 is_callable() の例

    <?php
    //  変数が、関数としてコール可能かどうかを確かめます。

    //
    //  関数名を含む単純な配列
    //

    function someFunction() 
    {
    }

    $functionVariable = 'someFunction';

    var_dump(is_callable($functionVariable, false, $callable_name));  // bool(true)

    echo $callable_name, "\n";  // someFunction

    //
    //  メソッドを含む配列
    //

    class someClass {

      function     someMethod() 
      {
      }

    }

    $anObject = new someClass();

    $methodVariable = array($anObject, 'someMethod');

    var_dump(is_callable($methodVariable, true, $callable_name));  //  bool(true)

    echo $callable_name, "\n";  //  someClass::someMethod

    ?>

    例2 is_callable() とコンストラクタ

    is_callable() はコンストラクタを callable だとはみなしません。

    <?php

    class Foo
    {
        public function     __construct() {}
        public function     foo() {}
    }

    var_dump(
            is_callable(array('Foo', '__construct')),
            is_callable(array('Foo', 'foo'))
    );

    上の例の出力は以下となります。

    bool(false)
bool(false)

    参考

    • function_exists() - 指定した関数が定義されている場合に true を返す
    • method_exists() - クラスメソッドが存在するかどうかを確認する

    add a note add a note

    User Contributed Notes 5 notes

    up
    31
    izharaazmi at gmail dot com
    8 years ago
    If the target class has __call() magic function implemented, then is_callable will ALWAYS return TRUE for whatever method you call it.
    is_callable does not evaluate your internal logic inside __call() implementation (and this is for good).
    Therefore every method name is callable for such classes.

    Hence it is WRONG to say (as someone said):
    ...is_callable will correctly determine the existence of methods made with __call...

    Example:
    <?php
    class TestCallable
    {
        public function     testing()
        {
              return     "I am called.";
        }

        public function     __call($name, $args)
        {
            if(    $name == 'testingOther')
            {
                    return     call_user_func_array(array($this, 'testing'), $args);
            }
        }
    }

    $t = new TestCallable();
    echo     $t->testing();      // Output: I am called.
    echo $t->testingOther(); // Output: I am called.
    echo $t->working();      // Output: (null)

    echo is_callable(array($t, 'testing'));       // Output: TRUE
    echo is_callable(array($t, 'testingOther'));  // Output: TRUE
    echo is_callable(array($t, 'working'));       // Output: TRUE, expected: FALSE
    ?>
    up
    2
    rahadotaboulfethatgmail.com
    16 years ago
    is_callable generates an [E_STRICT] error if the  tested method cannot be called staticly. (and returns the good value)

    I used @is_called
    i'm using php 5.2.1
    up
    0
    jlh
    5 years ago
    The story about __call() is a bit more complicated unfortunately. It will always return true ONLY if you pass an instance of a class, not if you pass the class name itself:

    <?php
    class MyClass {
        public function     method() { }
        public function     __call($name, $arguments) { }
    }

    is_callable([MyClass::class, 'method']); // true
    is_callable([new MyClass(), 'method']); // true
    is_callable([MyClass::class, 'other']); // false!!!
    is_callable([new MyClass(), 'other'])); // true
    up
    0
    fgm at osinet dot fr
    12 years ago
    Note that, for the purpose of this function, an abstract method, although necessarily non-callable since it does not have a body, is still considered to be callable:

    <?php
    abstract class Foo {
      abstract function     bar();
    }

    echo     is_callable(array('Foo', 'bar'));
    // display: 1
    ?>
    up
    0
    Quis strrev TA omicidio strrev TOD com
    16 years ago
    is_callable() does _not_ check wheter this function is disabled by php.ini's disable_functions

    use:

    <?PHP
    function is_disabled($function) {
          $disabled_functions=explode(',',ini_get('disable_functions'));
      return     in_array($function, $disabled_functions);
    }
    ?>

    I`m running PHP 5.2.4
    add a note add a note
    To Top