mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-24 17:02:18 +01:00
254 lines
6.2 KiB
XML
254 lines
6.2 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 5cdfb2a044f9bcd5fed5c399de09edf7c89afd45 Maintainer: yannick Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
|
|
<refentry xml:id="eventhttp.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<refnamediv>
|
|
<refname>EventHttp::__construct</refname>
|
|
<refpurpose>Construit un objet EventHttp (le serveur HTTP)</refpurpose>
|
|
</refnamediv>
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<modifier>public</modifier>
|
|
<methodname>EventHttp::__construct</methodname>
|
|
<methodparam>
|
|
<type>EventBase</type>
|
|
<parameter>base</parameter>
|
|
</methodparam>
|
|
<methodparam choice="opt">
|
|
<type>EventSslContext</type>
|
|
<parameter>ctx</parameter>
|
|
<initializer>&null;</initializer>
|
|
</methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
Construit l'objet serveur HTTP.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<parameter>base</parameter>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Evénement de base associé.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<parameter>ctx</parameter>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
L'objet de la classe <classname>EventSslContext</classname>.
|
|
Transforme un serveur HTTP en un serveur HTTPS. Cela signifie que si
|
|
le paramètre <parameter>ctx</parameter> est configuré correctement,
|
|
alors le buffer d'événements sous-jacent ser abasé sur des sockets OpenSSL.
|
|
Aussi, tout le trafic passera via SSL ou TLS.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
Ce paramètre n'est disponible que si <literal>Event</literal>
|
|
a été compilé avec le support d'OpenSSL, et seulement à partir de la
|
|
version <literal>Libevent 2.1.0-alpha</literal> ou supérieures.
|
|
</para>
|
|
</note>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1 role="changelog">
|
|
&reftitle.changelog;
|
|
<para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>PECL event 1.9.0</entry>
|
|
<entry>
|
|
Ajout du support d'OpenSSL (<parameter>ctx</parameter>).
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="examples">
|
|
&reftitle.examples;
|
|
<example>
|
|
<title>Serveur HTTP simple</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
/*
|
|
* Serveur HTTP simple.
|
|
*
|
|
* Pour le tester :
|
|
* 1) Exécutez-le sur le port de votre choix, i.e. :
|
|
* $ php examples/http.php 8010
|
|
* 2) Dans un autre terminal, connectez-vous sur une adresse de ce port
|
|
* et effectuez une requête GET ou POST (les autres sont désactivées ici),
|
|
* i.e. :
|
|
* $ nc -t 127.0.0.1 8010
|
|
* POST /about HTTP/1.0
|
|
* Content-Type: text/plain
|
|
* Content-Length: 4
|
|
* Connection: close
|
|
* (press Enter)
|
|
*
|
|
* Il devrait afficher :
|
|
* a=12
|
|
* HTTP/1.0 200 OK
|
|
* Content-Type: text/html; charset=ISO-8859-1
|
|
* Connection: close
|
|
*
|
|
* $ nc -t 127.0.0.1 8010
|
|
* GET /dump HTTP/1.0
|
|
* Content-Type: text/plain
|
|
* Content-Encoding: UTF-8
|
|
* Connection: close
|
|
* (press Enter)
|
|
*
|
|
* Il devrait afficher :
|
|
* HTTP/1.0 200 OK
|
|
* Content-Type: text/html; charset=ISO-8859-1
|
|
* Connection: close
|
|
* (press Enter)
|
|
*
|
|
* $ nc -t 127.0.0.1 8010
|
|
* GET /unknown HTTP/1.0
|
|
* Connection: close
|
|
*
|
|
* Il devrait afficher :
|
|
* HTTP/1.0 200 OK
|
|
* Content-Type: text/html; charset=ISO-8859-1
|
|
* Connection: close
|
|
*
|
|
* 3) Regardez ce que le serveur affiche sur le précédent terminal.
|
|
*/
|
|
|
|
function _http_dump($req, $data) {
|
|
static $counter = 0;
|
|
static $max_requests = 2;
|
|
|
|
if (++$counter >= $max_requests) {
|
|
echo "Counter reached max requests $max_requests. Exiting\n";
|
|
exit();
|
|
}
|
|
|
|
echo __METHOD__, " called\n";
|
|
echo "request:"; var_dump($req);
|
|
echo "data:"; var_dump($data);
|
|
|
|
echo "\n===== DUMP =====\n";
|
|
echo "Command:", $req->getCommand(), PHP_EOL;
|
|
echo "URI:", $req->getUri(), PHP_EOL;
|
|
echo "Input headers:"; var_dump($req->getInputHeaders());
|
|
echo "Output headers:"; var_dump($req->getOutputHeaders());
|
|
|
|
echo "\n >> Sending reply ...";
|
|
$req->sendReply(200, "OK");
|
|
echo "OK\n";
|
|
|
|
echo "\n >> Reading input buffer ...\n";
|
|
$buf = $req->getInputBuffer();
|
|
while ($s = $buf->readLine(EventBuffer::EOL_ANY)) {
|
|
echo $s, PHP_EOL;
|
|
}
|
|
echo "No more data in the buffer\n";
|
|
}
|
|
|
|
function _http_about($req) {
|
|
echo __METHOD__, PHP_EOL;
|
|
echo "URI: ", $req->getUri(), PHP_EOL;
|
|
echo "\n >> Sending reply ...";
|
|
$req->sendReply(200, "OK");
|
|
echo "OK\n";
|
|
}
|
|
|
|
function _http_default($req, $data) {
|
|
echo __METHOD__, PHP_EOL;
|
|
echo "URI: ", $req->getUri(), PHP_EOL;
|
|
echo "\n >> Sending reply ...";
|
|
$req->sendReply(200, "OK");
|
|
echo "OK\n";
|
|
}
|
|
|
|
$port = 8010;
|
|
if ($argc > 1) {
|
|
$port = (int) $argv[1];
|
|
}
|
|
if ($port <= 0 || $port > 65535) {
|
|
exit("Invalid port");
|
|
}
|
|
|
|
$base = new EventBase();
|
|
$http = new EventHttp($base);
|
|
$http->setAllowedMethods(EventHttpRequest::CMD_GET | EventHttpRequest::CMD_POST);
|
|
|
|
$http->setCallback("/dump", "_http_dump", array(4, 8));
|
|
$http->setCallback("/about", "_http_about");
|
|
$http->setDefaultCallback("_http_default", "custom data value");
|
|
|
|
$http->bind("0.0.0.0", 8010);
|
|
$base->loop();
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs.similar;
|
|
<screen>
|
|
<![CDATA[
|
|
a=12
|
|
HTTP/1.0 200 OK
|
|
Content-Type: text/html; charset=ISO-8859-1
|
|
Connection: close
|
|
|
|
HTTP/1.0 200 OK
|
|
Content-Type: text/html; charset=ISO-8859-1
|
|
Connection: close
|
|
(press Enter)
|
|
|
|
HTTP/1.0 200 OK
|
|
Content-Type: text/html; charset=ISO-8859-1
|
|
Connection: close
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
</refsect1>
|
|
</refentry>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|