الدوال السهمية في PHP: صيغة fn() => مع أمثلة

الدالة السهمية دالة مجهولة قصيرة: fn($x) => $x * 2. الجسم بعد => تعبير واحد تُعاد قيمته، وأي متغير من الشيفرة المحيطة يستخدمه التعبير يُلتقط تلقائيًا، بالقيمة. الدوال السهمية موجودة منذ PHP 7.4 وتُستخدم غالبًا دوالَّ استدعاء.

<?php
$double = fn($x) => $x * 2;
echo $double(21), "\n";

$prices = [10, 25, 40];
print_r(array_map(fn($p) => $p * 1.2, $prices));

$rate = 0.9;   // used inside without "use"
print_r(array_map(fn($p) => $p * $rate, $prices));

الصيغة

fn، ثم قائمة المعاملات، ثم =>، ثم تعبير واحد. تعمل أنواع المعاملات والقيم الافتراضية ونوع القيمة المعادة كما في الدوال العادية:

<?php
$add = fn(int $a, int $b = 1): int => $a + $b;
$greet = fn(string $name): string => "Hello, $name";
$isEven = fn(int $n): bool => $n % 2 === 0;
$now = fn() => 'no parameters';

echo $add(2, 3), ' ', $add(2), "\n";
echo $greet('Ada'), "\n";
var_dump($isEven(4), $isEven(7));
echo $now(), "\n";

// Call it immediately
echo (fn($x) => $x ** 2)(9), "\n";

لا توجد كلمة return ولا أقواس معقوصة. ومع ذلك يمكن تقسيم التعبير الطويل على عدة أسطر لتسهيل القراءة.

تُلتقط المتغيرات الخارجية بالقيمة

ترى الدالة السهمية كل متغير في النطاق الذي أُنشئت فيه. وتنسخ قيمها في تلك اللحظة. التغييرات داخلها تبقى داخلها، والتغييرات في الخارج بعد إنشاء الدالة لا تراها:

<?php
$count = 0;
$increment = fn() => ++$count;

echo $increment(), "\n";   // works on its own copy
echo $increment(), "\n";   // a fresh copy each call
echo $count, "\n";         // the outer variable is unchanged

$discount = 10;
$apply = fn($price) => $price - $discount;
$discount = 50;            // too late: 10 was already captured
echo $apply(100), "\n";

هذا هو الفرق الرئيسي عن function () use (&$count)، التي تستطيع مشاركة متغير بالمرجع. لا تستطيع الدالة السهمية إعادة إسناد متغير خارجي. لكنها تستطيع تغيير كائن التقطته (النسخة مقبض للكائن نفسه)، ويعمل المعامل المصرّح به بالمرجع كما في أي دالة: fn(array &$list) => $list[] = 'x'.

دوال الاستدعاء لـ array_map وarray_filter وusort

تأخذ معظم دوال المصفوفات دالة استدعاء، وهناك توفّر الدوال السهمية أكثر الضجيج. قارن تصفية واحدة مكتوبة بالطريقتين:

<?php
$users = [
    ['name' => 'Ada', 'age' => 36, 'active' => true],
    ['name' => 'Linus', 'age' => 28, 'active' => false],
    ['name' => 'Grace', 'age' => 45, 'active' => true],
];

// Long form
$active1 = array_filter($users, function ($u) {
    return $u['active'];
});

// Arrow function
$active2 = array_filter($users, fn($u) => $u['active']);
var_dump($active1 === $active2);

$names = array_map(fn($u) => $u['name'], $active2);
echo implode(', ', $names), "\n";

usort($users, fn($a, $b) => $a['age'] <=> $b['age']);
echo implode(', ', array_column($users, 'name')), "\n";

$total = array_reduce($users, fn($sum, $u) => $sum + $u['age'], 0);
echo "Total age: $total\n";

يعيد <=> القيمة -1 أو 0 أو 1، وهذا بالضبط ما تريده usort()، فيتسع الترتيب حسب حقل في سطر واحد. بدّل بين $a و$b للترتيب التنازلي.

دوال سهمية تعيد دوال سهمية

تشمل المتغيرات الملتقطة معاملات الدالة السهمية المحيطة، لذا يمكنك تداخلها لبناء دوال من قيم أخرى:

<?php
$multiplyBy = fn($factor) => fn($x) => $x * $factor;

$triple = $multiplyBy(3);
$tenTimes = $multiplyBy(10);

echo $triple(5), ' ', $tenTimes(5), "\n";

$between = fn($min, $max) => fn($n) => $n >= $min && $n <= $max;
$teen = $between(13, 19);
print_r(array_filter([8, 13, 16, 21, 19], $teen));

لاحظ أن array_filter() تحتفظ بالمفاتيح الأصلية، ولهذا تبدأ النتيجة عند الفهرس 1.

fn مقابل function: متى تحتاج إلى دالة مغلقة كاملة

تتوقف الدوال السهمية عن الملاءمة عندما يحتاج الجسم إلى أكثر من تعبير واحد أو يجب أن يغيّر متغيرًا خارجيًا. عندها استخدم دالة مجهولة:

<?php
$orders = [120, 45, 300, 80];

// Needs a statement and an outer total: a closure with use (&...)
$total = 0;
$big = [];
array_walk($orders, function ($amount) use (&$total, &$big) {
    $total += $amount;
    if ($amount > 100) {
        $big[] = $amount;
    }
});
echo "Total $total, big orders: ", implode(', ', $big), "\n";

// The same result split into expressions: arrow functions fit again
$total2 = array_sum($orders);
$big2 = array_values(array_filter($orders, fn($a) => $a > 100));
echo "Total $total2, big orders: ", implode(', ', $big2), "\n";

عندما تبدو الدالة السهمية ضيقة، فغالبًا ما يعني ذلك أن المهمة مهمتان. تقسيمها إلى تصفية وجمع، كما في المثال أعلاه، يُبقي كل دالة استدعاء تعبيرًا واحدًا.