トップページ　→関数リファレンス　→変数・データ型関連　→変数操作　→変数操作関数

関数・クラス解説

is_callable

version:PHP 4 >= 4.0.6, PHP 5, PHP 7 (公式)

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

公式リファレンス

書式

is_callable ( mixed $var [, bool $syntax_only = FALSE [, string &$callable_name ]] ) : bool

説明

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

パラメータ

var: チェックする値。
syntax_only: TRUE の場合、この関数は単に var が関数またはメソッドであるかどうかだけを調べます。文字列以外の型の変数や不正な形式の配列は、引数として受け付けられません。有効な配列の形式は、最初のエントリがオブジェクトあるいは文字列で、2 番目のエントリが文字列である 2 つのエントリからなるものです。
callable_name: "呼び出し名" を受け取ります。下の例では "someClass::someMethod" です。これは someClass::SomeMethod() が static メソッドであるかのようにみえますが、そうではないことに注意しましょう。

返値

var がコール可能な場合に TRUE、それ以外の場合に FALSE を返します。

サンプル

例1 is_callable() の例 

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

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

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() とコンストラクタ
  PHP 5.3.0 以降は、is_callable() はコンストラクタを callable だとはみなさなくなりました。 これは、PHP 5 以降の形式のコンストラクタ (__construct) であっても PHP 4 形式のコンストラクタ (クラスと同じ名前のメソッド) であっても同じです。 PHP 5.3.0 より前のバージョンでは、これらはいずれも callable だとみなされていました。 
 <?phpclass Foo{    public function __construct() {}    public function foo() {}}var_dump(    is_callable(array('Foo', '__construct')),    is_callable(array('Foo', 'foo'))); 上の例の出力は以下となります。 
bool(false)
bool(false)