插件不加载
1. 路径对不对:backend/plugins/<slug>/plugin.php(多一层目录就不认);
2. plugin.json 是不是合法 JSON(用 php -r 'var_dump(json_decode(file_get_contents("plugin.json")));' 看一下);
3. 后台插件列表里状态是不是「已启用」;
4. 有没有被熔断:插件管理页看故障原因,点「清除熔断」。
钩子没生效
addFilter必须 return 值;只 return 不 echo、只 echo 不 return 都不对;- 钩子名拼写:对照「扩展点清单」,注意是
plugin_render_footer而不是footer; - 注册代码必须在加载时就执行(不要包在
if (isset($_GET[...]))里); - 页面可能被整页缓存:先强刷(Ctrl/Cmd + Shift + R)。
接口返回 405 / UNKNOWN_ACTION
- 405:方法不匹配(写接口用 POST;读接口要声明
'method' => 'GET'); - UNKNOWN_ACTION:路由没注册上 —— 检查插件是否启用、action 名是否合法(小写字母/数字/下划线)。
数据库报错 no such table
安装钩子没跑或没建表。在 onInstall 里调用 pluginCreateTable(),并在入口文件里也做一次幂等 ensure(老站点升级时可能不会重新触发安装)。
中文乱码 / JSON 解析失败
文件保存为 UTF-8 无 BOM;json_encode 时加 JSON_UNESCAPED_UNICODE。
提交被拒:包结构不合法
常见原因:zip 里多了一层文件夹、没有 plugin.json、缺 plugin.php、版本号带 v 前缀(应写 1.0.0)、超过 8MB、包含 .mp4/.exe 等被禁止的文件。
想改已上架的版本号怎么办
不能覆盖已发布版本。递增版本号提交新版本,旧版本会保留给已经安装的站点升级用。
我的插件能不能收费
目前市场只做「审核上架 + 一键安装」,不支持支付。商业化需求可以先在插件页留项目主页。