在不修改方法返回类型或引入额外服务的前提下，可通过引用传参或类属性配合getter方式安全地返回错误消息等辅助数据。
在不修改方法返回类型或引入额外服务的前提下，可通过引用传参或类属性配合getter方式安全地返回错误消息等辅助数据。
在 PHP 中，当一个方法主要职责是执行操作并返回布尔结果（如 true/false），但又需要在失败时提供可读的错误信息时，直接通过引用参数返回附加数据虽技术上可行，却存在明显设计缺陷：它破坏了方法签名的清晰性，降低了可测试性与可维护性，且违背了“单一职责”和“最小接口”原则——调用方必须预先声明变量并理解该参数的副作用语义。
更符合现代 PHP 最佳实践的方式是采用封装式状态管理：
- 定义私有状态属性（如 private $lastError = null;）
- 在方法内部更新该状态（而非依赖外部变量）
- 提供只读 getter 方法（如 public function getLastError(): ?string）
✅ 示例重构代码如下：
class Test
{
private ?string $lastError = null;
public function action(): bool
{
// 模拟业务逻辑
if (/* 某些条件导致失败 */) {
$this->lastError = 'Operation failed: insufficient permissions.';
return false;
}
$this->lastError = null; // 成功时清空错误
return true;
}
public function getLastError(): ?string
{
return $this->lastError;
}
}
// 使用示例
$object = new Test();
if (!$object->action()) {
echo "Error: " . $object->getLastError(); // 输出错误信息
}
⚠️ 注意事项：
- 避免在方法中直接修改传入的引用参数（如 &$log），这会使方法产生隐蔽副作用，增加调试难度；
- 若需支持链式调用或无状态场景，可考虑抛出异常（throw new RuntimeException($message)），由调用方 try/catch 处理；
- 对于严格类型要求的项目，建议为 getLastError() 添加返回类型声明（?string），提升 IDE 支持与运行时安全性。
总结：优先使用类内状态 + 显式 getter 的组合，既保持接口简洁、语义明确，又兼顾扩展性与可测试性；引用传参仅适用于极少数性能敏感且上下文高度受控的底层场景，不应作为常规错误传递手段。
