Opción que pueden ser utilizadas con la clase HttpRequest y las funciones para peticiones
Opciones relacionadas con las desconexiones por tiempo (time outs)
-
timeout (integer)
-
segundos que toda la petición puede tardar para ser completada
-
connecttimeout (integer)
-
segundos que la conexión, incluyendo la resolución del nombre, puede tardar
-
dns_cache_timeout (integer)
-
segundos después de la desconexión por tiempo de una entrada en la cache del dns
Opciones relacionadas con las urls
-
url (string)
-
la url de la petición
-
port (integer)
-
empleo de otro puerto al especificado en la url
-
redirect (integer)
-
existencia de la redirección y cuantas redirecciones hay que efectuar;
por omisión, su valor es 0
-
unrestrictedauth (bool)
-
posibilidad de continuar enviando credenciales en las redirecciones a un host diferente
-
referer (string)
-
la url de referencia para enviar
Opciones relacionadas con las cookies
-
encodecookies (bool)
-
si las cookies personalizadas deben ser urlencode()adas antes de su envío
-
cookies (array)
-
lista de cookies personalizadas en forma de array asociativo como array("cookie" => "value")
-
cookiestore (string)
-
ruta al fichero donde las cookies son/serán almacenadas
-
cookiesession (bool)
-
no carga las cookies de la sesión desde la cookiestore si su valor es
TRUE
Opciones relacionadas con las cabeceras
-
useragent (string)
-
el agente de usuario a enviar; por omisión el valor es PECL::HTTP/x.y.z (PHP/x.y.z);
si se configura como una cadena vacía se omite el valor por omisión
-
lastmodified (int)
-
fecha Unix para la cabecera If-(Un)Modified-Since
-
etag (string)
-
etag citado para la cabecera If-(None-)Match
-
headers (array)
-
lista de cabeceras personalizadas en forma de array asociativo como array("header" => "value")
Opciones relacionadas con la autentificación
-
httpauth (string)
-
credenciales http en formato "user:pass"
-
httpauthtype (int)
-
Constantes de los tipos de autentificación HTTP
-
(array)
-
Opciones relacionadas con proxies
-
proxyhost (string)
-
host del proxy en formato "host[:port]"
-
proxyport (int)
-
empleo de otro puerto especificado en el proxyhost
-
proxytype (int)
-
Constantes del tipo de proxy HTTP
-
proxyauth (string)
-
credenciales del proxy en formato "user:pass"
-
proxyauthtype (int)
-
Constantes de los tipos de autentificación HTTP
Opciones relacionadas con la transferencia
-
compress (bool)
-
si se debe solicitar y aceptar una respuesta de contenido codificado con gzip/deflate
-
resume (int)
-
inicia la descarga en el byte especificado de la respuesta si existe soporte en el servidor
(indicado con el código de estado 206 de la respuesta)
-
range (array)
-
array de arrays, cada uno conteniendo dos integers, que indican el intervalo de la descarga
si existe soporte en el servidor (indicado con el código de estado 206 de la respuesta);
sólo se reconoce si la opción de pausa está vacía
Opciones que imponen límites
-
maxfilesize (integer)
-
tamaño máximo del fichero que debe ser descargado;
no tiene ningún efecto si el tamaño de la entidad solicitada es
desconocido (por ejemplo, páginas dinámicas con transferencia de codificación fragmentada, etc.)
-
low_speed_limit (int)
-
mínima velocidad de transferencia que una petición con éxito puede tener
-
low_speed_time (int)
-
el tiempo en el cual low_speed_limit es transferida a una petición con éxito
-
max_send_speed (int)
-
máxima velocidad en envío en bytes por segundo
-
max_recv_speed (int)
-
máxima velocidad de recepción en bytes por segundo
Opciones de llamada de retorno
-
onprogress (callable)
-
estado del progreso de la llamada de retorno
Opciones de red
-
interface (string)
-
interfaz de la red de salida (iframe, ip o nombre de host)
-
portrange (array)
-
Dos números enteros especificando el intervalo de puertos para la salida a intentar
Opciones de SSL
-
ssl (array)
-
Nota:
Las opciones de SSL son establecidas en un array con el sencillo nombre de la opción de la petición "ssl".
-
cert (string)
-
ruta del certificado
-
certtype (string)
-
tipo de certificado
-
certpasswd (string)
-
contraseña del certificado
-
key (string)
-
ruta de la llave
-
keytype (string)
-
tipo de llave
-
keypasswd (string)
-
contraseña de la llave
-
engine (string)
-
máquina de ssl a emplear
-
version (int)
-
versión de ssl a emplear
-
verifypeer (bool)
-
si se debe verificar la pareja
-
verifyhost (bool)
-
si se debe verificar el host
-
cipher_list (string)
-
lista de claves permitidas
-
cainfo (string)
-
-
capath (string)
-
-
random_file (string)
-
-
egdsocket (string)
-
dav7 dot net at php (reverse) ¶16 years ago
If anyone doesn't understand the purpose of these values and is scratching their head, they're all array indexes, and are used as the $option parameter to the various HTTP functions documented in this section. For example:
<?php
$body = http_get('http://example.com/private_area/', array(httpauth => 'username:password'));
print $body;
?>
This only had me "...huh?!" for a little while, but might have others confused for longer as the fact that these are what they are isn't clearly printed anywhere... to find out that these did what they say they do was a guessing game for me even.
-dav7