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 還原、保留型別 | 輸出冗長、含結構字元 | 除錯輸出、快取序列化 |
| 自訂遞迴函數 | 完全可控:過濾、編碼、深度限制、格式 | 需自行維護測試 | 安全日誌、審計追蹤、特殊格式需求 |
chmod 640、屬於專用使用者、非 Web 根目錄logrotate 或 Monolog 處理器避免磁碟爆滿將 POST 資料字串化是除錯與審計的基礎需求。http_build_query() 滿足 80% 場景;涉及安全合規時,自訂遞迴函數配合敏感欄位遮罩、深度限制、資源型別處理是更專業的選擇。建議封裝為獨立工具類別,整合至統一日誌系統(如 Monolog),統一管理輸出格式與儲存策略。