php 不支持函数按需加载，因内核不拦截函数调用；autoload.files 是唯一机制，仅通过 require_once 无条件预加载指定文件，路径须相对 composer.json、修改后须手动执行 composer dump-autoload，且文件严禁含副作用代码。

不支持。PHP 本身没有函数按需加载机制，Composer 的 autoload.files 只能无条件加载整个文件，调用前必须已存在所有函数。

为什么不能“按需加载函数”

PHP 内核只对未定义类触发 autoload 回调，但对函数调用不做任何拦截——my_helper() 执行时若函数未声明，直接报 Fatal error: Uncaught Error: Call to undefined function，不会走 Composer 或任何自动加载流程。

• PSR-4、classmap 都只处理 class、interface、trait，完全忽略文件里的函数
• autoload.files 是唯一入口，但它在 require vendor/autoload.php 时就 require_once 所有列出的文件，不是“调用时才加载”
• 试图在 PSR-4 类文件里混写全局函数？Composer 不保证该文件被加载，函数依然不可用

autoload.files 配置必须注意的三件事

它看似简单，但路径错、没 dump、有副作用，三者任一都会导致函数“明明写了却找不到”，且不报错。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 路径必须相对于 composer.json 所在目录，写 "src/helpers.php"，不能写 "./src/helpers.php" 或 "/full/path/src/helpers.php"
• 改完 composer.json 后必须手动运行 composer dump-autoload，否则 vendor/composer/autoload_files.php 不更新，函数永远不生效
• 文件里禁止运行时副作用：不能 echo、不能 file_get_contents、不能 new 实例——这些代码会在 CLI 命令、测试启动、甚至 phpunit --version 时就被执行

多个函数文件怎么安排顺序

files 数组顺序 = 实际 require_once 执行顺序，直接影响常量和函数可用性。

• 先加载 "config/constants.php"（定义 define('APP_ENV', 'dev')），再加载 "src/Helpers/functions.php"（里面用到了 APP_ENV）
• 反过来就会报 Use of undefined constant APP_ENV，甚至因逻辑错误导致后续函数注册失败
• 同名函数会被后加载的覆盖，如两个文件都定义 str_slug()，后者生效；没加 function_exists() 防护会直接 Fatal error

测试里函数报错的真正原因

不是 Composer 配错了，而是测试环境没正确引入自动加载器。

• PHPUnit 默认只 require vendor/autoload.php，但如果你的 files 配置没生效（漏了 dump-autoload），函数就不存在
• 检查 phpunit.xml 的 bootstrap 是否指向 vendor/autoload.php；不要在测试文件里手动 require 'src/helpers.php'，这绕过自动加载且易重复定义
• 并行测试工具（如 ParaTest）可能隔离 autoloader，需确认其是否复用同一份 autoload_files.php

真正麻烦的不是配置，而是误以为“函数可以像类一样懒加载”。一旦把初始化逻辑、I/O 操作塞进 files 文件，问题会在最意想不到的时机爆发——比如在生成 API 文档或运行静态分析时突然连接数据库失败。