在不修改返回值类型或引入额外服务的前提下，可通过类的私有属性配合 getter 方法安全地传递错误信息等上下文数据，既符合面向对象设计原则，又避免了 php 中直接使用引用参数带来的可维护性与可读性问题。
在不修改返回值类型或引入额外服务的前提下，可通过类的私有属性配合 getter 方法安全地传递错误信息等上下文数据，既符合面向对象设计原则，又避免了 php 中直接使用引用参数带来的可维护性与可读性问题。
在 PHP 开发中，常遇到一类典型需求：某个方法需保持简洁的返回契约（如仅返回 bool 表示操作是否成功），但又需要向调用方传递补充信息（如错误详情、调试日志、警告消息等）。此时，直接通过引用参数（&$log）修改外部变量虽技术上可行，却存在明显缺陷：
- 破坏封装性：方法行为依赖外部变量状态，调用逻辑耦合度高；
- 降低可测试性：单元测试需额外构造引用变量，增加测试复杂度；
- 违背单一职责：方法既承担业务逻辑，又负责副作用输出；
- 易引发意外修改：若调用方未传入变量或传入不可写变量，可能触发警告或静默失败。
✅ 推荐做法：使用私有状态属性 + 显式 getter，实现清晰、可控、可追溯的数据传递。
class Test
{
private ?string $lastLog = null;
public function action(): bool
{
// 模拟业务逻辑
if (/* 某些条件导致失败 */) {
$this->lastLog = 'Error: Invalid input';
return false;
}
$this->lastLog = 'Success';
return true;
}
public function getLastLog(): ?string
{
return $this->lastLog;
}
// 可选：重置日志，便于多次调用
public function clearLog(): void
{
$this->lastLog = null;
}
}
// 使用示例
$object = new Test();
$result = $object->action();
if (!$result) {
echo "操作失败，详情：{$object->getLastLog()}"; // 输出：操作失败，详情：Error: Invalid input
} else {
echo "操作成功，日志：{$object->getLastLog()}"; // 输出：操作成功，日志：Success
}? 进阶建议：
- 若需支持多条日志（如调试、警告、错误分级），可将 $lastLog 替换为 private array $logs = []，并提供 addLog(string $message, string $level = 'info') 与 getLogs(): array；
- 对于严格错误场景，更推荐抛出异常（throw new InvalidArgumentException(...)），由调用方 try/catch 处理，语义更明确；
- 避免在 getter 中做复杂计算或副作用操作，确保其纯函数特性（只读、无修改）。
总之，用对象状态承载上下文信息，比依赖引用参数更健壮、更符合现代 PHP 工程实践。它让类的行为更内聚，接口更稳定，也更容易演进和监控。
