# 第 06 章 插件(Addons)开发实战 ## 6.1 插件体系简介 Addons 是 FastAdmin 的功能分发单位:一个插件可以包含控制器、模型、视图、JS、配置与安装 SQL,即插即用、可卸载、可上架官方市场。 插件位于根目录 `addons/插件标识/`,标识为小写字母开头的目录名,如 `addons/myblog/`。 ## 6.2 插件目录结构 ``` addons/myblog/ ├── Myblog.php # 插件主类(必须,类名=目录名首字母大写) ├── info.ini # 插件信息 ├── config.php # 插件配置(可在后台修改) ├── install.sql # 安装时执行的 SQL ├── LICENSE ├── bootstrap.js # 前端钩子注入脚本 ├── controller/ # 插件控制器 ├── model/ ├── view/ └── lang/ ``` ### info.ini ```ini name = myblog title = 我的博客 intro = 一个演示插件 author = 你的名字 version = 1.0.0 state = 1 url = /myblog ``` ### 主类 Myblog.php ```php ', '', $content); } ``` 安装插件时钩子会自动注册到 `application/extra/addons.php`。 ## 6.5 插件内使用 CRUD 插件同样支持一键 CRUD: ```bash php think crud -t myblog_post -c myblog/post --addon=myblog ``` 生成的控制器继承 `app\common\controller\Backend`,访问路径为 `/admin/myblog/post/index?ref=addtabs`,插件后台菜单需在 `info.ini` 或后台插件配置中登记。 ## 6.6 配置项 `config.php` 返回数组即可在后台「插件管理 → 配置」中可视化编辑: ```php return [ ['name' => 'per_page', 'title' => '每页数量', 'type' => 'number', 'value' => '10', 'tip' => ''], ['name' => 'audit', 'title' => '开启审核', 'type' => 'radio', 'options' => ['1' => '是', '0' => '否'], 'value' => '1', 'tip' => ''], ]; ``` 代码中读取: ```php $config = get_addon_config('myblog'); $perPage = $config['per_page']; ``` ## 6.7 打包与发布 ```bash php think addon -a myblog -c package ``` 生成 zip 包。发布到官方市场需遵守命名、目录与安全规范,确保 `install.sql` 使用 `__PREFIX__` 占位表前缀: ```sql CREATE TABLE `__PREFIX__myblog_post` ( ... ); ``` ## 6.8 开发建议 - 业务功能优先做成插件,避免直接改动核心代码,便于升级 - 插件 SQL 一律使用 `__PREFIX__`,不要硬编码 `fa_` - 卸载时清理自己的数据表与 `fa_auth_rule` 中登记的菜单节点 ## 本章小结 插件 = 主类 + ini + 可选的 MVC 与钩子。掌握生成命令、生命周期与配置机制,就能把任何功能封装成可复用插件。下一章转向 API 接口开发。