fsockopen

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().

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); } ?>

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