الدوال (Functions)

<?php
// تعريف دالة بسيطة
function sayHello() {
    echo "مرحباً بالجميع! <br>";
}

// استدعاء الدالة
sayHello(); // مرحباً بالجميع!
sayHello(); // يمكن استدعاؤها مرات عديدة
sayHello();

// دالة مع معاملات (Parameters)
function greet($name, $title = "الأستاذ") {
    echo "مرحباً $title $name! <br>";
}

greet("أحمد");           // مرحباً الأستاذ أحمد
greet("فاطمة", "الدكتورة"); // مرحباً الدكتورة فاطمة

// دالة مع قيمة مُرجَعة (return)
function add($a, $b) {
    return $a + $b;
}

$result = add(15, 27);
echo "15 + 27 = $result <br>";

// يمكن استخدام نتيجة الدالة مباشرة
echo "10 + 5 = " . add(10, 5);
?>

<?php
$globalVar = "أنا عالمي";

function testScope() {
    // $globalVar غير متاح هنا مباشرة
    // global $globalVar; // لاستخدامه
    $localVar = "أنا محلي";
    echo $localVar . "<br>";
}
testScope();
// echo $localVar; // خطأ! localVar غير موجود هنا

// Variadic: عدد غير محدود من المعاملات
function sumAll(...$numbers) {
    return array_sum($numbers);
}
echo sumAll(1, 2, 3)         . "<br>"; // 6
echo sumAll(10, 20, 30, 40)  . "<br>"; // 100

// Anonymous Function (Closure)
$double = function($x) {
    return $x * 2;
};
echo $double(5) . "<br>"; // 10

// Arrow Function (أنيقة!)
$triple = fn($x) => $x * 3;
echo $triple(4) . "<br>"; // 12

// Type Declarations (PHP 7+)
function divide(float $a, float $b): float {
    if ($b == 0) return 0;
    return $a / $b;
}
echo divide(10, 3); // 3.333...
?>