socket_create_listen

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_create_listen — Abre un socket en un puerto para aceptar conexiones

Descripción

socket_create_listen(int $port, int $backlog = 128): resource

socket_create_listen() crea un nuevo recurso socket de tipo AF_INET que escucha en todas las interfaces locales del puerto dado esperando para nuevas conexiones.

Esta función tiene la intención de facilitar la tarea de crear un nuevo socket que sólo escuche para aceptar nuevas conexiones.

Parámetros

port: El puerto en el que escuchar todas las interfaces.
backlog: El parámetro backlog define la longitud máxima a la que puede aumentar la cola de conexiones pendientes. Se puede pasar SOMAXCONN como el parámetro backlog, véase socket_listen() para más información.

Valores devueltos

socket_create_listen() devuelve un nuevo recurso socket en caso de éxito o false en caso de error. El código de error de puede recuperar con socket_last_error(). Este código se puede pasar a socket_strerror() para obtener una explicación textual del error.

Notas

Nota:
Si quiere crear un socket que sólo escuche una cierta interfaz tiene que usar socket_create(), socket_bind() y socket_listen().

Ver también

socket_create() - Crear un socket (extremo de comunicación)
socket_create_pair() - Crea un par de sockets indistinguibles y los almacena en una matriz
socket_bind() - Vincula un nombre a un socket
socket_listen() - Escucha una conexión sobre un socket
socket_last_error() - Devuelve el último error sobre un socket
socket_strerror() - Devuelve una cadena que describe un error de socket

＋add a note

User Contributed Notes 4 notes

down

jdittmer at ppp0 dot net ¶

18 years ago


If you specify no port number, or 0, a random free port will be chosen.

To use ports for ipc between client/server on the same machine you can use (minus error checking)



server.php:

<?php

$sock = socket_create_listen(0);

socket_getsockname($sock, $addr, $port);

print "Server Listening on $addr:$port\n";

$fp = fopen($port_file, 'w');

fwrite($fp, $port);

fclose($fp);

while($c = socket_accept($sock)) {

   /* do something useful */

   socket_getpeername($c, $raddr, $rport);

   print "Received Connection from $raddr:$rport\n";

}

socket_close($sock);

?>



client.php:

<?php

$fp = fopen($port_file, 'r');

$port = fgets($fp, 1024);

fclose($fp);

$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

socket_connect($sock, '127.0.0.1', $port);

socket_close($sock);

?>

down

sysspoof at ng-lab dot org ¶

14 years ago


Please note that port 1 to and with 1024 on linux and bsd system require root privileges. So it is recommended to choose a higher port for your own application.

down

basim at baassiri dot com ¶

18 years ago


Remember that ports are only valid from 1 - 65535



[editor's note: typo fixed, thanks abryant at apple dot com]

down

-16

aeolianmeson at ifacfchi dot blitzeclipse dot com ¶

14 years ago


I believe that on some systems this may not bind to some or all public interfaces.

On my Windows system, I could not connect on the public interface using this, but could when I made the individual calls to create, bind, and listen.

Dustin Oprea

＋add a note