函数是组织代码的最小单位。语法不难,但边界没划清,函数就会慢慢变成”什么都干一点”的怪物。下面几处是实际项目里最常出问题的地方。
默认参数必须放后面
PHP 允许给参数设默认值,但带默认值的参数要放在参数列表末尾。PHP 8 引入了命名参数,可以绕过这个限制,但为了兼容性,仍然建议按顺序设计签名。
<?php
function paginate(int $page = 1, int $size = 20, string $order = 'desc'): array
{
return ['page' => $page, 'size' => $size, 'order' => $order];
}
// 位置参数
paginate(2, 50);
// 命名参数(PHP 8+),可跳过中间参数
paginate(page: 2, order: 'asc');
可变参数与展开
<?php
function sum(int ...$nums): int
{
return array_sum($nums);
}
sum(1, 2, 3); // 6
$args = [4, 5, 6];
sum(...$args); // 15
值传递与引用传递
PHP 默认按值传递,数组和对象看起来像引用,其实是”写时复制”。对象传入函数后修改属性会影响外部,因为复制的是句柄;数组则不会,除非显式加 &。
<?php
function addItem(array $arr, $item) { $arr[] = $item; return $arr; }
$list = [1, 2];
addItem($list, 3);
print_r($list); // [1, 2] —— 外部未变
function addItemRef(array &$arr, $item) { $arr[] = $item; }
addItemRef($list, 3);
print_r($list); // [1, 2, 3]
引用传参要慎用。它让函数产生副作用,调用方很难一眼看出变量被改了。除非是明确的”就地修改”语义(比如排序、累加),否则返回新值比修改入参更好维护。
闭包与 use
匿名函数要访问外部变量,必须用 use 显式引入。想在闭包里修改外部变量,也要加 &。
<?php
$factor = 2;
$double = function ($n) use ($factor) { return $n * $factor; };
echo $double(5); // 10
$count = 0;
$inc = function () use (&$count) { $count++; };
$inc(); $inc();
echo $count; // 2
一个实用建议
函数超过 40 行、参数超过 4 个,基本就该拆了。参数多的时候,把相关参数收成一个数组或值对象,比继续加参数更好读,也更好扩展。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。