sendhttp
sendhttp
SYNOPSIS
sendhttp($method, $url, $args, $files=false, $base64=false)
DESCRIPTION
sendhttp
génère un document HTTP 1.0 en GET ou en POST, le transmet à un serveur HTTP ou HTTPS et retourne le code HTTP, l'en-tête et le corps du document renvoyés par le serveur ou false
en cas d'erreur.
$method
vaut 'GET'
ou 'POST'
selon le type de requête attendu par le serveur.
$url
adresse le code PHP du serveur qui va analyser le document, effectuer un traitement et retourner un document au format HTTP.
$url
a le format [proto://]host[:portnum]/path.
Mettez proto à 'https'
pour transmettre le document en mode sécurisé.
host donne le nom ou l'adresse IP du serveur. Si nécessaire, ajoutez portnum pour spécifier un numéro de port différent de 80 ou 443 pour des connexions en HTTP ou HTTPS avec un serveur à l'écoute sur des ports particuliers.
path donne le chemin d'accès au code en PHP sur le serveur.
$args
contient la liste des paramètres du service appelé sous la forme d'un tableau associatif { 'param1' => val1, ... }
.
$args
permet de passer un ou plusieurs champs directement dans une URL pour une requête HTTP GET ou extraits d'un formulaire HTML pour une requête HTTP POST.
$files
contient la liste des fichiers ajoutés en pièces jointes sous la forme d'un tableau associatif { 'docname' => {'name' => 'filename', 'type' => 'mimetype', 'tmp_name' => 'pathname'}, ... }
. Ce paramètre est optionnel. Typiquement, il permet de passer un fichier transmis par une balise <input type="file" name="docname"... />
d'un formulaire HTML.
Si $base64
est à true
, les contenus des fichiers sont encodés en base64.
sendhttp
renvoie un tableau contenant le code de retour HTTP, l'en-tête MIME de la réponse ventilée ligne par ligne dans un tableau associatif et le corps brut de la réponse. Si un argument est invalide ou si la connexion a échoué, sendhttp
retourne false
.
EXEMPLE
php> $r = sendhttp('GET', 'http://www.google.com/search', array('q' => 'izend'));
Equivaut à taper http:://www.google.com/search?q=izend dans la barre d'adresse d'un navigateur.
php> print_r($r[0]);
200
Affiche le code de retour HTTP.
php> print_r($r[1]);
Array
(
[Date] => ...
[Expires] => -1
[Cache-Control] => private, max-age=0
[Content-Type] => text/html; charset=ISO-8859-1
...
)
Affiche l'en-tête MIME du document.
php> echo $r[1]['Content-Type'];
text/html; charset=ISO-8859-1
Affiche le type de contenu du document.
php> print_r($r[2]);
<!doctype html><head><title>izend - Google Search</title> ...
Affiche le document.
CODE
- function sendhttp($method, $url, $args, $files=false, $base64=false, $options=false, $header=false) {
sendhttp
accepte 5 arguments : un type de requête, une URL, une liste de paramètres et en option une liste de fichiers dont le contenu peut être transmis encodé en base64.
- $r = http_parse_url($url);
- if (!$r) {
- return false;
- }
- list($proto, $scheme, $host, $portnum, $path)=$r;
Décompose l'URL avec http_parse_url
.
Initialise les variables $proto
, $scheme
, $host
, $portnum
et $path
.
Retourne false
si $url
est invalide.
- $hostaddr=($scheme == 'http' && $portnum == 80) ? $host : $host . ':' . $portnum;
- $user_agent='iZend';
- $header_string=$content_string='';
- $crlf="\r\n";
- switch ($method) {
Initialise la valeur des champs Host:
et User-Agent:
de la requête.
Prépare l'en-tête et le corps du document HTTP.
Définit $crlf
à la valeur de la fin d'une ligne d'un document MIME.
Teste le type de requête.
- case 'POST':
- if ($files && is_array($files)) {
- $boundary = md5(microtime());
- $content_type = 'multipart/form-data; boundary='.$boundary;
- $content_string = '';
- if ($args && is_array($args)) {
- foreach ($args as $k => $v) {
- $content_string .= '--' . $boundary . $crlf;
- $content_string .= 'Content-Disposition: form-data; name="' . $k . '"' . $crlf . $crlf . $v . $crlf;
- }
- }
- foreach ($files as $k => $v ) {
- if (isset($v['tmp_name'])) {
- $data = file_get_contents($v['tmp_name']);
- }
- else if (isset($v['data'])) {
- $data = $v['data'];
- }
- if (!$data) {
- break;
- }
- $content_string .= '--' . $boundary . $crlf;
- $content_string .= 'Content-Disposition: form-data; name="' . $k . '"; filename="' . $v['name'] . '"' . $crlf;
- $content_string .= 'Content-Type: ' . $v['type'] . $crlf;
- if ($base64) {
- $content_string .= 'Content-Transfer-Encoding: base64' . $crlf . $crlf;
- $content_string .= chunk_split(base64_encode($data)) . $crlf;
- }
- else {
- $content_string .= 'Content-Transfer-Encoding: binary' . $crlf . $crlf;
- $content_string .= $data . $crlf;
- }
- }
- $content_string .= '--' . $boundary . '--' . $crlf;
- }
- else {
- $content_type = 'application/x-www-form-urlencoded';
- if ($args && is_array($args)) {
- $content_string = http_build_args($args);
- }
- }
- $content_length = strlen($content_string);
- $header_string="POST $path HTTP/1.1${crlf}Host: $hostaddr${crlf}User-Agent: $user_agent${crlf}Content-Type: $content_type${crlf}Content-Length: $content_length${crlf}";
- break;
- case 'GET':
- if ($args && is_array($args)) {
Si la requête est un POST, si le document à un ou plusieurs fichiers joints, écrit un document de type multipart/form-data
, sinon écrit un document de type application/x-www-form-urlencoded
.
Dans le premier cas, fabrique un corps de document avec une première partie qui définit un séparateur unique puis une séries de parties annexes contenant chacune un des fichiers joints dont le contenu est encodé en base64 si $base64
est à true
.
Dans le second cas, fabrique un corps de document HTTP contenant les paramètres éventuels de la requêtes proprement formatés avec http_build_args
.
- }
- $header_string="GET $path HTTP/1.1${crlf}Host: $hostaddr${crlf}User-Agent: $user_agent${crlf}";
- break;
- default:
- return false;
Si la requête est un GET, ajoute les paramètres éventuels proprement formatés avec http_build_args
après le chemin d'accès, puis fabrique l'en-tête du document HTTP. Le corps du document est vide.
- if ($header && is_array($header)) {
- foreach ($header as $name => $value) {
Retourne false
si $method
n'est pas 'POST'
ou 'GET'
.
- $value = implode('; ', $value);
- }
- $header_string .= "${name}: ${value}${crlf}";
- }
- }
- $header_string .= "Connection: close${crlf}${crlf}";
Ajoute dans $header_string
les lignes définies par le tableau $header
passé en argument.
- }
Termine l'entête du document.
- function sendhttpraw($proto, $host, $portnum, $header_string, $content_string=false, $options=false) {
- $url=$proto . '://' . $host . ':' . $portnum;
Envoie $header_string
et $content_string
à $host
avec sendhttpraw
et retourne un tableau avec le code HTTP renvoyé par le service, l'en-tête MIME du document sous la forme d'un tableau associatif et le contenu brut du corps de la réponse.
sendhttpraw
SYNOPSIS
sendhttpraw($proto, $host, $portnum, $header_string, $content_string=false)
DESCRIPTION
CODE
- $socket = $options ? @stream_socket_client($url, $errstr, $errno, 60, STREAM_CLIENT_CONNECT, stream_context_create($options)) : @stream_socket_client($url);
sendhttpraw
accepte 5 arguments : un type de connexion - tcp
ou ssl
, un nom d'hôte ou une adresse IP, un numéro de port, l'entête et le corps d'un document HTTP.
- if ($socket === false) {
- return false;
- }
- if (fwrite($socket, $header_string) === false) {
- return false;
Ouvre la connexion avec le serveur. Retourne false
en cas d'erreur.
- if ($content_string) {
- $content_len = strlen($content_string);
- for ($written = 0; $written < $content_len; $written += $w) {
- $w = fwrite($socket, $written == 0 ? $content_string : substr($content_string, $written));
- if ($w === false) {
- return false;
- }
- }
- }
- $response = '';
- while (!feof($socket)) {
Écrit l'en-tête du document puis le corps du document en plusieurs paquets si nécessaire.
- }
- fclose($socket);
- if (!$response) {
Lit la réponse du serveur.
- return false;
Ferme la connexion avec le serveur.
- $crlf="\r\n";
Retourne false
si la réponse est vide.
Définit $crlf
à la valeur de la fin d'une ligne d'un document MIME.
- $http_response_line = array_shift($response_header_lines);
Divise l'en-tête et le corps de la réponse. Sépare l'en-tête ligne par ligne. Extrait la première ligne de l'en-tête pour en retirer le code de retour.
- if (preg_match('@^HTTP/[0-9]\.[0-9] ([0-9]{3})@', $http_response_line, $r)) {
- $response_code = $r[1];
- }
- else {
- $response_code = 0;
- }
- $response_header_array = array();
- foreach ($response_header_lines as $header_line) {
- list($header, $value) = explode(': ', $header_line, 2);
- $response_header_array[$header] = $value;
- }
- return array($response_code, $response_header_array, $response_body);
- }
Sauve l'en-tête de la réponse dans un tableau associatif.
Retourne un tableau avec le code HTTP renvoyé par le service, l'en-tête MIME du document sous la forme d'un tableau associatif et le contenu brut du corps de la réponse.
sendget
SYNOPSIS
sendget($url, $args)
DESCRIPTION
sendget
retourne le document renvoyé par l'appel du service HTTP à l'adresse $url
en GET avec les arguments $args
.
En cas d'erreur, sendget
retourne false
.
CODE
- function sendget($url, $args=false, $options=false, $header=false) {
- return sendhttp('GET', $url, $args, false, false, $options, $header);
- }
sendget
retourne le résultat de l'appel de sendhttp
avec $method
à 'GET'
et les arguments $url
et $args
.
sendpost
SYNOPSIS
sendpost($url, $args, $files=false, $base64=false)
DESCRIPTION
sendpost
retourne le document renvoyé par l'appel du service HTTP à l'adresse $url
en POST avec les arguments $args
et les pièces jointes $files
encodées en base64 si $base64
vaut true
.
En cas d'erreur, sendpost
retourne false
.
CODE
- function sendpost($url, $args=false, $files=false, $base64=false, $options=false, $header=false) {
- return sendhttp('POST', $url, $args, $files, $base64, $options, $header);
- }
sendpost
retourne le résultat de l'appel de sendhttp
avec $method
à 'POST'
et les arguments $url
, $args
, $files
et $base64
.
http_build_args
SYNOPSIS
http_build_args($args)
DESCRIPTION
http_build_args
retourne le tableau associatif $args
sous la forme d'une chaine de paramètres d'une URL proprement encodée.
CODE
- function http_build_args($args) {
- $args_string = '';
- foreach ($args as $name => $value) {
- $args_string .= ($args_string ? '&' : '') . urlencode($name) . '=' . urlencode($value);
- }
- return $args_string;
- }
http_parse_url
SYNOPSIS
http_parse_url($url)
DESCRIPTION
http_parse_url
retourne un tableau contenant le protocole - tcp
ou ssl
, le schéma - http
ou https
, le nom d'hôte ou l'adresse IP, le numéro de port et le chemin décrit par $url
.
CODE
- function http_parse_url($url) {
- $purl = @parse_url($url);
- if ($purl === false) {
- return false;
- }
- $scheme = isset($purl['scheme']) ? $purl['scheme'] : 'http';
- switch($scheme) {
- case 'https':
- $proto = 'ssl';
- break;
- case 'http':
- $proto = 'tcp';
- break;
- default:
- return false;
- }
- $host = isset($purl['host']) ? $purl['host'] : 'localhost';
- $portnum = isset($purl['port']) ? $purl['port'] : ($scheme == 'https' ? 443 : 80);
- $path = isset($purl['path']) ? $purl['path'] : '/';
- return array($proto, $scheme, $host, $portnum, $path);
- }
Application
Encoder un code QR
Google publie une API pour dessiner des graphiques et d'autres types d'images - Google Charts API - qui permet d'obtenir une image PNG d'un code QR. Passez simplement les paramètres requis dans une <img>
:
<img src="http://chart.googleapis.com/chart?cht=qr&chf=&bg,s,ffffff&chs=63x63&chld=M|0&chl=www.izend.org" />
Pour appeler ce service dans un programme, encapsulez sendhttp
dans une fonction spécifique :
- require_once 'validatecolor.php';
- require_once 'phpqrcode/qrlib.php';
- function qrencode($s, $size=1, $quality='M', $fg=false, $bg=false, $margin=0) {
- $ql = array('L' => QR_ECLEVEL_L, 'M' => QR_ECLEVEL_M, 'Q' => QR_ECLEVEL_Q, 'H' => QR_ECLEVEL_H);
- if (!$s or !is_numeric($size) or !is_numeric($margin) or !$quality or !array_key_exists($quality, $ql) or ($fg and !validate_color($fg)) or ($bg and !validate_color($bg))) {
- return false;
- }
- if ($size < 1) {
- $size=1;
- }
- if ($margin < 0) {
- $margin=0;
- }
- $q=$ql[$quality];
- $frame = @QRcode::text($s, false, $q, 1, 0);
- if (!$frame) {
- return false;
- }
- $h = count($frame);
- $w = strlen($frame[0]);
- $img = imagecreatetruecolor($w+2*$margin, $h);
- $qrimg = imagecreatetruecolor($w*$size+2*$margin, $h*$size+2*$margin);
- if ($bg) {
- $rgb=str_split($bg[0] == '#' ? substr($bg, 1, 6) : $bg, 2);
- $r=hexdec($rgb[0]);
- $g=hexdec($rgb[1]);
- $b=hexdec($rgb[2]);
- }
- else {
- $r=$g=$b=255;
- }
- $bg=imagecolorallocate($img, $r, $g, $b);
- imagefill($img, 0, 0, $bg);
- $bg=imagecolorallocate($qrimg, $r, $g, $b);
- imagefill($qrimg, 0, 0, $bg);
- if ($fg) {
- $rgb=str_split($fg[0] == '#' ? substr($fg, 1, 6) : $fg, 2);
- $r=hexdec($rgb[0]);
- $g=hexdec($rgb[1]);
- $b=hexdec($rgb[2]);
- }
- else {
- $r=$g=$b=0;
- }
- $fg=imagecolorallocate($img, $r, $g, $b);
- for ($y=0; $y < $h; $y++) {
- for ($x=0; $x < $w; $x++) {
- if ($frame[$y][$x] == '1') {
- imagesetpixel($img, $x, $y, $fg);
- }
- }
- }
- imagecopyresized($qrimg, $img, $margin, $margin, 0, 0, $w*$size, $h*$size, $w, $h);
- imagedestroy($img);
- ob_start();
- imagepng($qrimg);
- $png=ob_get_clean();
- imagedestroy($qrimg);
- return $png;
- }
qrencode
envoie une requête GET au service à l'adresse http://chart.googleapis.com/chart et retourne les données en binaire d'une image ou false
en cas d'erreur.
$s
contient la chaîne de caractères à encoder.
$size
est en pixels.
$quality
peut valoir L
, M
, Q
ou H
.
Voir la documentation pour plus de détails.
Décoder un code QR
Décoder l'image d'un code QR est plus délicat. Supposez que vous n'ayez pas trouvé une véritable API HTTP mais juste un formulaire qui vous laisse télécharger une image et retourne le texte décodé : ZXing Decoder Online. Essayez-le. Ce formulaire retourne le texte décodé ou un autre document HTML en cas d'erreur.
Extrayez le code source du formulaire :
<form enctype="multipart/form-data" method="post" action="decode">
<p><input name="f" size="50" type="file"/> <input type="submit"/>
<input value="true" name="full" type="hidden"/></p></form>
Écrivez une fonction qui passe ces paramètres dans une requête HTTP du type POST :
- require_once 'sendhttp.php';
- require_once 'filemimetype.php';
- function qrdecode($file) {
- $url = 'http://zxing.org/w/decode';
- $args = array(
- 'full' => 'true',
- );
- $files=array('f' => array('name' => basename($file), 'tmp_name' => $file, 'type' => file_mime_type($file)));
- $response=sendpost($url, $args, $files, false); // DON'T encode data in base64
- if (!$response or $response[0] != 200) {
- return false;
- }
- if (!preg_match('#<tr><td>Parsed Result</td><td><pre.*>(.*)</pre></td></tr>#', $response[2], $r)) { // extract data - adapt when response format changes
- return false;
- }
- return strip_tags($r[1]);
- }
qrdecode
envoie une requête POST à l'adresse http://zxing.org/w/decode avec un fichier en pièce jointe.
Si le service retourne un autre document HTML, qrdecode
retourne false
.
IMPORTANT: Soyez très prudent lorsque vous insérez des données retournées par un autre programme. Si possible, retirez toutes les balises avec strip_tags
et ajoutez votre propre formatage.
Commentaires