Last updated: Fri, 14 Aug 2009

socket_create_pair

(PHP 4 >= 4.1.0, PHP 5)

socket_create_pair — Crée une paire de sockets identiques et les stocke dans un tableau

Description

bool socket_create_pair ( int $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).

Liste de paramètres

domain

Le paramètre domain spécifie la famille du protocole à utiliser par la 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 la 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 une socket retournée. 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.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Historique

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.

Exemples

Exemple #1 Exemple avec socket_create_pair()


<?php
$sockets = array();

/* On Windows we need to use 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());
}
/* Send and Recieve Data */
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]);
}
?>

Voir aussi

socket_create() - Crée une socket
socket_create_listen() - Ouvre une socket sur un port pour accepter les connexions
socket_bind() - Lie un nom à une socket
socket_listen() - Attend une connexion sur une socket
socket_last_error() - Lit la dernière erreur générée par une socket
socket_strerror() - Retourne une chaîne décrivant un message d'erreur

add a note User Contributed Notes
socket_create_pair

cweiske at php dot net
09-May-2009 08:45


The underlying sockpair() function does only support AF_UNIX at least on BSD and Linux.

thegreatall at gmail dot com
13-Jul-2007 06:24


There is a syntax error in one of the code samples provided, it should look like this:

<?php

$sockets = array();

/* Setup socket pair */

if (socket_create_pair(AF_UNIX, SOCK_STREAM, 0, $sockets) === false) {

    echo "socket_create_pair failed. Reason: ".socket_strerror(socket_last_error());

}

/* Send and Recieve Data */

if (socket_write($sockets[0], "ABCdef123\n", strlen("ABCdef123\n")) === false) {

    echo "socket_write() failed. Reason: ".socket_strerror(socket_last_error($sockets[0]));

}

if (($data = socket_read($sockets[1], strlen("ABCdef123\n"), PHP_BINARY_READ)) === false) {

    echo "socket_read() failed. Reason: ".socket_strerror(socket_last_error($sockets[1]));

}

var_dump($data);



/* Close sockets */

socket_close($sockets[0]);

socket_close($sockets[1]);

?>

add a note

socket_create

socket_create_listen

Last updated: Fri, 14 Aug 2009