phpMyAdmin 5.2+ 必须通过插件机制添加自定义SQL按钮：在./plugins/quicksql/下创建main.php注册钩子，index.lib.php中用getHeader钩子渲染带预设SQL的链接按钮，URL需urlencode且SQL应简洁安全。
phpMyAdmin 5.2+ 怎么在工具栏加自定义 SQL 按钮
新版 phpmyadmin（5.2 起）已移除旧版的 $cfg['quicksearchdefault'] 和直接修改 navigation.php 的方式，自定义按钮必须通过插件机制实现。硬改前端模板或 js 文件不仅下次升级就失效，还会触发 csp 报错。
- 必须启用
plugins目录且确保config.inc.php中开启了插件支持：$cfg['Servers'][$i]['extension'] = 'mysqli';（不是必需但常见依赖） - 插件需放在
./plugins/子目录下，结构为./plugins/quicksql/，含main.php和index.lib.php - 按钮逻辑不能写死 SQL 字符串，要通过
$_GET['sql_query']或PMA_getMessage()安全注入，否则会触发 SQL 注入警告
写一个最小可用的 quicksql 插件
不依赖额外类库，只用 phpMyAdmin 原生钩子。核心是注册一个「工具栏按钮」并绑定点击后跳转到 SQL 执行页。
- 创建
./plugins/quicksql/main.php，内容只需定义插件元信息和钩子：
return [
'name' => 'Quick SQL Button',
'author' => 'admin',
'description' => 'Add toolbar button to run predefined SQL',
'hooks' => [
'getHeader' => 'PMA\Plugins\QuickSql::addButton',
],
];
- 创建
./plugins/quicksql/index.lib.php，实现按钮渲染：
namespace PMA\Plugins;
class QuickSql
{
public static function addButton($params)
{
$url = 'import.php' . '?sql_query=' . urlencode('SELECT COUNT(*) FROM information_schema.tables;');
$html = '<a href="' . htmlspecialchars($url) . '" class="btn btn-secondary" title="Count all tables">? Tables Count</a>';
return $html;
}
}
- 重启 Web 服务后，在任意数据库页面右上角工具栏就会出现「? Tables Count」按钮
为什么不能直接用 JavaScript 注入按钮
因为 phpMyAdmin 启用了严格的 CSP 策略（Content-Security-Policy: script-src 'self'），任何内联 <script> 或动态 eval() 都会被拦截，控制台报错 Refused to execute inline script。
- 浏览器开发者工具里能看到按钮被渲染，但点击无响应——其实是 JS 被阻止执行了
- 试图用
document.write或addEventListener动态挂载，也会因 DOM 加载时机和 CSP 双重限制失败 - 唯一合规路径是走插件系统，让 phpMyAdmin 自己生成带正确 nonce 的脚本标签
按钮里执行多行 SQL 或带变量怎么办
URL 参数长度有限（通常 2048 字符），复杂 SQL 不能靠 urlencode() 硬塞；且用户当前数据库名、表名等上下文需要动态获取。
- 多行 SQL：改用 POST 提交，插件中生成一个隐藏表单 + 自动 submit，目标地址仍是
import.php - 动态数据库名：用
PMA\libraries\Util::getScriptNameForOption()获取当前 db 名，拼进 SQL 字符串前做白名单校验 - 安全红线：绝不能把
$_GET['db']或$_GET['table']未经过滤就拼进 SQL；必须用PMA\libraries\Util::escapeMysqlWildcards()处理
真正难的不是加按钮，而是让按钮背后那条 SQL 在所有权限组合、字符集、SQL_MODE 下都稳定执行——比如 SET NAMES utf8mb4 必须显式前置，否则中文字段值可能乱码。
立即学习“PHP免费学习笔记（深入）”；
