ThinkPHP插件开发_创建HelloWorld示例插件【方法】-php教程-PHP中文网

插件需严格按目录名与入口文件名匹配（如helloworld目录下必须有helloworld.php），并定义含name、title、identifier、version、author的$info数组，否则后台不显示；install()须返回true且runtime可写，路由需手动绑定。

thinkphp插件开发_创建helloworld示例插件【方法】

直接在 addons 目录下建目录、写入口文件、继承 Addons 类、实现 install() 和 uninstall()，就能让插件被系统识别——但缺了 $info 数组，后台不会显示插件信息，安装按钮也不会出现。

ThinkPHP 插件机制靠目录名和入口文件名双重校验。比如插件叫 HelloWorld，就必须：

在 addons/ 下新建目录 HelloWorld（注意大小写，不能是 helloworld 或 hello-world）
在该目录下新建入口文件 HelloWorld.php（文件名必须与目录名完全一致，且后缀是 .php，不是 .class.php 或其他）
文件内命名空间必须是 addons\HelloWorld，类名必须是 HelloWorld，且继承 \app\common\controller\Addons

常见错误：目录名用下划线（hello_world），文件名写成 index.php 或 main.php，命名空间漏掉 addons\ 前缀——这些都会导致插件不被扫描到，后台列表里压根看不到。

没有 $info，插件类即使能加载，也会被系统跳过。这个数组不是可选配置，而是插件元信息的强制契约。必须包含以下键：

'name'：纯英文标识符，建议全小写+下划线，如 'hello_world'（注意：和目录名可以不同，但推荐一致）
'title'：后台显示的中文标题，如 'Hello World 示例插件'
'identifier'：全局唯一 ID，格式为 "插件名.开发者标识.plugin"，例如 'hello_world.lwwan.plugin'；重复会导致安装失败
'version'：三段式版本号，如 '1.0.0'；后续升级依赖此字段比对
'author'：作者名，不能为空

漏掉任意一项（尤其是 identifier 或 version），插件在后台“插件管理”页就不会出现，也触发不了 install() 方法。

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

下载

点击安装按钮没反应，或提示“安装失败”，大概率不是代码问题，而是环境卡点：

runtime/ 目录不可写：ThinkPHP 插件安装过程会写日志、生成缓存、甚至创建数据库表（如果插件有 $admin['table_name']）。Linux 下常见 chmod -R 755 runtime 不够，得给 775 或至少确保 Web 进程用户（如 www-data 或 nginx）有写权限
应用缓存未清除：修改插件后，ThinkPHP 会缓存插件列表。执行 php think clear 或手动删掉 runtime/cache/ 下所有文件
install() 返回值不是 true：该方法必须显式 return true;，返回字符串、空数组、null 都算失败

特别注意：install() 里不要做耗时操作（如远程请求、大文件读写），它是在 HTTP 请求周期内同步执行的，超时会导致安装中断且无明确报错。

插件本身不自动暴露 URL 路由。若想提供前端页面或 API 接口，必须手动绑定路由。例如，在插件目录下新增 route.php 文件（与 HelloWorld.php 同级）：

return [
    'hello' => 'addons/HelloWorld/index/index',
];

然后访问 /hello 就会路由到插件内的 addons\HelloWorld\controller\Index 类的 index 方法。这个路由文件不是必需的，但没它，插件就只是后台的一个开关，无法对外提供服务。

最易忽略的一点：插件里的控制器类，命名空间必须是 addons\HelloWorld\controller，而不是 app\index\controller；否则即使路由配对成功，也会因自动加载失败而抛出 ClassNotFoundException。

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

ThinkPHP插件开发_创建HelloWorld示例插件【方法】