rawurlencode_deep()
云策文档标注
概述
rawurlencode_deep() 是一个 WordPress 函数,用于遍历数组、对象或标量值,并对值进行原始 URL 编码,以便在 URL 中使用。
关键要点
- 参数 $value 是必需的,可以是数组或字符串,用于指定要编码的值。
- 返回值是编码后的值,类型与输入相同。
- 该函数内部调用 map_deep() 函数,将 rawurlencode 应用于所有非可迭代元素。
- 在 WordPress 3.4.0 版本中引入。
代码示例
function rawurlencode_deep( $value ) {
return map_deep( $value, 'rawurlencode' );
}注意事项
- 该函数主要用于处理 URL 中的特殊字符,确保数据在传输时正确编码。
- 相关函数包括 map_deep(),用于将函数映射到数组或对象的非可迭代元素。
- 被 get_avatar_data() 和 redirect_canonical() 等函数使用。
原文内容
Navigates through an array, object, or scalar, and raw-encodes the values to be used in a URL.
Parameters
$valuemixedrequired-
The array or string to be encoded.
Source
function rawurlencode_deep( $value ) {
return map_deep( $value, 'rawurlencode' );
}
Changelog
| Version | Description |
|---|---|
| 3.4.0 | Introduced. |