PHP最佳实践：如何将大型函数拆分为多个独立小函数

原代码的核心问题是把通用导出流程和平台专属的格式规则完全耦合在同一个函数里：每个平台分支都重复实现「写表头→遍历数据→写行」的完全相同逻辑，新增平台、调整字段映射、新增导出格式都需要直接修改主函数的switch分支，越改越臃肿。按照单一职责原则把通用能力和差异逻辑拆分即可，不需要引入复杂的设计模式。

把代码按职责边界拆成独立小函数，主函数只负责流程调度，不写具体业务逻辑：

• 通用基础能力（数据库连接、文件打开、通用写入流程）抽成公共函数，所有平台共用，不保留重复代码
• 平台专属差异（表头定义、单行字段映射）单独抽离，和通用流程完全解耦
• 新增平台/导出格式时，不需要修改已有核心流程代码，只需要追加对应差异逻辑即可

1. 通用基础能力函数 #

这部分逻辑和具体平台无关，全导出场景复用：

/**
 * 获取导出业务的数据库连接实例
 */
function getExportDbConnection()
{
    return new MysqliDb(TEST_DB_HOSTNAME, TEST_DB_USERNAME, TEST_DB_PASSWORD, TEST_DB_DATABASE);
}

/**
 * 初始化导出文件句柄，统一处理文件创建失败逻辑
 */
function getExportFileHandle(string $fileName)
{
    $fullPath = DOWNLOAD_FILE_PATH . $fileName;
    $handle = fopen($fullPath, 'wb');
    if (!$handle) {
        die(json_encode([
            "status" => "error",
            "errMessage" => "Error while downloading file!"
        ]));
    }
    return $handle;
}

/**
 * 通用CSV写入逻辑，所有平台复用同一套遍历写入流程
 */
function writeCsv($fileHandle, array $header, array $rawData, callable $rowFormatter)
{
    // 写入表头
    fputcsv($fileHandle, $header);
    // 遍历写入行数据，仅通过传入的格式化函数处理平台差异
    foreach ($rawData as $row) {
        $formattedRow = call_user_func($rowFormatter, $row);
        fputcsv($fileHandle, $formattedRow);
    }
    fclose($fileHandle);
}

2. 平台专属逻辑 #

每个平台的表头配置、字段映射规则单独维护，互不干扰：

/**
 * 获取指定平台的导出表头配置
 */
function getPlatformHeader(string $platform): array
{
    $headerMap = [
        'magento' => [
            // 原magento分支的表头数组填在这里
        ],
        'catch' => [
            // 原catch分支的表头数组填在这里
        ],
        'amazon' => [
            // 新增Amazon平台直接在这里加表头配置即可
        ]
    ];

    if (!isset($headerMap[$platform])) {
        die(json_encode([
            "status" => "error",
            "errMessage" => "Unsupported export platform: {$platform}"
        ]));
    }
    return $headerMap[$platform];
}

/**
 * Magento平台单行数据格式化
 */
function formatMagentoRow(array $rawRow): array
{
    return [
        // 原magento分支的csvData字段映射填在这里
    ];
}

/**
 * Catch平台单行数据格式化
 */
function formatCatchRow(array $rawRow): array
{
    return [
        // 原catch分支的csvData字段映射填在这里
    ];
}

/**
 * 获取指定平台对应的行格式化函数
 */
function getPlatformRowFormatter(string $platform): callable
{
    $formatterMap = [
        'magento' => 'formatMagentoRow',
        'catch' => 'formatCatchRow',
        'amazon' => 'formatAmazonRow' // 新增平台在这里加格式化函数映射即可
    ];

    if (!isset($formatterMap[$platform])) {
        die(json_encode([
            "status" => "error",
            "errMessage" => "No format rule for platform: {$platform}"
        ]));
    }
    return $formatterMap[$platform];
}

3. 重构后的主函数 #

主函数只做流程串接，没有冗余逻辑：

function exportFile($fileName, $platform, $option)
{
    // 初始化依赖
    $db = getExportDbConnection();
    $fileHandle = getExportFileHandle($fileName);

    // 拉取原始数据（如果后续不同平台查询条件不同，把这部分也抽成对应平台的查询函数即可）
    $rawData = $db->rawQuery("SELECT * FROM database");

    // 获取当前平台的规则配置
    $header = getPlatformHeader($platform);
    $rowFormatter = getPlatformRowFormatter($platform);

    // 统一写入文件
    writeCsv($fileHandle, $header, $rawData, $rowFormatter);
}

• 如果后续需要支持.txt格式导出，只需要新增一个和writeCsv平级的writeTxt通用写入函数，在主函数里根据文件后缀分发即可，不需要修改任何平台相关的配置和格式化逻辑
• 如果后续单平台的导出逻辑复杂度上升（比如需要加数据校验、特殊值转换、平台专属查询条件），可以把每个平台的逻辑封装成独立的适配器类，不需要调整现有通用流程
• 所有配置和逻辑按职责拆分后，排查问题不需要通读全函数：表头错误直接改getPlatformHeader的对应配置，某列数据映射错误直接找对应平台的format函数即可

内容的提问来源于stack exchange，提问作者Soyas