ucwords()可将字符串每个单词首字母转大写,默认以空白字符分隔;php 8.3+支持自定义分隔符;多字节字符需用mb_convert_case(mb_case_title);预处理空白和保护缩写可提升准确性。

如果您需要将字符串中每个单词的首字母转换为大写,PHP 提供了内置函数 ucwords() 来实现这一操作。以下是关于该函数的具体使用方式和注意事项:
一、基础用法:直接调用 ucwords()
ucwords() 函数默认以空白字符(空格、制表符、换行符等)作为单词分隔符,将每个单词的首字母转为大写,其余字母保持原样。
1、定义一个包含多个单词的小写字符串,例如 $str = "hello world php";
2、调用 $result = ucwords($str);
立即学习“PHP免费学习笔记(深入)”;
3、输出 $result,结果为 "Hello World Php"。
二、自定义分隔符:使用 ucwords() 的第二个参数
从 PHP 8.3.0 开始,ucwords() 支持可选的第二个参数,用于指定自定义分隔符集合,从而在非空格分隔的字符串中正确识别单词边界。
1、定义字符串 $str = "hello-world_php";
2、调用 $result = ucwords($str, "-_");
3、输出 $result,结果为 "Hello-World_Php"。
三、处理多字节字符:结合 mb_convert_case()
ucwords() 基于单字节 ASCII 实现,对中文、日文、俄文等多字节字符不生效;如需支持 UTF-8 编码下的多语言首字母大写,应改用 mb_convert_case() 并指定 MB_CASE_TITLE。
1、确保已启用 mbstring 扩展,可通过 extension=mbstring 检查 php.ini 配置。
2、定义字符串 $str = "café naïve résumé";
3、调用 $result = mb_convert_case($str, MB_CASE_TITLE, 'UTF-8');
4、输出 $result,结果为 "Café Naïve Résumé"。
四、预处理去除多余空白:配合 trim() 和 preg_replace()
当输入字符串含有连续空格、制表符或不可见 Unicode 空白时,ucwords() 可能产生异常分词;需先标准化空白再执行首字母大写。
1、定义字符串 $str = " hello world \t php \n";
2、先清理空白:$clean = preg_replace('/\s+/', ' ', trim($str));
3、再执行首字母大写:$result = ucwords($clean);
4、输出 $result,结果为 "Hello World Php"。
五、避免误转缩写:手动跳过特定小写模式
ucwords() 无法识别英文缩写(如 "PHP", "ID", "URL"),会将其强制转为 "Php", "Id", "Url";若需保留原始大写缩写,须在调用前进行正则替换保护。
1、定义字符串 $str = "the php id url handler";
2、预先将目标缩写替换为带标记的临时占位符:$temp = preg_replace('/\b(php|id|url)\b/i', '###UPPER:$1###', $str);
3、执行 ucwords($temp) 得到初步结果;
4、再将占位符还原为全大写形式:$result = preg_replace('/###UPPER:(\w+)###/', strtoupper('$1'), $temp_result);











