thinkphp扩展需手动注册命名空间、配置加载路径并声明门面或服务，否则报class not found；扩展统一放extend/目录，需在common.php中用loader::addnamespace注册，门面调用需定义门面类、配置映射并清缓存，自定义配置须置于config/extra/下。

ThinkPHP 扩展不是“丢进目录就能用”，必须手动注册命名空间、配置加载路径、声明门面（Facade）或插件服务，否则会直接报 Class not found。核心就三点：类要声明正确命名空间、框架要知道它在哪、调用方式得配对。

扩展文件放哪？命名空间怎么写？

扩展代码统一放在项目根目录的 extend/ 目录下（不是 app/ 或 vendor/）。比如你想写一个工具类：

• 路径：extend/utils/ArrayHelper.php
• 文件开头必须声明命名空间：namespace extendutils;
• 类名首字母大写，如 class ArrayHelper
• 不能漏掉 declare(strict_types=1);（TP8 推荐）

怎么让框架认出这个类？

ThinkPHP 默认不扫描 extend/ 目录。你需要在 app/common.php（或服务提供者的 register() 方法）里显式注册：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 用 Loader 注册命名空间：Loader::addNamespace('utils', EXTEND_PATH . 'utils/');
• 之后就能直接 new：new utilsArrayHelper()
• 如果想省略前缀，可加别名：class_alias('extend\utils\ArrayHelper', 'ArrayHelper');

想用门面（Facade）调用？三步不能少

比如想写 ArrayHelper::filter($arr) 而不是 new 实例，需完整走三步：

• 新建门面类：app/facade/ArrayHelper.php，内容含 protected static function getFacadeClass() { return 'extend\utils\ArrayHelper'; }
• 在 config/app.php 的 'facade' => [] 数组里加映射：'array_helper' => appacadeArrayHelper::class
• 清缓存：php think clear:all，再调用 ArrayHelper::filter(...)

配置文件怎么生效？

扩展自带的配置（如 alipay.php、wechat.php）不能放 config/ 下，必须：

• 放到 config/extra/alipay.php（注意 extra 子目录）
• 文件内容只能是 return ['app_id' => 'xxx', 'secret' => 'yyy'];
• 读取时用 config('alipay.app_id')，框架会自动合并

不复杂但容易忽略

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！