call_user_func
(PHP 4, PHP 5, PHP 7, PHP 8)
call_user_func — 最初の引数で指定したコールバック関数をコールする
説明
パラメータ callback
で指定したユーザー定義のコールバック関数をコールします。
パラメータ
callback
-
コールする callable。
args
-
コールバック関数に渡す、ゼロ個以上のパラメータ。
注意:
call_user_func() のパラメータは 参照渡しではないことに注意しましょう。
例1 call_user_func() の例と参照
<?php
error_reporting(E_ALL);
function increment(&$var)
{
$var++;
}
$a = 0;
call_user_func('increment', $a);
echo $a."\n";
// このようにしてもかまいません
call_user_func_array('increment', array(&$a));
echo $a."\n";
// 関数名を変数として使ってもかまいません
$increment = 'increment';
$increment($a);
echo $a."\n";
?>上の例の出力は以下となります。
Warning: Parameter 1 to increment() expected to be a reference, value given in … 0 1 2
戻り値
コールバック関数の結果を返します。
例
例2 call_user_func() の例
<?php
function barber($type)
{
echo "$type ですね、わかりました。\n";
}
call_user_func('barber', "マッシュルームカット");
call_user_func('barber', "髭剃り");
?>
上の例の出力は以下となります。
マッシュルームカット ですね、わかりました。 髭剃り ですね、わかりました。
例3 名前空間を使用した call_user_func()
<?php
namespace Foobar;
class Foo {
static public function test() {
print "Hello world!\n";
}
}
call_user_func(__NAMESPACE__ .'\Foo::test');
call_user_func(array(__NAMESPACE__ .'\Foo', 'test'));
?>
上の例の出力は以下となります。
Hello world! Hello world!
例4 call_user_func() でのクラスメソッドの使用
<?php
class myclass {
static function say_hello()
{
echo "Hello!\n";
}
}
$classname = "myclass";
call_user_func(array($classname, 'say_hello'));
call_user_func($classname .'::say_hello');
$myobject = new myclass();
call_user_func(array($myobject, 'say_hello'));
?>
上の例の出力は以下となります。
Hello! Hello! Hello!
例5 call_user_func() でのラムダ関数の使用
<?php
call_user_func(function($arg) { print "[$arg]\n"; }, 'test');
?>
上の例の出力は以下となります。
[test]
注意
注意:
call_user_func() や call_user_func_array() で登録されたコールバックは、 前のコールバックからスローされた例外がキャッチされていない場合はコールされません。
参考
- call_user_func_array() - パラメータの配列を指定してコールバック関数をコールする
- is_callable() - 引数が、現在のスコープから関数としてコール可能な値かどうかを調べる
- Variable functions
- ReflectionFunction::invoke() - 関数を起動する
- ReflectionMethod::invoke() - 実行する
+add a note
User Contributed Notes 4 notes
gskluzacek dot nospam at gmail dot com ¶
14 years ago
if you simply want to dynamically call a method on an object it is not necessary to use call_user_function but instead you can do the following:
<?php
$method_name = "AMethodName";
$obj = new ClassName();
$obj->{$method_name}();
?>
I've used the above so I know it works.
Regards,
-- Greg
Knightnet ¶
17 years ago
You don't need to use this function to call a variable class function. Instead you can do the following:
$this->{$fnname}();
The example works in PHP 5 from within the class. It is the {} that do the trick.
Regards,
Julian.
Nitrogen ¶
15 years ago
A good use for call_user_func(); is for recursive functions.
If you're distributing code, you will often come across users who will rename functions and break the code..
Use this: call_user_func(__FUNCTION__, ... ); inside a function to call itself with whatever parameters you want.
<?php
// example, an extremely simplified factorial calculator..
// it's quite obvious when someone renames the function, it'll spit out an error because it wants to call itself.
function Factorial($i=1) {
return($i==1?1:$i*Factorial($i-1));
}
// you can give this function whatever name you want, it'll always work, of course if you initially call it using the name you gave it.
function qwertyuiop($i=1) {
return($i==1?1:$i*call_user_func(__FUNCTION__,$i-1));
}
?>
Just that I didn't see any reference to recursive functions when user_call_func(); really helps.
James at enfsolar dot com ¶
5 years ago
<?php
class MyClass{
public function hello($str)
{
echo 'hello ' . $str;
}
}
$obj = new MyClass();
[$obj, 'hello']('World'); // the array can be called as a function
↑ and ↓ to navigate •
Enter to select •
Esc to close
Press Enter without
selection to search using Google