ThinkPHP加载工具类_工具类自动加载法【详解】-ThinkPHP-PHP中文网

class "apputilsarrhelper" not found 是因该类未在 composer.json 的 "autoload": {"psr-4": {...}} 中注册，tp6 完全依赖 composer 的 psr-4 机制加载应用类，文件路径、命名空间、类名须严格匹配，且需执行 composer dump-autoload -o 生效。

thinkphp加载工具类_工具类自动加载法【详解】

ThinkPHP 6+ 项目里，工具类（比如 app/utils/ArrHelper.php）默认不会自动加载，直接 new apputilsArrHelper 会报 Class "apputilsArrHelper" not found——这不是框架坏了，是它压根没被 Composer 知道。

为什么 new AppUtilsArrHelper() 找不到类？

TP6 不再用自己写的一套 Loader::addNamespace() 去管应用层类，而是完全交由 Composer 的 PSR-4 加载机制。你写的工具类如果不在 composer.json 的 "autoload": {"psr-4": {...}} 里注册，Composer 就当它不存在。

常见错误现象：Class "apputilsArrHelper" not found、Attempted to load class "DateHelper" from namespace "apputils"
命名空间声明必须和物理路径严格对齐：文件在 app/utils/ArrHelper.php，就必须写 namespace apputils;（注意末尾无），不能写 AppUtils 或 apputils
文件名必须首字母大写且与类名一致：ArrHelper.php 对应 class ArrHelper，写成 arrhelper.php 或 Arrhelper.php 在 Linux 服务器上必失败
改了命名空间或加了新类后，不运行 composer dump-autoload -o，改动就无效

如何让 app/utils 下的工具类被自动加载？

唯一正解：编辑项目根目录的 composer.json，补全 PSR-4 映射，然后刷新 autoload。

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

打开 composer.json，在 "autoload": {"psr-4": {...}} 里加一行："app\utils\": "app/utils/"（注意双反斜杠转义，末尾带和 /）
确保路径是相对项目根目录的，不要写成 ./app/utils/ 或绝对路径
执行命令：composer dump-autoload -o（加 -o 是为了生成优化映射，开发环境也建议加，否则某些 IDE 补全或调试可能不识别）
验证是否生效：运行 composer show --platform | grep autoload，或临时写个 var_dump(class_exists('apputilsArrHelper'));

extend/ 目录下的工具类能自动加载吗？

不能，默认不参与 PSR-4 扫描。TP6 的 extend/ 是“手动加载区”，不是自动加载区。

如果你把 qrcode.php 放进 extend/qrcode.php，想用 new QrCode()，必须先配 autoload 或改路径
方案一（推荐）：把它移到 app/tools/，并在 composer.json 中加 "app\tools\": "app/tools/"
方案二（兼容旧代码）：在 composer.json 的 "autoload": {"classmap": ["extend/"]} 下添加，然后运行 composer dump-autoload -o（注意：classmap 是全量扫描，加了大目录会影响 dump 速度）
方案三（临时救急）：用 Loader::import('qrcode', EXTEND_PATH);，但这是 TP5 风格，TP6 不鼓励，且无法被 IDE 正确识别类型

vendor 里的第三方包加载失败怎么办？

这不是 ThinkPHP 的问题，是 Composer 加载链断了。入口文件里漏引 vendor/autoload.php 是最常见原因。

检查 public/index.php 开头是否包含：require __DIR__ . '/../vendor/autoload.php';（TP6 默认有，但你若重写过入口，可能删掉了）
运行 composer show overtrue/pinyin 看实际安装版本，有些新版已把 OvertruePinyinPinyin 改成 OvertruePinyinGenerator
某些老包用的是 classmap 而非 PSR-4，必须加 -o 才生效：composer dump-autoload -o
别在 config/app.php 里瞎配 autoload_namespace——TP6 已弃用该配置项