Oggetto wrapper di base per una Requests_Response per la standardizzazione.

Descrizione

Vedere anche

Fonte

File: wp-includes/class-wp-http-requests-response.php

classWP_HTTP_Requests_ResponseextendsWP_HTTP_Response{/**
	 * Requests Response object.
	 *
	 * @since 4.6.0
	 * @var Requests_Response
	 */protected$response;/**
	 * Filename the response was saved to.
	 *
	 * @since 4.6.0
	 * @var string|null
	 */protected$filename;/**
	 * Constructor.
	 *
	 * @since 4.6.0
	 *
	 * @param Requests_Response $response HTTP response.
	 * @param string            $filename Optional. File name. Default empty.
	 */publicfunction__construct(Requests_Response$response,$filename=''){$this->response=$response;$this->filename=$filename;}/**
	 * Retrieves the response object for the request.
	 *
	 * @since 4.6.0
	 *
	 * @return Requests_Response HTTP response.
	 */publicfunctionget_response_object(){return$this->response;}/**
	 * Retrieves headers associated with the response.
	 *
	 * @since 4.6.0
	 *
	 * @return Requests_Utility_CaseInsensitiveDictionary Map of header name to header value.
	 */publicfunctionget_headers(){// Ensure headers remain case-insensitive.$converted=newRequests_Utility_CaseInsensitiveDictionary();foreach($this->response->headers->getAll()as$key=>$value){if(count($value)===1){$converted[$key]=$value[0];}else{$converted[$key]=$value;}}return$converted;}/**
	 * Sets all header values.
	 *
	 * @since 4.6.0
	 *
	 * @param array $headers Map of header name to header value.
	 */publicfunctionset_headers($headers){$this->response->headers=newRequests_Response_Headers($headers);}/**
	 * Sets a single HTTP header.
	 *
	 * @since 4.6.0
	 *
	 * @param string $key     Header name.
	 * @param string $value   Header value.
	 * @param bool   $replace Optional. Whether to replace an existing header of the same name.
	 *                        Default true.
	 */publicfunctionheader($key,$value,$replace=true){if($replace){unset($this->response->headers[$key]);}$this->response->headers[$key]=$value;}/**
	 * Retrieves the HTTP return code for the response.
	 *
	 * @since 4.6.0
	 *
	 * @return int The 3-digit HTTP status code.
	 */publicfunctionget_status(){return$this->response->status_code;}/**
	 * Sets the 3-digit HTTP status code.
	 *
	 * @since 4.6.0
	 *
	 * @param int $code HTTP status.
	 */publicfunctionset_status($code){$this->response->status_code=absint($code);}/**
	 * Retrieves the response data.
	 *
	 * @since 4.6.0
	 *
	 * @return string Response data.
	 */publicfunctionget_data(){return$this->response->body;}/**
	 * Sets the response data.
	 *
	 * @since 4.6.0
	 *
	 * @param string $data Response data.
	 */publicfunctionset_data($data){$this->response->body=$data;}/**
	 * Retrieves cookies from the response.
	 *
	 * @since 4.6.0
	 *
	 * @return WP_HTTP_Cookie[] List of cookie objects.
	 */publicfunctionget_cookies(){$cookies=array();foreach($this->response->cookiesas$cookie){$cookies[]=newWP_Http_Cookie(array('name'=>$cookie->name,'value'=>urldecode($cookie->value),'expires'=>isset($cookie->attributes['expires'])?$cookie->attributes['expires']:null,'path'=>isset($cookie->attributes['path'])?$cookie->attributes['path']:null,'domain'=>isset($cookie->attributes['domain'])?$cookie->attributes['domain']:null,'host_only'=>isset($cookie->flags['host-only'])?$cookie->flags['host-only']:null,));}return$cookies;}/**
	 * Converts the object to a WP_Http response array.
	 *
	 * @since 4.6.0
	 *
	 * @return array WP_Http response array, per WP_Http::request().
	 */publicfunctionto_array(){returnarray('headers'=>$this->get_headers(),'body'=>$this->get_data(),'response'=>array('code'=>$this->get_status(),'message'=>get_status_header_desc($this->get_status()),),'cookies'=>$this->get_cookies(),'filename'=>$this->filename,);}}

Correlato

Utilizzi

Usi Descrizione
wp-includes/class-wp-http-response.php:WP_HTTP_Response

Classe centrale usata per preparare le risposte HTTP.

Metodi

Changelog

Versione Descrizione
4.6.0 Introdotto.