php函数返回引用必须在函数定义时用&声明,如function &my_func(),且return后只能跟变量或可寻址表达式;主要用于避免大对象拷贝或允许修改原始值,但易引发生命周期问题,多数场景推荐用对象替代。

PHP 函数返回引用的正确写法
PHP 函数不能「默认」返回引用,必须显式声明——在函数名前加 & 符号,否则即使内部用了 &$var,返回的仍是副本。
常见错误是只在 return 时加 &,比如 return &$arr[0];,但函数定义没带 &,这会直接报错:Strict standards: Only variables should be returned by reference。
- 函数定义必须写成
function &my_func() { ... } - return 后面必须是变量(或可寻址表达式),不能是字面量、函数调用或数组字面量
- 如果 return
&$obj->prop或&$arr['key'],确保该属性/键确实存在且可写
什么时候真需要返回引用
返回引用不是为了“看起来高级”,而是为了解决两类实际问题:避免大数组/对象重复拷贝;或让调用方能修改原始存储位置的值。
典型场景包括:
立即学习“PHP免费学习笔记(深入)”;
- 封装全局配置容器,允许外部直接修改某个配置项:
$config =& get_config('database.host');,之后赋值$config = '127.0.0.1';就改到了源数据 - 实现链式调用中可变状态(如某些 DSL 风格的 builder),但注意 PHP 中引用链容易失控,多数情况用对象实例更安全
- 配合
foreach引用遍历做原地更新时,需确保底层数据源本身支持被引用修改
返回引用的坑:变量生命周期和 unset 行为
PHP 引用绑定的是「变量容器」,不是内存地址。一旦被引用的变量被 unset() 或函数执行结束,引用就可能失效或指向不可预期的位置。
动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包
例如:
function &get_temp_ref() {
$tmp = [1, 2, 3];
return $tmp[0]; // 错误:$tmp 是局部变量,函数返回后释放
}
运行会触发 notice:Notice: Indirect modification of overloaded element of ... has no effect,因为返回的是临时值,不是变量本身。
- 只能返回「存活变量」的引用,比如全局变量、静态变量、对象属性、传入的引用参数
- 不要返回函数内新建的局部数组元素、字符串偏移、或
new StdClass()的临时结果 - 如果用
static $cache = [];缓存并返回其中某项,要小心并发写入冲突(CLI/Swoole 场景下尤其明显)
替代方案:多数时候该用对象而不是引用
想让调用方修改原始数据?优先考虑返回一个轻量对象,把目标字段作为 public 属性或提供 setter 方法。
比如代替 &get_user_name(),改成:
class UserRef {
public function __construct(&$name) { $this->name = &$name; }
public function set($v) { $this->name = $v; }
public function get() { return $this->name; }
}
// 调用方:$ref = new UserRef($user['name']); $ref->set('Alice');
这样逻辑清晰、可调试、不依赖引用语义,也规避了 unset() 后悬空引用的风险。
真正需要函数返回引用的场景其实很少,一不小心就会让代码变得脆弱难测。先确认是不是非它不可,再动手加那个 &。










