函数是把一段逻辑命名并存起来。写得好,代码像句子;写得差,一个函数两百行,谁都不敢动。
参数的三条规则
- 有默认值的参数放在最后。PHP 允许把可选参数放前面,但调用时想跳过它就得很别扭,而且 PHP 8 起会给出弃用提示。
- 参数不要超过四个。超过就说明这个函数在做太多事,或者应该传一个配置数组/对象。
- 类型能写就写。参数类型和返回类型都写上,编辑器能提示,错误能提前暴露。
<?php
declare(strict_types=1);
function money(float $amount, string $symbol = '¥', int $decimals = 2): string
{
return $symbol . number_format($amount, $decimals);
}
echo money(1299.5); // ¥1,299.50
echo money(1299.5, '$'); // $1,299.50可变参数
参数前面加 ... 表示「收下剩下所有参数」,函数内部拿到的是数组。调用时也可以反过来,把数组展开传进去。
function sum(int ...$nums): int {
return array_sum($nums);
}
echo sum(1, 2, 3); // 6
echo sum(...[4, 5, 6]); // 15PHP 8 支持命名参数,调用时可以写 money(amount: 99, symbol: '$'),顺序无关。这让「参数很多但大多有默认值」的函数好用了不少。
返回值
一个函数最好只有一个返回类型。有时返回数组、有时返回 false、有时返回 null,调用方就得写一堆判断。更好的做法是:成功返回值,失败抛异常,或者返回一个包含 ok 与 data 的统一结构。
早返回(卫语句)能让主逻辑保持在最外层。函数超过 40 行,通常就该拆了;拆的依据不是行数,而是「这段能不能用一个名字概括」。
纯函数与副作用
同样的输入永远得到同样的输出,且不修改外部状态,这叫纯函数。纯函数最好测试。写函数时尽量把「计算」和「输出/写库」分开:calc_total() 只算钱,save_order() 负责落库。
一个实用习惯:函数名用动词开头,返回布尔值的用 is_/has_/can_ 开头。看到名字就知道它干什么、返回什么。