(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_create_pair — Crée une paire de sockets identiques et les stocke dans un tableau
socket_create_pair() crée une paire de sockets identiques et les stocke dans pair
. 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.
pair
Une référence vers un tableau dans lequel les deux instances de Socket seront insérées.
Version | Description |
---|---|
8.0.0 | pair est une référence à un tableau d'instance de Socket ; auparavant, c'était une référence à un tableau de resources. |
Exemple #1 Exemple avec socket_create_pair()
<?php
$sockets = array();
$domain = (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN' ? AF_INET : AF_UNIX);
if (socket_create_pair($domain, SOCK_STREAM, 0, $sockets) === false) {
echo "socket_create_pair a échoué. Raison : ".socket_strerror(socket_last_error());
}
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);
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) {
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 "Réception de $strtwo\n";
}
socket_close($ary[1]);
} else {
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]);
}
?>