Introducci贸n

La extensi贸n de sockets implementa una interfaz de bajo nivel con las funciones de comunicaci贸n de sockets, basadas en los populares sockets BSD, ofreciendo la posibilidad de actuar como un servidor de sockets, as铆 como cliente.

Para una interfaz m谩s gen茅rica de sockets del lado del cliene, vea stream_socket_client(), stream_socket_server(), fsockopen(), y pfsockopen().

Cuando use estas funciones, es importante recordar que, aunque muchas de ellas tienen nombres id茅nticos a sus contrapartes en C, usualmente cuentan con declaraciones distintas. Por favor, aseg煤rese de leer las descripciones, con el prop贸sito de evitar confusiones.

Aquellos que no se encuentran familiarizados con programaci贸n de sockets, pueden encontrar una gran cantidad de material 煤til en las p谩ginas man de Unix apropiadas, y existe una enorme cantidad de informaci贸n estilo tutorial sobre programaci贸n de sockets en C en la web, mucha de la cual puede aplicarse, con ligeras modificaciones, a la programaci贸n de sockets en PHP. El FAQ de Sockets Unix puede ser un buen comienzo.

Requisitos

No se necesitan bibliotecas externas para construir esta extensi贸n

Instalaci贸n

The socket functions described here are part of an extension to PHP which must be enabled at compile time by giving the --enable-sockets option to configure.

Configuraci贸n en tiempo de ejecuci贸n

Esta extensi贸n no tiene directivas de configuraci贸n en php.ini.

Tipos de recursos

Esta extensi贸n no tiene ning煤n tipo de recurso definido.

Constantes predefinidas

Estas constantes est谩n definidas por esta extensi贸n y estar谩n disponibles solamente cuando la extensi贸n ha sido o bien compilada dentro de PHP o grabada din谩micamente en tiempo de ejecuci贸n.

Errores de Socket

La extensi贸n de sockets fue escrita para ofrecer una interfaz usable a los poderosos sockets BSD. Se ha tenido cuidado para que las funciones trabajen igualmente bien en implementaciones Win32 y Unix. Casi todas las funciones de sockets pueden fallar bajo ciertas condiciones y por lo tanto emiten un mensaje E_WARNING que describe el error. Algunas veces esto no ocurre conforme al deseo del desarrollador. Por ejemplo, la funci贸n socket_read() puede emitir repentinamente un mensaje E_WARNING debido a que la conexi贸n ha sido cerrada inesperadamente. Es com煤n suprimir la advertencia con el operador @ y atrapar el c贸digo de error dentro de la aplicaci贸n con la funci贸n socket_last_error(). Puede llamar la funci贸n socket_strerror() con 茅ste c贸digo de error para recuperar una cadena que describe el error. Vea su descripci贸n para m谩s informaci贸n.

Ejemplos

Ejemplo 1. Ejemplo de Socket: Servidor TCP/IP simple Este ejemplo le muestra un servidor simple que repite de vuelta su entrada. Modifique las variables direccion y puerto para que se acomoden a su configuraci贸n y ejec煤telo. Puede entonces conectarse con el servidor mediante un comando similar a: telnet 192.168.1.53 10000 (en donde la direcci贸n y el puerto se ajustan a su configuraci贸n). Cualquier cosa que escriba ser谩 entonces impresa en el lado del servidor, y devuelta a su lado. Para desconectarse, ingrese 'salir'. #!/usr/local/bin/php -q <?php error_reporting(E_ALL); /* Permitir que el script permanezca en espera de conexiones. */ set_time_limit(0); /* Habilitar vaciado de salida implicito, de modo que veamos lo que * obtenemos a medida que va llegando. */ ob_implicit_flush(); $direccion = '192.168.1.53'; $puerto    = 10000; if (($sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP)) < 0) {     echo "socket_create() fall&oacute;: motivo: " . socket_strerror($sock) . "\n"; } if (($ret = socket_bind($sock, $direccion, $puerto)) < 0) {     echo "socket_bind() fall&oacute;: motivo: " . socket_strerror($ret) . "\n"; } if (($ret = socket_listen($sock, 5)) < 0) {     echo "socket_listen() fall&oacute;: motivo: " . socket_strerror($ret) . "\n"; } do {     if (($mens_sock = socket_accept($sock)) < 0) {         echo "socket_accept() fall&oacute;: motivo " . socket_strerror($mens_sock) . "\n";         break;     }     /* Enviar instrucciones. */     $mensaje = "\nBienvenido al Servidor de Prueba PHP. \n" .                "Para salir, escriba 'salir'. " .                "Para detener el servidor, escriba 'detener'.\n";     socket_write($mens_sock, $mensaje, strlen($mensaje));     do {         if (false === ($buf = socket_read($mens_sock, 2048, PHP_NORMAL_READ))) {             echo "socket_read() fall&oacute;: motivo: " . socket_strerror($ret) . "\n";             break 2;         }         if (!$buf = trim($buf)) {             continue;         }         if ($buf == 'salir') {             break;         }         if ($buf == 'detener') {             socket_close($mens_sock);             break 2;         }         $respuesta = "PHP: Usted dijo '$buf'.\n";         socket_write($mens_sock, $respuesta, strlen($respuesta));         echo "$buf\n";     } while (true);     socket_close($mens_sock); } while (true); socket_close($sock); ?>

Ejemplo 2. Ejemplo de Socket: Cliente TCP/IP simple Este ejemplo muestra un cliente HTTP simple, de un paso. Simplemente se conecta con una p谩gina, envia una petici贸n HEAD, imprime la respuesta, y sale. <?php error_reporting(E_ALL); echo "<h2>Conexi&oacute;n TCP/IP</h2>\n"; /* Obtener el puerto para el servicio WWW. */ $puerto_servicio = getservbyname('www', 'tcp'); /* Obtener la direccion IP del host de destino. */ $direccion = gethostbyname('www.example.com'); /* Crear un socket TCP/IP. */ $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP); if ($socket < 0) {     echo "socket_create() fall&oacute;: motivo: " . socket_strerror($socket) . "\n"; } else {     echo "OK.\n"; } echo "Intentando una conexi&oacute;n con '$direccion' en el puerto '$puerto_servicio'..."; $resultado = socket_connect($socket, $direccion, $puerto_servicio); if ($resultado < 0) {     echo "socket_connect() fall&oacute;.\nMotivo: ($resultado) " .          socket_strerror($resultado) . "\n"; } else {     echo "OK.\n"; } $entrada = "HEAD / HTTP/1.1\r\n"; $entrada .= "Host: www.example.com\r\n"; $entrada .= "Connection: Close\r\n\r\n"; $salida = ''; echo "Enviando petici&oacute;n HTTP HEAD..."; socket_write($socket, $entrada, strlen($entrada)); echo "OK.\n"; echo "Leyendo respuesta:\n\n"; while ($salida = socket_read($socket, 2048)) {     echo $salida; } echo "Cerrando socket..."; socket_close($socket); echo "OK.\n\n"; ?>