(no version information, might be only in CVS)
php_stream_sock_open_host -- Abrir una conexión con un servidor
huésped y devolver una secuencia
Descripción
php_stream *
php_stream_sock_open_host ( const char * host, unsigned short puerto, int tipo_sock, struct timeval * tiempo_espera, int persistente )
php_stream_sock_open_host() establece una
conexión con el host y
puerto
especificados. tipo_sock especifica la
semántica de conexión que debe aplicarse a la
misma. Los valores de tipo_sock dependen
del sistema, pero usualmente incluyen (como mínimo)
SOCK_STREAM para secuencias basadas en
conexiones secuenciales, confiables y de doble vía (TCP),
o SOCK_DGRAM para mensajes sin
conexión, no confiables y una longitud máxima
(UDP).
persistente es una bandera que controla
si la secuencia es abierta como una secuencia persistente. Por
lo general, este parámetro será 0.
Si es diferente a NULL, tiempo_espera
especifica un tiempo máximo para permitir que se
establezca la conexión. Si el intento de conexión
toma más tiempo que el valor de tiempo de espera, el
intento de conexión es abortado y se devuelve NULL para
indicar que la secuencia no pudo ser abierta.
Nota:
El valor de tiempo de espera no incluye el tiempo que toma
realizar una consulta de DNS. La razón de esto es que no
hay una forma portable de implementar una consulta DNS que no
bloquee.
El tiempo de espera sólo se aplica a la fase de
conexión; si necesita establecer los tiempos de espera
para operaciones posteriores de lectura o escritura,
debería usar
php_stream_sock_set_timeout() para configurar
la duración de tiempo de espera para su secuencia una vez
ésta ha sido abierta.
La API de secuencias no coloca restricciones sobre los valores
que puede usar para tipo_socket, pero es
recomendable que considere la portabilidad de los valores que
elige antes de que libere su extensión.