描述
另见
参数
- $url
-
(string) (必填) 要清理的URL。
- $protocols
-
(string[]) (可选) 一个可接受的协议数组,默认返回值为wp_allowed_protocols()。
默认值: null
返回
(string) 使用esc_url()清理后的URL,在“db”上下文中运行。
说明
esc_url_raw()函数类似于esc_url()(并实际使用),但与esc_url()不同的是,它不替换用于显示的实体。生成的URL可以安全地用于数据库查询、重定向和HTTP请求。
这个函数用于显示URL是不安全的,请使用 esc_url() 代替。
源码
更新日志
版本 | 描述 |
---|---|
2.8.0 | 开始引入 |
使用示例
正确和错误用法
<!-- Right --> $url = 'http://wordpress.org'; $response = wp_remote_get( esc_url_raw( $url ) ); // no need to escape entities if ( ! is_wp_error( $response ) ) { echo wp_remote_retrieve_body( $response ); }
<!-- Wrong! Use esc_url instead! --> <img src="<?php echo esc_url_raw( $url ); ?>" /> <a href="<?php echo esc_url_raw( $url ); ?>">WordPress</a>