php函数名调用时不区分大小写,如strlen、strlen、strlen均可正常运行,但定义时必须保持一致;推荐始终使用小写以保证可维护性、工具兼容性和框架规范。

PHP 函数名不区分大小写
PHP 中调用函数时,strlen、STRLEN、StrLen 都能正常运行——语言层面对函数名做的是不区分大小写的解析。这不是“推荐写法”,而是 PHP 解析器实际行为。
但要注意:这只是针对「用户定义函数」和「内置函数」的调用阶段;函数定义本身仍需保持一致(比如你写了 function MyFunc(),就不能在定义处写成 function myfunc(),那会直接报错),而调用时可以随意变大小写。
为什么建议始终小写函数名
虽然不区分大小写,但混用大小写会让代码难以维护,尤其在团队协作或使用静态分析工具时:
-
phpstan和psalm会把非常规大小写当成风格问题甚至潜在错误 - IDE(如 PhpStorm)默认按小写索引函数,大写调用可能丢失自动补全或跳转
- Composer 加载的第三方库(如
monolog)全部采用小写函数/方法名,混用易造成认知断层 - PHP 8.0+ 引入的 JIT 编译器虽不依赖大小写,但函数名哈希表初始化仍以小写为标准键,非小写调用多一次 strtolower 开销(微乎其微,但存在)
容易踩的坑:类方法 vs 普通函数
函数名不区分大小写,但类中的方法名在调用时——仍然不区分大小写。这点很多人误以为“类方法区分”,其实不是。
立即学习“PHP免费学习笔记(深入)”;
真正区分大小写的只有:class 名、interface 名、trait 名、以及命名空间里的部分标识符(如 MyNamespace\SomeClass 中的 SomeClass 是区分大小写的)。而 $obj->getData() 和 $obj->GETDATA() 在 PHP 中是等价的(只要类里定义的是 getData)。
但注意这个陷阱:
- 如果类中同时定义了
getData()和GETDATA(),PHP 会报Fatal error: Cannot redeclare—— 因为解析器认为这是重复声明同一个方法 - Windows 文件系统不区分大小写,所以
require 'Foo.php'和require 'foo.php'都能加载;但 Linux 下若文件实际叫Foo.php,而代码写require 'foo.php'就会失败 —— 这和函数名无关,是文件系统层面的问题
PSR-12 和现代框架的实际约束
PHP-FIG 的 PSR-12 明确要求:函数名必须使用小写加下划线(my_function)或驼峰(myFunction),但「不得混合大小写」。Laravel、Symfony 等主流框架全部遵循小写驼峰(str_replace 是例外,因继承自 PHP 内置)。
这意味着:即使语法允许 STR_REPLACE,你在 Laravel 项目里这么写,php-cs-fixer 会立刻把它改回 str_replace;CI 流程也可能因此失败。
更关键的是:扩展函数(如 mb_strlen)和原生函数(如 strlen)都只以小写形式出现在文档和源码中。偏离它,等于主动放弃可读性和协作基础。











