PHP建造者模式构建复杂对象吗

本文目录导读：

1. 为什么用建造者模式构建复杂对象？
2. 建造者模式如何解决？
3. 更复杂的情况：带有子对象的复杂对象
4. 建造者模式 vs 其他构造方式
5. 什么时候用建造者模式？
6. 一个真实世界的类比

是的，PHP 的建造者模式（Builder Pattern） 非常适合用来构建复杂对象，尤其是当对象有多个可选属性、参数或构造步骤时（比如需要按特定顺序组合、或有很多嵌套对象）。

建造者模式帮你把对象的构造过程和它的最终表示分离开，这样你就可以用相同的构造过程创建出不同表现的对象。

为什么用建造者模式构建复杂对象？

假设你有一个 User 类,它有很多属性：

class User
{
    public function __construct(
        private string $name,
        private int $age,
        private string $email,
        private ?string $phone = null,
        private ?string $address = null,
        private ?array $hobbies = null,
        private ?string $avatar = null,
        // ... 可能还有更多
    ) {}
}

如果没有建造者模式,你可能需要这样实例化：

$user = new User(
    '张三',
    28,
    'zhangsan@example.com',
    '13800138000',    // phone
    '北京市朝阳区',   // address
    ['读书', '游泳'], // hobbies
    null              // avatar
);

问题来了：

• 参数顺序容易搞错（特别是可选的 null 参数很多时）。
• 可读性差：一眼看不出来每个参数是什么。
• 扩展性差：如果以后增加了新属性,所有构造调用处都得改。

建造者模式如何解决？

创建 Builder 类

class UserBuilder
{
    private string $name;
    private int $age;
    private string $email;
    private ?string $phone = null;
    private ?string $address = null;
    private array $hobbies = [];
    private ?string $avatar = null;
    // 每个 setter 返回 $this 实现链式调用
    public function setName(string $name): self
    {
        $this->name = $name;
        return $this;
    }
    public function setAge(int $age): self
    {
        $this->age = $age;
        return $this;
    }
    public function setEmail(string $email): self
    {
        $this->email = $email;
        return $this;
    }
    public function setPhone(?string $phone): self
    {
        $this->phone = $phone;
        return $this;
    }
    public function setAddress(?string $address): self
    {
        $this->address = $address;
        return $this;
    }
    public function addHobby(string $hobby): self
    {
        $this->hobbies[] = $hobby;
        return $this;
    }
    public function setAvatar(?string $avatar): self
    {
        $this->avatar = $avatar;
        return $this;
    }
    // 最终构建方法
    public function build(): User
    {
        return new User(
            $this->name,
            $this->age,
            $this->email,
            $this->phone,
            $this->address,
            $this->hobbies,
            $this->avatar
        );
    }
}

使用 Builder 创建对象

$builder = new UserBuilder();
$user = $builder
    ->setName('张三')
    ->setAge(28)
    ->setEmail('zhangsan@example.com')
    ->setPhone('13800138000')
    ->setAddress('北京市朝阳区')
    ->addHobby('读书')
    ->addHobby('游泳')
    ->build();

相比直接构造函数，优势很明显：

• 代码意图清晰，一看就知道在设置什么属性。
• 顺序任意,不依赖参数位置。
• 可选的属性可以完全忽略,不影响代码可读性。
• 很容易复用同一个 builder 创建相似但略有不同的对象。

更复杂的情况：带有子对象的复杂对象

比如一个 Car 类，包含 Engine、Wheels、GPS 等子对象，建造者模式可以让你逐步构建这些子部件：

$car = (new CarBuilder())
    ->setEngine(new V8Engine())
    ->addWheel(new WinterWheel(17))
    ->addWheel(new WinterWheel(17))
    ->addWheel(new WinterWheel(17))
    ->addWheel(new WinterWheel(17))
    ->setGPS(new PremiumGPS())
    ->paint('红色')
    ->build();

建造者模式 vs 其他构造方式

什么时候用建造者模式？

• 对象有大量可选参数（5 个以上）。
• 构造参数有很多 null 或默认值。
• 对象的构造需要分步骤完成（比如先设基础属性，再设子对象）。
• 想要创建不同配置的对象,但配置过程类似。
• 对象一旦构建就不应该被修改（Immutable 对象），此时你只能通过建造者模式构建，而不能暴露 setter。

一个真实世界的类比

建造者模式就像去餐厅点定制套餐：

• 直接构造函数：你对着菜单报一串数字：“我要 4 号套餐加辣不加葱加蛋不要番茄酱盐少一半……” —— 容易出错且不优雅。
• 建造者模式：服务员拿着点单板问你：“主食要什么？……饮品呢？……有哪些忌口？” 你一步一步回答，最后服务员确认：“好的，您的定制餐马上就好。” 每一步都很清晰,且可以跳过某些步骤。

✅ 建造者模式非常适合 PHP 中构建复杂对象
✅ 它解决的是可读性、灵活性、可维护性的问题
✅ 尤其适合不可变对象（Immutable）、参数很多、构造步骤有顺序的场景
✅ 在大型项目、框架（如 Laravel 的查询构造器、Symfony 的配置构建等）中广泛使用

如果你的对象只有 3-4 个必须参数，或者很少变化，直接用构造函数就好——不要过度设计，但一旦你发现构造函数参数超过 5 个、有很多可选 null、或者经常需要改变构造方式,那就是引入建造者模式的好时机了。