將字串依特定分隔符拆分為陣列是資料處理的基礎操作。PHP 提供多種函式,各有適用場景。本文系統整理 explode()、preg_split()、str_getcsv() 等函式的用法、效能與陷阱。
適用於固定單一字元分隔符,不支援正則。
<?php
$csv = 'apple,banana,orange,grape';
$arr = explode(',', $csv);
// ['apple','banana','orange','grape']
// 限制分割筆數(第三參數)
$str = 'a,b,c,d,e';
explode(',', $str, 3); // ['a', 'b', 'c,d,e'] 正數:最多返回 n 個
explode(',', $str, -2); // ['a', 'b', 'c'] 負數:排除最後 n 個
注意:分隔符為空字串會拋出 ValueError (PHP 8+) 或回傳 false。
適用於多種分隔符、或需保留分隔符的場景。
<?php
// 多種分隔符:逗號、分號、空白
$str = 'apple, banana; orange grape';
$arr = preg_split('/[,;\s]+/', $str);
// ['apple','banana','orange','grape']
// 保留分隔符(PREG_SPLIT_DELIM_CAPTURE)
$arr = preg_split('/([,;])/', 'a,b;c', -1, PREG_SPLIT_DELIM_CAPTURE);
// ['a', ',', 'b', ';', 'c']
// 保留位移資訊(PREG_SPLIT_OFFSET_CAPTURE)
$arr = preg_split('/,/', 'a,b', -1, PREG_SPLIT_OFFSET_CAPTURE);
// [['a',0], [',',1], ['b',2]]
正確處理引號包裹、欄位內含分隔符/換行的標準 CSV 格式。
<?php
$csvLine = 'id,name,desc
1,"Apple, Inc.","Fruit, red
sweet"';
$rows = array_map('str_getcsv', explode("\n", $csvLine));
/*
[
['id','name','desc'],
['1','Apple, Inc.','Fruit, red\nsweet']
]
*/
優勢:自動處理雙引號跳脫、換行符、前後空白,符合 RFC 4180 標準。
$str = 'id=123&name=John&tags=php,laravel,api';
// 方案 A:兩層 explode
parse_str($str, $arr); // PHP 內建,直接解析查詢字串
// ['id'=>'123','name'=>'John','tags'=>'php,laravel,api']
// 方案 B:手動處理(特殊格式)
$pairs = explode('&', $str);
$result = [];
foreach ($pairs as $pair) {
[$k, $v] = explode('=', $pair, 2) + [null, ''];
$result[$k] = $v;
}
| 函式 | 簡單分割 | 正則分割 | CSV 解析 |
|---|---|---|---|
| explode() | ~0.03s ⭐ | N/A | N/A |
| preg_split() | ~0.12s | ~0.15s ⭐ | ~0.18s |
| str_getcsv() | ~0.08s | N/A | ~0.10s ⭐ |
explode() 按位元組分割,中文分隔符會錯亂 → 改用 preg_split('/' . preg_quote($sep, '/') . '/u', $str)explode(',', 'a,,b') 會產生空字串元素,array_filter() 可移除explode("\n", file_get_contents(...)) 一次載入記憶體,改用 fgets() 或 SplFileObject 逐行讀取explode()preg_split()str_getcsv() 或 fgetcsv()parse_str()SplFileObject 迭代器模式