(PHP 4 >= 4.1.0, PHP 5)
socket_create_pair — Crée une paire de sockets identiques et les stocke dans un tableau
$domain
, int $type
, int $protocol
, array &$fd
)
socket_create_pair() crée une paire de sockets identiques et les stocke
dans fd. Cette fonction est utilisée couramment dans
IPC (InterProcess Communication).
domain
Le paramètre domain spécifie la famille du protocole à utiliser par
le socket. Voir la documentation sur la fonction socket_create()
pour une liste complète.
type
Le paramètre type spécifie le type de
communication à utiliser par le socket. Voir la documentation
sur la fonction socket_create() pour une liste
complète.
protocol
Le paramètre protocol définit un protocole
spécifique dans le domaine spécifié domain
pour être utilisé lors d'une communication sur un socket retourné.
La valeur appropriée peut être retrouvée par son nom en utilisant
la fonction getprotobyname(). Si le protocole
désiré est TCP ou UDP, les constantes correspondantes
SOL_TCP et SOL_UDP peuvent
être utilisées.
Voir la documentation sur la fonction socket_create() pour une liste complète des protocoles supportés.
fd
Une référence vers un tableau dans lequel les deux ressources de sockets seront insérées.
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
| Version | Description |
|---|---|
| 5.3.0 | Cette fonction a été ré-activée sous Windows. |
| 4.3.0 | Cette fonction, à cause d'un bogue, a été désactivée sous Windows. |
Exemple #1 Exemple avec socket_create_pair()
<?php
$sockets = array();
/* Sous Windows, nous devons utiliser AF_INET */
$domain = (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN' ? AF_INET : AF_UNIX);
/* Création de la paire de sockets */
if (socket_create_pair($domain, SOCK_STREAM, 0, $sockets) === false) {
echo "socket_create_pair a échoué. Raison : ".socket_strerror(socket_last_error());
}
/* Envoie et reçoit les données */
if (socket_write($sockets[0], "ABCdef123\n", strlen("ABCdef123\n")) === false) {
echo "socket_write() a échoué. Raison : ".socket_strerror(socket_last_error($sockets[0]));
}
if (($data = socket_read($sockets[1], strlen("ABCdef123\n"), PHP_BINARY_READ) === false) {
echo "socket_read() a échoué. Raison : ".socket_strerror(socket_last_error($sockets[1]));
}
var_dump($data);
/* Fermeture des sockets */
socket_close($sockets[0]);
socket_close($sockets[1]);
?>
Exemple #2 Exemple IPC avec socket_create_pair()
<?php
$ary = array();
$strone = 'Message depuis le parent.';
$strtwo = 'Message depuis le fils.';
if (socket_create_pair(AF_UNIX, SOCK_STREAM, 0, $ary) === false) {
echo "socket_create_pair() a échoué. Raison : ".socket_strerror(socket_last_error());
}
$pid = pcntl_fork();
if ($pid == -1) {
echo 'Impossible de dupliquer le processus.';
} elseif ($pid) {
/* parent */
socket_close($ary[0]);
if (socket_write($ary[1], $strone, strlen($strone)) === false) {
echo "socket_write() a échoué. Raison : ".socket_strerror(socket_last_error($ary[1]));
}
if (socket_read($ary[1], strlen($strtwo), PHP_BINARY_READ) == $strtwo) {
echo "Recieved $strtwo\n";
}
socket_close($ary[1]);
} else {
/* fils */
socket_close($ary[1]);
if (socket_write($ary[0], $strtwo, strlen($strtwo)) === false) {
echo "socket_write() a échoué. Raison : ".socket_strerror(socket_last_error($ary[0]));
}
if (socket_read($ary[0], strlen($strone), PHP_BINARY_READ) == $strone) {
echo "Réception de $strone\n";
}
socket_close($ary[0]);
}
?>