esc_url_raw()URL过滤

目录

描述

esc_url_raw() 函数类似与 esc_url() (实际上 esc_url_raw 函数中就使 了 esc_url ),但是 同于 esc_url(),它不 将字符   HTML 实体用于显 ,它的结果适用于在数据库  操作,重定 ,或者 HTTP 请 中。

esc_url_raw() 描述

用法

<?php esc_url_raw$url$protocols ); ?>

esc_url_raw() 用法

参数

$url

(string) (必填) 将要被清理过 的 URL

 值: None

$protocols

(array) (可选)  以接受协议 数组,如果  置,默认 :'http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet'。

默认值: null

esc_url_raw() 参数

返回值

(string) 

The cleaned $url after the 'clean_url' filter is applied. An empty string is returned if $url specifies a protocol other than those in $protocols, or if $url contains an empty string.

已经清理 滤的 URL

esc_url_raw() 返回值

示例



<!-- Right -->
<?php
    $url 
'http://wordpress.org';
    
$response wp_remote_getesc_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>

esc_url_raw() 示例

注意

  • 开发者可以通过 cleaned_url 这个 filter  口队返回 $url 进行再次过滤。
  • esc_url_raw() 注意

    源文件

    esc_url_raw() 函数的代码位于 wp-includes/formatting.php.

    esc_url_raw() 源文件

    相关