正文
#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 目录,后台刷新就能看到,删文件夹就是卸载。
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 显式写成实际文件名。别把入口放到子目录里,路径带不上跳就过不了。