php_stream_sock_open_host

(no version information, might be only in CVS)

php_stream_sock_open_host -- Ouvre une connexion avec un serveur, et retourne un flux

Description

php_stream * php_stream_sock_open_host ( const char * host, unsigned short port, int socktype, struct timeval * timeout, int persistent )

php_stream_sock_open_host() établit une connexion à l'hôte host et sur le port port. socktype spécifie les options de sockets qui devront être appliquées. socktype est dépendant du système, mais incluera notamment SOCK_STREAM pour les connexions full-duplex, séquentielle et fiables et SOCK_DGRAM pour les connexions non fiables, sans connexion, avec une taille maximale fixée (UDP).

persistent est une option qui contrôle si le flux doit être ouvert comme un flux persistant. Généralement, ce paramètre vaudra 0.

Si non-NULL, timeout spécifie la durée maximale de connexion. Si la connexion prend plus de temps que cette valeur, la tentative de connexion sera abandonnée et NULL sera retourné pour indiquer que le flux n'a pu être ouvert.

Note : Le paramètre timeout n'inclut pas le temps de résolution DNS. La raison à cela est qu'il n'y a pas de méthode portable pour effectuer des résolutions DNS.

La durée d'expiration s'applique à la phase de connexion; si vous avez besoin de durées d'expiration pour les opérations de lecture et d'écritures, il faudra utiliser la fonction php_stream_sock_set_timeout() pour configurer la durée d'expiration de votre flux une fois qu'il sera ouvert.

L'API n'impose aucune restriction sur les valeurs de socktype, mais il est recommandé de considérer les problèmes de portabilité lorsque vous faites ce choix.