函數簽名
implode(string $separator, array $array): string
// 歷史兼容:implode(array $array): string (不推薦)
參數詳解
$separator:分隔符,**可選**,默認空字符串 ''。建議顯式傳遞以提高可讀性。
$array:待拼接數組,**必需**。鍵名會被忽略,僅按順序取值。
基礎示例
$arr = ['H', 'I', 'J', 'K!'];
echo implode('m ', $arr); // Hm Im Jm K!
echo implode(' ', $arr); // H I J K!
echo implode('', $arr); // HIJK!
echo implode(',', $arr); // H,I,J,K!
進階場景
1. SQL IN 子句構建(防注入版)
$ids = [1, 3, 5, 7];
$placeholders = implode(',', array_fill(0, count($ids), '?')); // ?,?,?,?
$stmt = $pdo->prepare("SELECT * FROM users WHERE id IN ($placeholders)");
$stmt->execute($ids);
2. 生成 CSV 行
$row = ['張三', '25', '北京', '工程師'];
echo implode(',', array_map(fn($v) => '"' . str_replace('"', '""', $v) . '"', $row)) . "\n";
3. 路徑拼接
$parts = ['home', 'user', 'docs', 'file.txt'];
$path = implode(DIRECTORY_SEPARATOR, $parts); // 跨平台兼容
性能對比
implode 為 C 級函數,極快。
- 手動
foreach 拼接字符串($str .= $sep . $val)慢 3-5 倍且易出現首尾分隔符多餘問題。
對比:explode() 反向操作
$str = 'a,b,c';
$arr = explode(',', $str); // ['a','b','c']
// 注意:explode 不支持參數順序互換,separator 必須在前
常見錯誤
- 傳入非數組(對象/標量)會拋出
TypeError(PHP 8+)或警告。
- 多維數組直接 implode 會觸發
Array to string conversion Notice,需先 array_map 展平或遞歸處理。