الدوال المجهولة والمغلقة في PHP: الكلمة use

الدالة المجهولة، وتُسمى أيضًا الدالة المغلقة، دالة بلا اسم. تكتب function ($param) { ... } حيث تُتوقع قيمة: أسندها إلى متغير، أو مرّرها إلى دالة أخرى، أو أعِدها. ويمكنها حمل متغيرات من الشيفرة المحيطة بـ 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);

كل دالة مجهولة كائن من الصنف المدمج Closure، ولهذا يمكن تخزينها وتمريرها واستدعاؤها لاحقًا بـ $greet(...).

الكلمة use تلتقط بالقيمة

لا تستطيع الدالة المغلقة رؤية المتغيرات الخارجية بنفسها. تنسخ use ($x) قيمة $x إلى الدالة المغلقة لحظة إنشائها، لا لحظة تنفيذها:

<?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 بالمرجع: &$var

تعطي use (&$x) الدالة المغلقة المتغير نفسه لا نسخة منه. التغييرات داخل الدالة المغلقة مرئية في الخارج، والتغييرات في الخارج تُرى داخلها. وهكذا تضيف دالة استدعاء إلى مجموع أو تحتفظ بعداد.

<?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";

كل استدعاء لـ makeCounter() ينشئ $count جديدًا، وتُبقيه الدالة المغلقة المعادة حيًا بعد انتهاء الدالة. وهذا ما تشير إليه كلمة «مغلقة»: تنغلق الدالة على المتغيرات التي تحتاجها.

تمرير دالة مغلقة دالةَ استدعاء

تأخذ دوال مثل array_map() وarray_filter() وusort() وarray_walk() دالة وسيطًا. وتتيح لك الدالة المغلقة كتابتها في مكانها، بعدد الجمل الذي تحتاجه المهمة:

<?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);

عندما يكون الجسم تعبيرًا واحدًا، تكون الدالة السهمية مثل fn($p) => $p['price'] أقصر ولا تحتاج إلى use.

القابلات للاستدعاء: أسماء الدوال والتوابع وstrlen(...)

يقبل المعامل ذو النوع callable أكثر من الدوال المغلقة. فالنص الذي فيه اسم دالة، والمصفوفة التي فيها كائن واسم تابع، والمصفوفة التي فيها اسم صنف واسم تابع ساكن، كلها تُحسب. ومنذ PHP 8.1، تحوّل صيغة الاستدعاء من الدرجة الأولى strlen(...) أيًّا منها إلى Closure مباشرة.

<?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'));

تُفحص صيغة (...) عند تنفيذ السطر: الخطأ الإملائي يرمي Error في مكانه. أما نص مثل 'strtoupr' فليس إلا نصًا حتى يحاول أحدهم استدعاءه.

الدوال المغلقة داخل صنف: $this وstatic

الدالة المغلقة المنشأة داخل تابع تُربط بها $this تلقائيًا، فتستطيع استخدام خصائص الكائن. علّمها بـ static function عندما لا تحتاج إلى $this، وهذا يمنعها أيضًا من إبقاء الكائن حيًا.

<?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());

نسيان use

أشهر أخطاء الدوال المغلقة استخدام متغير خارجي دون ذكره في use. داخل الدالة المغلقة لا يوجد المتغير:

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

PHP prints: Warning: Undefined variable $minAge

تكون $minAge داخلها null، وأي عمر يُقارن بـ >= null يعطي true، فيجتاز كل شخص التصفية. وعلى خادم يخفي التحذيرات، لا شيء يخبرك. أضف المتغير إلى 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'));