(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_bind — Lie un nom à un socket
$socket
, string $address
[, int $port
= 0
] )
Lie le nom donné par address
à l'interface
de connexion décrite par socket
. Ceci doit
être effectué avant qu'une connexion ne soit établie en utilisant
socket_connect() ou socket_listen().
socket
Une ressource de socket valide créée par la fonction socket_create().
address
Si le socket est de la famille AF_INET
, le paramètre
address
est une IP numérique
(i.e. 127.0.0.1).
Si le socket est de la famille AF_UNIX
, le paramètre
address
représente le chemin d'un socket de domaine Unix
(i.e. /tmp/my.sock).
port
(optionnel)
Le paramètre port
est uniquement utilisé lors de la
liaison à un socket AF_INET
et désigne le port
sur lequel écouter pour une connexion.
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Le code erreur peut être récupéré avec la fonction socket_last_error(). Ce code peut être passé à la fonction socket_strerror() pour récupérer le message textuel de l'erreur.
Exemple #1 Utilisation de socket_bind() pour définir l'adresse de la source
<?php
// Création d'un nouveau socket
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
// Une liste d'adresse IP, par exemple, appartenent à l'ordinateur
$sourceips['kevin'] = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';
// Lie l'adresse de la source
socket_bind($sock, $sourceips['madcoder']);
// Connexion à l'adresse de destination
socket_connect($sock, '127.0.0.1', 80);
// Écriture
$request = 'GET / HTTP/1.1' . "\r\n" .
'Host: example.com' . "\r\n\r\n";
socket_write($sock, $request);
// Fermeture
socket_close($sock);
?>
Note:
Cette fonction doit être utilisée sur le socket avant la fonction socket_connect().
Note:
Note de compatibilité avec Windows 9x/ME : socket_last_error() peut retourner un code erreur invalide lorsque vous tentez de lier un socket avec une adresse fausse, qui n'appartient pas à la machine.