ThinkPHP扩展加载需按类型配置：LOAD_EXT_FILE加载无命名空间函数文件，LOAD_EXT_CONFIG加载配置文件，手动注册PSR-4命名空间加载类库，推荐用Composer管理第三方扩展。
ThinkPHP 加载扩展文件不是靠“自动发现”，而是依赖明确的配置或代码注册。核心原则是：路径要对、命名空间要准、加载时机要早。
通过 LOAD_EXT_FILE 配置加载函数文件
适用于无命名空间的工具函数类（如 helper.php、common.php）。需在应用配置中声明：
- 在 Application/Common/Conf/config.php 中添加：
'LOAD_EXT_FILE' => 'helper,upload,wechat'
表示加载 Application/Common/Common/ 目录下的helper.php、upload.php等文件。 - 这些文件必须返回数组或直接执行逻辑，不能定义类（否则会因无命名空间而无法 PSR-4 加载）。
- 注意：该机制不支持子目录，所有文件必须放在
Common/下的Common/子目录中。
通过 LOAD_EXT_CONFIG 加载配置文件
用于分离配置项，便于环境切换或模块化管理：
- 同样在
config.php中配置：'LOAD_EXT_CONFIG' => 'database,alipay,sms' - 对应文件路径为：
Application/Common/Conf/database.php、Application/Common/Conf/alipay.php 等。 - 每个文件需以
return [ ... ];形式返回配置数组；读取时直接用C('DB_HOST')或C('alipay.app_id')（若配置为'ALIPAY'=>'alipay'则启用二级键）。 - 修改后记得清空
Runtime/Cache/和Runtime/Conf/缓存，否则新配置不生效。
手动注册 PSR-4 命名空间加载扩展类库
这是加载带命名空间的自定义类（如 Org\Util\ArrayHelper）的唯一可靠方式：
立即学习“PHP免费学习笔记（深入）”；
- 在 application/common.php 或 public/index.php 开头处加入：
use think\Loader;Loader::addNamespace('Org', EXTEND_PATH . 'org/');Loader::addNamespace('ThirdParty', EXTEND_PATH . 'third-party/');- 确保目录结构与命名空间严格对应：
extend/org/Util/ArrayHelper.php→namespace Org\Util; - 路径末尾必须带
/，否则拼接错误；命名空间前缀不含反斜杠，但类文件内namespace必须完整。
用 Composer 管理第三方扩展（推荐）
现代项目应优先走 Composer 路线，避免手动维护路径：
- 在项目根目录执行：
composer require topthink/think-captcha - 确认入口文件
public/index.php包含：require __DIR__ . '/../vendor/autoload.php'; - 部分扩展需手动注册服务提供者（如
config/app.php的providers数组）或复制配置文件到config/目录。 - 改了
composer.json后，务必运行composer dump-autoload -o更新映射。
