WordPress 主题安全编码核心原则:验证、清洗与转义的正确使用时机
WordPress 官方开发者文档明确指出了主题安全开发的核心原则:不要信任任何数据,依赖 WordPress API,保持代码更新。理解验证、清洗和转义这三个概念的区别和正确使用时机,是写出安全主题的基础。
验证:拒绝不合规的数据
验证是在数据进入系统之前检查它是否符合预期格式。比如检查一个字段是否为有效的邮箱地址,检查一个数字是否在允许范围内。验证的结果是接受或拒绝。验证比清洗更安全,因为不合规的数据根本不会进入系统。
清洗:让数据变得安全
清洗是去除数据中潜在危险的部分,保留可用的内容。比如从文本中移除 HTML 标签,从 URL 中移除非法字符。使用 sanitize_text_field 清洗文本输入,sanitize_email 清洗邮箱,intval 强制转换为整数。清洗适用于你希望接受用户输入但需要确保安全性的场景。
转义:在输出时保护上下文
转义是在数据输出到 HTML 时,将其转换为安全的格式。这是防止 XSS 攻击的最后一道防线。esc_html 用于 HTML 标签内的文本,esc_attr 用于 HTML 属性值,esc_url 用于 URL 属性,esc_js 用于 JavaScript 内的字符串。
转义的时机原则
WordPress 安全指南强调:尽可能晚地转义。意思是不要过早地把数据转义后存储,而是在输出到具体上下文时才进行转义。因为同一个数据可能在不同的上下文中使用,比如 HTML 属性、JavaScript、URL,每种上下文需要不同的转义方式。
nonce 与权限检查
除了数据处理安全,主题中任何敏感操作都需要 nonce 验证和权限检查。wp_nonce_field 和 wp_verify_nonce 防止跨站请求伪造,current_user_can 确保用户有执行操作的能力。

