\Http

Esta clase provee métodos estáticos para trabajar con el protocolo HTTP.

Los métodos de esta clase que generan cabeceras se deben usar antes de devolver cualquier tipo de contenido o llamar a \session_start().

Summary

Methods
Properties
Constants
getStatusCodeReasonPhrase()
statusLine()
headerContentType()
cache()
noCache()
headersStandard()
redirigir()
redirigirPorPost()
redirigirAError()
No public properties found
HTTP1_STATUS_CONTINUE
HTTP1_STATUS_SWITCHING_PROTOCOLS
HTTP1_STATUS_OK
HTTP1_STATUS_CREATED
HTTP1_STATUS_ACCEPTED
HTTP1_STATUS_NON_AUTHORITATIVE_INFORMATION
HTTP1_STATUS_NO_CONTENT
HTTP1_STATUS_RESET_CONTENT
HTTP1_STATUS_PARTIAL_CONTENT
HTTP1_STATUS_MULTIPLE_CHOICES
HTTP1_STATUS_MOVED_PERMANENTLY
HTTP1_STATUS_FOUND
HTTP1_STATUS_SEE_OTHER
HTTP1_STATUS_NOT_MODIFIED
HTTP1_STATUS_USE_PROXY
HTTP1_STATUS_TEMPORARY_REDIRECT
HTTP1_STATUS_BAD_REQUEST
HTTP1_STATUS_UNAUTHORIZED
HTTP1_STATUS_PAYMENT_REQUIRED
HTTP1_STATUS_FORBIDDEN
HTTP1_STATUS_NOT_FOUND
HTTP1_STATUS_METHOD_NOT_ALLOWED
HTTP1_STATUS_NOT_ACCEPTABLE
HTTP1_STATUS_PROXY_AUTHENTICATION_REQUIRED
HTTP1_STATUS_REQUEST_TIME_OUT
HTTP1_STATUS_CONFLICT
HTTP1_STATUS_GONE
HTTP1_STATUS_LENGTH_REQUIRED
HTTP1_STATUS_PRECONDITION_FAILED
HTTP1_STATUS_REQUEST_ENTITY_TOO_LARGE
HTTP1_STATUS_REQUEST_URI_TOO_LARGE
HTTP1_STATUS_UNSUPPORTED_MEDIA_TYPE
HTTP1_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE
HTTP1_STATUS_EXPECTATION_FAILED
HTTP1_STATUS_INTERNAL_SERVER_ERROR
HTTP1_STATUS_NOT_IMPLEMENTED
HTTP1_STATUS_BAD_GATEWAY
HTTP1_STATUS_SERVICE_UNAVAILABLE
HTTP1_STATUS_GATEWAY_TIME_OUT
HTTP1_STATUS_HTTP_VERSION_NOT_SUPPORTED
PARAMETRO_PAG_ORIGEN
PARAMETRO_CODIGO_ERROR
No protected methods found
$status_codes
N/A
No private methods found
No private properties found
N/A

Constants

HTTP1_STATUS_CONTINUE

HTTP1_STATUS_CONTINUE

HTTP1_STATUS_SWITCHING_PROTOCOLS

HTTP1_STATUS_SWITCHING_PROTOCOLS

HTTP1_STATUS_OK

HTTP1_STATUS_OK

HTTP1_STATUS_CREATED

HTTP1_STATUS_CREATED

HTTP1_STATUS_ACCEPTED

HTTP1_STATUS_ACCEPTED

HTTP1_STATUS_NON_AUTHORITATIVE_INFORMATION

HTTP1_STATUS_NON_AUTHORITATIVE_INFORMATION

HTTP1_STATUS_NO_CONTENT

HTTP1_STATUS_NO_CONTENT

HTTP1_STATUS_RESET_CONTENT

HTTP1_STATUS_RESET_CONTENT

HTTP1_STATUS_PARTIAL_CONTENT

HTTP1_STATUS_PARTIAL_CONTENT

HTTP1_STATUS_MULTIPLE_CHOICES

HTTP1_STATUS_MULTIPLE_CHOICES

HTTP1_STATUS_MOVED_PERMANENTLY

HTTP1_STATUS_MOVED_PERMANENTLY

HTTP1_STATUS_FOUND

HTTP1_STATUS_FOUND

HTTP1_STATUS_SEE_OTHER

HTTP1_STATUS_SEE_OTHER

HTTP1_STATUS_NOT_MODIFIED

HTTP1_STATUS_NOT_MODIFIED

HTTP1_STATUS_USE_PROXY

HTTP1_STATUS_USE_PROXY

HTTP1_STATUS_TEMPORARY_REDIRECT

HTTP1_STATUS_TEMPORARY_REDIRECT

HTTP1_STATUS_BAD_REQUEST

HTTP1_STATUS_BAD_REQUEST

HTTP1_STATUS_UNAUTHORIZED

HTTP1_STATUS_UNAUTHORIZED

HTTP1_STATUS_PAYMENT_REQUIRED

HTTP1_STATUS_PAYMENT_REQUIRED

HTTP1_STATUS_FORBIDDEN

HTTP1_STATUS_FORBIDDEN

HTTP1_STATUS_NOT_FOUND

HTTP1_STATUS_NOT_FOUND

HTTP1_STATUS_METHOD_NOT_ALLOWED

HTTP1_STATUS_METHOD_NOT_ALLOWED

HTTP1_STATUS_NOT_ACCEPTABLE

HTTP1_STATUS_NOT_ACCEPTABLE

HTTP1_STATUS_PROXY_AUTHENTICATION_REQUIRED

HTTP1_STATUS_PROXY_AUTHENTICATION_REQUIRED

HTTP1_STATUS_REQUEST_TIME_OUT

HTTP1_STATUS_REQUEST_TIME_OUT

HTTP1_STATUS_CONFLICT

HTTP1_STATUS_CONFLICT

HTTP1_STATUS_GONE

HTTP1_STATUS_GONE

HTTP1_STATUS_LENGTH_REQUIRED

HTTP1_STATUS_LENGTH_REQUIRED

HTTP1_STATUS_PRECONDITION_FAILED

HTTP1_STATUS_PRECONDITION_FAILED

HTTP1_STATUS_REQUEST_ENTITY_TOO_LARGE

HTTP1_STATUS_REQUEST_ENTITY_TOO_LARGE

HTTP1_STATUS_REQUEST_URI_TOO_LARGE

HTTP1_STATUS_REQUEST_URI_TOO_LARGE

HTTP1_STATUS_UNSUPPORTED_MEDIA_TYPE

HTTP1_STATUS_UNSUPPORTED_MEDIA_TYPE

HTTP1_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE

HTTP1_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE

HTTP1_STATUS_EXPECTATION_FAILED

HTTP1_STATUS_EXPECTATION_FAILED

HTTP1_STATUS_INTERNAL_SERVER_ERROR

HTTP1_STATUS_INTERNAL_SERVER_ERROR

HTTP1_STATUS_NOT_IMPLEMENTED

HTTP1_STATUS_NOT_IMPLEMENTED

HTTP1_STATUS_BAD_GATEWAY

HTTP1_STATUS_BAD_GATEWAY

HTTP1_STATUS_SERVICE_UNAVAILABLE

HTTP1_STATUS_SERVICE_UNAVAILABLE

HTTP1_STATUS_GATEWAY_TIME_OUT

HTTP1_STATUS_GATEWAY_TIME_OUT

HTTP1_STATUS_HTTP_VERSION_NOT_SUPPORTED

HTTP1_STATUS_HTTP_VERSION_NOT_SUPPORTED

PARAMETRO_PAG_ORIGEN

PARAMETRO_PAG_ORIGEN

Nombre de parámetro de request para la página de origen.

PARAMETRO_CODIGO_ERROR

PARAMETRO_CODIGO_ERROR

Nombre de parámetro de request para el código de error.

Properties

$status_codes

$status_codes : array

Lista de todos los códigos de estado conocidos y sus mensajes correspondientes.

Type

array

Methods

getStatusCodeReasonPhrase()

getStatusCodeReasonPhrase(integer  $code) : string

Retorna el mensaje definido para un código de estado.

Parameters

integer $code

el código solicitado; una de las constantes HTTP1STATUS*

Returns

string —

el mensaje correspondiente a $code

statusLine()

statusLine(integer  $status_code, string  $reason_phrase = '') 

Emite la cabecera correspondiente a la línea de estado de la respuesta.

Parameters

integer $status_code

el código de estado; generalmente una de las constantes HTTP1STATUS*

string $reason_phrase

la frase que acompaña al código; si es vacía se usa la frase predeterminada para el código dado, si es reconocido

headerContentType()

headerContentType(string  $media_type = null,   $charset = \Html::DEFAULT_ENCODING) 

Envía la cabecera Content-Type.

Parameters

string $media_type

media type a enviar; si es vacío, se asume que se está generando una página XHTML

$charset

charset a enviar; si es vacío, no se envía

cache()

cache() 

Este metodo induce al browser a guardar la pagina en su cache.

noCache()

noCache(boolean  $send_content_type = true, string  $media_type = null,   $charset = \Html::DEFAULT_ENCODING) 

Este método induce al browser a <b>no</b> guardar la página en su cache.

Parameters

boolean $send_content_type

¿enviar la cabecera Content-Type?

string $media_type

media type a enviar; si es vacío, se asume que se está generando una página XHTML

$charset

charset a enviar; si es vacío, no se envía

headersStandard()

headersStandard() 

Este metodo prepara las cabeceras para las páginas normales de la aplicación (aunque hace lo mismo que noCache).

redirigir()

redirigir(string  $url, integer  $codigo = 302, boolean  $exit = true, boolean  $rfc2616 = false) : boolean

Redirige a otra dirección por medio del método HTTP GET.

Parameters

string $url

dirección destino; si es relativa, se transforma en absoluta con {@link direccionAbsolutaPagina()}

integer $codigo

código de respuesta HTTP (30x)

boolean $exit

¿se debe hacer un {@link exit()} luego de la redirección?

boolean $rfc2616

¿se debe mostrar un link con la dirección a donde se está redirigiendo?

Returns

boolean —

false si por algún motivo no se puede hacer la redirección

redirigirPorPost()

redirigirPorPost(string  $url, array  $params = array(), boolean  $exit = true,   $mostrar_continuar = false) : boolean

Redirige a otra página por medio del método HTTP POST.

Requiere que javascript esté habilitado en el cliente para poder hacer la redirección de forma automática.

Parameters

string $url

dirección destino si es relativa, se transforma en absoluta con {@link direccionAbsolutaPagina()}

array $params

lista de parámetros a pasar al destino; ejemplo: $params = array('col' => 1, 'orden' => 'asc')

boolean $exit

¿se debe hacer un {@link exit()} luego de la redirección?

$mostrar_continuar

si es true, genera un botón que le permite al usuario continuar la redirección si su cliente no tiene javascript habilitado

Returns

boolean

redirigirAError()

redirigirAError(string  $pag_error = null, string  $codigo_error = null, boolean  $incluir_origen = true, string  $comando_historial = 'skip', boolean  $exit = true, boolean  $rfc2616 = false, string  $metodo = 'get', array  $params_extra = null) 

Redirige a una página de error.

Los parámetros para la página destino están dados por los parámetros de este método. Además incluye el parámetro PARAMETRO_ESTRUCTURA_PAGINA_SIMPLE con valor true si la página actual es simple.

Parameters

string $pag_error

dirección de la página de error; si es null, se usa una por defecto

string $codigo_error

código de error a pasar en el parámetro {@link Http::PARAMETRO_CODIGO_ERROR}

boolean $incluir_origen

¿se debe pasar la página actual en el parámetro {@link Http::PARAMETRO_PAG_ORIGEN}?

string $comando_historial

comando a pasar al {@link AdministradorHistorial historial de páginas}, en el parámetro PARAMETRO_HISTORIAL; si es null no se pasa este parámetro

boolean $exit

¿se debe hacer un {@link exit()} luego de la redirección?

boolean $rfc2616

¿se debe mostrar un link con la dirección a donde se está redirigiendo?; sólo se tiene en cuenta si $metodo != 'post'

string $metodo

'get'|'post' método HTTP a usar

array $params_extra

parámetros extra a pasar a $pag_error, en formato 'clave' => valor