array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.socket-bind.php', 1 => 'socket_bind', 2 => 'Lie un nom à un socket', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Fonctions sur les sockets', ), 'prev' => array ( 0 => 'function.socket-atmark.php', 1 => 'socket_atmark', ), 'next' => array ( 0 => 'function.socket-clear-error.php', 1 => 'socket_clear_error', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/sockets/functions/socket-bind.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_bind

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

socket_bind — Lie un nom à un socket

Description

socket_bind(Socket $socket, string $address, int $port = 0): bool

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().

Liste de paramètres

socket

Une instance de Socket créée par socket_create().

address

Si le socket est de la famille AF_INET, le paramètre address est une adresse IP en notation pointée (c.-à-d. 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 (c.-à-d. /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.

Valeurs de retour

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.

Historique

Version Description
8.0.0 socket est désormais une instance de Socket ; auparavant, c'était une resource.

Exemples

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'adresses IP, par exemple, appartenant à 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);

?>

Notes

Note:

Cette fonction doit être utilisée sur le socket avant la fonction socket_connect().

Voir aussi