Last updated: Sun, 16 Aug 2009

stream_socket_client

(PHP 5)

stream_socket_client — Ouvre une connexion socket Internet ou Unix

Description

resource stream_socket_client ( string $remote_socket [, int &$errno [, string &$errstr [, float $timeout = ini_get("default_socket_timeout") [, int $flags = STREAM_CLIENT_CONNECT [, resource $context ]]]]] )

Initie un flux ou une connexion datagramme avec la destination remote_socket . Le type de socket créée est déterminé par le transport spécifié avec le formatage URL suivant : transport://target. Pour une socket Internet, (AF_INET) comme TCP et UDP, la cible de remote_socket sera une adresse IP ou un nom d'hôte. Pour une socket Unix, la cible doit être un fichier de socket du système.

Note: Le flux sera par défaut ouvert en mode bloquant. Vous pouvez le passer en mode non bloquant en utilisant la fonction stream_set_blocking().

Liste de paramètres

remote_socket

L'adresse du socket.

errno

Contiendra le numéro de l'erreur système si la connexion échoue.

errstr

Contiendra le message de l'erreur système si la connexion échoue.

timeout

Délai d'expiration, en secondes, pour l'appel système connect().

Note: Ce paramètre n'est appliqué que pour les connexions qui ne sont pas asynchrones.

Note: Pour définir un délai d'expiration lors de la lecture/écriture de données via un socket, utilisez la fonction stream_set_timeout(), vu que le paramètre timeout n'est appliqué que lors de la connexion au socket.

flags

Champ de bits qui peut être la combinaison de n'importe quelles options de connexion. Actuellement, les valeurs possibles pour ces options sont STREAM_CLIENT_CONNECT (défaut), STREAM_CLIENT_ASYNC_CONNECT et STREAM_CLIENT_PERSISTENT.

context

Une ressource de contexte valide, créée par la fonction stream_context_create().

Valeurs de retour

En cas de succès, une ressource de flux est retournée, qui peut être utilisée avec d'autres fonctions de fichiers, comme fgets(), fgetss(), fwrite(), fclose(), et feof(), FALSE si une erreur survient.

Erreurs / Exceptions

Si l'appel échoue, stream_socket_client() va retourner FALSE et si les paramètres optionnels errno et errstr sont fournis, ils recevront l'erreur exacte qui est survenue dans le système lors de l'appel à connect(). Si la valeur retournée dans errno est 0 et que la fonction a retourné FALSE, c'est une indication que l'erreur est survenue avant l'appel à connect(). Cela est probablement dû à un problème d'initialisation de la socket. Notez que errno eterrstr doivent être passés par référence.

Exemples

Exemple #1 Exemple avec stream_socket_client()


<?php
$fp = stream_socket_client("tcp://www.example.com:80", $errno, $errstr, 30);
if (!$fp) {
    echo "$errstr ($errno)<br />\n";
} else {
    fwrite($fp, "GET / HTTP/1.0\r\nHost: www.example.com\r\nAccept: */*\r\n\r\n");
    while (!feof($fp)) {
        echo fgets($fp, 1024);
    }
    fclose($fp);
}
?>

Exemple #2 Utilisation de connexions UDP

Lit la date et l'heure sur un service UDP de type "daytime" (port 13) sur votre propre machine :


<?php
$fp = stream_socket_client("udp://127.0.0.1:13", $errno, $errstr);
if (!$fp) {
    echo "ERREUR : $errno - $errstr<br />\n";
} else {
    fwrite($fp, "\n");
    echo fread($fp, 26);
    fclose($fp);
}
?>

Notes

Avertissement

Les sockets UDP sembleront parfois s'ouvrir sans erreur, même si l'hôte distant n'est pas accessible. Cette erreur ne deviendra apparente que lorsque vous essaierez de lire ou écrire des données avec cette socket. La raison à cela est que UDP est un protocole sans connexion, ce qui signifie que le système d'exploitation n'a pas à établir de lien pour la socket, jusqu'à ce qu'il commence à échanger des données.

Note: Lors de la spécification d'adresses IPv6 au format numérique (e.g. fe80::1) vous devez placer l'adresse IP entre crochets. Par exemple : tcp://[fe80::1]:80.

Note: Suivant votre environnement, les sockets Unix ou le délai d'expiration peuvent ne pas être disponibles. Une liste des transports disponibles sur le système est accessible via stream_get_transports(). Voyez Liste des modes de transport de sockets disponibles pour une liste de transports natifs.

Voir aussi

stream_socket_server() - Crée une socket serveur Unix ou Internet
stream_set_blocking() - Configure le mode bloquant d'un flux
stream_set_timeout() - Configure la durée d'expiration d'un flux
stream_select() - Surveille la modification d'un ou plusieurs flux
fgets() - Récupère la ligne courante sur laquelle se trouve le pointeur du fichier
fgetss() - Renvoie la ligne courante du fichier et élimine les balises HTML
fwrite() - Écrit un fichier en mode binaire
fclose() - Ferme un fichier
feof() - Teste la fin du fichier
Fonctions cURL

stream_socket_enable_crypto

stream_socket_accept

Last updated: Sun, 16 Aug 2009

add a note User Contributed Notes
stream_socket_client

nicholas at nicholaswilliams dot net
29-Oct-2008 01:08


For those wanting to use stream_socket_client() to connect to a local UNIX socket who can't find documentation on how to do it, here's a (rough) example:



<?php



$sock = stream_socket_client('unix:///full/path/to/my/socket.sock', $errno, $errstr);



fwrite($sock, 'SOME COMMAND'."\r\n");



echo fread($sock, 4096)."\n";



fclose($sock);



?>

robin at gareus dot org
26-Aug-2008 11:19


the httpPost() function was almost too long for a user-comment..  I've cut some newlines but to be complete the code snippet misses:



<?php

 function randomNonce($len=0) {

  $chars = "ABCDEFGHIJKMNOPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz023456789";

  $i=0; $rv='';

  if ($len < 1) $len= (6+rand()%10);

  while ($i++ < $len) {

    $rv.=$chars[rand() % strlen($chars)];

  }

  return $rv;

}

?>

robin at gareus dot org
26-Aug-2008 10:34


I came here since fsockopen() does not support any SSL certificate checking in PHP5.



while curl is nice, I use stream_socket_client() to make XML-RPC POST requests via HTTPS and since I have not found any PHP code around that does this, I'll attach an example that also includes HTTP-Digest Auth (eg. trac's WikiRPCInterface2):



<?php

#################################################

# $host: hostname ; eg 'example.org' 

# $path: request' eg '/index.php?id=123'

# $data_to_send : data to POST after the HTTP header.

#

# if $opts is an  empty array() a standard  HTTP to port 80 request is performed. 

# 

# set auth['type']='basic' to use plain-text auth, 

# digest-auth will be handled automatically if $auth['username'] is set and a 401

# status is encountered. - use auth['type']='nodigest' to override.

#

##

function httpPost($host, $path, $data_to_send,

                  $opts=array('cert'=>"", 'headers'=>0, 'transport' =>'ssl', 'port'=>443),

                  $auth=array('username'=>"", 'password'=>"", 'type'=>"")

                 ) {

  $transport=''; $port=80;

  if (!empty($opts['transport'])) $transport=$opts['transport'];

  if (!empty($opts['port'])) $port=$opts['port'];

  $remote=$transport.'://'.$host.':'.$port;



  $context = stream_context_create();

  $result = stream_context_set_option($context, 'ssl', 'verify_host', true);

  if (!empty($opts['cert'])) {

    $result = stream_context_set_option($context, 'ssl', 'cafile', $opts['cert']);

    $result = stream_context_set_option($context, 'ssl', 'verify_peer', true);

  } else {

    $result = stream_context_set_option($context, 'ssl', 'allow_self_signed', true);

  }

  $fp = stream_socket_client($remote, $err, $errstr, 60, STREAM_CLIENT_CONNECT, $context);



  if (!$fp) {

    trigger_error('httpPost error: '.$errstr);

    return NULL;

  }



  $req='';

  $req.="POST $path HTTP/1.1\r\n";

  $req.="Host: $host\r\n";

  if ($auth['type']=='basic' && !empty($auth['username'])) {

    $req.="Authorization: Basic ";

    $req.=base64_encode($auth['username'].':'.$auth['password'])."\r\n";

  }

  elseif ($auth['type']=='digest' && !empty($auth['username'])) {

    $req.='Authorization: Digest ';

    foreach ($auth as $k => $v) {

      if (empty($k) || empty($v)) continue;

      if ($k=='password') continue;

      $req.=$k.'="'.$v.'", ';

    }

    $req.="\r\n";

  }

  $req.="Content-type: text/xml\r\n";

  $req.='Content-length: '. strlen($data_to_send) ."\r\n";

  $req.="Connection: close\r\n\r\n";



  fputs($fp, $req);

  fputs($fp, $data_to_send);



  while(!feof($fp)) { $res .= fgets($fp, 128); }

  fclose($fp);



  if ($auth['type']!='nodigest'

        && !empty($auth['username'])

        && $auth['type']!='digest' # prev. digest AUTH failed.

        && preg_match("/^HTTP\/[0-9\.]* 401 /", $res)) {

    if (1 == preg_match("/WWW-Authenticate: Digest ([^\n\r]*)\r\n/Us", $res, $matches)) {

      foreach (split(",", $matches[1]) as $i) {

        $ii=split("=",trim($i),2);

        if (!empty($ii[1]) && !empty($ii[0])) {

          $auth[$ii[0]]=preg_replace("/^\"/",'', preg_replace("/\"$/",'', $ii[1]));

        }

      }

      $auth['type']='digest';

      $auth['uri']='https://'.$host.$path;

      $auth['cnonce']=randomNonce();

      $auth['nc']=1;

      $a1=md5($auth['username'].':'.$auth['realm'].':'.$auth['password']);

      $a2=md5('POST'.':'.$auth['uri']);

      $auth['response']=md5($a1.':'

                           .$auth['nonce'].':'.$auth['nc'].':'

                           .$auth['cnonce'].':'.$auth['qop'].':'.$a2);

      return httpPost($host, $path, $data_to_send, $opts, $auth);

    }

  }



  if (1 != preg_match("/^HTTP\/[0-9\.]* ([0-9]{3}) ([^\r\n]*)/", $res, $matches)) {

    trigger_error('httpPost: invalid HTTP reply.');

    return NULL;

  }



  if ($matches[1] != '200') {

    trigger_error('httpPost: HTTP error: '.$matches[1].' '.$matches[2]);

    return NULL;

  }



  if (!$opts['headers']) {

    $res=preg_replace("/^.*\r\n\r\n/Us",'',$res);

  }

  return $res;

}

?>

wbeaver at afilias dot info
31-Aug-2007 09:06


# Some may find it useful to know that your caCert 

# must be in pem format, and that PHP seems to like 

# your key, cert, and cacert pem's to be concatenated

# in a single file (I suffered various "unknown chain" 

# errors, otherwise)

#

# So, (linux users), concat your components as follows:

# (where current working dir is dir where 

# cert components are stored)

#

# cat key.pem >certchain.pem

# cat cert.pem >>certchain.pem

# cat cacert.pem >>certchain.pem

#

# Then, the php....

##################################



<?php



$host = 'host.domain.tld';

$port = 1234;

$timeout = 10;



$cert = '/path/to/your/certchain/certchain.pem';

$context = stream_context_create(array('ssl'=>array('local_cert'=> $cert,

)));



if ($fp = stream_socket_client('ssl://'.$host.':'.$port, $errno, $errstr, 30,

        STREAM_CLIENT_CONNECT, $context)) {

    fwrite($fp, "\n");

    echo fread($fp,8192);

    fclose($fp);

} else {

   echo "ERROR: $errno - $errstr<br />\n";

}



?>

add a note

stream_socket_enable_crypto

stream_socket_accept

Last updated: Sun, 16 Aug 2009