17370845950

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

所以别光记“怎么传”，先想清楚：这个参数我需不需要它被函数改？改了之后外部是否依赖这个变化？想不清楚，就默认用值传递。

容易被忽略的坑：函数内部 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 或留空。