本文目录导读：
- 解决“构造函数参数爆炸”问题
- 保证对象的不变性（Immutable）
- 支持“链式调用”和“流式构建”
- 统一复杂对象的构建逻辑
- 解决“多个同名构造函数”问题
- 清晰的“校验逻辑”集中管理
- 支持“分步构建”和“延迟构建”
- 总结：什么时候用？
建造者模式（Builder Pattern）在 PHP 中是一个非常有用的设计模式，它的核心价值在于将复杂对象的构建过程与它的表示分离。
它的用处主要体现在以下几个方面：
解决“构造函数参数爆炸”问题
当对象需要很多参数（5 个以上），且很多参数是可选的时,直接写构造函数会非常痛苦且容易出错。
传统方式的问题：
class User {
public function __construct(
private string $name,
private string $email,
private string $address = '',
private string $phone = '',
private string $birthday = '',
private string $avatar = '',
// ... 可能更多参数
) {}
}
// 使用：很难记住参数顺序，容易传错
$user = new User('张三', 'zhangsan@example.com', '', '', '', '');
使用建造者模式后：
$user = UserBuilder::create()
->setName('张三')
->setEmail('zhangsan@example.com')
->setPhone('13800138000')
->setAvatar('avatar.png')
->build();
参数语义清晰,可选参数按需设置。
保证对象的不变性（Immutable）
建造者模式可以在 build() 方法中创建最终的对象，创建后对象属性就是只读的,不允许修改。
class UserBuilder {
private string $name;
private string $email;
public function build(): User {
// 在构建完成后，创建一个完整的 User 对象
return new User($this->name, $this->email);
}
}
// 构建后
$user = $builder->build();
// 由于 User 没有 setter，且属性为 private，无法被外部修改
支持“链式调用”和“流式构建”
建造者模式天然适合链式调用（fluent interface），这使得代码读起来像自然语言,可读性极高。
$pizza = PizzaBuilder::create()
->setSize('large')
->addTopping('pepperoni')
->addCheese('mozzarella')
->setCrust('thick')
->build();
统一复杂对象的构建逻辑
如果一个对象的构建过程非常复杂（比如需要从数据库、API、文件等来源组装数据），建造者模式可以把这些逻辑集中在一个地方,方便维护。
class ReportBuilder {
public function buildFromDatabase(int $reportId): Report {
// 1. 从数据库查询基础数据
$data = $this->db->query(...);
// 2. 计算统计信息
$stats = $this->calculateStats($data);
// 3. 生成图表
$charts = $this->generateCharts($stats);
// 4. 生成 PDF
$pdf = $this->renderPdf($charts);
return new Report($data, $stats, $charts, $pdf);
}
}
解决“多个同名构造函数”问题
PHP 不像 C++ 或 Java 那样支持构造函数重载（多个不同参数的同名方法），而建造者模式可以通过不同的 build 方法或配置来创建不同类型的对象。
class CarBuilder {
// 可以通过不同的方法创建不同的配置
public function buildSportsCar(): Car { ... }
public function buildFamilyCar(): Car { ... }
public function buildManualTransmissionCar(): Car { ... }
}
清晰的“校验逻辑”集中管理
在 build() 方法中，可以对所有参数进行统一校验,避免每次创建对象都写一遍校验逻辑。
class UserBuilder {
public function build(): User {
if (empty($this->email)) {
throw new \InvalidArgumentException('Email 不能为空');
}
if (!filter_var($this->email, FILTER_VALIDATE_EMAIL)) {
throw new \InvalidArgumentException('Email 格式不正确');
}
// 其他校验逻辑...
return new User(...);
}
}
支持“分步构建”和“延迟构建”
在有些场景下，对象需要分多个步骤才能完全构建，或者构建过程需要等待其他条件满足，建造者模式允许你先收集信息，最后再一次性 build()。
什么时候用？
- ✅ 对象有 5 个以上 可选/必填参数
- ✅ 对象的初始化逻辑很复杂（需要计算、关联、校验等）
- ✅ 需要创建多种变体的相同类型对象
- ✅ 想要不可变对象（没有 setter）
- ✅ 希望代码有极高的可读性
一句话总结：当你在创建对象时感到“参数太多、逻辑太乱、容易出错”,那就是该用建造者模式的时候了！
