PHP：如何避免函数内修改类实例影响外部作用域

从PHP 5开始，类实例的传参、赋值都不再是拷贝整个对象，而是传递对象句柄的副本：函数拿到的入参和外部原变量，指向的是堆内存中同一个真实对象。只要在函数内部调用setter、修改对象属性，本质上都是修改这块共享内存的内容，自然会影响外部作用域的实例。

注：你之前写的$unchangedTest = $test根本不是有效备份，这行代码只是把对象句柄复制了一份，两个变量依然指向同一个对象，完全起不到隔离作用。

按实用性从高到低排序：

• 源头规避隐式副作用：尽量不要让业务函数直接修改传入对象的属性，而是把需要变更的值作为返回值传出，从设计上避免跨作用域的修改。这是长期维护成本最低的方案。
• 函数内部做深拷贝隔离：在需要修改对象的函数开头，对入参做独立克隆，所有修改操作只作用在克隆体上，完全不触碰原对象。基础写法参考：

function changeVarValue(Test $originTest)
{
    // 克隆出完全独立的副本
    $test = clone $originTest;
    $test->setVar(false); // 仅修改克隆体，外部原对象不受影响
}

注意：默认的clone是浅拷贝，如果对象内部包含嵌套的其他实例、引用类型属性，需要在类中实现__clone()方法做递归深拷贝，否则嵌套的对象依然会被共享修改。

• 单属性备份恢复：只适合对象结构简单、修改逻辑固定的极小场景，一旦涉及多属性修改，很容易出现漏备份、漏恢复的问题，维护成本很高。

• Java、C#、Python：和PHP逻辑一致，传递对象时本质是传对象引用/句柄的值副本，函数内修改对象属性会影响外部实例。
• C++：可自由选择传参模式，传值时会完整拷贝对象、修改不影响外部；传引用、传指针时会共享内存，修改同步到外部。
• Golang：结构体默认是值拷贝传递，函数内修改不影响外部；如果传递结构体指针，就会共享内存、修改同步到外部。

你当前的核心矛盾是createUser方法会把User实例里的明文密码覆盖成哈希值，导致后续传给认证服务的User对象已经失去了做凭证校验需要的明文内容，对应可落地的优化方案按合理性排序：

• 优先选择无副作用的createUser实现：不要直接修改传入User实例的密码属性，单独计算密码哈希值，把哈希值作为存储层的入参传入，原User实例全程保持明文密码不变。示例逻辑：

public function createUser(User $user): int
{
    // 单独计算哈希，不修改原对象属性
    $hashedPwd = password_hash($user->getPassword(), PASSWORD_DEFAULT);
    // 存储层直接接收独立的哈希参数，不依赖被修改的User实例
    return $this->userRepo->insert([
        'email' => $user->getEmail(),
        'password_hash' => $hashedPwd,
        // 其余业务字段...
    ]);
}

这种方式完全不需要克隆、备份属性，外部的User实例依然保留明文密码，后续传给authService做登录校验时，password_verify可以正常运行，从根源上避免了流程跨节点的副作用。

• 你最初想到的拆分password、passwordHash双属性的思路完全可行：给User类设置两个独立属性，password仅承载流程流转阶段的明文密码，用于校验；passwordHash承载持久化存储的哈希值，用于数据库读写。两个属性各司其职，不会出现互相覆盖的问题。
• 避坑提醒：尽量不要在业务层把传入对象的核心属性直接覆盖修改，这类隐式副作用会让流程的可预测性大幅下降，后续排查跨模块的属性异常时成本极高。

内容的提问来源于stack exchange，提问作者Samuel Gfeller