自己的数据表(能力 db)
php
// 表名会自动带上站点前缀,避免与核心表 / 其它插件冲突
$table = pluginTableName('my_plugin', 'logs'); // plugin_my_plugin_logs
// 老写法 pluginTableName('my_plugin') . '_logs' 也照样能用(第二个参数可选)
pluginCreateTable('my_plugin', 'logs',
'id INTEGER PRIMARY KEY AUTOINCREMENT, content TEXT, created_at TEXT');> 小提示:pluginCreateTable() 会先检查你是否声明了 db 能力,没声明会拒绝建表并写一条警告日志。
规则:
- 建表必须幂等(
CREATE TABLE IF NOT EXISTS由pluginCreateTable()保证),安装钩子里调用一次; - 查询一律用预处理语句(
$db->prepare()),不要拼字符串; - 大表要自己建索引:
CREATE INDEX IF NOT EXISTS ...; - 卸载时删除自己的表(
DROP TABLE IF EXISTS),否则站长会看到「卸不干净」。
插件私有上传目录(能力 files)
php
$dir = pluginUploadDir(); // backend/data/plugin_uploads/<slug>/
if (!is_dir($dir)) @mkdir($dir, 0755, true);
$safe = preg_replace('/[^a-zA-Z0-9._-]/', '', basename($_FILES['file']['name']));
move_uploaded_file($_FILES['file']['tmp_name'], $dir . '/' . $safe);上传三件套:校验扩展名白名单、限制体积、重命名落盘。永远不要用用户提供的路径拼路径。
自己的 css / js / 图片怎么给前台用
插件目录在 web 根之外,不能直接写 <link href="backend/plugins/...">。用平台提供的资源出口:
php
<link rel="stylesheet" href="<?= pluginAssetUrl('my_plugin', 'css/style.css') ?>">
<script src="<?= pluginAssetUrl('my_plugin', 'js/app.js') ?>"></script>
<img src="<?= pluginAssetUrl('my_plugin', 'img/logo.svg') ?>" alt="">规则(plugin_asset.php 实现):
| 规则 | 说明 |
| --- | --- |
| 目录 | 只能读 <插件目录>/assets/ 下的文件,assets/ 之外一律 403 |
| 后缀 | css / js / json / 图片 / 字体 等白名单;.php 之类一律 403 |
| 安全 | 拒绝 .. 路径穿越与软链接;文件必须真实存在 |
| 生命周期 | 插件停用后资源立即 404(不会留着旧脚本) |
| 缓存 | 带 ETag / Last-Modified / 长缓存,重复访问自动 304 |
外部请求(能力 http)
php
$r = pluginHttp('my_plugin', 'https://api.example.com/data', [
'method' => 'GET',
'timeout' => 5,
'headers' => ['Accept: application/json'],
]);
if (!$r['ok']) { pluginLog('my_plugin', 'warn', '外部接口失败:' . $r['error']); }
$data = json_decode((string)$r['body'], true);默认 5 秒超时、失败会计入插件故障计数(连续失败会触发熔断,避免拖垮整站)。
在页面渲染路径里做外部请求是大忌:请放到定时任务或后台手动操作里。