在WordPress二次开发中如何调用$wpdb安全执行SQL?

P粉602998670

P粉602998670

2026-06-02

961人浏览

原创

必须用 $wpdb->prepare() 处理所有含用户输入的 sql,否则易遭注入;占位符仅限 %d、%f、%s,like 用 %%,in 列表需动态生成占位符,查询方法依返回结构选择,且须全局声明 $wpdb 并正确处理前缀与自定义表。

在wordpress二次开发中如何调用$wpdb安全执行sql?

必须用 $wpdb->prepare() 包裹所有含用户输入或动态变量的 SQL,否则大概率被注入——这不是建议,是 WordPress 官方强制要求的安全底线。

为什么不能直接拼接 SQL 字符串

直接用 "SELECT * FROM $wpdb->posts WHERE post_status = '$status'" 这类写法,一旦 $status 来自 $_GET 或表单提交,攻击者就能传入 ' OR 1=1 -- 让整张表被拖走。WordPress 不会帮你过滤,它只信任你主动做安全处理的结果。

  • esc_sql() 已被官方标记为“不推荐”,仅用于极少数无法用 prepare() 的边缘场景(比如动态表名)
  • addslashes()mysql_real_escape_string() 在现代 PHP 环境下完全失效,且与 $wpdb 的连接方式不兼容
  • 硬编码值(如 "WHERE post_type = 'post'")看似安全,但只要混入一个变量,整条语句就失守

正确使用 $wpdb->prepare() 的三个硬规则

$wpdb->prepare() 不是可选项,是唯一受支持的参数化查询方式。它按顺序绑定变量,不依赖引号、不拼接字符串。

unity3d游戏开发之相机切换 中文WORD版
unity3d游戏开发之相机切换 中文WORD版

本文档主要讲述的是unity3d游戏开发之相机切换;希望对大家会有帮助;感兴趣的朋友可以过来看看

下载
  • 占位符只能是 %d(整数)、%f(浮点)、%s(字符串),不可加引号、括号或空格,例如 "%s" 错,%s
  • LIKE 查询中百分号要写成 %%,比如 "WHERE post_title LIKE %s" + "%{$keyword}%" → 应写成 "WHERE post_title LIKE %s" + "%{$keyword}%%"
  • IN 列表不能用单个 %s 代入数组,必须展开为多个 %d%s 占位符,再用 array_merge() 拼接参数

示例:

$ids = [1, 5, 12];
$placeholders = implode(',', array_fill(0, count($ids), '%d'));
$query = $wpdb->prepare("SELECT * FROM $wpdb->posts WHERE ID IN ($placeholders)", $ids);

get_var() / get_row() / get_results() 选哪个?看返回结构

选错方法会导致前端输出乱码、NULL、对象转字符串失败,甚至暴露调试信息。

  • 只取一个数字或字符串(如 COUNT(*)SUM(price))→ 用 $wpdb->get_var(),它只返回第一行第一列
  • 只取一行数据(如查某用户邮箱)→ 用 $wpdb->get_row(),默认返回对象,加 ARRAY_A 可得关联数组
  • 要遍历多行(如列表页查 10 篇文章)→ 用 $wpdb->get_results(),别用 get_var() 然后 foreach,那会报错
  • 所有输出到 HTML 的结果,必须过 esc_html()esc_attr()get_var() 返回的 NULL 不会自动转成空字符串

容易被忽略的四个执行细节

这些点不写进文档,但线上出问题八成栽在这儿。

  • 每次调用前必须声明 global $wpdb;,漏写会导致 Fatal error: Call to a member function prepare() on null
  • 自定义表未注册到 $wpdb 对象时(比如表名不是 $wpdb->prefix . 'my_table'),需手动挂载:$wpdb->my_table = $wpdb->prefix . 'my_table';
  • $wpdb->query() 执行 INSERT/UPDATE/DELETE 后,返回的是影响行数(int),不是布尔值;失败时返回 false,要用 is_int() 判断而非 === true
  • 多站点环境下,$wpdb->prefix 是动态的,硬写 wp_ 前缀会导致子站查询失败,必须用 {$wpdb->prefix}my_table

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

word wordpress 二次开发

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

2451

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

448

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

614

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3969

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

1345

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

3561

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

3492

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

642

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

526

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何在 Windows 11 上安装 XAMPP
如何在 Windows 11 上安装 XAMPP

共1课时 | 129人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 10.4万人学习