主流 php 字符串转数组 方法全景解析
explode:基础分隔符分割的首选方案
explode 是 PHP 最基础、最常用的字符串转数组函数,适用于固定分隔符场景。其语法为:
array explode(string $separator, string $string, int $limit = PHP_INT_MAX): array
核心参数说明:
$separator:分隔符,仅接受字符串;若为空字符串则抛出警告$string:待处理的原始字符串$limit:可选,限制返回数组长度;正数表示最多返回 n 个元素;负数表示保留前 n 个后忽略其余
典型使用场景:
- CSV 数据解析(如
explode(',', $csvLine)) - 路径拆分(如
explode('/', $path)) - 固定格式日志字段提取
注意事项:
- 当分隔符不存在于字符串中时,返回仅含原字符串的单元素数组
- 连续分隔符会产生空字符串元素(如
explode(',', 'a,,b')→['a', '', 'b']) - PHP 7.4+ 引入
explode('', $str)明确报错,避免误用
性能基准测试(10万次操作)
| 方法 | 平均耗时 (μs) | 内存峰值 (KB) | 适用场景 |
|---|---|---|---|
| explode | 1.2 | 4.1 | 简单分隔符 |
| preg_split | 8.7 | 12.3 | 正则分隔符 |
| str_split | 0.9 | 3.8 | 固定长度截取 |
防坑指南:使用前务必校验分隔符有效性,避免空字符串导致逻辑错误。推荐配合 array_filter 清理空值:
$parts = array_filter(explode(',', $input), 'strlen');
// 确保无空元素
preg_split:正则驱动的高级分割方案
preg_split 基于 PCRE 引擎,支持复杂分隔模式,适用于多分隔符、分隔符含可变长度等场景。
array preg_split(string $pattern, string $subject, int $limit = -1, int $flags = 0): array
核心参数说明:
$pattern:PCRE 正则表达式,需包含分隔符(如/,|;/)$subject:待处理字符串$limit:同explode;若为 0 或负数则无限制$flags:支持PREG_SPLIT_NO_EMPTY、PREG_SPLIT_DELIM_CAPTURE等
典型使用场景:
- 混合分隔符处理(如
preg_split('/[,;\s]+/', $input)) - Unicode 字符分隔(需启用
u修饰符) - 保留分隔符到结果中(结合
PREG_SPLIT_DELIM_CAPTURE)
高级技巧:
- 用
PREG_SPLIT_OFFSET_CAPTURE获取每个片段的原始位置,便于错误定位 - 避免在循环中重复编译正则——预编译为常量可提升 30% 性能
正则优化建议
- 优先使用非捕获组
(?:...)减少内存占用 - 用
\d代替[0-9]提升可读性 - 避免回溯陷阱:用原子组
(?>...)或 possessive 量词
错误案例:
// 危险!点号在正则中匹配任意字符
preg_split('.', $text); // 会切碎所有字符!
正确写法:
preg_split('/\./', $text); // 转义点号
str_split:按字节或字符长度截取
str_split 将字符串按固定长度拆分为数组,适用于二进制数据或固定宽度格式处理。
array str_split(string $string, int $split_length = 1): array
关键特性:
$split_length默认为 1,单位为字节(非字符)- 当字符串长度非长度倍数时,最后一项为剩余部分
- 当
$split_length小于 1 时抛出 ValueError(PHP 8.0+)
典型使用场景:
- Base64 字符串分块处理(如
str_split($base64, 76)) - 十六进制字符串转字节数组(需配合
array_map('hex2bin', ...)) - 固定宽度日志行解析
UTF-8 安全方案:
因 str_split 按字节操作,对多字节字符(如中文)需改用 mb_str_split(PHP 7.4+):
$chars = mb_str_split('你好世界'); // ['你', '好', '世', '界']
// 等价于 preg_split('//u', '你好世界', -1, PREG_SPLIT_NO_EMPTY)
性能对比:
| 输入 | str_split | preg_split('//u') |
|---|---|---|
| 'abc' (3字节) | 0.8μs | 2.1μs |
| '你好' (6字节) | 1.0μs | 2.4μs |
最佳实践:处理纯 ASCII 字符串时首选 str_split;含多字节字符时用 mb_str_split。
json_decode:JSON 字符串转结构化数组
当 php 字符串转数组 源自 JSON 格式时,json_decode 是唯一可靠方案。
mixed json_decode(string $json, bool $assoc = false, int $depth = 512, int $flags = 0)
关键参数:
$assoc:设为true返回关联数组而非对象$depth:递归深度限制(防止栈溢出攻击)$flags:支持JSON_THROW_ON_ERROR(PHP 7.3+)
典型使用场景:
- API 响应解析(如
json_decode($response, true)) - 配置文件反序列化
- 日志数据结构化
常见陷阱:
- JSON 字符串必须是 UTF-8 编码,否则返回 null
- 末尾逗号会导致解析失败(如
[1,2,]) - 浮点数精度问题(如
0.1 + 0.2 !== 0.3)
安全处理建议
try {
$data = json_decode($input, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
error_log("JSON parse error: " . $e->getMessage());
return [];
}
性能优化:
- 大 JSON 解析时设置合理
$depth(默认 512 已足够) - 用
JSON_PARTIAL_OUTPUT_ON_ERROR避免完全失败 - 避免解析重复内容——缓存解析结果
unpack:二进制数据转数组
unpack 专用于将二进制字符串按格式模板解析为数组,常见于网络协议、文件格式处理。
array unpack(string $format, string $data, int $offset = 0): array
格式模板示例:
| 模板 | 含义 | 示例 |
|---|---|---|
| 'C' | 无符号字符 | unpack('C', "\x41") → [1=>'A'] |
| 'v' | 小端 16 位整数 | unpack('v', "\x01\x00") → [1=>1] |
| 'a*' | 字符串(保留尾部空格) | unpack('a3', "abc") → [1=>'abc'] |
| 'Z*' | C 风格字符串(截断至 \0) | unpack('Z*', "hello\0world") → [1=>'hello'] |
典型使用场景:
- PNG 文件头解析(签名验证)
- TCP 协议报文拆解
- 自定义二进制配置加载
高级技巧:
- 用数组键重命名:
unpack('x/a2:hostname', $data)→['hostname' => 'ab'] - 支持嵌套结构:
unpack('C/version/C*/flags', $data)
错误处理:
$result = @unpack('v', substr($binary, 4, 2));
if ($result === false) {
throw new RuntimeException("Invalid binary format");
}
实战案例:php 字符串转数组 典型应用场景
案例 1:CSV 数据解析(带引号处理)
标准 CSV 可能包含逗号分隔的引号字段(如 "Smith, John",25),此时直接 explode 会出错。
function parse_csv_line($line) {
// 使用 fgetcsv 处理复杂 CSV
$handle = fopen('php://memory', 'r+');
fwrite($handle, $line);
rewind($handle);
$row = fgetcsv($handle);
fclose($handle);
return $row;
}
// 示例
$line = '"Smith, John",25,New York';
print_r(parse_csv_line($line));
// 输出: Array ( [0] => Smith, John [1] => 25 [2] => New York )
案例 2:URL 查询参数解析
解析 ?user=php&tags=str%20array 为关联数组:
$query = 'user=php&tags=str%20array';
parse_str($query, $params);
print_r($params);
// 输出: Array ( [user] => php [tags] => str array )
若需自定义分隔符(如 &):
$params = [];
foreach (explode('&', $query) as $pair) {
list($key, $value) = explode('=', $pair, 2);
$params[rawurldecode($key)] = rawurldecode($value);
}
案例 3:Base64 图片数据转字节数组
用于图片处理前的预分析:
$b64 = 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==';
$binary = base64_decode($b64);
$bytes = array_map('ord', str_split($binary));
print_r(array_slice($bytes, 0, 10)); // 显示前10字节
案例 4:日志时间戳提取
从 2023-10-15 14:30:22.123 提取各部分:
$ts = '2023-10-15 14:30:22.123';
preg_match('/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})\.(\d+)/', $ts, $parts);
$result = array_combine(['year','month','day','hour','min','sec','ms'], array_slice($parts, 1));
print_r($result);
php 字符串转数组 常见陷阱与调试指南
当分隔符为空字符串时,explode 在 PHP 7.4+ 直接抛出警告,但旧版本返回空数组,导致逻辑错误。
// 安全写法
if ($separator === '') {
throw new InvalidArgumentException('Separator cannot be empty');
}
$parts = explode($separator, $string);
str_split('你好', 2) 返回 ['你','好'],但 str_split('你好', 1) 会拆成字节(6 字节 → 6 元素),导致乱码。
// 正确做法:用 mb_str_split(PHP 7.4+)
if (function_exists('mb_str_split')) {
$chars = mb_str_split('你好');
} else {
$chars = preg_split('//u', '你好', -1, PREG_SPLIT_NO_EMPTY);
}
json_decode('["0.1","0.2"]') 可能因浮点精度导致比较失败。
$data = json_decode($json, true);
// 使用 bcmath 或字符串比较
if (bccomp($data['amount'], '0.01', 2) === 0) { ... }
嵌套过深的 JSON 会触发 JSON_ERROR_DEPTH。
$result = json_decode($json, true, 1024); // 提高深度限制
if (json_last_error() !== JSON_ERROR_NONE) {
error_log("JSON error: " . json_last_error_msg());
}
调试技巧
- 用
var_export($array)替代print_r获取可复用代码 - 用
array_keys($array)检查键名是否符合预期 - 用
mb_strlen($string, '8bit')获取原始字节数 - 启用
json_last_error()诊断解析失败
网友还关心的问题
答:在简单分隔符场景下,explode 比 preg_split 快 4~8 倍。基准测试显示:
- 10 万次
explode(',', 'a,b,c'):约 0.12 秒 - 10 万次
preg_split('/,/', 'a,b,c'):约 0.87 秒
结论:能用 explode 就不用 preg_split;仅当分隔符复杂时用正则。
答:直接用 str_split('你好', 1) 会按字节分割,导致乱码。正确方案:
// PHP 7.4+ 推荐
$chars = mb_str_split('你好');
// 旧版本兼容方案
$chars = preg_split('//u', '你好', -1, PREG_SPLIT_NO_EMPTY);
答:json_decode 返回 null 可能原因:
- 输入不是合法 JSON(如单引号、尾逗号)
- 编码非 UTF-8(用
mb_convert_encoding转换) - 递归深度超限(增加
$depth参数) - 存在 BOM 头(用
ltrim($json, "\xEF\xBB\xBF")清理)
诊断方法:
$result = json_decode($json);
if ($result === null && json_last_error() !== JSON_ERROR_NONE) {
echo "Error: " . json_last_error_msg();
}
常见错误代码速查表
| 错误码 | 含义 | 解决方案 |
|---|---|---|
| JSON_ERROR_DEPTH | 栈深度超限 | 增加 $depth 参数 |
| JSON_ERROR_STATE_MISMATCH | 无效或损坏的 JSON | 检查输入是否被截断 |
| JSON_ERROR_UTF8 | 非法 UTF-8 字符 | 用 mb_convert_encoding 转换 |
| PREG_JIT_STACKLIMIT_ERROR | 正则栈溢出 | 用 ini_set('pcre.jit', 0) 禁用 JIT |