0

0

PHP如何将下划线命名的字符串转为驼峰命名_PHP命名风格转换函数编写

下次还敢

下次还敢

发布时间:2025-09-16 14:21:01

|

1059人浏览过

|

来源于php中文网

原创

答案:文章介绍了在PHP中将下划线命名转换为驼峰命名的方法,主要通过编写convertUnderlineToCamelCase函数实现小驼峰和大驼峰两种格式,处理了空字符串、连续下划线、首尾下划线等边界情况,并对比了explode/implode与正则两种实现方式的优劣,最后提到框架如Laravel提供了内置辅助函数(如Str::camel和Str::studly)来简化该操作,推荐在实际项目中优先使用。

php如何将下划线命名的字符串转为驼峰命名_php命名风格转换函数编写

将下划线命名的字符串转换为驼峰命名,这在PHP开发中是相当常见的需求,尤其是在处理数据库字段名或者API接口参数时。简单来说,这个过程就是找到字符串中的下划线,然后将下划线后面的第一个字母大写,同时移除下划线本身。比如

user_name
变成
userName
,或者
product_id
变成
productId
。这不仅仅是命名风格的转换,更是为了让代码保持一致性,提高可读性。

解决方案

编写一个PHP函数来实现这个转换,通常我们会考虑到两种驼峰命名:小驼峰(

lowerCamelCase
,首字母小写)和大驼峰(
UpperCamelCase
,首字母大写,也称Pascal Case)。这里我们主要实现小驼峰,并提供一个选项来生成大驼峰。

 $part) {
        // 过滤空部分,例如 'foo__bar' 或 '_foo'
        if ($part === '') {
            continue;
        }

        // 第一个部分的处理:
        // 如果是小驼峰,则首字母小写;如果是大驼峰,则首字母大写。
        // 但要注意,这里是针对整个转换结果的首字母,而不是每个分割后的part。
        // 实际操作中,通常是第一个part保持原样(或lcfirst),后续part ucfirst。
        if ($index === 0 && !$capitalizeFirstChar) {
            $camelCaseParts[] = lcfirst($part); // 确保第一个单词的首字母小写
        } else {
            $camelCaseParts[] = ucfirst($part); // 其他单词首字母大写
        }
    }

    // 合并所有部分
    return implode('', $camelCaseParts);
}

// 示例用法:
// echo convertUnderlineToCamelCase('user_first_name'); // 输出: userFirstName
// echo convertUnderlineToCamelCase('product_id', true); // 输出: ProductId
// echo convertUnderlineToCamelCase('_leading_underscore'); // 输出: leadingUnderscore
// echo convertUnderlineToCamelCase('trailing_underscore_'); // 输出: trailingUnderscore
// echo convertUnderlineToCamelCase('__double_underscore__'); // 输出: doubleUnderscore
// echo convertUnderlineToCamelCase('simple'); // 输出: simple
// echo convertUnderlineToCamelCase(''); // 输出:
// echo convertUnderlineToCamelCase('alreadyCamelCase'); // 输出: alreadyCamelCase

我个人觉得,使用

explode
implode
的组合,配合
ucfirst
lcfirst
,这种方式既直观又高效,在大多数情况下表现得相当不错。逻辑清晰,也容易理解。

命名风格转换的必要性:统一与可读性

我们为什么会频繁地进行命名风格的转换?这背后其实是编程实践中对“统一性”和“可读性”的追求。想想看,如果一个项目里,数据库字段是

snake_case
(下划线命名),PHP变量是
camelCase
,JavaScript变量又是
kebab-case
(短横线命名),那每次从一个层级跳到另一个层级,大脑就得做一次“翻译”。这无疑增加了认知负担,降低了开发效率,也更容易出错。

立即学习PHP免费学习笔记(深入)”;

统一的命名风格,无论是在团队协作还是个人维护代码时,都能显著提升代码的可读性。它就像是一种约定,让所有参与者都遵循相同的“语言习惯”。比如,在PHP生态中,变量名、函数名通常推荐使用小驼峰,类名和接口名使用大驼峰。而数据库字段名,出于历史原因或某些ORM的默认设置,往往倾向于下划线命名。当我们需要从数据库获取数据并映射到PHP对象时,这种转换就显得尤为关键。它让数据从“数据库的世界”平滑地过渡到“PHP应用的世界”,减少了摩擦。

应对复杂情况:非标准分隔符与多重转换

在实际开发中,我们遇到的字符串可能不总是那么“规矩”,仅仅包含下划线。比如,有时可能会遇到用短横线(

-
)分隔的字符串,如
my-product-name
,或者字符串中夹杂着数字、特殊符号,甚至空字符串和连续的下划线。

我上面提供的

convertUnderlineToCamelCase
函数,已经考虑了几个常见的特殊情况:

GitHub Copilot
GitHub Copilot

GitHub AI编程工具,实时编程建议

下载
  • 空字符串或非字符串输入: 直接返回空字符串,避免不必要的错误。
  • 不含下划线的字符串: 如果输入本身就是驼峰命名或者没有下划线,函数会根据
    $capitalizeFirstChar
    参数,直接处理首字母后返回,避免过度处理。
  • 连续下划线(如
    foo__bar
    )或首尾下划线(如
    _foo
    foo_
    ):
    explode('_', $inputString)
    会产生空字符串的数组元素。我的
    foreach
    循环中的
    if ($part === '') { continue; }
    语句有效地过滤掉了这些空元素,确保了结果的正确性,例如
    _leading_underscore
    会正确转换为
    leadingUnderscore

但如果遇到其他分隔符,比如短横线

my-product-name
,那么现有的函数就无能为力了。这时,可能需要一个更通用的函数,或者在调用前先进行一次预处理,将短横线替换成下划线,再进行驼峰转换。例如:

// 假设有一个将短横线转为下划线的函数
function convertKebabToUnderline(string $inputString): string {
    return str_replace('-', '_', $inputString);
}

// 然后可以这样组合使用
// $kebabString = 'my-product-name';
// $underlinedString = convertKebabToUnderline($kebabString); // my_product_name
// $camelCaseString = convertUnderlineToCamelCase($underlinedString); // myProductName

这种链式转换在处理多重命名风格时非常实用,也体现了函数设计的单一职责原则。

效率与灵活性:正则替换与框架辅助函数

除了

explode
implode
的组合,PHP中还有其他实现方式,其中最常见的就是使用正则表达式。正则替换在处理更复杂的模式匹配和替换时,展现出其强大的灵活性。

正则方法的优点在于其简洁性,一行代码就能完成核心转换逻辑。但它也有其局限性,比如处理连续下划线或首尾下划线时,需要更精细的正则模式或额外的

ltrim
处理。从性能角度看,对于简单的分隔符替换,
explode
/
implode
通常比正则更快,因为正则引擎的开销相对较大。不过,对于现代PHP版本,这些性能差异在大多数非极端场景下都可以忽略不计。

再者,如果你在使用像Laravel、Symfony这样的PHP框架,那么恭喜你,它们通常都内置了非常方便的字符串处理辅助函数。例如,Laravel的

Illuminate\Support\Str
类提供了
Str::camel()
Str::studly()
方法,可以直接实现小驼峰和大驼峰的转换。

// Laravel 示例
// use Illuminate\Support\Str;
//
// $camelCase = Str::camel('user_first_name'); // userFirstName
// $pascalCase = Str::studly('product_id'); // ProductId

使用框架提供的函数是首选,它们经过了严格测试,性能优化,并且能保证项目内部命名风格的一致性。只有在没有框架或需要定制化程度更高的场景下,我们才需要自己编写这类转换函数。选择哪种方法,最终还是取决于项目的具体需求、性能考量以及个人或团队的偏好。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
PHP Symfony框架
PHP Symfony框架

本专题专注于PHP主流框架Symfony的学习与应用,系统讲解路由与控制器、依赖注入、ORM数据操作、模板引擎、表单与验证、安全认证及API开发等核心内容。通过企业管理系统、内容管理平台与电商后台等实战案例,帮助学员全面掌握Symfony在企业级应用开发中的实践技能。

78

2025.09.11

laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

319

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

278

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

372

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

374

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

85

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

65

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

68

2025.08.05

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.8万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号