当参数超3个且含混合类型、需校验或预设组合时该用Builder；Builder可独立或作静态内部类；build()须统一校验必填字段；命名参数不能替代Builder的运行时校验与可控构造。
什么时候该用 Builder 而不是直接 new？
当一个类的构造需要传入 4 个以上参数，尤其包含可选参数、类型校验逻辑、依赖对象需按顺序初始化时，硬写 new MyClass($a, $b, $c, $d, null, true, []) 很快就失控。比如构建一个带验证规则、缓存策略、重试配置的 HttpClient 实例，直接构造极易漏参数或传错顺序。
- 参数超过 3 个且存在布尔/数组/对象混合类型 → 建议上
Builder - 对象创建前需做字段合法性检查（如 URL 格式、超时值范围）→
Builder可集中校验 - 不同业务场景需要固定组合（如「测试环境 builder」和「生产环境 builder」）→ 可封装成子类或静态方法
Builder 类必须和目标类解耦吗？
不一定。PHP 中常见两种写法：独立 Builder 类（如 HttpClientBuilder），或把 Builder 写成目标类的静态内部类（PHP 8.1+ 支持 final class HttpClient { private function __construct() {} public static function builder(): self { ... } }）。前者利于测试和复用，后者更轻量、避免命名污染。
- 如果目标类是
final或你无法修改其源码 → 必须用独立Builder类 - 若目标类是你自己维护，且构建逻辑简单 → 直接用静态
builder()方法更直观，调用方写HttpClient::builder()->withTimeout(5)->build() - 注意：无论哪种，
build()方法必须返回最终对象，且不能暴露未完成状态（比如允许 build 后再调withXxx()）
为什么 build() 常报 “Required parameter missing”？
根本原因是校验逻辑没覆盖所有必填字段，或者字段在 build() 时被覆盖/清空。典型错误是把参数存到普通属性（$this->timeout），但没在 build() 前强制检查；或者用了数组存储配置，却忘了在 build() 时判断 isset($this->config['timeout'])。
- 推荐在
build()开头统一检查：if (!isset($this->host) || !is_string($this->host)) { throw new InvalidArgumentException('host is required'); } - 避免在 setter 中做“自动补默认值”，比如
withTimeout(null)自动设为 30 —— 这会让调用方误以为可不传，实际却可能违反业务约束 - 如果用了 fluent 接口（链式调用），确保每个
withXxx()都return $this，且不改变已设字段（即不可变性）
PHP 8 的命名参数能替代 Builder 吗？
能简化部分场景，但不能替代。命名参数解决的是「调用时参数可读性」问题，而 Builder 解决的是「构造过程可控性」问题。比如 new Query($table, $fields, $where, $limit, $offset) 改成命名参数后是清晰了，但依然无法阻止你传入 $limit = -1 或 $where = '' 导致 SQL 报错。
立即学习“PHP免费学习笔记（深入）”；
- 命名参数适合参数少、无强校验、无依赖顺序的类（如 DTO、Value Object）
-
Builder适合需要运行时校验、组合预设配置、延迟实例化（如连接池中先建 builder 再按需 build）的场景 - 二者可共存：用命名参数初始化 builder 的内部配置，再由 builder 执行最终校验与组装
真正难的不是写一个能跑的 Builder，而是定义清楚哪些字段必须校验、哪些可以延迟决定、以及 build 失败时抛出的异常是否能让调用方快速定位是哪步配置错了 —— 这些细节往往要靠线上日志反推才能补全。
