is_callable() 函数验证变量的内容能否作为函数调用。 这可以检查包含有效函数名的变量,或者一个数组,包含了正确编码的对象以及函数名。
PHP 版本要求:PHP 4 >= 4.0.6, PHP 5, PHP 7
一、函数解析
is_callable()
定义:
(PHP 4 >= 4.0.6, PHP 5, PHP 7)
is_callable — 检测参数是否为合法的可调用结构
bool is_callable ( callable $name [, bool $syntax_only = false [, string &$callable_name ]] )
验证变量的内容能否作为函数调用。 这可以检查包含有效函数名的变量,或者一个数组,包含了正确编码的对象以及函数名。
参数:
name
要检查的回调函数。
syntax_only
如果设置为 TRUE,这个函数仅仅验证 name 可能是函数或方法。 它仅仅拒绝非字符,或者未包含能用于回调函数的有效结构。有效的应该包含两个元素,第一个是一个对象或者字符,第二个元素是个字符。
callable_name
接受“可调用的名称”。下面的例子是“someClass::someMethod”。 注意,尽管 someClass::SomeMethod() 的含义是可调用的静态方法,但例子的情况并不是这样的。
返回值:
如果 name
可调用则返回 TRUE
,否则返回 FALSE
。
二、函数测试
测试一:
echo '<pre >'; $func = function ($a) { echo $a; }; $re = is_callable($func, true, $callable_name1); echo '<hr />'; $re1 = is_callable($func, false, $callable_name2); //结果 bool(true) string(17) "Closure::__invoke" ------------------------------------- bool(true) string(17) "Closure::__invoke"
测试结果:
对于匿名函数,传入函数变量后,参数二syntax_only true 和 false,打印结果是一样的。
测试二:
function c_b($d) { echo $d; } $re = is_callable('c_b', false, $callable_name1); $re1 = is_callable('c_b', true, $callable_name2); var_dump($re); echo '<hr />'; var_dump($re1); echo '<hr />'; var_dump($callable_name1); echo '<hr />'; var_dump($callable_name2); //结果 bool(true) ---------------- bool(true) ---------------- string(3) "c_b" ---------------- string(3) "c_b"
测试结果:
对于一般函数,传入函数名称后,参数二syntax_only true 和 false,打印结果是一样的。
测试三:
class Person { public static function get($a) { echo $a; } protected function _set() { echo 1; } } $p = new Person(); $re = is_callable([$p, 'get'], false, $callable_name1); $re1 = is_callable([$p, 'get'], true, $callable_name2); var_dump($re); echo '<hr />'; var_dump($re1); echo '<hr />'; var_dump($callable_name1); echo '<hr />'; var_dump($callable_name2); //结果 bool(true) ----------------- bool(true) ----------------- string(11) "Person::get" --------------------------- string(11) "Person::get"
测试结果:
对于类的方法,参数以数组结构(类对象或类名称 + 方法名称),参数二syntax_only true 和 false,打印结果也是一样的。
测试四:
$a = 'i am string'; $re = is_callable($a, false, $callable_name1); $re1 = is_callable($a, true, $callable_name2); var_dump($re); echo '<hr />'; var_dump($re1); echo '<hr />'; var_dump($callable_name1); echo '<hr />'; var_dump($callable_name2); //结果 bool(false) ---------------- bool(true) ---------------- string(11) "i am string" ------------------------- string(11) "i am string"
测试结果:
对于传入的验证name,如果syntax_only 设置为true,它验证传入name是否是字符串,是否含有非法字符,如果不含有,则返回true,它并不会验证name是否为合法调用结构。
测试五:
$re = is_callable(['Class', 'Method'], false, $callable_name1); $re1 = is_callable(['Class', 'Method'], true, $callable_name2); var_dump($re); echo '<hr />'; var_dump($re1); echo '<hr />'; var_dump($callable_name1); echo '<hr />'; var_dump($callable_name2); //结果 bool(false) -------------- bool(true) -------------- string(13) "Class::Method" ----------------------------- string(13) "Class::Method"
测试结果:
对于传入的验证name,如果syntax_only 设置为true,它只验证传入name是否是字符串,是否含有非法字符或是否为数组参数字符串1 + 字符串二,如果符合条件,则返回true,它并不会验证name是否为合法调用结构。否者返回false;
测试六:
class Person { public static function get($a) { echo $a; } protected function _set() { echo 1; } } $p = new Person(); $re = is_callable([$p, '_set'], false); var_dump($re); echo '<hr />'; $re1 = method_exists($p, '_set'); var_dump($re1); //结果 bool(false) ------------ bool(true)
测试结果:
对于函数is_callable() 来说,如果验证的类方法,访问修饰符为protected或private 则返回false。
对于method_exists() 来说,则不受访问修饰符的影响,只要类方法存在,则返回true。
三、总结
1、is_callable() 函数,可传入的name类型有:函数字符串,匿名函数变量,类或类对象和方法名称组成的数组。其函数第二参数,如果是true,则只验证name是否是字符串或则是类或字符串1(类对象)和字符串二(方法名称)组成的数组。而不验证name是否为合法调用结构。如果是false,则验证name是否为合法调用结构。
2、method_exists() 函数,不受访问修饰符的影响,只要类方法存在,则返回true。函数is_callable()来说,如果验证的类方法,访问修饰符为protected或private 则返回false。