当前浏览:首页 / WordPress函数 / wp_safe_remote_get()

wp_safe_remote_get( string $url, array $args = array() ): array|WP_Error

使用GET方法从安全HTTP请求中检索原始响应

remote 远程

safe


描述

当向任意URL发出HTTP请求时,此函数非常理想。验证URL以避免重定向和请求伪造攻击。

另见

  • wp_remote_request():有关响应数组格式的更多信息。
  • WP_Http::request():默认参数信息。

参数

$urlstring必填
要检索的URL。
$argsarray可选
请求参数。

默认:array()


返回

array|WP_Error 响应结果或失败时的WP_Error



源码

查看源码 官方文档


更新日志

版本描述
3.6.0开始引入

使用示例

  • 示例1

    检索和解码json文件–

    $request = wp_safe_remote_get( 'http://www.example.com/file.json' );
    
    if ( is_wp_error( $request ) ) {
    	return false;
    }
    
    $body = wp_remote_retrieve_body( $request );
    $json = json_decode( $body );
  • 示例2

    带有授权参数的请求

    $response = wp_safe_remote_get( 
    	'https://endpoint-uri.com/example', 
    	array(
    		'timeout'     => 45,
    		'redirection' => 5,
    		'headers'     => array(
    			'Content-Type' => 'application/json; charset=utf-8',
    			'Authorization'      => 'Basic AUTH_KEY_HERE',
    		),
    		'cookies'     => array(),
    	),
    );