PHP怎样实现建造者设计模式_PHP实现建造者设计模式方法【架构】-php教程-PHP中文网

建造者模式在PHP中的核心价值是解决构造逻辑复杂、参数多变、对象不可变的问题，通过类型安全的链式调用、明确校验与实例化分离，避免失控的构造过程。

php怎样实现建造者设计模式_php实现建造者设计模式方法【架构】

建造者模式在 PHP 中的核心价值是什么

它不是为了炫技，而是解决「构造逻辑复杂、参数多变、对象不可变」这类问题。比如你要创建一个 HttpRequest 对象，带 URL、headers、body、timeout、retry 等十多个可选参数，且某些组合必须校验（如设置了 body 就不能是 GET），直接用构造函数或工厂方法会迅速失控。

如何用 PHP 写一个真正可用的建造者类

关键不是套结构，而是让链式调用不破坏类型安全、不丢失可读性、不引入隐藏状态。常见错误是把 build() 写成万能兜底，结果返回 array 或 stdClass，失去 IDE 支持和类型约束。

每个 setter 方法（如 withUrl()、withHeader()）必须返回 $this，且声明返回类型为当前建造者类（PHP 8+ 推荐用 self）
build() 应该只做最终校验和实例化，不处理业务逻辑；失败时抛出明确异常，比如 BuilderException，而不是静默返回 null
避免在建造者中保存中间状态变量（如 $this->isBuilt = true），因为 PHP 没有内置的“构建后不可再改”机制，靠文档或注释不如靠类型系统——让建造者实例在 build() 后被显式弃用

示例片段：

class HttpRequestBuilder
{
    private string $method = 'GET';
    private ?string $url = null;
    private array $headers = [];

    public function withUrl(string $url): self
    {
        $this->url = $url;
        return $this;
    }

    public function withMethod(string $method): self
    {
        $this->method = strtoupper($method);
        return $this;
    }

    public function build(): HttpRequest
    {
        if ($this->url === null) {
            throw new BuilderException('URL is required');
        }
        if ($this->method === 'GET' && !empty($this->body)) {
            throw new BuilderException('GET request cannot have body');
        }
        return new HttpRequest($this->url, $this->method, $this->headers);
    }
}