PHP建造者模式

建造者模式：
将一个产品的内部表象和产品的生产过程分离，使同样的构建过程可以创建不同的产品。

建造者模式角色：
抽象建造者角色:定义一个抽象接口，规范产品各个组成成分的建造以及如何返回一个产品。
具体建造者角色:实现抽象建造者角色所定义的方法。
导演者角色：调用具体的建造者角色建造产品。
产品角色：在指导者的指导下由建造者所创建的那个对象。

在电商系统，需要导出商品数据，订单数据，客户数据等等数据，可以将导出的文件看作产品角色，导出商品数据，订单数据，客户数据等看作具体建造者角色。

本示例是Yii2.0实现

抽象建造者角色：

<?php
namespace common\services;

use common\services\ExportFileService;
use Yii;

/**
 * 导出类
 * Class BuilderService
 *
 * @package common\services
 */
abstract class BuilderService
{
    protected $fileObj;

    public function __construct() {
        $this->fileObj = new ExportFileService();
    }
    /**
     * 获取文件名
     * @return mixed
     */
    public abstract function getFileName();

    /**
     * 获取表头
     * @return mixed
     */
    public abstract function getHeader();

    /**
     * 获取要导出的数据
     * @return mixed
     */
    public abstract function queryData();

    /**
     * 获取导出文件
     * @return mixed
     */
    public abstract function getFile();
}

具体建造者角色：

<?php
namespace common\services;

use common\services\BuilderService;
use Yii;

/**
 * 订单导出类
 * Class OrderBuilderService
 *
 * @package common\services
 */
class OrderBuilderService extends BuilderService
{
    /**
     * 获取文件名
     * @return mixed|void
     */
    public function getFileName()
    {
        $fileName = 'order.csv';
        $this->fileObj->setFileName($fileName);
    }

    /**
     * 获取表头
     * @return mixed|void
     */
    public function getHeader()
    {
        $header = ['订单号','订单金额','下单日期'];
        $this->fileObj->setHeader($header);
    }

    /**
     * 获取要导出的数据
     * @return mixed|void
     */
    public function queryData()
    {
        $data = [['123456',1000,'2022-02-22']];
        $this->fileObj->setExportData($data);
    }

    /**
     * 获取导出文件
     * @return mixed
     */
    public function getFile()
    {
        return $this->fileObj;
    }
}

导演者角色：

<?php
namespace common\services;

use common\services\BuilderService;
use Yii;

/**
 * 导演者类
 * Class DirectorService
 *
 * @package common\services
 */
class DirectorService
{
    public function __construct(BuilderService $builder) {
        $builder->getFileName();
        $builder->getHeader();
        $builder->queryData();
    }
}

产品角色：

<?php
namespace common\services;

use Yii;

/**
 * 产品角色类
 * Class ExportFileService
 *
 * @package common\services
 */
class ExportFileService
{
    public $fileName;
    public $headerMap;
    public $exportData;

    /**
     * 设置文件名
     * @param $fileName
     */
    public function setFileName($fileName)
    {
        $this->fileName = $fileName;
    }

    /**
     * 设置表头
     * @param $header
     */
    public function setHeader($header)
    {
        $this->headerMap = $header;
    }

    /**
     * 设置导出的数据
     * @param $data
     */
    public function setExportData($data)
    {
        $this->exportData = $data;
    }

    /**
     * 输出文件
     * @return mixed
     */
    public function outputFile()
    {
        //将数据写入文件，省略...

        return  $this->fileName;
    }
}

测试：

<?php
namespace backend\controllers;

use common\services\DirectorService;
use common\services\OrderBuilderService;
use Yii;
use yii\web\Controller;

class BuilderTestController extends Controller
{
    /**
     * 测试
     */
    public function actionIndex()
    {
        $builder = new OrderBuilderService();
        $director = new DirectorService($builder);
        $product = $builder->getFile();
        $fileName = $product->outputFile();
        echo 'filename:'.$fileName;
    }
}