萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 將 POST 資料轉為字串函數:日誌記錄與除錯實用工具

需求場景

API 開發、表單處理、第三方回調調試時,需將 $_POST 多維陣列序列化為單一字串寫入日誌、資料庫或回傳前端。

遞迴實作:支援多維陣列扁平化

<?php
/**
 * 將 POST 陣列轉為 URL 編碼字串,支援多維陣列
 * 
 * @param array  $data 輸入陣列,預設 $_POST
 * @param string $prefix 遞迴用鍵名前綴
 * @return string 格式:key1=val1&key2=val2&parent[child]=val
 */
function postToString(array $data = [], string $prefix = ''): string {
    $data = $data ?: $_POST; // 預設取 $_POST
    $parts = [];

    foreach ($data as $key => $value) {
        $newKey = $prefix ? "{$prefix}[{$key}]" : $key;
        
        if (is_array($value)) {
            // 遞迴處理子陣列
            $parts[] = postToString($value, $newKey);
        } else {
            // 標準 URL 編碼
            $parts[] = urlencode($newKey) . '=' . urlencode((string)$value);
        }
    }

    return implode('&', $parts);
}

// 使用範例
$_POST = [
    'user' => [
        'name' => '小明',
        'age'  => 25,
        'tags' => ['php', 'laravel', 'vue']
    ],
    'action' => 'create',
    'token'  => 'abc123'
];

echo postToString();
// 輸出:
// user[name]=%E5%B0%8F%E6%98%8E&user[age]=25&user[tags][0]=php&user[tags][1]=laravel&user[tags][2]=vue&action=create&token=abc123
?>

進階版:支援檔案上傳與敏感資料過濾

<?php
function postToLogString(array $data = [], array $options = []): string {
    $defaults = [
        'exclude_keys'    => ['password', 'token', 'secret', 'credit_card'], // 敏感鍵名
        'mask_value'      => '***MASKED***',
        'max_depth'       => 10,
        'current_depth'   => 0,
        'encode_values'   => true,
    ];
    $opts = array_merge($defaults, $options);
    
    if ($opts['current_depth'] >= $opts['max_depth']) {
        return '[MAX_DEPTH_REACHED]';
    }
    
    $data = $data ?: $_POST;
    $parts = [];
    
    foreach ($data as $key => $value) {
        // 敏感欄位過濾
        if (in_array(strtolower($key), $opts['exclude_keys'])) {
            $parts[] = $key . '=' . $opts['mask_value'];
            continue;
        }
        
        if (is_array($value)) {
            $parts[] = postToLogString($value, [
                ...$opts,
                'current_depth' => $opts['current_depth'] + 1
            ]);
        } elseif (is_resource($value) || is_object($value)) {
            $parts[] = $key . '=' . $opts['mask_value'] . '_' . gettype($value);
        } else {
            $val = $opts['encode_values'] ? urlencode((string)$value) : (string)$value;
            $parts[] = $key . '=' . $val;
        }
    }
    
    return implode('&', $parts);
}

// 實際日誌寫入範例
function logPostRequest(): void {
    $logLine = sprintf(
        "[%s] %s %s %s\n",
        date('c'),
        $_SERVER['REQUEST_METHOD'] ?? 'CLI',
        $_SERVER['REQUEST_URI'] ?? '',
        postToLogString()
    );
    file_put_contents(
        __DIR__ . '/logs/post_' . date('Y-m-d') . '.log',
        $logLine,
        FILE_APPEND | LOCK_EX
    );
}
?>

替代方案比較

方法優點缺點適用場景
http_build_query()內建、支援多維、RFC 3986 標準無敏感欄位過濾、物件/資源會報警告一般表單提交、API 參數組裝
json_encode()結構完整保留、可讀性佳、支援 Unicode體積較大、非 URL 格式API 請求體日誌、複雜結構存儲
var_export()可直接 eval 還原、保留型別輸出冗長、含結構字元除錯輸出、快取序列化
自訂遞迴函數完全可控:過濾、編碼、深度限制、格式需自行維護測試安全日誌、審計追蹤、特殊格式需求

安全注意事項

  1. 必須過濾敏感欄位:密碼、Token、信用卡、個資等不可明文寫入日誌
  2. 日誌檔案權限:chmod 640、屬於專用使用者、非 Web 根目錄
  3. 日誌輪轉:使用 logrotate 或 Monolog 處理器避免磁碟爆滿
  4. GDPR/個資法合規:定期清理、匿名化、使用者刪除請求支援

總結

將 POST 資料字串化是除錯與審計的基礎需求。http_build_query() 滿足 80% 場景;涉及安全合規時,自訂遞迴函數配合敏感欄位遮罩、深度限制、資源型別處理是更專業的選擇。建議封裝為獨立工具類別,整合至統一日誌系統(如 Monolog),統一管理輸出格式與儲存策略。

copyright © 萬盛學電腦網 all rights reserved