匿名函数

匿名函数(Anonymous functions),也叫闭包函数(closures),允许 临时创建一个没有指定名称的函数。最经常用作回调函数 callable参数的值。当然,也有其它应用的情况。

匿名函数目前是通过 Closure 类来实现的。

示例 #1 匿名函数示例

<?php
echo preg_replace_callback('~-([a-z])~', function ($match) {
    return 
strtoupper($match[1]);
}, 
'hello-world');
// 输出 helloWorld
?>

闭包函数也可以作为变量的值来使用。PHP 会自动把此种表达式转换成内置类 Closure 的对象实例。把一个 closure 对象赋值给一个变量的方式与普通变量赋值的语法是一样的,最后也要加上分号:

示例 #2 匿名函数变量赋值示例

<?php
$greet 
= function($name)
{
    
printf("Hello %s\r\n"$name);
};

$greet('World');
$greet('PHP');
?>

闭包可以从父作用域中继承变量。 任何此类变量都应该用 use 语言结构传递进去。 PHP 7.1 起,不能传入此类变量: superglobals$this 或者和参数重名。 返回类型声明必须放在 use 子句的 后面

示例 #3 从父作用域继承变量

<?php
$message 
'hello';

// 没有 "use"
$example = function () {
    
var_dump($message);
};
$example();

// 继承 $message
$example = function () use ($message) {
    
var_dump($message);
};
$example();

// 当函数被定义而不是被调用的时候继承变量的值
$message 'world';
$example();

// 重置 message
$message 'hello';

// 通过引用继承
$example = function () use (&$message) {
    
var_dump($message);
};
$example();

// 父级作用域改变的值反映在函数调用中
$message 'world';
$example();

// 闭包函数也可以接受常规参数
$example = function ($arg) use ($message) {
    
var_dump($arg ' ' $message);
};
$example("hello");

// 返回类型在 use 子句的后面
$example = function () use ($message): string {
    return 
"hello $message";
};
var_dump($example());
?>

以上例程的输出类似于:

Notice: Undefined variable: message in /example.php on line 6
NULL
string(5) "hello"
string(5) "hello"
string(5) "hello"
string(5) "world"
string(11) "hello world"
string(11) "hello world"

从 PHP 8.0.0 开始,作用域继承的变量列表可能包含一个尾部的逗号,这个逗号将被忽略。

这些变量都必须在函数或类的头部声明。 从父作用域中继承变量与使用全局变量是不同的。全局变量存在于一个全局的范围,无论当前在执行的是哪个函数。而 闭包的父作用域是定义该闭包的函数(不一定是调用它的函数)。示例如下:

示例 #4 Closures 和作用域

<?php
// 一个基本的购物车,包括一些已经添加的商品和每种商品的数量。
// 其中有一个方法用来计算购物车中所有商品的总价格,该方法使
// 用了一个 closure 作为回调函数。
class Cart
{
    const 
PRICE_BUTTER  1.00;
    const 
PRICE_MILK    3.00;
    const 
PRICE_EGGS    6.95;

    protected 
$products = array();

    public function 
add($product$quantity)
    {
        
$this->products[$product] = $quantity;
    }

    public function 
getQuantity($product)
    {
        return isset(
$this->products[$product]) ? $this->products[$product] :
               
FALSE;
    }

    public function 
getTotal($tax)
    {
        
$total 0.00;

        
$callback =
            function (
$quantity$product) use ($tax, &$total)
            {
                
$pricePerItem constant(__CLASS__ "::PRICE_" .
                    
strtoupper($product));
                
$total += ($pricePerItem $quantity) * ($tax 1.0);
            };

        
array_walk($this->products$callback);
        return 
round($total2);
    }
}

$my_cart = new Cart;

// 往购物车里添加条目
$my_cart->add('butter'1);
$my_cart->add('milk'3);
$my_cart->add('eggs'6);

// 打出出总价格,其中有 5% 的销售税.
print $my_cart->getTotal(0.05) . "\n";
// 最后结果是 54.29
?>

示例 #5 自动绑定 $this

<?php

class Test
{
    public function 
testing()
    {
        return function() {
            
var_dump($this);
        };
    }
}

$object = new Test;
$function $object->testing();
$function();

?>

以上例程会输出:

object(Test)#1 (0) {
}

当在类的上下文中声明时,当前的类会自动与之绑定,使得 $this 在函数的作用域中可用。如果不需要当前类的自动绑定,可以使用 静态匿名函数 替代。

静态匿名函数

匿名函数允许被定义为静态化。这样可以防止当前类自动绑定到它们身上,对象在运行时也可能不会被绑定到它们上面。

示例 #6 试图在静态匿名函数中使用 $this

<?php

class Foo
{
    function 
__construct()
    {
        
$func = static function() {
            
var_dump($this);
        };
        
$func();
    }
};
new 
Foo();

?>

以上例程会输出:

Notice: Undefined variable: this in %s on line %d
NULL

示例 #7 试图将对象绑定到静态匿名函数

<?php

$func 
= static function() {
    
// function body
};
$func $func->bindTo(new StdClass);
$func();

?>

以上例程会输出:

Warning: Cannot bind an instance to a static closure in %s on line %d

更新日志

版本 说明
7.1.0 匿名函数不能用 use 包含 superglobals$this 、 跟参数同名的变量。

注释

注意: 可以在闭包中使用 func_num_args()func_get_arg()func_get_args()