Composer 不支持函数自动加载，仅支持类、接口、trait；唯一原生方式是通过 autoload.files 显式声明 PHP 文件路径，每次请求均 require_once 加载。
Composer 本身不支持函数自动加载，这是设计上的明确限制。它只管类（class）、接口（interface）、trait 的自动加载，函数必须显式 require 或通过 PSR-4/PSR-0 的“类文件”机制间接载入——但后者有严格前提。
为什么 Composer 不 autoload 函数
PSR-4 和 PSR-0 规范只定义了类名到文件路径的映射规则，没涉及函数。Composer 的 autoload 配置（如 "psr-4"、"classmap"）底层依赖的是 spl_autoload_register()，而该机制只在 new / instanceof / class_exists 等触发类查找时才调用，不会为裸函数名触发。
常见错误现象：Call to undefined function my_helper()，即使函数文件已放在 src/ 下且配置了 PSR-4，也不会被加载。
- 函数不能靠命名空间路径自动发现
-
composer dump-autoload -o对纯函数文件无效 - 试图在
autoload.files里漏写路径，会导致上线后直接报错
真正可行的函数自动加载方式：用 autoload.files
这是 Composer 唯一原生支持的函数加载途径——把含函数定义的 PHP 文件硬性列入启动加载列表，每次请求都会 require_once 它们。
使用场景：项目级工具函数（如 str_slug()、array_only()）、Laravel 风格的 helpers.php。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json中添加"autoload": { "files": ["src/helpers.php"] } - 文件路径必须是相对于
composer.json的，不能用../跨出项目根目录 - 修改后必须运行
composer dump-autoload（加-o不影响 files 加载） - 避免在
autoload.files中放有副作用的代码（比如直接执行 DB 查询），它会在所有 CLI/Web 请求中无条件执行
示例 src/helpers.php：
function array_except(array $array, array|string $keys): array
{
return array_diff_key($array, array_flip((array) $keys));
}
PSR-4 “假装加载函数”的边界操作（慎用）
有人把函数定义塞进一个同名类文件里（比如 src/Helpers/Str.php 中同时定义 class Str 和 function str_slug()），再靠 PSR-4 加载该类来顺带载入函数。这能工作，但属于 hack，问题明显：
- 违反单一职责：类文件不该承担函数定义职责
- 函数实际加载时机不可控（只有首次用到
Str类时才载入，不是启动时） - IDE 和静态分析工具无法识别这些“幽灵函数”，补全和类型检查失效
- 若类被 autoloader 跳过（如用了
class_exists('Str', false)），函数也不会加载
兼容性与性能提醒
autoload.files 是最稳妥的选择，但它带来的开销是固定的：每个 HTTP 请求或 CLI 命令都会完整 require_once 所列文件，无论其中的函数是否被调用。
容易被忽略的地方：
- 多个包共用 helpers 时，不要在各自
autoload.files里重复引入同一文件，否则会报Cannot redeclare - 测试环境若用
phpunit单独加载 bootstrap，需确认vendor/autoload.php是否已被包含，否则函数不可见 - 部署时若忘记
composer install --no-dev后再dump-autoload，可能因开发依赖的 autoload.files 干扰线上行为
函数加载这件事，没有银弹。要么接受 autoload.files 的确定性开销，要么老老实实 require，别指望 Composer 替你猜函数在哪。
