函数文档

wp_slash_strings_only()

💡 云策文档标注

概述

wp_slash_strings_only() 函数用于仅对数组中的字符串值添加反斜杠,适用于准备需要斜杠数据的核心 API。该函数自 WordPress 5.6.0 起已弃用,建议使用 wp_slash() 替代。

关键要点

  • 功能:仅对数组或标量中的字符串值添加反斜杠,非字符串值保持不变。
  • 用途:准备数据以用于期望斜杠数据的核心 API,不应直接用于 SQL 查询转义。
  • 参数:$value(必需),可以是标量或标量数组。
  • 返回值:返回添加了反斜杠的 $value。
  • 弃用状态:自 WordPress 5.6.0 起弃用,推荐使用 wp_slash()。
  • 内部实现:通过 map_deep() 调用 addslashes_strings_only 函数处理。

代码示例

function wp_slash_strings_only( $value ) {
	return map_deep( $value, 'addslashes_strings_only' );
}

注意事项

  • 不要将此函数用于直接转义 SQL 查询数据,以避免安全风险。
  • 在 WordPress 5.6.0 及以上版本中,应优先使用 wp_slash() 函数。

📄 原文内容

Adds slashes to only string values in an array of values.

Description

This should be used when preparing data for core APIs that expect slashed data.
This should not be used to escape data going directly into an SQL query.

See also

Parameters

$valuemixedrequired
Scalar or array of scalars.

Return

mixed Slashes $value

Source

function wp_slash_strings_only( $value ) {
	return map_deep( $value, 'addslashes_strings_only' );
}

Changelog

Version Description
5.6.0 Deprecated. Use wp_slash()
5.3.0 Introduced.