PHP: 函数进阶

<?php
function sum(...$numbers): int {
    return array_sum($numbers);
}

echo sum(1, 2);           // 3
echo sum(1, 2, 3, 4, 5);  // 15
echo sum();               // 0

// 也可以前面有固定参数，后面接收剩余
function sendMessage(string $to, string ...$messages): void {
    foreach ($messages as $msg) {
        echo "发送给{$to}：{$msg}<br>";
    }
}

sendMessage("小明", "早上好", "午饭吃了吗", "晚安");
// 发送给小明：早上好
// 发送给小明：午饭吃了吗
// 发送给小明：晚安
?>

<?php
function add(int $a, int $b, int $c): int {
    return $a + $b + $c;
}

$nums = [1, 2, 3];
echo add(...$nums);  // 6（数组展开为3个参数）

// 常用于 array_push 等函数
$stack = ["a", "b"];
array_push($stack, ...["c", "d", "e"]);
print_r($stack);  // ["a", "b", "c", "d", "e"]
?>

<?php
function createUser(
    string $name,
    int $age,
    string $email = "",
    bool $isAdmin = false
): array {
    return compact('name', 'age', 'email', 'isAdmin');
}

// 传统方式：必须按顺序传
$u1 = createUser("小明", 25, "xiaoming@example.com", true);

// 命名参数：顺序随便，跳过有默认值的参数
$u2 = createUser(
    name: "小红",
    age: 22,
    isAdmin: true
    // email 用默认值
);

// 函数参数很多时，命名参数可读性巨大提升
setcookie(
    name: "theme",
    value: "dark",
    expires_or_options: time() + 3600,
    httponly: true
);
?>

<?php
// 按值传递（默认）：函数内修改不影响外部
function addTen(int $n): void {
    $n += 10;
}
$x = 5;
addTen($x);
echo $x;  // 5（没变）

// 按引用传递：函数内修改直接影响外部
function addTenRef(int &$n): void {
    $n += 10;
}
addTenRef($x);
echo $x;  // 15（变了！）
?>

<?php
$globalVar = "我在外面";

function test(): void {
    // echo $globalVar;  // Warning: Undefined variable
    // 函数内部无法直接访问外部变量

    $localVar = "我在里面";
    echo $localVar;  // OK
}

test();
// echo $localVar;  // Warning: 也访问不到函数内部的变量
?>

<?php
$counter = 0;

function increment(): void {
    global $counter;  // 声明我要用全局变量
    $counter++;
}

increment();
increment();
echo $counter;  // 2
?>

<?php
$name = "小明";

function showName(): void {
    echo $GLOBALS['name'];  // 小明
}
showName();
?>

<?php
function getNextId(): int {
    static $id = 0;
    $id++;
    return $id;
}

echo getNextId();  // 1
echo getNextId();  // 2
echo getNextId();  // 3

// static 变量只在第一次调用时初始化
// 后续调用保持上次的值
?>

<?php
// 匿名函数赋值给变量
$greet = function(string $name): string {
    return "你好，{$name}！";
};

echo $greet("小明");  // 你好，小明！

// 作为参数传给其他函数（回调）
$numbers = [1, 2, 3, 4, 5];
$doubled = array_map(function($n) {
    return $n * 2;
}, $numbers);
print_r($doubled);  // [2, 4, 6, 8, 10]
?>

<?php
$prefix = "用户";

// ❌ 错误：$prefix 在匿名函数内部不可见
// $greet = function($name) {
//     return "{$prefix}：{$name}";
// };

// ✅ 用 use 导入外部变量
$greet = function($name) use ($prefix): string {
    return "{$prefix}：{$name}";
};

echo $greet("小明");  // 用户：小明

// 按引用导入（可以修改外部变量）
$count = 0;
$inc = function() use (&$count): void {
    $count++;
};
$inc(); $inc();
echo $count;  // 2
?>

<?php
$factor = 3;

// 匿名函数写法
$anon = function($n) use ($factor) {
    return $n * $factor;
};

// 箭头函数写法（自动捕获 $factor）
$arrow = fn($n) => $n * $factor;

echo $anon(5);   // 15
echo $arrow(5);  // 15

// array_map 中的黄金搭档
$nums = [1, 2, 3, 4, 5];
$tripled = array_map(fn($n) => $n * $factor, $nums);
print_r($tripled);  // [3, 6, 9, 12, 15]
?>

<?php
// 方式 1：函数名字符串
function double(int $n): int {
    return $n * 2;
}
$result = array_map('double', [1, 2, 3]);
// 不是 'double'（带引号），是函数名作为字符串传给 array_map

// 方式 2：匿名函数
$result = array_map(fn($n) => $n * 3, [1, 2, 3]);

// 方式 3：callable 类型声明
function apply(callable $fn, array $data): array {
    return array_map($fn, $data);
}

$result = apply('double', [1, 2, 3]);          // ✅
$result = apply(fn($n) => $n * 2, [1, 2, 3]);   // ✅
// apply(123, [1, 2, 3]);  // TypeError!
?>