单个键名可用lcfirst(ucwords(str_replace('_', ' ', $key)))转小驼峰;多维数组需手写递归遍历,跳过数字键;array_change_key_case仅预处理大小写混用;第三方camelize行为不一,Laravel推荐Str::camel()。

用 lcfirst() + ucwords() 组合处理单个键名
PHP 没有内置函数直接批量转换下划线键名为驼峰,但单个键名可以靠字符串函数快速搞定:ucwords() 先让每个单词首字母大写,str_replace() 去掉下划线,再用 lcfirst() 把第一个字母转小写。注意顺序不能反,否则首字母会变大写。
常见错误是漏掉 lcfirst(),导致结果变成 UserLoginTime 而不是 userLoginTime;或者误用 ucfirst() 替代 lcfirst(),造成首字母重复大写。
-
ucwords('user_login_time', '_')→'User_Login_Time'(注意它不自动替换分隔符) - 必须接
str_replace('_', '', ...)才能得到'UserLoginTime' - 最后一定要
lcfirst(...),否则不符合小驼峰规范
遍历数组递归转换所有键名(含多维)
实际项目里数组往往嵌套,比如 API 返回的 user_info 里还有 created_at。这时候得写个递归函数,对每一层的键名做转换,值为数组时继续深入。
别直接用 array_walk_recursive() —— 它只遍历叶子节点的值,不暴露键名,没法改 key。必须手写递归或用 array_keys() + array_values() 拆解重组。
- 用
foreach ($arr as $key => $value)拿到原始键名,转换后作为新 key - 判断
is_array($value)决定是否递归调用自身 - 新数组用
[$newKey => $newValue]语法构建,避免键名丢失 - 如果原数组是数字索引,跳过转换(避免把
0、1当成字符串处理)
用 array_change_key_case() 之前先确认是否真需要它
array_change_key_case() 只能转大小写,不能动下划线。有人误以为它能“标准化键名”,结果发现 user_name 还是 user_name,没变成 userName。它只对 USER_NAME 或 User_Name 有效。
如果你的原始数据是全大写下划线(如数据库字段 CREATED_AT),可先用它统一转小写,再走驼峰逻辑;但若本来就是小写下划线,这步纯属多余,还可能意外覆盖已有小写键名。
-
array_change_key_case($arr, CASE_LOWER)是安全的预处理,仅当源键含大小混用时才需要 - 不要和驼峰转换链式连用:它不返回引用,且不处理下划线
- 它的性能开销很小,但加了它不代表“更健壮”,只是适配特定输入格式
第三方包如 camelize 的兼容性坑
有些 Composer 包(如 symfony/property-access 或独立 camelize 工具类)提供 camelize() 方法,但行为不统一:有的默认转大驼峰(UserLoginTime),有的要求传参指定小驼峰;有的把连续下划线(user__name)当作一个词,有的拆成三个单词。
最常踩的坑是没看文档默认行为,上线后发现 api_token 变成 ApiToken 而不是 apiToken,导致前端取不到字段。
- 调用前务必查清该函数是否支持
$lowerCamel = true参数 - 测试用例至少覆盖:单下划线、双下划线、开头/结尾下划线(如
_id、name_) - 如果项目已用 Laravel,优先用
Str::camel()—— 它明确按小驼峰设计,且自动 trim 下划线
真正麻烦的不是转换逻辑本身,而是混合场景:比如数组里既有下划线键,又有已驼峰的键,还有数字索引。这时候硬统一转容易破坏结构,得加白名单或类型判断。别图省事写个全局替换函数就往所有接口响应上套。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











