PHP 8.1 中自动加载函数文件的关键是通过 Composer 的 "files" 配置显式声明，路径需相对 composer.json、为 .php 文件，修改后须执行 composer dump-autoload。
PHP 8.1 中自动加载函数文件（非类）的关键，不在于“写个 autoload 函数”，而在于**让 Composer 的 PSR-4 或 files 加载机制覆盖到你的函数文件**。PHP 本身不支持对普通函数做命名空间级的自动加载，必须通过配置显式声明。
用 "files" 方式直接加载函数文件
这是最直接、最可靠的方式，适合工具函数、辅助函数等全局可用、无需实例化的代码。
- 在 composer.json 的
autoload或autoload-dev下添加"files"数组 - 路径必须是相对于
composer.json的相对路径，且为 .php 文件（不能是目录） - 执行
composer dump-autoload后，这些文件会在每次请求时被require_once加载一次
示例：
{
"autoload": {
"psr-4": { "App\": "src/" },
"files": ["helpers/functions.php", "app/defines.php"]
}
}
PSR-4 不适用函数文件，但可间接支持
PSR-4 只处理类、接口、trait，它不会、也不能自动加载纯函数文件。但你可以把函数“包进类里”再加载：
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 将函数封装为 static 方法（如
class StrHelper { public static function slug($s) { ... } }） - 按 PSR-4 规则命名空间和路径（如
AppHelpersStrHelper→src/Helpers/StrHelper.php） - 这样既保持函数复用性，又享受自动加载和 IDE 支持
避免常见路径匹配错误
函数文件路径写错，会导致 composer dump-autoload 成功但运行时报“函数未定义”。重点检查：
- 路径中不要有
./或多余斜杠（如"./helpers/functions.php"→ 应写"helpers/functions.php"） - 文件实际存在且可读；Windows 下注意大小写（
Functions.php≠functions.php） - 如果放在
autoload-dev，测试环境才加载，Web 请求或 CLI 主流程可能不生效 - 修改后务必运行
composer dump-autoload，否则配置不生效
开发中快速验证是否加载成功
不用等业务逻辑触发，可立即验证：
- 写一行
echo "loaded ";在函数文件顶部，执行php -r "require 'vendor/autoload.php';" - 或在脚本开头加
var_dump(get_included_files());，看列表里有没有你的函数文件 - 用
function_exists('your_helper_function')直接判断
