跳到主要内容
万能墙开放平台
插件开发教程

数据表、上传目录与外部请求

全部内容基于万能墙真实的插件平台(清单 + 钩子 + 接口 + 后台页 + 数据 + 定时任务),示例可直接复制运行。

自己的数据表(能力 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 秒超时、失败会计入插件故障计数(连续失败会触发熔断,避免拖垮整站)。

在页面渲染路径里做外部请求是大忌:请放到定时任务或后台手动操作里。