自 PHP 5.4 起可用 callable 类型指定回调类型 callback。本文档基于同样理由使用 callback 类型信息。
一些函数如 call_user_func() 或 usort() 可以接受用户自定义的回调函数作为参数。回调函数不止可以是简单函数,还可以是对象的方法,包括静态类方法。
传递
一个 PHP 的函数以 string 类型传递其名称。可以使用任何内置或用户自定义函数,但除了语言结构例如: array() , echo ,empty() , eval() , exit() , isset() , list() , print 或 unset() 。
一个已实例化的对象的方法被作为数组传递,下标 0 包含该对象,下标 1 包含方法名。
静态类方法也可不经实例化该类的对象而传递,只要在下标 0 中包含类名而不是对象。自 PHP 5.2.3 起,也可以传递 ‘ClassName::methodName’。
除了普通的用户自定义函数外, create_function() 可以用来创建一个匿名回调函数。自 PHP 5.3.0 起也可传递 closure 给回调参数。
<?php
// An example callback function
function my_callback_function () {
echo 'hello world!' ;
}
// An example callback method
class MyClass {
static function myCallbackMethod () {
echo 'Hello World!' ;
}
}
// Type 1: Simple callback
call_user_func ( 'my_callback_function' );
// Type 2: Static class method call
call_user_func (array( 'MyClass' , 'myCallbackMethod' ));
// Type 3: Object method call
$obj = new MyClass ();
call_user_func (array( $obj , 'myCallbackMethod' ));
// Type 4: Static class method call (As of PHP 5.2.3)
call_user_func ( 'MyClass::myCallbackMethod' );
// Type 5: Relative static class method call (As of PHP 5.3.0)
class A {
public static function who () {
echo "A\n" ;
}
}
class B extends A {
public static function who () {
echo "B\n" ;
}
}
call_user_func (array( 'B' , 'parent::who' )); // A
?>
例2
<?php
// Our closure
$double = function( $a ) {
return $a * 2 ;
};
// This is our range of numbers
$numbers = range ( 1 , 5 );
// Use the closure as a callback here to
// double the size of each element in our
// range
$new_numbers = array_map ( $double , $numbers );
print implode ( ' ' , $new_numbers );
?>
以上例程会输出:
2 4 6 8 10
Note: 在 PHP 4 中,需要使用一个引用来创建一个指向具体对象的回调函数,而不是一个拷贝。参见引用的解释。
Note:
在函数中注册有多个回调内容时(如使用 call_user_func() 与 call_user_func_array() ),如在前一个回调中有未捕获的异常,其后的将不再被调用