PHP函数参数默认值传递,可显式用&声明引用传递;需根据是否需修改原始变量及外部依赖该修改来决定,误用引用会导致不可预期行为。

PHP 函数参数是值传递还是引用传递?
默认是值传递,但可以显式改成引用传递。关键不在“学哪种”,而在“什么时候必须用引用”。比如你写一个函数想修改原始变量,却忘了加 &,调用后变量没变——不是语法错,是逻辑错,这种问题调试起来特别隐蔽。
- 值传递:函数内部对参数的修改不影响外部变量,PHP 会复制一份(对数组、对象等大结构有性能开销)
- 引用传递:在形参前加
&,如function foo(&$x),函数内改$x就等于直接改外面那个变量 - 对象在 PHP 7+ 默认按“对象引用”语义传递(不是 C 风格的引用),即你改对象属性会影响原对象,但把参数重新赋值为新对象(
$obj = new StdClass();)不会影响外部变量
怎么判断该不该加 &?看函数要做什么
加 & 不是为了“看起来高级”,而是为了明确副作用。PHP 官方函数里极少用引用传参(sort()、array_shift() 是少数例外),你自己写的函数如果需要“输出多个结果”或“就地修改数组”,才考虑它。
- 适合引用传参的场景:
parse_config_file($path, &$config_array)—— 把解析结果直接塞进传入的数组 - 不适合的场景:
format_price($amount, $currency)—— 只返回新字符串,不碰输入 - 误用引用会导致不可预期行为:比如把常量或表达式传给引用参数(
foo(&123)或foo(&$arr[0] ?? null)),PHP 8 会报Cannot pass parameter 1 by reference
PHP 8 的只读引用和参数类型声明让传递更安全
PHP 8.1 引入了 readonly 属性,虽不直接作用于函数参数,但它推动了“避免意外修改”的设计习惯。更重要的是,配合严格类型声明,能提前暴露传递错误。
function process_user(array &$data): void
{
$data['processed'] = true;
}
// 这样调用没问题
$user = ['id' => 1];
process_user($user);
// 但这样会报致命错误(PHP 8.0+)
process_user(['id' => 1]); // Warning: Cannot pass array literal by reference
所以别光记“怎么传”,先想清楚:这个参数我需不需要它被函数改?改了之后外部是否依赖这个变化?想不清楚,就默认用值传递。
立即学习“PHP免费学习笔记(深入)”;
容易被忽略的坑:函数内部 unset() 引用参数
很多人以为 unset($x) 在引用函数里只是断开别名,其实它会真正销毁原始变量——这是极少见但真实存在的行为。
function bad_example(&$x) {
unset($x); // 外部的变量也会消失!
}
$var = 'hello';
bad_example($var);
var_dump($var); // PHP Notice: Undefined variable: var
除非你明确需要这个效果(比如实现类似 compact() 的清理逻辑),否则别在引用参数上用 unset()。更安全的做法是设为 null 或留空。











