ThinkPHP系统扩展开发教程-ThinkPHP-PHP中文网

thinkphp 的 extend/ 目录需手动注册命名空间、配置、服务等才能使用：类须声明命名空间并用 loader::addnamespace() 注册；facade 需重写 getfacadeclass() 并在 config/app.php 映射；配置文件必须放 config/extra/ 下且返回数组；插件需在 providers 或 provider.php 中显式注册。

thinkphp系统扩展开发教程

ThinkPHP 的 extend/ 目录不是“插件安装区”，直接丢文件进去就用，90% 会报 Class not found。它默认不扫描、不自动加载、不注册命名空间——你得手动告诉框架“这些类在哪、叫什么、怎么调”。

extend/ 目录里的类为什么 new 不出来？

因为 ThinkPHP 默认只加载 app/、vendor/ 和配置的自动加载路径，extend/ 完全被忽略。

类文件必须声明命名空间，比如 extend/mylib/Helper.php 要写 namespace extend\mylib;
调用时不能省略命名空间前缀，得写 new extend\mylib\Helper()（除非你注册了别名）
更常用的做法是在 app/common.php 或服务提供者的 register() 方法里加：
Loader::addNamespace('mylib', EXTEND_PATH . 'mylib/');
之后就能用 new mylib\Helper()
如果用了 PHP8+，注意 Loader 类在 TP8 中已迁移到 think\facade\Loader，但底层仍支持旧调用方式；推荐统一用 think\Loader 防止兼容问题

想封装成门面（Facade）却报 getFacadeClass 未定义？

这是扩展封装中最常踩的坑：只写了 Facade 类，没重写 getFacadeClass()，框架根本不知道该代理到哪个真实类。

btpanel phpsite 宝塔面板PHP网站

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

下载

假设你的工具类是 extend\utils\JsonFormatter，那么门面类 app\facade\JsonFormatter 必须包含：
protected static function getFacadeClass() { return 'extend\utils\JsonFormatter'; }
然后在 config/app.php 的 'facade' => [] 数组里加映射：
'json_formatter' => app\facade\JsonFormatter::class
最后才能在任意地方调用 JsonFormatter::format($data)
漏掉任何一步，都会触发 Fatal error: Call to undefined method getFacadeClass()

扩展自带的配置文件（如 alipay.php）放 config/ 下不生效？

ThinkPHP 只合并 config/extra/ 目录下的同名 PHP 文件，config/alipay.php 是无效路径。

正确路径是 config/extra/alipay.php，内容必须是纯 return []; 数组，不能有 echo、var_dump 或执行逻辑
读取方式仍是 config('alipay.app_id')，和内置配置完全一致
多环境配置不要在 extra/alipay.php 里做 if (APP_ENV === 'prod') 判断——应拆成 config/extra/alipay_dev.php 和 config/extra/alipay_prod.php，框架会按 APP_ENV 自动加载对应文件
若扩展包本身带配置（如 topthink/think-queue），它不会自动复制进 config/，需手动从 vendor/topthink/think-queue/config/queue.php 复制过去

composer require 装完插件，use 还是报错？

装上了 ≠ 注册了。Composer 只负责下载和自动加载，但 ThinkPHP 的服务、Facade、事件监听器等，必须由服务提供者（Service Provider）显式注册。

检查 config/app.php 的 'providers' 数组，确认是否加入了类似 think\captcha\CaptchaService::class 的条目
打开 composer.json，搜 dont-discover：如果值是 ["*"]，说明全局禁用了自动发现，删掉这行或改成精确列表（如 ["topthink/framework"]）
部分插件（如 think-queue）不带服务提供者，或者提供者未启用，就得自己在 app/provider.php 里手动追加
命令行指令（如 php think queue:work）要生效，还必须在 config/console.php 的 'commands' 里注册，否则 php think 根本不认识