PSR-4仅加载类、接口、trait，不支持函数；函数必须通过autoload.files数组一次性引入，重复声明或手动require会导致“Cannot redeclare”错误。
PSR-4 自动加载不处理函数，autoload 配置里不能写函数
Composer 的 autoload 字段（包括 psr-4、psr-0、classmap）只负责类、接口、trait 的自动加载，**完全不支持函数**。你写在 composer.json 里的任何 autoload 配置，对全局函数（比如 helper_format_date()）都无效。
所以所谓“同名函数 autoload 冲突”，本质是误判——不是 Composer 加载时撞了，而是你手动 require 或 include 多次，或多个文件定义了同一个函数名，触发了 PHP 的 Fatal error: Cannot redeclare ...。
files 是唯一能加载函数的方式，但必须手动去重
如果真要让 Composer 自动加载函数，唯一合法入口是 autoload.files 数组。它会在 vendor/autoload.php 被引入时，**无条件、按顺序 require 所有列出的文件**。
- 每个文件只能被列一次，重复写进
files会导致重复 require，直接报错 - 不同包的
autoload.files可能互相冲突（比如两个第三方包都声明了helpers.php），这时 Composer 不做合并去重，而是按依赖顺序加载，后加载的会覆盖先加载的定义 - 你自己的函数文件建议统一放在
src/Functions/下，并只在根项目的composer.json中声明："autoload": { "files": ["src/Functions/helpers.php", "src/Functions/strings.php"] }
为什么 __autoload 或 spl_autoload_register 不能解决函数冲突
PHP 的自动加载机制（无论是老式 __autoload 还是现代 spl_autoload_register）**只响应类名查找**。当你调用一个未定义的函数时，PHP 根本不会触发任何 autoload 回调，而是直接抛出 Fatal error。
这意味着：
- 你无法靠注册 autoload 函数来“按需加载”函数文件
- 所有函数必须在调用前就已定义，要么提前
require，要么靠autoload.files在启动时一次性载入 - 想“隔离”函数命名空间？做不到。PHP 没有函数命名空间，只有类才有。函数名全局唯一
实际项目中最容易踩的坑
很多团队把工具函数散落在 app/helpers.php、common/functions.php、vendor/some-pkg/src/functions.php 里，然后靠各种方式 include，结果：
- ThinkPHP 的
helper()函数被多次加载，报Cannot redeclare helper() - CI3 开启
$config['composer_autoload'] = TRUE后，又在autoload.php里手动require APPPATH.'helpers/my_helper.php'，导致重复 - 两个 Composer 包都用了
"autoload": {"files": ["functions.php"]}，而它们的functions.php里定义了同名函数，安装顺序决定谁胜出，极难调试
最稳妥的做法：函数文件只进 autoload.files 一次，且确保内容不重复；所有第三方包若含函数，优先改造成静态方法（Helper::formatDate()），而不是裸函数。
