PHP 文件追加寫入與 XML 生成實戰：從基礎 API 到高併發安全模式

場景

定時任務、日誌記錄、數據導出、報表生成等場景常需將結構化數據以 XML 格式追加寫入文件。核心挑戰在於：原子性、併發安全、內存效率、編碼正確性、大文件性能。

基礎 API 回顧

原始代碼問題分析

');
fwrite($fp, '');
for ($i = 0; $i < $count; $i++) {
    $id = $result[$i]['ID'];
    $serviceid = $result[$i]['SERVICEID'];
    $downtime = $result[$i]['DOWNTIME'];
    $visittime = $result[$i]['VISITTIME'];
    // 直接拼接，無 XML 轉義，極高風險！
    fwrite($fp, "");
}
fwrite($fp, '');
fwrite($fp, '');
fclose($fp);

四大隱患

1. 併發競態：多進程同時 fopen('a') 寫入，XML 結構破壞（交織的標籤）。
2. 注入漏洞：數據未 XML 轉義，包含 < > & " ' 時導致 XML 解析失敗或注入。
3. 無原子性：寫入中斷（磁盤滿、進程被殺）產生殘缺 XML。
4. 內存/性能：循環內多次 fwrite 系統調用開銷大，大數據量應批次緩衝。

進階方案：原子寫入 + XMLWriter + 文件鎖

openMemory();
        $writer->setIndent(true);
        $writer->setIndentString('  ');
        $writer->startDocument('1.0', 'UTF-8');
        $writer->startElement('xml');
        $writer->startElement('data');

        foreach ($records as $rec) {
            $writer->startElement('ref');
            $writer->writeAttribute('id', (string)$rec['ID']);
            $writer->writeAttribute('serviceid', (string)$rec['SERVICEID']);
            $writer->writeAttribute('downtime', (string)$rec['DOWNTIME']);
            $writer->writeAttribute('visittime', (string)$rec['VISITTIME']);
            $writer->endElement(); // ref
        }

        $writer->endElement(); // data
        $writer->endElement(); // xml
        $writer->endDocument();

        $xml = $writer->outputMemory(true);
        if ($xml === false) throw new RuntimeException('XML 生成失敗');

        // 一次性寫入，減少系統調用
        if (fwrite($fp, $xml) === false) throw new RuntimeException('寫入失敗');
        if (fflush($fp) === false) throw new RuntimeException('刷新失敗');
        
        // 釋放鎖前確保數據落盤 (可選 fsync)
        // if (function_exists('fsync')) fsync($fp);

    } catch (Throwable $e) {
        flock($fp, LOCK_UN);
        fclose($fp);
        @unlink($tmpFile);
        error_log("XML 寫入失敗: {$e->getMessage()}");
        return false;
    }

    flock($fp, LOCK_UN);
    fclose($fp);

    // 原子重命名 (POSIX 保證同文件系統原子性)
    if (!@rename($tmpFile, $filePath)) {
        @unlink($tmpFile);
        return false;
    }
    return true;
}

// 使用示例
$records = [
    ['ID' => 1001, 'SERVICEID' => 'SVC001', 'DOWNTIME' => '2024-01-01 10:00:00', 'VISITTIME' => '2024-01-01 10:05:00'],
    ['ID' => 1002, 'SERVICEID' => 'SVC002', 'DOWNTIME' => '2024-01-01 11:00:00', 'VISITTIME' => '2024-01-01 11:10:00'],
];
writeXmlAtomically('/var/data/export/20240101.xml', $records);

關鍵技術點

• XMLWriter：內置擴展，自動處理實體轉義（< > & "）、編碼聲明、縮進格式化，零手工拼接風險。
• 臨時文件 + rename：POSIX 保證 rename() 在同一文件系統上原子性，讀者永遠看到完整文件或舊文件，無中間態。
• flock(LOCK_EX)：進程級獨佔鎖，防止多進程並發寫入衝突。NFS 環境下需配置 lockd 或改用數據庫。
• 內存緩衝輸出：openMemory() 將完整 XML 構建在內存，一次 fwrite 寫入，極大減少系統調用。

高併發/大數據量優化策略

讀取端最佳實踐

open('/var/data/export/20240101.xml');
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT && $reader->localName === 'ref') {
        $id = $reader->getAttribute('id');
        $serviceid = $reader->getAttribute('serviceid');
        // 處理單條記錄...
    }
}
$reader->close();

結語

文件追加寫入 XML 看似簡單，實則暗藏併發安全、注入防範、原子性、性能四大挑戰。採用 XMLWriter + 臨時文件原子重命名 + flock 獨佔鎖 組合拳，可構建生產級可靠的寫入管道。隨著數據規模增長，適時遷移至數據庫或對象存儲，才是長久之計——文件系統不是數據庫，不要試圖用它解決事務、索引、併發控制問題。