PHP Fluent API中如何实现带IDE自动补全的方法禁用功能？

需求背景 #

我有一个采用Fluent API设计的Car类，希望能动态禁用指定方法——被禁用的方法后续调用时仅返回$this，不执行原有逻辑。原始类代码如下：

class Car {
    public function accelerate() {
        // 原有加速逻辑
        return $this;
    }

    public function turnLeft() {
        // 原有左转逻辑
        return $this;
    }

    public function turnRight() {
        // 原有右转逻辑
        return $this;
    }

    public function stop() {
        // 原有停车逻辑
        return $this;
    }
}

// 原有链式调用
$car = new Car();
$car
->accelerate()
->turnLeft()
->accelerate()
->turnRight()
->stop();

直接在每个方法开头加状态检查的方式太繁琐，我尝试通过__call魔术方法+disableMethod实现动态禁用：

private array $disabledMethods = [];

public function disableMethod(string $method) {
    $this->disabledMethods[] = $method;
}

public function __call($method, array $parameters)
{
    if(in_array($method, $this->disabledMethods)) {
        return $this;
    }
    return parent::__call($method, $parameters);
}

但这个方案的问题是：传递给disableMethod的方法名是字符串，无法获得IDE自动补全，容易出现拼写错误。

可行解决方案 #

下面提供几种既保留灵活性、又能获得IDE自动补全的实现方式：

方案1：PHP 8.1+ 原生支持的First-class Callable语法 #

利用PHP 8.1引入的First-class callable语法，直接传递方法的可调用引用，既支持IDE补全，又能提取方法名：

class Car {
    private array $disabledMethods = [];

    public function accelerate() {
        echo "执行加速逻辑\n";
        return $this;
    }

    public function turnLeft() {
        echo "执行左转逻辑\n";
        return $this;
    }

    public function turnRight() {
        echo "执行右转逻辑\n";
        return $this;
    }

    public function stop() {
        echo "执行停车逻辑\n";
        return $this;
    }

    public function disableMethod(callable $method) {
        // 从可调用对象中提取目标方法名
        if (is_array($method) && $method[0] === $this) {
            $this->disabledMethods[] = $method[1];
        }
        return $this; // 保持Fluent链式调用
    }

    public function __call($method, array $parameters)
    {
        if (in_array($method, $this->disabledMethods)) {
            return $this;
        }
        throw new BadMethodCallException("方法 {$method} 不存在");
    }
}

// 使用示例
$car = new Car();
$car->disableMethod($car->accelerate(...))
    ->accelerate() // 被禁用，无输出
    ->turnLeft()   // 正常执行，输出"执行左转逻辑"
    ->stop();      // 正常执行，输出"执行停车逻辑"

原理：$car->accelerate(...)会生成一个绑定当前实例的可调用数组[$car, 'accelerate']，我们只需从中提取方法名存入禁用列表即可，IDE会自动补全实例的方法。

方案2：用枚举定义可禁用方法（兼容PHP 8.1以下） #

如果项目版本低于PHP 8.1，可以用枚举（PHP 8.0+支持）定义所有可禁用的方法名，通过枚举值传递实现IDE补全：

// 定义枚举，包含所有可禁用的方法
enum CarMethod: string {
    case Accelerate = 'accelerate';
    case TurnLeft = 'turnLeft';
    case TurnRight = 'turnRight';
    case Stop = 'stop';
}

class Car {
    private array $disabledMethods = [];

    // ... 原有方法省略

    public function disableMethod(CarMethod $method) {
        $this->disabledMethods[] = $method->value;
        return $this;
    }

    public function __call($method, array $parameters)
    {
        if (in_array($method, $this->disabledMethods)) {
            return $this;
        }
        throw new BadMethodCallException("方法 {$method} 不存在");
    }
}

// 使用示例
$car = new Car();
$car->disableMethod(CarMethod::Accelerate)
    ->accelerate() // 被禁用
    ->turnLeft();  // 正常执行

优点：类型安全，IDE会自动列出枚举选项，完全避免手动输入字符串的错误。

方案3：反射提取闭包中的方法名（兼容PHP 7.x） #

如果还在使用PHP 7.x版本，可以通过闭包+反射的方式实现：

class Car {
    private array $disabledMethods = [];

    // ... 原有方法省略

    public function disableMethod(callable $method) {
        $reflection = new ReflectionFunction($method);
        // 验证闭包绑定的是当前实例，且是类的成员方法
        if ($reflection->isClosure() && $reflection->getClosureThis() === $this) {
            $methodName = $reflection->getName();
            $this->disabledMethods[] = $methodName;
        }
        return $this;
    }

    public function __call($method, array $parameters)
    {
        if (in_array($method, $this->disabledMethods)) {
            return $this;
        }
        throw new BadMethodCallException("方法 {$method} 不存在");
    }
}

// 使用示例
$car = new Car();
$car->disableMethod(fn() => $this->accelerate())
    ->accelerate() // 被禁用
    ->turnLeft();  // 正常执行

原理：通过反射获取闭包绑定的实例和方法名，存入禁用列表，IDE在编写闭包时会自动补全accelerate方法。

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