Hàm ẩn danh và closure trong PHP: từ khóa use

Hàm ẩn danh (anonymous function), còn gọi là closure, là một hàm không có tên. Bạn viết function ($param) { ... } ở chỗ cần một giá trị: gán nó vào biến, truyền cho một hàm khác hoặc trả về nó. Hàm này có thể mang theo biến từ đoạn code xung quanh bằng use ($var).

<?php
$greet = function (string $name): string {
    return "Hello, $name";
};   // the semicolon ends the assignment

echo $greet('Ada'), "\n";

$greeting = 'Welcome';
$welcome = function (string $name) use ($greeting): string {
    return "$greeting, $name";
};
echo $welcome('Linus'), "\n";

var_dump($greet instanceof Closure);

Mọi hàm ẩn danh đều là đối tượng của lớp có sẵn Closure, vì vậy nó có thể được lưu lại, truyền đi khắp nơi và gọi sau bằng $greet(...).

Từ khóa use bắt biến theo giá trị

Tự bản thân closure không nhìn thấy các biến bên ngoài. use ($x) sao chép giá trị của $x vào closure vào lúc closure được tạo, không phải lúc nó chạy:

<?php
$discount = 10;

$apply = function (float $price) use ($discount): float {
    return $price - $discount;
};

$discount = 50;            // changed after the closure was created
echo $apply(100), "\n";    // still uses 10

// Several variables
$currency = 'EUR';
$rate = 1.08;
$convert = function (float $usd) use ($rate, $currency): string {
    return number_format($usd / $rate, 2) . " $currency";
};
echo $convert(54), "\n";

use theo tham chiếu: &$var

use (&$x) đưa cho closure chính biến đó thay vì một bản sao. Thay đổi bên trong closure được thấy ở bên ngoài, và thay đổi bên ngoài cũng được thấy ở bên trong. Đây là cách một callback cộng dồn vào tổng hoặc giữ một bộ đếm.

<?php
$total = 0;
$addToTotal = function (int $amount) use (&$total): void {
    $total += $amount;
};

$addToTotal(10);
$addToTotal(32);
echo $total, "\n";

// A counter that remembers its state between calls
function makeCounter(): Closure
{
    $count = 0;
    return function () use (&$count): int {
        return ++$count;
    };
}

$next = makeCounter();
echo $next(), $next(), $next(), "\n";

$other = makeCounter();     // its own $count
echo $other(), "\n";

Mỗi lần gọi makeCounter() tạo ra một $count mới, và closure được trả về giữ cho biến đó tiếp tục tồn tại sau khi hàm đã kết thúc. Đó chính là ý nghĩa của từ "closure": hàm "bao lấy" những biến mà nó cần.

Truyền closure làm callback

Các hàm như array_map(), array_filter(), usort() và array_walk() nhận một hàm làm đối số. Closure cho phép bạn viết hàm đó ngay tại chỗ, với bao nhiêu câu lệnh tùy công việc cần:

<?php
$products = [
    ['name' => 'Laptop', 'price' => 1200, 'stock' => 3],
    ['name' => 'Mouse', 'price' => 25, 'stock' => 0],
    ['name' => 'Monitor', 'price' => 300, 'stock' => 7],
];

$minPrice = 100;
$available = array_filter($products, function ($p) use ($minPrice) {
    return $p['stock'] > 0 && $p['price'] >= $minPrice;
});

usort($available, function ($a, $b) {
    return $b['price'] <=> $a['price'];   // most expensive first
});

$labels = array_map(function ($p) {
    $label = strtoupper($p['name']);
    return "$label ({$p['stock']} left)";
}, $available);

print_r($labels);

Khi thân hàm chỉ là một biểu thức, một arrow function như fn($p) => $p['price'] ngắn hơn và không cần use.

Callable: tên hàm, phương thức và strlen(...)

Một tham số có kiểu callable nhận nhiều thứ hơn closure. Một chuỗi chứa tên hàm, một mảng gồm đối tượng và tên phương thức, một mảng gồm tên lớp và tên phương thức tĩnh đều được tính. Từ PHP 8.1, cú pháp first-class callable strlen(...) biến bất kỳ thứ nào trong số đó thành Closure một cách trực tiếp.

<?php
class Formatter
{
    public function shout(string $s): string { return strtoupper($s) . '!'; }
    public static function whisper(string $s): string { return strtolower($s) . '...'; }
}

$words = ['Hello', 'World'];
$f = new Formatter();

print_r(array_map('strtoupper', $words));                   // function name
print_r(array_map([$f, 'shout'], $words));                  // object method
print_r(array_map([Formatter::class, 'whisper'], $words));  // static method

// PHP 8.1 first-class callable syntax
$len = strlen(...);
$shout = $f->shout(...);
$whisper = Formatter::whisper(...);
echo $len('closure'), ' ', $shout('hey'), ' ', $whisper('PSST'), "\n";

function apply(callable $fn, string $value): string
{
    return $fn($value);
}
echo apply('ucfirst', 'php'), "\n";
var_dump(is_callable('no_such_function'));

Dạng (...) được kiểm tra ngay khi dòng đó chạy: gõ nhầm sẽ ném ra Error ngay tại chỗ. Một chuỗi như 'strtoupr' chỉ là một chuỗi cho đến khi có ai đó thử gọi nó.

Closure bên trong lớp: $this và static

Một closure được tạo bên trong phương thức sẽ tự động được gắn $this, nên nó có thể dùng các thuộc tính của đối tượng. Hãy đánh dấu nó là static function khi không cần $this, việc này cũng giúp closure không giữ đối tượng tồn tại lâu hơn cần thiết.

<?php
class Cart
{
    private array $items = [];
    private float $taxRate = 0.2;

    public function add(string $name, float $price): void
    {
        $this->items[$name] = $price;
    }

    public function pricesWithTax(): array
    {
        // $this is available inside the closure
        return array_map(function (float $price): float {
            return round($price * (1 + $this->taxRate), 2);
        }, $this->items);
    }

    public function names(): array
    {
        return array_map(static function (string $name): string {
            return ucfirst($name);
        }, array_keys($this->items));
    }
}

$cart = new Cart();
$cart->add('book', 12.5);
$cart->add('pen', 1.99);
print_r($cart->pricesWithTax());
print_r($cart->names());

Quên use

Bug phổ biến nhất với closure là dùng một biến bên ngoài mà không liệt kê nó trong use. Bên trong closure, biến đó không tồn tại:

$minAge = 18;
$adults = array_filter($people, function ($p) {
    return $p['age'] >= $minAge;   // $minAge is not in use (...)
});

PHP prints: Warning: Undefined variable $minAge

$minAge là null bên trong closure, mọi độ tuổi so sánh >= null đều cho true, và mọi người đều lọt qua bộ lọc. Trên một máy chủ ẩn cảnh báo, chẳng có gì báo cho bạn biết. Hãy thêm biến đó vào use:

<?php
$people = [['name' => 'Ada', 'age' => 36], ['name' => 'Tom', 'age' => 12]];
$minAge = 18;

$adults = array_filter($people, function ($p) use ($minAge) {
    return $p['age'] >= $minAge;
});
print_r(array_column($adults, 'name'));

// Or an arrow function, which captures $minAge automatically
$adults2 = array_filter($people, fn($p) => $p['age'] >= $minAge);
print_r(array_column($adults2, 'name'));