首页 › 论坛 › 二次开发 › 正文

插件包结构与 plugin.json 字段,逐个说明哪些不能少

二次开发 回复 1 浏览 62 最后回复 11-07 08:22

正文

#1 楼主帖
插件包是 public 下一个自包含文件夹,主程序靠 plugin.json 认它。字段写错或者漏了,提交预检和后台列表都会读不到,退回文案会点名是哪一项。

plugin.json 必须是一个标准 JSON 对象:别写注释,别用单引号,格式错了解析直接失败。里面的字段一条条说:
name 是插件机器名,只能字母、数字、下划线和短横线,1 到 40 位,还要等于标识 ID 里那段目录名;
entry 是入口文件,不写就默认是同名的 name.php,它得是包里的一个 php 文件,不能带 ..,也不能指到包外面;
class 是主类名,要符合 PHP 类名规则,形如 DTR 命名空间下 Plugins 里的那个类;
title、version、author、desc 这几项后台列表和商店页都要读,少一项都不让过。

要建数据表的插件,在 plugin.json 里声明 tables,建表跟着导入走,不用手工建库。开关和设置写在自己的 config.json 里,换服务器连目录一起拷走就带走了。

打包规则和模板一样严:根目录唯一、里面有 plugin.json、入口文件必须在包里、路径合法。插件只通过钩子和路由挂进主程序,动了核心文件的直接退回。加插件就是把整个文件夹放进 public 目录,后台刷新就能看到,删文件夹就是卸载。

全部回复

共 1 条 · 第 1 / 1 页
老 老李 #2

老李 11-07 08:22

补充 entry 最常见的一种错:name 写成带短横线的机器名,插件文件也在包里,但上传时把入口文件重命名成了 index.php,预检找不到同名的那个 php 就退回。两种改法:把文件名改回和 name 一致,或者在 plugin.json 里把 entry 显式写成实际文件名。别把入口放到子目录里,路径带不上跳就过不了。

我要回复

支持加粗、列表、引用和代码块
回帖要先登录会员账号。 去登录 注册一个