如何在 PHP 中实现同一方法的多次链式调用并累积结果-php教程-PHP中文网

如何在 PHP 中实现同一方法的多次链式调用并累积结果

本文讲解如何通过维护内部状态数组，使 PHP 类支持同一方法（如 addInput()）的多次链式调用，并真正累积每次调用生成的 HTML 片段，而非覆盖前次结果。

本文讲解如何通过维护内部状态数组，使 php 类支持同一方法（如 `addinput()`）的多次链式调用，并真正累积每次调用生成的 html 片段，而非覆盖前次结果。

在构建 Fluent Interface（流式接口）时，一个常见误区是认为只要方法返回 $this 就能自然“累积”行为——但若未显式保存每次调用产生的数据，链式调用只会反复修改同一属性，最终仅保留最后一次的结果。正如示例中 FormInputBuilder 的 addInput() 方法，它将生成的 HTML 赋值给 $this->label，导致前一次输入被完全覆盖。

要真正支持多次链式调用并保留全部输出，关键在于：将每次调用的结果追加到一个内部集合（如数组）中，而非覆盖单一属性。以下是重构后的专业实践：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

✅ 正确实现：使用私有数组累积输入项

<?php interface FormInputInterface
{
    public function addInput(
        string $inputType,
        string $placeholder,
        string $inputName,
        string $label = '',
        string $inputCssClasses = '',
        string $labelCssClasses = ''
    ): self;

    public function getInputs(): array;
}

class FormInputBuilder implements FormInputInterface
{
    private array $inputs = []; // 私有数组，安全存储所有生成的 HTML 输入片段

    public function addInput(
        string $inputType,
        string $placeholder,
        string $inputName,
        string $label = '',
        string $inputCssClasses = '',
        string $labelCssClasses = ''
    ): self
    {
        // 生成 label（如需）
        $inputLabel = $label !== '' 
            ? sprintf('<label for="%s">%s', htmlspecialchars($inputName), htmlspecialchars($label))
            : '';

        // 生成 input 标签（注意：对用户输入做基础转义防 XSS）
        $inputHtml = sprintf(
            '<input type="%s" name="%s" placeholder="%s" class="%s">',
            htmlspecialchars($inputType),
            htmlspecialchars($inputName),
            htmlspecialchars($placeholder),
            htmlspecialchars($inputCssClasses)
        );

        // 追加到内部数组（✅ 累积，非覆盖）
        $this->inputs[] = $inputLabel . $inputHtml;

        return $this; // 支持链式调用
    }

    public function getInputs(): array
    {
        return $this->inputs; // 提供只读访问
    }
}

✅ 使用方式：链式添加后统一获取结果

$formBuilder = new FormInputBuilder();

// 链式调用多次 addInput()
$elements = $formBuilder
    ->addInput(
        inputType:       'text',
        placeholder:     '',
        inputName:       'address',
        label:           '地址',
        inputCssClasses: 'd-block'
    )
    ->addInput(
        inputType:       'number',
        placeholder:     '请输入年龄',
        inputName:       'age',
        label:           '年龄',
        inputCssClasses: 'd-block'
    )
    ->addInput(
        inputType:       'email',
        placeholder:     'example@domain.com',
        inputName:       'email',
        label:           '邮箱',
        inputCssClasses: 'd-block'
    )
    ->getInputs(); // ? 最终一次性获取全部 HTML 字符串数组

// 输出验证
var_dump($elements);
// 结果包含 3 个独立的 HTML 字符串，顺序与调用一致

⚠️ 注意事项与最佳实践

安全性优先：示例中已加入 htmlspecialchars() 对所有用户可控参数（如 $inputName, $label）进行转义，避免 XSS 漏洞。生产环境切勿拼接未经处理的原始输入。
接口契约清晰：getInputs() 明确作为构建完成后的出口方法，符合 Fluent Interface 设计惯例（build → get）。
不可变性建议：若需更高健壮性，可让 getInputs() 返回副本（array_values($this->inputs)），防止外部意外修改内部状态。
扩展性预留：后续可轻松添加 removeInput(), getInput($name), 或 render()（直接输出完整 <form></form>）等方法，而无需破坏现有链式逻辑。