fsockopen
Manual de PHP
AnteriorSiguiente

fsockopen

(PHP 3, PHP 4, PHP 5)

fsockopen --  Abrir una conexi贸n de sockets de dominio de Internet o Unix

Descripci贸n

resource fsockopen ( string destino [, int puerto [, int &errno [, string &errstr [, float tiempo_espera]]]] )

Inicia una conexi贸n a trav茅s de sockets con el recurso especificado por destino. PHP soporta el uso de destinos en los dominios de Internet y Unix, tal y como se describe en Ap茅ndice O. Una lista de transportes soportados puede recuperarse usando stream_get_transports().

Nota: Si necesita establecer un tiempo de espera para la lectura/escritura de datos a trav茅s del socket, use stream_set_timeout(), dado que el par谩metro tiempo_espera de fsockopen() s贸lo se aplica cuando se conecta con el socket.

A partir de PHP 4.3.0, si ha compilado el soporte para OpenSSL, usted puede usar un prefijo sobre el nombre_host, ya sea 'ssl://' o 'tls://' para usar una conexi贸n de cliente SSL o TLS sobre TCP/IP para conectarse con el host remoto.

fsockopen() devuelve un apuntador de archivo el cual puede ser usado junto con otras funciones de archivos (como fgets(), fgetss(), fwrite(), fclose(), y feof()).

Si la llamada falla, devolver谩 FALSE, y si los argumentos opcionales errno y errstr est谩n presentes, ser谩n modificados para indicar el error de nivel de sistema real que ocurri贸 en la llamada de sistema connect(). Si el valor devuelto en errno es 0 y la funci贸n devolvi贸 FALSE, es un indicio de que el error ocurri贸 antes de la llamada a connect(). Lo m谩s probable es que esto se deba a un problema con la inicializaci贸n del socket. Note que los argumentos errno y errstr siempre ser谩n pasados por referencia.

Dependiendo del entorno, el dominio Unix o el tiempo de espera de conexi贸n opcional pueden no estar disponibles.

El socket ser谩 abierto por defecto en modo de bloqueo. Puede cambiar a modo de no-bloqueo usando stream_set_blocking().

Ejemplo 1. Ejemplo de fsockopen()

<?php
$da = fsockopen("www.example.com", 80, $errno, $errstr, 30);
if (!$da) {
    echo "$errstr ($errno)<br />\n";
} else {
    $salida = "GET / HTTP/1.1\r\n";
    $salida .= "Host: www.example.com\r\n";
    $salida .= "Connection: Close\r\n\r\n";

    fwrite($da, $salida);
    while (!feof($da)) {
        echo fgets($da, 128);
    }
    fclose($da);
}
?>
El ejemplo a continuaci贸n presenta la forma de recuperar la fecha y hora desde el servicio UDP "daytime" (puerto 13) en su propia m谩quina.

Ejemplo 2. Uso de una conexi贸n UDP

<?php
$da = fsockopen("udp://127.0.0.1", 13, $errno, $errstr);
if (!$da) {
    echo "ERROR: $errno - $errstr<br />\n";
} else {
    fwrite($da, "\n");
    echo fread($da, 26);
    fclose($da);
}
?>

Aviso

En ocasiones, los sockets UDP parecer谩n haber sido abiertos sin errores, incluso si el host remoto no puede ser contactado. El error s贸lo se percibir谩 cuando lea o escriba datos hacia/desde el socket. La raz贸n es que UDP es un protocolo "sin conexi贸n", lo que quiere decir que el sistema operativo no intenta establecer un enlace con el socket hasta que necesite realmente enviar o recibir datos.

Nota: Cuando se especifique una direcci贸n num茅rica IPv6 (p.ej. fe80::1) se debe incluir la IP entre corchetes. Por ejemplo tcp://[fe80::1]:80.

Nota: El par谩metro de tiempo de espera fue introducido en PHP 3.0.9 y el soporte para UDP fue a帽adido en PHP 4.

Vea tambi茅n pfsockopen(), stream_set_blocking(), stream_set_timeout(), fgets(), fgetss(), fwrite(), fclose(), feof(), y la extensi贸n Curl.

AnteriorInicioSiguiente
dns_get_recordSubirgethostbyaddr