cvs: phpdoc /fr/functions network.xml
| From: | Damien Seguy | Date: | Wed, 06 Dec 2000 13:02:05 +0000 |
| Subject: | cvs: phpdoc /fr/functions network.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333153@lists.php.net to get a copy of this message | ||
dams Wed Dec 6 05:02:05 2000 EDT
Modified files:
/phpdoc/fr/functions network.xml
Log:
Added several options' details.
Index: phpdoc/fr/functions/network.xml diff -u phpdoc/fr/functions/network.xml:1.5 phpdoc/fr/functions/network.xml:1.6 --- phpdoc/fr/functions/network.xml:1.5 Thu Oct 19 13:08:17 2000 +++ phpdoc/fr/functions/network.xml Wed Dec 6 05:02:05 2000 @@ -1,7 +1,6 @@ <reference id="ref.network"> <title>Réseau</title> <titleabbrev>Réseau</titleabbrev> - <refentry id="function.checkdnsrr"> <refnamediv> <refname>checkdnsrr</refname> @@ -10,55 +9,63 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>checkdnsrr</function></funcdef> - <paramdef>string <parameter>host</parameter></paramdef> - <paramdef>string <parameter><optional>type</optional></parameter></paramdef> + <funcprototype> + <funcdef>int <function>checkdnsrr</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string + <parameter><optional>type</optional></parameter> + </paramdef> + </funcprototype> </funcsynopsis> - <simpara> - Recherche l'enregistrement DNS de type <parameter>type</parameter> correspondant - à l'hôte <parameter>host</parameter>. - Retourne TRUE si un record a été trouvé, et FALSE en cas d'erreur ou d'échec. - </simpara> - + <function>checkdnsrr</function> recherche l'enregistrement DNS de type + <parameter>type</parameter> correspondant à l'hôte + <parameter>host</parameter>. Retourne TRUE si un record a été + trouvé, et FALSE en cas d'erreur ou d'échec. + </simpara> <simpara> - <parameter>type</parameter> peut prendre les valeurs suivantes : A, MX, NS, SOA, - PTR, CNAME, ou ANY. Par défaut, la valeur est : MX. + <parameter>type</parameter> peut prendre les valeurs suivantes : + A, MX, NS, SOA, PTR, CNAME, ou ANY. Par défaut, + la valeur est : MX. </simpara> - <simpara> - <parameter>host</parameter> peut être soit une adresse IP de la forme + <parameter>host</parameter> peut être soit une adresse IP de la forme x.x.x.x avec x entre 0 et 256, soit un nom d'hôte. </simpara> - <simpara> - Voir aussi - <function>getmxrr</function>, <function>gethostbyaddr</function>, - <function>gethostbyname</function>, <function>gethostbynamel</function> et - la page de manuel named(8).</simpara> - + Voir aussi <function>getmxrr</function>, + <function>gethostbyaddr</function>, + <function>gethostbyname</function>, + <function>gethostbynamel</function> et + la page de manuel named(8). + </simpara> </refsect1> </refentry> - <refentry id="function.closelog"> <refnamediv> <refname>closelog</refname> - <refpurpose>Ferme la connexion à l'historique système.</refpurpose> + <refpurpose>Ferme la connexion à l'historique système.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>closelog</function></funcdef> - <void/> + <funcprototype> + <funcdef>int <function>closelog</function></funcdef> + <void/> + </funcprototype> </funcsynopsis> + <para> + <function>closelog</function> ferme le pointeur qui sert à + écrire dans l'historique système. L'utilisation de + <function>closelog</function> est optionnelle. + </para> <para> - <function>closelog</function> ferme le pointeur qui sert à écrire - dans l'historique système. L'utilisation de <function>closelog</function> est - optionnelle. + Voir aussi <function>define_syslog_variables</function>, + <function>syslog</function> et + <function>openlog</function>. </para> </refsect1> </refentry> - <refentry id="function.debugger-off"> <refnamediv> <refname>debugger_off</refname> @@ -67,16 +74,17 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>debugger_off</function></funcdef> - <void/> + <funcprototype> + <funcdef>int <function>debugger_off</function></funcdef> + <void/> + </funcprototype> </funcsynopsis> <para> - Inactive le debuggeur interne de PHP. Le debuggeur est toujours en cours de - développement. + <function>debugger_off</function> inactive le debuggeur interne de PHP. + Le debuggeur est toujours en cours de développement. </para> </refsect1> </refentry> - <refentry id="function.debugger-on"> <refnamediv> <refname>debugger_on</refname> @@ -89,12 +97,12 @@ <paramdef>string <parameter>address</parameter></paramdef> </funcsynopsis> <para> - Active le debugger interne de PHP, et le connecte à l'adresse - <parameter>address</parameter>. Le debuggeur est toujours en cours de développement. + <function>debugger_on</function> active le debugger interne de PHP, et + le connecte à l'adresse <parameter>address</parameter>. Le debuggeur + est toujours en cours de développement. </para> </refsect1> </refentry> - <refentry id="function.define-syslog-variables"> <refnamediv> <refname>define_syslog_variables</refname> @@ -109,7 +117,8 @@ </funcprototype> </funcsynopsis> <para> - Initialise toutes les constantes utilisées par les fonctions de syslog. + <function>define_syslog_varaibles</function> initialise toutes les + constantes utilisées par les fonctions de syslog. </para> <para> Voir aussi <function>openlog</function>, @@ -118,60 +127,69 @@ </para> </refsect1> </refentry> - <refentry id="function.fsockopen"> <refnamediv> <refname>fsockopen</refname> - <refpurpose>Ouvre une socket de connexion Internet ou Unix.</refpurpose> + <refpurpose>Ouvre une socket de connexion Internet ou Unix.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>fsockopen</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> - <paramdef>int <parameter>port</parameter></paramdef> - <paramdef>int <parameter><optional>errno</optional></parameter></paramdef> - <paramdef>string <parameter><optional>errstr</optional></parameter></paramdef> - <paramdef>double - <parameter><optional>timeout</optional></parameter></paramdef> - </funcsynopsis> - - <para> - Créer un flot de connexion à l'Internet (AF_INET) ou à un domaine Unix (AF_UNIX). - Via Internet, cette fonction va ouvrir une socket de connexion TCP avec l'hôte - <parameter>hostname</parameter> sur le port <parameter>port</parameter>. - Via un domaine Unix, <parameter>hostname</parameter> représente le chemin jusqu'à - la socket, et <parameter>port</parameter> doit être mis à 0. L' option - <parameter>timeout</parameter> sert à donner une durée maximale à cet appel. - </para> - - <para> - <function>fsockopen</function> retourne un pointeur de fichier qui peut être - utilisé avec d'autres fonctions fichiers, telles que <function>fgets</function>, - <function>fgetss</function>, <function>fputs</function>, - <function>fclose</function> et <function>feof</function>. - </para> - - <para> - Si l'appel échoue, <function>fsockopen</function> retourne FALSE, et si les - options <parameter>errno</parameter> et <parameter>errstr</parameter> ont été - fournies, elles contiennent désormais les raisons de l'échec. Si l'erreur - retournée est 0 et que la fonction retourne FALSE, c'est une indication d'erreur. - C'est probablement du à une erreur d'initialisation de la socket. Notez que - <parameter>errno</parameter> et <parameter>errstr</parameter> sont passées par - référence. - </para> - - <para> - Suivant les environnements, le type 'domaine Unix' ou l'option <parameter>timeout</parameter> - ne sont pas toujours disponibles. - </para> - - <para> - La socket sera ouverte par défaut en mode bloquant. Vous pouvez changer de mode - en utilisant : <function>set_socket_blocking</function>. - <example> - <title>fsockopen example</title> + <funcprototype> + <funcdef>int <function>fsockopen</function></funcdef> + <paramdef> + string <parameter><optional>udp://</optional>hostname</parameter> + </paramdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>int + <parameter><optional>errno</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>errstr</optional></parameter> + </paramdef> + <paramdef>double + <parameter><optional>timeout</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fsockopen</function> créer un flot de connexion à + l'Internet (AF_INET) ou à un domaine Unix (AF_UNIX). Via Internet, + cette fonction va ouvrir une socket de connexion TCP avec l'hôte + <parameter>hostname</parameter> sur le port <parameter>port</parameter>. + Pour les connexions UDP, vous devez explicitement spécifier le protocole : + <parameter>udp://hostname</parameter>. + Via un domaine Unix, <parameter>hostname</parameter> représente le + chemin jusqu'à la socket, et <parameter>port</parameter> doit + être mis à 0. L'option <parameter>timeout</parameter> sert + à donner une durée maximale à cet appel. + </para> + <para> + <function>fsockopen</function> retourne un pointeur de fichier qui peut + être utilisé avec d'autres fonctions fichiers, telles que + <function>fgets</function>, <function>fgetss</function>, + <function>fputs</function>, <function>fclose</function> et + <function>feof</function>. + </para> + <para> + Si l'appel échoue, <function>fsockopen</function> retourne FALSE, + et si les options <parameter>errno</parameter> et <parameter>errstr</parameter> + ont été fournies, elles contiennent désormais les + raisons de l'échec. Si l'erreur retournée est 0 et que la + fonction retourne FALSE, c'est une indication d'erreur. C'est probablement + du à une erreur d'initialisation de la socket. Notez que + <parameter>errno</parameter> et <parameter>errstr</parameter> sont + passées par référence. + </para> + <para> + Suivant les environnements, le type 'domaine Unix' ou l'option + <parameter>timeout</parameter> ne sont pas toujours disponibles. + </para> + <para> + La socket sera ouverte par défaut en mode bloquant. Vous pouvez + changer de mode en utilisant : <function>socket_set_blocking</function>. + <example> + <title>Exemple avec <function>fsockopen</function></title> <programlisting> $fp = fsockopen("www.php.net", 80, &$errno, &$errstr, 30); if(!$fp) { @@ -185,84 +203,107 @@ } </programlisting> </example> - - Voir aussi <function>pfsockopen</function></para> - + L'exemple ci-dessous décrit comment lire la date et l'heure grâce à + un service UDP "daytime" (port 13), sur votre propre machine. + <example> + <title>Utilisation d'une connexion UDP</title> + <programlisting role="php"> +<?php +$fp = fsockopen("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); +} +?> + </programlisting> + </example> + Voir aussi: <function>pfsockopen</function>, + <function>socket_set_blocking</function>, + <function>socket_set_timeout</function>, <function>fgets</function>, + <function>fgetss</function>, <function>fputs</function>, + <function>fclose</function>, et <function>feof</function>. + </para> </refsect1> </refentry> - <refentry id="function.gethostbyaddr"> <refnamediv> <refname>gethostbyaddr</refname> - <refpurpose>Retourne le nom d'hôte correspondant à une IP.</refpurpose> + <refpurpose> + Retourne le nom d'hôte correspondant à une IP. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>gethostbyaddr</function></funcdef> - <paramdef>string <parameter>ip_address</parameter></paramdef> + <funcprototype> + <funcdef>string <function>gethostbyaddr</function></funcdef> + <paramdef>string <parameter>ip_address</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - Retourne le nom d'hôte correspondant à l'IP <parameter>ip_address</parameter>. + <function>gethostbyaddr</function> retourne le nom d'hôte + correspondant à l'IP <parameter>ip_address</parameter>. Si une erreur survient, retourne <parameter>ip_address</parameter>. </para> - <para> Voir aussi <function>gethostbyname</function>. </para> - </refsect1> </refentry> - <refentry id="function.gethostbyname"> <refnamediv> <refname>gethostbyname</refname> - <refpurpose>Retourne l'adresse IP correspondant à un hôte.</refpurpose> + <refpurpose> + Retourne l'adresse IP correspondant à un hôte. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>gethostbyname</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> + <funcprototype> + <funcdef>string <function>gethostbyname</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - Retourne l'adresse IP correspondant à l'hôte <parameter>hostname</parameter>. - </para> - + <function>gethostbyname</function> retourne l'adresse IP + correspondant à l'hôte <parameter>hostname</parameter>. + </para> <para> Voir aussi <function>gethostbyaddr</function>. </para> - </refsect1> </refentry> - <refentry id="function.gethostbynamel"> <refnamediv> <refname>gethostbynamel</refname> - <refpurpose>Retourne la liste d'IP correspondants à un hôte.</refpurpose> + <refpurpose> + Retourne la liste d'IP correspondants à un hôte. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>array <function>gethostbynamel</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> + <funcprototype> + <funcdef>array <function>gethostbynamel</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - Retourne la liste d'IP correspondant à l'hôte <parameter>hostname</parameter>. + <function>gethostbynamel</function> retourne la liste d'IP + correspondant à l'hôte <parameter>hostname</parameter>. </para> - <para> - Voir aussi - <function>gethostbyname</function>, <function>gethostbyaddr</function>, - <function>checkdnsrr</function>, <function>getmxrr</function> - et la page 8 du manuel.</para> - + Voir aussi <function>gethostbyname</function>, + <function>gethostbyaddr</function>, + <function>checkdnsrr</function>, <function>getmxrr</function> + et la page 8 du manuel. + </para> </refsect1> </refentry> - <refentry id="function.getmxrr"> <refnamediv> <refname>getmxrr</refname> @@ -271,107 +312,114 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>getmxrr</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> - <paramdef>array <parameter>mxhosts</parameter></paramdef> - <paramdef>array <parameter><optional>weight</optional></parameter></paramdef> + <funcprototype> + <funcdef>int <function>getmxrr</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + <paramdef>array <parameter>mxhosts</parameter></paramdef> + <paramdef>array + <parameter><optional>weight</optional></parameter> + </paramdef> + </funcprototype> </funcsynopsis> - <simpara> - Effectue une recherche DNS pour obtenir les enregistrements MX de - l'hôte <parameter>hostname</parameter>. Retourne TRUE si des enregistrements sont - trouvés, et FALSE si une erreur est rencontrée, ou si la recherche échoue. + <function>getmxrr</function> effectue une recherche DNS pour + obtenir les enregistrements MX de l'hôte <parameter>hostname</parameter>. + Retourne TRUE si des enregistrements sont trouvés, et + FALSE si une erreur est rencontrée, ou si la recherche + échoue. </simpara> - <simpara> - La liste des enregistrements MX est placée dans le tableau - <parameter>mxhosts</parameter>. Si le tableau <parameter>weight</parameter> + La liste des enregistrements MX est placée dans le tableau + <parameter>mxhosts</parameter>. Si le tableau <parameter>weight</parameter> est fourni, il sera rempli par les informations de poids. </simpara> - <simpara> Voir aussi <function>checkdnsrr</function>, <function>gethostbyname</function>, - <function>gethostbynamel</function>, <function>gethostbyaddr</function>, + <function>gethostbynamel</function>, <function>gethostbyaddr</function>, et la page 8 du manuel. </simpara> - </refsect1> </refentry> - <refentry id="function.getprotobyname"> <refnamediv> <refname>getprotobyname</refname> - <refpurpose>Retourne le numéro de protocole associé au nom de protocole</refpurpose> + <refpurpose> + Retourne le numéro de protocole associé au nom de protocole + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>getprotobyname</function></funcdef> - <paramdef>string <parameter>name</parameter></paramdef> + <funcprototype> + <funcdef>int <function>getprotobyname</function></funcdef> + <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>getprotobyname</function> retourne le numéro de protocole associé avec - le nom de protocole <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. + <function>getprotobyname</function> retourne le numéro de + protocole associé avec le nom de protocole + <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. </para> <para> Voir aussi <function>getprotobynumber</function>. </para> </refsect1> </refentry> - <refentry id="function.getprotobynumber"> <refnamediv> <refname>getprotobynumber</refname> - <refpurpose>Retourne le nom de protocole associé au numéro de protocole</refpurpose> + <refpurpose> + Retourne le nom de protocole associé au numéro de protocole + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>getprotobynumber</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> + <funcprototype> + <funcdef>string <function>getprotobynumber</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>getprotobynumber</function> retourne le numéro de protocole associé avec - le nom de protocole <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. + <function>getprotobynumber</function> retourne le numéro + de protocole associé avec le nom de protocole + <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. </para> <para> Voir aussi <function>getprotobyname</function>. </para> </refsect1> </refentry> - <refentry id="function.getservbyname"> <refnamediv> <refname>getservbyname</refname> <refpurpose> - Retourne le numéro de port associé à un service Internet, et un protocole. + Retourne le numéro de port associé à un service + Internet, et un protocole. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>getservbyname</function></funcdef> - <paramdef>string <parameter>service</parameter></paramdef> - <paramdef>string <parameter>protocol</parameter></paramdef> + <funcprototype> + <funcdef>int <function>getservbyname</function></funcdef> + <paramdef>string <parameter>service</parameter></paramdef> + <paramdef>string <parameter>protocol</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>getservbyname</function> retourne le numéro de port associé à - au service <parameter>service</parameter> et protocole - <parameter>protocol</parameter>, comme dans <filename>/etc/services</filename>. - <parameter>protocol</parameter> vaut soit <literal>tcp</literal> ou - <literal>udp</literal>. + <function>getservbyname</function> retourne le numéro de + port associé à au service <parameter>service</parameter> + et protocole <parameter>protocol</parameter>, comme dans + <filename>/etc/services</filename>. <parameter>protocol</parameter> + vaut soit <literal>tcp</literal> ou <literal>udp</literal>. </para> - <para> Voir aussi <function>getservbyport</function>. </para> </refsect1> </refentry> - <refentry id="function.getservbyport"> <refnamediv> <refname>getservbyport</refname> @@ -382,14 +430,15 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>getservbyport</function></funcdef> - <paramdef>int <parameter>port</parameter></paramdef> - <paramdef>string <parameter>protocol</parameter></paramdef> + <funcprototype> + <funcdef>string <function>getservbyport</function></funcdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>string <parameter>protocol</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> <function>getservbyport</function> le service internet associé au port - <parameter>port</parameter> pour le protocole <parameter>protocol</parameter> + <parameter>port</parameter> pour le protocole <parameter>protocol</parameter> comme dans <filename>/etc/services</filename>. <parameter>protocol</parameter> vaut soit <literal>tcp</literal> ou <literal>udp</literal>. @@ -399,14 +448,13 @@ </para> </refsect1> </refentry> - <refentry id="function.ip2long"> <refnamediv> <refname>ip2long</refname> <refpurpose> - Converti une chaîne contenant une adresse (IPv4) IP numérique en adresse - litérale. - </refpurpose> + Converti une chaîne contenant une adresse (IPv4) + IP numérique en adresse litérale. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -417,10 +465,10 @@ </funcprototype> </funcsynopsis> <para> - <function>ip2long</function> génére une adresse IPv4 à partir de son - équivalent numérique. + <function>ip2long</function> génére une adresse + IPv4 à partir de son équivalent numérique. <example> - <title>Exemple <function>Ip2long</function></title> + <title>Exemple <function>ip2long</function></title> <programlisting role="php"> <? $ip = gethostbyname("www.php.net"); @@ -436,13 +484,12 @@ </para> </refsect1> </refentry> - <refentry id="function.long2ip"> <refnamediv> <refname>long2ip</refname> <refpurpose> Converti une adresse IP (IPv4) en adresse IP numérique - </refpurpose> + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -453,69 +500,199 @@ </funcprototype> </funcsynopsis> <para> - <function>long2ip</function> génére une adresse IP (format aaa.bbb.ccc.ddd) - à partir de sa représentation litérale. + <function>long2ip</function> génére une adresse IP + (format aaa.bbb.ccc.ddd) à partir de sa représentation + litérale. </para> <para> Voir aussi: <function>ip2long</function> </para> </refsect1> </refentry> - <refentry id="function.openlog"> <refnamediv> <refname>openlog</refname> - <refpurpose>Ouvre la connexion à l'historique système.</refpurpose> + <refpurpose>Ouvre la connexion à l'historique système.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>openlog</function></funcdef> - <paramdef>string <parameter>ident</parameter></paramdef> - <paramdef>int <parameter>option</parameter></paramdef> - <paramdef>int <parameter>facility</parameter></paramdef> + <funcprototype> + <funcdef>int <function>openlog</function></funcdef> + <paramdef>string <parameter>ident</parameter></paramdef> + <paramdef>int <parameter>option</parameter></paramdef> + <paramdef>int <parameter>facility</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>openlog</function> ouvre la connexion à l'historique système. La chaîne - <parameter>ident</parameter> sera ajouté à chaque message. Les valeurs de - <parameter>option</parameter> et <parameter>facility</parameter> sont données dans - la section suivante. L'utilisation de <function>openlog</function> est - optionnelle; cette fonction sera automatiquement appelée par - <function>syslog</function> si nécessaire, et dans ce cas, l'identification - sera mise par défaut à <literal>FALSE</literal>. + <function>openlog</function> ouvre la connexion à l'historique + système. La chaîne <parameter>ident</parameter> sera + ajouté à chaque message. Les valeurs de + <parameter>option</parameter> et <parameter>facility</parameter> sont + données ci-dessous. L'utilisation de <function>openlog</function> + est optionnelle; cette fonction sera automatiquement appelée par + <function>syslog</function> si nécessaire, et dans ce cas, + l'identification sera mise par défaut à <literal>FALSE</literal>. + <parameter>facility</parameter> sert à indiquer quel programme + enregistre ce message. Cela vous permet de spécifier + (sur la machine d'historique) comment traiter les messages venant + de plusieurs serveurs. </para> - <para> - Voir aussi <function>syslog</function> et <function>closelog</function>. + <para> + <table> + <title>Options <function>openlog</function></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_CONS</entry> + <entry> + Si une erreur survient lors de l'envoi des données au gestionnaire + d'historique, écrire directement l'erreur sur la console. + </entry> + </row> + <row> + <entry>LOG_NDELAY</entry> + <entry> + Ouvre immédiatement une connexion au gestionnaire d'historique + </entry> + </row> + <row> + <entry>LOG_ODELAY</entry> + <entry> + (par défaut) retarde l'ouverture de la connexion jusqu'à ce que le + premier message soit enregistré + </entry> + </row> + <row> + <entry>LOG_PERROR</entry> + <entry>Envoie le message au gestionnaire standard</entry> + </row> + <row> + <entry>LOG_PID</entry> + <entry>Inclus le PID à chaque message</entry> + </row> + </tbody> + </tgroup> + </table> + Vous pouvez utiliser une ou plusieurs de ces options. Pour les + combiner, utiliser l'opérateur <literal>OR</literal>. Par exemple, + pour ouvrir immédiatement la connexion, écrire sur la console et + inclure le PID de chaque message, utilisez : + <literal>LOG_CONS | LOG_NDELAY | LOG_PID</literal>. + </para> + <para> + <table> + <title> + Paramètre <parameter>facility</parameter> de <function>openlog</function> + </title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_AUTH</entry> + <entry> + securité/messages d'autorisation (utilisez LOG_AUTHPRIV, pour + remplacer cette constante sur les systèmes où elle est définie). + </entry> + </row> + <row> + <entry>LOG_AUTHPRIV</entry> + <entry>securité/messages d'autorisation (privé)</entry> + </row> + <row> + <entry>LOG_CRON</entry> + <entry>démon horologe (cron et at)</entry> + </row> + <row> + <entry>LOG_DAEMON</entry> + <entry>autres démons système</entry> + </row> + <row> + <entry>LOG_KERN</entry> + <entry>noyau (kernel)</entry> + </row> + <row> + <entry>LOG_LOCAL0 ... LOG_LOCAL7</entry> + <entry>reservé pour utilisation ultérieure</entry> + </row> + <row> + <entry>LOG_LPR</entry> + <entry>imprimante (line printer subsystem)</entry> + </row> + <row> + <entry>LOG_MAIL</entry> + <entry>messagerie mail</entry> + </row> + <row> + <entry>LOG_NEWS</entry> + <entry>USENET newsgroup</entry> + </row> + <row> + <entry>LOG_SYSLOG</entry> + <entry>messages generé en interne par syslogd</entry> + </row> + <row> + <entry>LOG_USER</entry> + <entry>messages utilisateurs générique</entry> + </row> + <row> + <entry>LOG_UUCP</entry> + <entry>UUCP subsystem</entry> + </row> + </tbody> + </tgroup> + </table> </para> + <para> + Voir aussi <function>define_syslog_variables</function>, + <function>syslog</function> et <function>closelog</function>. + </para> </refsect1> </refentry> - <refentry id="function.pfsockopen"> <refnamediv> <refname>pfsockopen</refname> - <refpurpose>Ouvre une socket de connexion Internet ou Unix persistante.</refpurpose> + <refpurpose> + Ouvre une socket de connexion Internet ou Unix persistante. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>pfsockopen</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> - <paramdef>int <parameter>port</parameter></paramdef> - <paramdef>int <parameter><optional>errno</optional></parameter></paramdef> - <paramdef>string <parameter><optional>errstr</optional></parameter></paramdef> - <paramdef>int - <parameter><optional>timeout</optional></parameter></paramdef> - </funcsynopsis> - - <para> - Cette fonction se comporte exactement comme <function>fsockopen</function> - mais la connexion ouverte le reste, même après la fin du script. C'est la - version persistante de <function>fsockopen</function>. - </para> + <funcprototype> + <funcdef>int <function>pfsockopen</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>int + <parameter><optional>errno</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>errstr</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>timeout</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pfsockopen</function> se comporte exactement comme + <function>fsockopen</function> mais la connexion ouverte le reste, + même après la fin du script. C'est la version + persistante de <function>fsockopen</function>. + </para> </refsect1> </refentry> - <refentry id="function.socket-get-status"> <refnamediv> <refname>socket_get_status</refname> @@ -528,15 +705,16 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>socket_get_status</function></funcdef> - <paramdef>resource + <paramdef>resource <parameter>socket_get_status</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - <function>socket_get_status</function> retourne les informations sur la socket - <parameter>socket_get_status</parameter>, et fournit la réponse sous la forme - d'un tableau à quatre entrées: + <function>socket_get_status</function> retourne les informations + sur la socket <parameter>socket_get_status</parameter>, et fournit + la réponse sous la forme d'un tableau à quatre + entrées: </para> <itemizedlist> <listitem> @@ -547,23 +725,25 @@ </listitem> <listitem> <para> - <parameter>blocked</parameter> (bool) - La socket a été bloquée + <parameter>blocked</parameter> (bool) - La socket a + été bloquée </para> </listitem> <listitem> <para> - <parameter>eof</parameter> (bool) - Indique un événement fin de fichier (EOF) + <parameter>eof</parameter> (bool) - Indique un événement + fin de fichier (EOF) </para> </listitem> <listitem> <para> - <parameter>unread_bytes</parameter> (int) - Nombre d'octets restant dans + <parameter>unread_bytes</parameter> (int) - Nombre d'octets restant dans les buffers de la socket. </para> </listitem> </itemizedlist> <para> - Voir aussi + Voir aussi <function>accept_connect</function>, <function>bind</function>, <function>connect</function>, @@ -572,35 +752,35 @@ </para> </refsect1> </refentry> - - <refentry id="function.set-socket-blocking"> + <refentry id="function.socket-set-blocking"> <refnamediv> - <refname>set_socket_blocking</refname> - <refpurpose>Active/desactive le mode bloquant d'une socket.</refpurpose> + <refname>socket_set_blocking</refname> + <refpurpose>Active/desactive le mode bloquant d'une socket.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>set_socket_blocking</function></funcdef> - <paramdef>int <parameter>socket descriptor</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> + <funcprototype> + <funcdef>int <function>socket_set_blocking</function></funcdef> + <paramdef>int <parameter>socket descriptor</parameter></paramdef> + <paramdef>int <parameter>mode</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> - Si <parameter>mode</parameter> est FALSE, la socket est mise en mode non bloquant, - et si il est TRUE, la socket est mise en mode bloquant. Cela affecte des appels - tels que <function>fgets</function> qui lisent depuis une socket. En mode non - bloquant, un appel <function>fgets</function> retournera immediatement toujours - TRUE tandis qu'en mode bloquant, elle va attendre que des données arrivent pour - répondre TRUE. + Si <parameter>mode</parameter> est FALSE, la socket est mise en + mode non bloquant, et si il est TRUE, la socket est mise en mode + bloquant. Cela affecte des appels tels que <function>fgets</function> + qui lisent depuis une socket. En mode non bloquant, un appel + <function>fgets</function> retournera immediatement toujours + TRUE tandis qu'en mode bloquant, elle va attendre que des + données arrivent pour répondre TRUE. </para> - </refsect1> </refentry> - <refentry id="function.socket-set-timeout"> <refnamediv> <refname>socket_set_timeout</refname> - <refpurpose>Fixe la durée de vie de la socket</refpurpose> + <refpurpose>Fixe la durée de vie de la socket</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -638,7 +818,7 @@ </example> </para> <para> - Cette fonction s'appelait <function>set_socket_timeout</function> + Cette fonction s'appelait set_socket_timeout() mais elle est désormais obsolète. </para> <para> @@ -646,35 +826,115 @@ </para> </refsect1> </refentry> - <refentry id="function.syslog"> <refnamediv> <refname>syslog</refname> - <refpurpose>Génére un message dans l'historique système.</refpurpose> + <refpurpose> + Génére un message dans l'historique système. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>syslog</function></funcdef> - <paramdef>int <parameter>priority</parameter></paramdef> - <paramdef>string <parameter>message</parameter></paramdef> + <funcprototype> + <funcdef>int <function>syslog</function></funcdef> + <paramdef>int <parameter>priority</parameter></paramdef> + <paramdef>string <parameter>message</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> - <function>syslog</function> génére un message qui sera inscrit dans l'historique - par le système. <parameter>priority</parameter> est une combinaison des valeurs - d'accès et de niveau, qui seront décrites dans la prochaîne section. Les derniers - arguments sont le message à envoyer. Attention : les caractères - <literal>%m</literal> seront remplacés par l'erreur (sous forme de chaîne), + <function>syslog</function> génére un message qui + sera inscrit dans l'historique par le système. + <parameter>priority</parameter> est une combinaison des valeurs + d'accès et de niveau, qui seront décrites dans la + prochaîne section. Les derniers arguments sont le message + à envoyer. Attention : les caractères <literal>%m</literal> + seront remplacés par l'erreur (sous forme de chaîne), présente dans <errortype>errno</errortype>. - </para> + </para> + <para> + <table> + <title>Priorités <function>syslog</function>(en ordre décroissant)</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_EMERG</entry> + <entry>système inutilisable</entry> + </row> + <row> + <entry>LOG_ALERT</entry> + <entry>une décision doit être prise immédiatement</entry> + </row> + <row> + <entry>LOG_CRIT</entry> + <entry>conditions critiques</entry> + </row> + <row> + <entry>LOG_ERR</entry> + <entry>conditions d'erreur</entry> + </row> + <row> + <entry>LOG_WARNING</entry> + <entry>conditions d'alerte</entry> + </row> + <row> + <entry>LOG_NOTICE</entry> + <entry>condition normale, mais significative</entry> + </row> + <row> + <entry>LOG_INFO</entry> + <entry>message d'information</entry> + </row> + <row> + <entry>LOG_DEBUG</entry> + <entry>message de débuggage</entry> + </row> + </tbody> + </tgroup> + </table> + </para> <para> - Pour plus d'informations sur l'historique, reportez vous au manuel Unix (syslog). + <example> + <title>Utilisation de <function>syslog</function></title> + <programlisting role="php"> +<?php +define_syslog_variables(); +// ouverture de syslog, ajout du PID et envoie simultané du +// message à la sortie standard et à un mecanisme +// spécifique +openlog("myScripLog", LOG_PID | LOG_PERROR, LOG_LOCAL0); +// quelques lignes de code +if (authorized_client()) { + // faire quelquechose +} else { + // client non autorisé! + // notation de la tentative + $access = date("Y/m/d H:i:s"); + syslog(LOG_WARNING,"Client non autorisé: $access $REMOTE_ADDR ($HTTP_USER_AGENT)"); +} +closelog(); +?> + </programlisting> + </example> + Pour plus d'informations sur comment mettre en place un gestionnaire + d'historique, reportez vous au manuel Unix, page 5 + <citerefentry><refentrytitle>syslog.conf</refentrytitle> + <manvolnum>5</manvolnum></citerefentry>. D'autres informations + sur les systèmes d'historique et leurs options sont aussi + disponibles dans le manuel <citerefentry><refentrytitle>syslog</refentrytitle> + <manvolnum>3</manvolnum></citerefentry> des machines Unix. </para> <para> - Avec Windows NT, l'historique est pris en charge par Event Log.</para> + Avec Windows NT, l'historique est pris en charge par Event Log. + </para> </refsect1> </refentry> - </reference> <!-- Keep this comment at the end of the file Local variables:
Index: phpdoc/fr/functions/network.xml diff -u phpdoc/fr/functions/network.xml:1.5 phpdoc/fr/functions/network.xml:1.6 --- phpdoc/fr/functions/network.xml:1.5 Thu Oct 19 13:08:17 2000 +++ phpdoc/fr/functions/network.xml Wed Dec 6 05:02:05 2000 @@ -1,7 +1,6 @@ <reference id="ref.network"> <title>Réseau</title> <titleabbrev>Réseau</titleabbrev> - <refentry id="function.checkdnsrr"> <refnamediv> <refname>checkdnsrr</refname> @@ -10,55 +9,63 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>checkdnsrr</function></funcdef> - <paramdef>string <parameter>host</parameter></paramdef> - <paramdef>string <parameter><optional>type</optional></parameter></paramdef> + <funcprototype> + <funcdef>int <function>checkdnsrr</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string + <parameter><optional>type</optional></parameter> + </paramdef> + </funcprototype> </funcsynopsis> - <simpara> - Recherche l'enregistrement DNS de type <parameter>type</parameter> correspondant - à l'hôte <parameter>host</parameter>. - Retourne TRUE si un record a été trouvé, et FALSE en cas d'erreur ou d'échec. - </simpara> - + <function>checkdnsrr</function> recherche l'enregistrement DNS de type + <parameter>type</parameter> correspondant à l'hôte + <parameter>host</parameter>. Retourne TRUE si un record a été + trouvé, et FALSE en cas d'erreur ou d'échec. + </simpara> <simpara> - <parameter>type</parameter> peut prendre les valeurs suivantes : A, MX, NS, SOA, - PTR, CNAME, ou ANY. Par défaut, la valeur est : MX. + <parameter>type</parameter> peut prendre les valeurs suivantes : + A, MX, NS, SOA, PTR, CNAME, ou ANY. Par défaut, + la valeur est : MX. </simpara> - <simpara> - <parameter>host</parameter> peut être soit une adresse IP de la forme + <parameter>host</parameter> peut être soit une adresse IP de la forme x.x.x.x avec x entre 0 et 256, soit un nom d'hôte. </simpara> - <simpara> - Voir aussi - <function>getmxrr</function>, <function>gethostbyaddr</function>, - <function>gethostbyname</function>, <function>gethostbynamel</function> et - la page de manuel named(8).</simpara> - + Voir aussi <function>getmxrr</function>, + <function>gethostbyaddr</function>, + <function>gethostbyname</function>, + <function>gethostbynamel</function> et + la page de manuel named(8). + </simpara> </refsect1> </refentry> - <refentry id="function.closelog"> <refnamediv> <refname>closelog</refname> - <refpurpose>Ferme la connexion à l'historique système.</refpurpose> + <refpurpose>Ferme la connexion à l'historique système.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>closelog</function></funcdef> - <void/> + <funcprototype> + <funcdef>int <function>closelog</function></funcdef> + <void/> + </funcprototype> </funcsynopsis> + <para> + <function>closelog</function> ferme le pointeur qui sert à + écrire dans l'historique système. L'utilisation de + <function>closelog</function> est optionnelle. + </para> <para> - <function>closelog</function> ferme le pointeur qui sert à écrire - dans l'historique système. L'utilisation de <function>closelog</function> est - optionnelle. + Voir aussi <function>define_syslog_variables</function>, + <function>syslog</function> et + <function>openlog</function>. </para> </refsect1> </refentry> - <refentry id="function.debugger-off"> <refnamediv> <refname>debugger_off</refname> @@ -67,16 +74,17 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>debugger_off</function></funcdef> - <void/> + <funcprototype> + <funcdef>int <function>debugger_off</function></funcdef> + <void/> + </funcprototype> </funcsynopsis> <para> - Inactive le debuggeur interne de PHP. Le debuggeur est toujours en cours de - développement. + <function>debugger_off</function> inactive le debuggeur interne de PHP. + Le debuggeur est toujours en cours de développement. </para> </refsect1> </refentry> - <refentry id="function.debugger-on"> <refnamediv> <refname>debugger_on</refname> @@ -89,12 +97,12 @@ <paramdef>string <parameter>address</parameter></paramdef> </funcsynopsis> <para> - Active le debugger interne de PHP, et le connecte à l'adresse - <parameter>address</parameter>. Le debuggeur est toujours en cours de développement. + <function>debugger_on</function> active le debugger interne de PHP, et + le connecte à l'adresse <parameter>address</parameter>. Le debuggeur + est toujours en cours de développement. </para> </refsect1> </refentry> - <refentry id="function.define-syslog-variables"> <refnamediv> <refname>define_syslog_variables</refname> @@ -109,7 +117,8 @@ </funcprototype> </funcsynopsis> <para> - Initialise toutes les constantes utilisées par les fonctions de syslog. + <function>define_syslog_varaibles</function> initialise toutes les + constantes utilisées par les fonctions de syslog. </para> <para> Voir aussi <function>openlog</function>, @@ -118,60 +127,69 @@ </para> </refsect1> </refentry> - <refentry id="function.fsockopen"> <refnamediv> <refname>fsockopen</refname> - <refpurpose>Ouvre une socket de connexion Internet ou Unix.</refpurpose> + <refpurpose>Ouvre une socket de connexion Internet ou Unix.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>fsockopen</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> - <paramdef>int <parameter>port</parameter></paramdef> - <paramdef>int <parameter><optional>errno</optional></parameter></paramdef> - <paramdef>string <parameter><optional>errstr</optional></parameter></paramdef> - <paramdef>double - <parameter><optional>timeout</optional></parameter></paramdef> - </funcsynopsis> - - <para> - Créer un flot de connexion à l'Internet (AF_INET) ou à un domaine Unix (AF_UNIX). - Via Internet, cette fonction va ouvrir une socket de connexion TCP avec l'hôte - <parameter>hostname</parameter> sur le port <parameter>port</parameter>. - Via un domaine Unix, <parameter>hostname</parameter> représente le chemin jusqu'à - la socket, et <parameter>port</parameter> doit être mis à 0. L' option - <parameter>timeout</parameter> sert à donner une durée maximale à cet appel. - </para> - - <para> - <function>fsockopen</function> retourne un pointeur de fichier qui peut être - utilisé avec d'autres fonctions fichiers, telles que <function>fgets</function>, - <function>fgetss</function>, <function>fputs</function>, - <function>fclose</function> et <function>feof</function>. - </para> - - <para> - Si l'appel échoue, <function>fsockopen</function> retourne FALSE, et si les - options <parameter>errno</parameter> et <parameter>errstr</parameter> ont été - fournies, elles contiennent désormais les raisons de l'échec. Si l'erreur - retournée est 0 et que la fonction retourne FALSE, c'est une indication d'erreur. - C'est probablement du à une erreur d'initialisation de la socket. Notez que - <parameter>errno</parameter> et <parameter>errstr</parameter> sont passées par - référence. - </para> - - <para> - Suivant les environnements, le type 'domaine Unix' ou l'option <parameter>timeout</parameter> - ne sont pas toujours disponibles. - </para> - - <para> - La socket sera ouverte par défaut en mode bloquant. Vous pouvez changer de mode - en utilisant : <function>set_socket_blocking</function>. - <example> - <title>fsockopen example</title> + <funcprototype> + <funcdef>int <function>fsockopen</function></funcdef> + <paramdef> + string <parameter><optional>udp://</optional>hostname</parameter> + </paramdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>int + <parameter><optional>errno</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>errstr</optional></parameter> + </paramdef> + <paramdef>double + <parameter><optional>timeout</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fsockopen</function> créer un flot de connexion à + l'Internet (AF_INET) ou à un domaine Unix (AF_UNIX). Via Internet, + cette fonction va ouvrir une socket de connexion TCP avec l'hôte + <parameter>hostname</parameter> sur le port <parameter>port</parameter>. + Pour les connexions UDP, vous devez explicitement spécifier le protocole : + <parameter>udp://hostname</parameter>. + Via un domaine Unix, <parameter>hostname</parameter> représente le + chemin jusqu'à la socket, et <parameter>port</parameter> doit + être mis à 0. L'option <parameter>timeout</parameter> sert + à donner une durée maximale à cet appel. + </para> + <para> + <function>fsockopen</function> retourne un pointeur de fichier qui peut + être utilisé avec d'autres fonctions fichiers, telles que + <function>fgets</function>, <function>fgetss</function>, + <function>fputs</function>, <function>fclose</function> et + <function>feof</function>. + </para> + <para> + Si l'appel échoue, <function>fsockopen</function> retourne FALSE, + et si les options <parameter>errno</parameter> et <parameter>errstr</parameter> + ont été fournies, elles contiennent désormais les + raisons de l'échec. Si l'erreur retournée est 0 et que la + fonction retourne FALSE, c'est une indication d'erreur. C'est probablement + du à une erreur d'initialisation de la socket. Notez que + <parameter>errno</parameter> et <parameter>errstr</parameter> sont + passées par référence. + </para> + <para> + Suivant les environnements, le type 'domaine Unix' ou l'option + <parameter>timeout</parameter> ne sont pas toujours disponibles. + </para> + <para> + La socket sera ouverte par défaut en mode bloquant. Vous pouvez + changer de mode en utilisant : <function>socket_set_blocking</function>. + <example> + <title>Exemple avec <function>fsockopen</function></title> <programlisting> $fp = fsockopen("www.php.net", 80, &$errno, &$errstr, 30); if(!$fp) { @@ -185,84 +203,107 @@ } </programlisting> </example> - - Voir aussi <function>pfsockopen</function></para> - + L'exemple ci-dessous décrit comment lire la date et l'heure grâce à + un service UDP "daytime" (port 13), sur votre propre machine. + <example> + <title>Utilisation d'une connexion UDP</title> + <programlisting role="php"> +<?php +$fp = fsockopen("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); +} +?> + </programlisting> + </example> + Voir aussi: <function>pfsockopen</function>, + <function>socket_set_blocking</function>, + <function>socket_set_timeout</function>, <function>fgets</function>, + <function>fgetss</function>, <function>fputs</function>, + <function>fclose</function>, et <function>feof</function>. + </para> </refsect1> </refentry> - <refentry id="function.gethostbyaddr"> <refnamediv> <refname>gethostbyaddr</refname> - <refpurpose>Retourne le nom d'hôte correspondant à une IP.</refpurpose> + <refpurpose> + Retourne le nom d'hôte correspondant à une IP. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>gethostbyaddr</function></funcdef> - <paramdef>string <parameter>ip_address</parameter></paramdef> + <funcprototype> + <funcdef>string <function>gethostbyaddr</function></funcdef> + <paramdef>string <parameter>ip_address</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - Retourne le nom d'hôte correspondant à l'IP <parameter>ip_address</parameter>. + <function>gethostbyaddr</function> retourne le nom d'hôte + correspondant à l'IP <parameter>ip_address</parameter>. Si une erreur survient, retourne <parameter>ip_address</parameter>. </para> - <para> Voir aussi <function>gethostbyname</function>. </para> - </refsect1> </refentry> - <refentry id="function.gethostbyname"> <refnamediv> <refname>gethostbyname</refname> - <refpurpose>Retourne l'adresse IP correspondant à un hôte.</refpurpose> + <refpurpose> + Retourne l'adresse IP correspondant à un hôte. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>gethostbyname</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> + <funcprototype> + <funcdef>string <function>gethostbyname</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - Retourne l'adresse IP correspondant à l'hôte <parameter>hostname</parameter>. - </para> - + <function>gethostbyname</function> retourne l'adresse IP + correspondant à l'hôte <parameter>hostname</parameter>. + </para> <para> Voir aussi <function>gethostbyaddr</function>. </para> - </refsect1> </refentry> - <refentry id="function.gethostbynamel"> <refnamediv> <refname>gethostbynamel</refname> - <refpurpose>Retourne la liste d'IP correspondants à un hôte.</refpurpose> + <refpurpose> + Retourne la liste d'IP correspondants à un hôte. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>array <function>gethostbynamel</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> + <funcprototype> + <funcdef>array <function>gethostbynamel</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - Retourne la liste d'IP correspondant à l'hôte <parameter>hostname</parameter>. + <function>gethostbynamel</function> retourne la liste d'IP + correspondant à l'hôte <parameter>hostname</parameter>. </para> - <para> - Voir aussi - <function>gethostbyname</function>, <function>gethostbyaddr</function>, - <function>checkdnsrr</function>, <function>getmxrr</function> - et la page 8 du manuel.</para> - + Voir aussi <function>gethostbyname</function>, + <function>gethostbyaddr</function>, + <function>checkdnsrr</function>, <function>getmxrr</function> + et la page 8 du manuel. + </para> </refsect1> </refentry> - <refentry id="function.getmxrr"> <refnamediv> <refname>getmxrr</refname> @@ -271,107 +312,114 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>getmxrr</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> - <paramdef>array <parameter>mxhosts</parameter></paramdef> - <paramdef>array <parameter><optional>weight</optional></parameter></paramdef> + <funcprototype> + <funcdef>int <function>getmxrr</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + <paramdef>array <parameter>mxhosts</parameter></paramdef> + <paramdef>array + <parameter><optional>weight</optional></parameter> + </paramdef> + </funcprototype> </funcsynopsis> - <simpara> - Effectue une recherche DNS pour obtenir les enregistrements MX de - l'hôte <parameter>hostname</parameter>. Retourne TRUE si des enregistrements sont - trouvés, et FALSE si une erreur est rencontrée, ou si la recherche échoue. + <function>getmxrr</function> effectue une recherche DNS pour + obtenir les enregistrements MX de l'hôte <parameter>hostname</parameter>. + Retourne TRUE si des enregistrements sont trouvés, et + FALSE si une erreur est rencontrée, ou si la recherche + échoue. </simpara> - <simpara> - La liste des enregistrements MX est placée dans le tableau - <parameter>mxhosts</parameter>. Si le tableau <parameter>weight</parameter> + La liste des enregistrements MX est placée dans le tableau + <parameter>mxhosts</parameter>. Si le tableau <parameter>weight</parameter> est fourni, il sera rempli par les informations de poids. </simpara> - <simpara> Voir aussi <function>checkdnsrr</function>, <function>gethostbyname</function>, - <function>gethostbynamel</function>, <function>gethostbyaddr</function>, + <function>gethostbynamel</function>, <function>gethostbyaddr</function>, et la page 8 du manuel. </simpara> - </refsect1> </refentry> - <refentry id="function.getprotobyname"> <refnamediv> <refname>getprotobyname</refname> - <refpurpose>Retourne le numéro de protocole associé au nom de protocole</refpurpose> + <refpurpose> + Retourne le numéro de protocole associé au nom de protocole + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>getprotobyname</function></funcdef> - <paramdef>string <parameter>name</parameter></paramdef> + <funcprototype> + <funcdef>int <function>getprotobyname</function></funcdef> + <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>getprotobyname</function> retourne le numéro de protocole associé avec - le nom de protocole <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. + <function>getprotobyname</function> retourne le numéro de + protocole associé avec le nom de protocole + <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. </para> <para> Voir aussi <function>getprotobynumber</function>. </para> </refsect1> </refentry> - <refentry id="function.getprotobynumber"> <refnamediv> <refname>getprotobynumber</refname> - <refpurpose>Retourne le nom de protocole associé au numéro de protocole</refpurpose> + <refpurpose> + Retourne le nom de protocole associé au numéro de protocole + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>getprotobynumber</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> + <funcprototype> + <funcdef>string <function>getprotobynumber</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>getprotobynumber</function> retourne le numéro de protocole associé avec - le nom de protocole <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. + <function>getprotobynumber</function> retourne le numéro + de protocole associé avec le nom de protocole + <parameter>name</parameter>, comme dans <filename>/etc/protocols</filename>. </para> <para> Voir aussi <function>getprotobyname</function>. </para> </refsect1> </refentry> - <refentry id="function.getservbyname"> <refnamediv> <refname>getservbyname</refname> <refpurpose> - Retourne le numéro de port associé à un service Internet, et un protocole. + Retourne le numéro de port associé à un service + Internet, et un protocole. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>getservbyname</function></funcdef> - <paramdef>string <parameter>service</parameter></paramdef> - <paramdef>string <parameter>protocol</parameter></paramdef> + <funcprototype> + <funcdef>int <function>getservbyname</function></funcdef> + <paramdef>string <parameter>service</parameter></paramdef> + <paramdef>string <parameter>protocol</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>getservbyname</function> retourne le numéro de port associé à - au service <parameter>service</parameter> et protocole - <parameter>protocol</parameter>, comme dans <filename>/etc/services</filename>. - <parameter>protocol</parameter> vaut soit <literal>tcp</literal> ou - <literal>udp</literal>. + <function>getservbyname</function> retourne le numéro de + port associé à au service <parameter>service</parameter> + et protocole <parameter>protocol</parameter>, comme dans + <filename>/etc/services</filename>. <parameter>protocol</parameter> + vaut soit <literal>tcp</literal> ou <literal>udp</literal>. </para> - <para> Voir aussi <function>getservbyport</function>. </para> </refsect1> </refentry> - <refentry id="function.getservbyport"> <refnamediv> <refname>getservbyport</refname> @@ -382,14 +430,15 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>string <function>getservbyport</function></funcdef> - <paramdef>int <parameter>port</parameter></paramdef> - <paramdef>string <parameter>protocol</parameter></paramdef> + <funcprototype> + <funcdef>string <function>getservbyport</function></funcdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>string <parameter>protocol</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> <function>getservbyport</function> le service internet associé au port - <parameter>port</parameter> pour le protocole <parameter>protocol</parameter> + <parameter>port</parameter> pour le protocole <parameter>protocol</parameter> comme dans <filename>/etc/services</filename>. <parameter>protocol</parameter> vaut soit <literal>tcp</literal> ou <literal>udp</literal>. @@ -399,14 +448,13 @@ </para> </refsect1> </refentry> - <refentry id="function.ip2long"> <refnamediv> <refname>ip2long</refname> <refpurpose> - Converti une chaîne contenant une adresse (IPv4) IP numérique en adresse - litérale. - </refpurpose> + Converti une chaîne contenant une adresse (IPv4) + IP numérique en adresse litérale. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -417,10 +465,10 @@ </funcprototype> </funcsynopsis> <para> - <function>ip2long</function> génére une adresse IPv4 à partir de son - équivalent numérique. + <function>ip2long</function> génére une adresse + IPv4 à partir de son équivalent numérique. <example> - <title>Exemple <function>Ip2long</function></title> + <title>Exemple <function>ip2long</function></title> <programlisting role="php"> <? $ip = gethostbyname("www.php.net"); @@ -436,13 +484,12 @@ </para> </refsect1> </refentry> - <refentry id="function.long2ip"> <refnamediv> <refname>long2ip</refname> <refpurpose> Converti une adresse IP (IPv4) en adresse IP numérique - </refpurpose> + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -453,69 +500,199 @@ </funcprototype> </funcsynopsis> <para> - <function>long2ip</function> génére une adresse IP (format aaa.bbb.ccc.ddd) - à partir de sa représentation litérale. + <function>long2ip</function> génére une adresse IP + (format aaa.bbb.ccc.ddd) à partir de sa représentation + litérale. </para> <para> Voir aussi: <function>ip2long</function> </para> </refsect1> </refentry> - <refentry id="function.openlog"> <refnamediv> <refname>openlog</refname> - <refpurpose>Ouvre la connexion à l'historique système.</refpurpose> + <refpurpose>Ouvre la connexion à l'historique système.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>openlog</function></funcdef> - <paramdef>string <parameter>ident</parameter></paramdef> - <paramdef>int <parameter>option</parameter></paramdef> - <paramdef>int <parameter>facility</parameter></paramdef> + <funcprototype> + <funcdef>int <function>openlog</function></funcdef> + <paramdef>string <parameter>ident</parameter></paramdef> + <paramdef>int <parameter>option</parameter></paramdef> + <paramdef>int <parameter>facility</parameter></paramdef> + </funcprototype> </funcsynopsis> - <para> - <function>openlog</function> ouvre la connexion à l'historique système. La chaîne - <parameter>ident</parameter> sera ajouté à chaque message. Les valeurs de - <parameter>option</parameter> et <parameter>facility</parameter> sont données dans - la section suivante. L'utilisation de <function>openlog</function> est - optionnelle; cette fonction sera automatiquement appelée par - <function>syslog</function> si nécessaire, et dans ce cas, l'identification - sera mise par défaut à <literal>FALSE</literal>. + <function>openlog</function> ouvre la connexion à l'historique + système. La chaîne <parameter>ident</parameter> sera + ajouté à chaque message. Les valeurs de + <parameter>option</parameter> et <parameter>facility</parameter> sont + données ci-dessous. L'utilisation de <function>openlog</function> + est optionnelle; cette fonction sera automatiquement appelée par + <function>syslog</function> si nécessaire, et dans ce cas, + l'identification sera mise par défaut à <literal>FALSE</literal>. + <parameter>facility</parameter> sert à indiquer quel programme + enregistre ce message. Cela vous permet de spécifier + (sur la machine d'historique) comment traiter les messages venant + de plusieurs serveurs. </para> - <para> - Voir aussi <function>syslog</function> et <function>closelog</function>. + <para> + <table> + <title>Options <function>openlog</function></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_CONS</entry> + <entry> + Si une erreur survient lors de l'envoi des données au gestionnaire + d'historique, écrire directement l'erreur sur la console. + </entry> + </row> + <row> + <entry>LOG_NDELAY</entry> + <entry> + Ouvre immédiatement une connexion au gestionnaire d'historique + </entry> + </row> + <row> + <entry>LOG_ODELAY</entry> + <entry> + (par défaut) retarde l'ouverture de la connexion jusqu'à ce que le + premier message soit enregistré + </entry> + </row> + <row> + <entry>LOG_PERROR</entry> + <entry>Envoie le message au gestionnaire standard</entry> + </row> + <row> + <entry>LOG_PID</entry> + <entry>Inclus le PID à chaque message</entry> + </row> + </tbody> + </tgroup> + </table> + Vous pouvez utiliser une ou plusieurs de ces options. Pour les + combiner, utiliser l'opérateur <literal>OR</literal>. Par exemple, + pour ouvrir immédiatement la connexion, écrire sur la console et + inclure le PID de chaque message, utilisez : + <literal>LOG_CONS | LOG_NDELAY | LOG_PID</literal>. + </para> + <para> + <table> + <title> + Paramètre <parameter>facility</parameter> de <function>openlog</function> + </title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_AUTH</entry> + <entry> + securité/messages d'autorisation (utilisez LOG_AUTHPRIV, pour + remplacer cette constante sur les systèmes où elle est définie). + </entry> + </row> + <row> + <entry>LOG_AUTHPRIV</entry> + <entry>securité/messages d'autorisation (privé)</entry> + </row> + <row> + <entry>LOG_CRON</entry> + <entry>démon horologe (cron et at)</entry> + </row> + <row> + <entry>LOG_DAEMON</entry> + <entry>autres démons système</entry> + </row> + <row> + <entry>LOG_KERN</entry> + <entry>noyau (kernel)</entry> + </row> + <row> + <entry>LOG_LOCAL0 ... LOG_LOCAL7</entry> + <entry>reservé pour utilisation ultérieure</entry> + </row> + <row> + <entry>LOG_LPR</entry> + <entry>imprimante (line printer subsystem)</entry> + </row> + <row> + <entry>LOG_MAIL</entry> + <entry>messagerie mail</entry> + </row> + <row> + <entry>LOG_NEWS</entry> + <entry>USENET newsgroup</entry> + </row> + <row> + <entry>LOG_SYSLOG</entry> + <entry>messages generé en interne par syslogd</entry> + </row> + <row> + <entry>LOG_USER</entry> + <entry>messages utilisateurs générique</entry> + </row> + <row> + <entry>LOG_UUCP</entry> + <entry>UUCP subsystem</entry> + </row> + </tbody> + </tgroup> + </table> </para> + <para> + Voir aussi <function>define_syslog_variables</function>, + <function>syslog</function> et <function>closelog</function>. + </para> </refsect1> </refentry> - <refentry id="function.pfsockopen"> <refnamediv> <refname>pfsockopen</refname> - <refpurpose>Ouvre une socket de connexion Internet ou Unix persistante.</refpurpose> + <refpurpose> + Ouvre une socket de connexion Internet ou Unix persistante. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>pfsockopen</function></funcdef> - <paramdef>string <parameter>hostname</parameter></paramdef> - <paramdef>int <parameter>port</parameter></paramdef> - <paramdef>int <parameter><optional>errno</optional></parameter></paramdef> - <paramdef>string <parameter><optional>errstr</optional></parameter></paramdef> - <paramdef>int - <parameter><optional>timeout</optional></parameter></paramdef> - </funcsynopsis> - - <para> - Cette fonction se comporte exactement comme <function>fsockopen</function> - mais la connexion ouverte le reste, même après la fin du script. C'est la - version persistante de <function>fsockopen</function>. - </para> + <funcprototype> + <funcdef>int <function>pfsockopen</function></funcdef> + <paramdef>string <parameter>hostname</parameter></paramdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>int + <parameter><optional>errno</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>errstr</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>timeout</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pfsockopen</function> se comporte exactement comme + <function>fsockopen</function> mais la connexion ouverte le reste, + même après la fin du script. C'est la version + persistante de <function>fsockopen</function>. + </para> </refsect1> </refentry> - <refentry id="function.socket-get-status"> <refnamediv> <refname>socket_get_status</refname> @@ -528,15 +705,16 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>socket_get_status</function></funcdef> - <paramdef>resource + <paramdef>resource <parameter>socket_get_status</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - <function>socket_get_status</function> retourne les informations sur la socket - <parameter>socket_get_status</parameter>, et fournit la réponse sous la forme - d'un tableau à quatre entrées: + <function>socket_get_status</function> retourne les informations + sur la socket <parameter>socket_get_status</parameter>, et fournit + la réponse sous la forme d'un tableau à quatre + entrées: </para> <itemizedlist> <listitem> @@ -547,23 +725,25 @@ </listitem> <listitem> <para> - <parameter>blocked</parameter> (bool) - La socket a été bloquée + <parameter>blocked</parameter> (bool) - La socket a + été bloquée </para> </listitem> <listitem> <para> - <parameter>eof</parameter> (bool) - Indique un événement fin de fichier (EOF) + <parameter>eof</parameter> (bool) - Indique un événement + fin de fichier (EOF) </para> </listitem> <listitem> <para> - <parameter>unread_bytes</parameter> (int) - Nombre d'octets restant dans + <parameter>unread_bytes</parameter> (int) - Nombre d'octets restant dans les buffers de la socket. </para> </listitem> </itemizedlist> <para> - Voir aussi + Voir aussi <function>accept_connect</function>, <function>bind</function>, <function>connect</function>, @@ -572,35 +752,35 @@ </para> </refsect1> </refentry> - - <refentry id="function.set-socket-blocking"> + <refentry id="function.socket-set-blocking"> <refnamediv> - <refname>set_socket_blocking</refname> - <refpurpose>Active/desactive le mode bloquant d'une socket.</refpurpose> + <refname>socket_set_blocking</refname> + <refpurpose>Active/desactive le mode bloquant d'une socket.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>set_socket_blocking</function></funcdef> - <paramdef>int <parameter>socket descriptor</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> + <funcprototype> + <funcdef>int <function>socket_set_blocking</function></funcdef> + <paramdef>int <parameter>socket descriptor</parameter></paramdef> + <paramdef>int <parameter>mode</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> - Si <parameter>mode</parameter> est FALSE, la socket est mise en mode non bloquant, - et si il est TRUE, la socket est mise en mode bloquant. Cela affecte des appels - tels que <function>fgets</function> qui lisent depuis une socket. En mode non - bloquant, un appel <function>fgets</function> retournera immediatement toujours - TRUE tandis qu'en mode bloquant, elle va attendre que des données arrivent pour - répondre TRUE. + Si <parameter>mode</parameter> est FALSE, la socket est mise en + mode non bloquant, et si il est TRUE, la socket est mise en mode + bloquant. Cela affecte des appels tels que <function>fgets</function> + qui lisent depuis une socket. En mode non bloquant, un appel + <function>fgets</function> retournera immediatement toujours + TRUE tandis qu'en mode bloquant, elle va attendre que des + données arrivent pour répondre TRUE. </para> - </refsect1> </refentry> - <refentry id="function.socket-set-timeout"> <refnamediv> <refname>socket_set_timeout</refname> - <refpurpose>Fixe la durée de vie de la socket</refpurpose> + <refpurpose>Fixe la durée de vie de la socket</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -638,7 +818,7 @@ </example> </para> <para> - Cette fonction s'appelait <function>set_socket_timeout</function> + Cette fonction s'appelait set_socket_timeout() mais elle est désormais obsolète. </para> <para> @@ -646,35 +826,115 @@ </para> </refsect1> </refentry> - <refentry id="function.syslog"> <refnamediv> <refname>syslog</refname> - <refpurpose>Génére un message dans l'historique système.</refpurpose> + <refpurpose> + Génére un message dans l'historique système. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>syslog</function></funcdef> - <paramdef>int <parameter>priority</parameter></paramdef> - <paramdef>string <parameter>message</parameter></paramdef> + <funcprototype> + <funcdef>int <function>syslog</function></funcdef> + <paramdef>int <parameter>priority</parameter></paramdef> + <paramdef>string <parameter>message</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> - <function>syslog</function> génére un message qui sera inscrit dans l'historique - par le système. <parameter>priority</parameter> est une combinaison des valeurs - d'accès et de niveau, qui seront décrites dans la prochaîne section. Les derniers - arguments sont le message à envoyer. Attention : les caractères - <literal>%m</literal> seront remplacés par l'erreur (sous forme de chaîne), + <function>syslog</function> génére un message qui + sera inscrit dans l'historique par le système. + <parameter>priority</parameter> est une combinaison des valeurs + d'accès et de niveau, qui seront décrites dans la + prochaîne section. Les derniers arguments sont le message + à envoyer. Attention : les caractères <literal>%m</literal> + seront remplacés par l'erreur (sous forme de chaîne), présente dans <errortype>errno</errortype>. - </para> + </para> + <para> + <table> + <title>Priorités <function>syslog</function>(en ordre décroissant)</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_EMERG</entry> + <entry>système inutilisable</entry> + </row> + <row> + <entry>LOG_ALERT</entry> + <entry>une décision doit être prise immédiatement</entry> + </row> + <row> + <entry>LOG_CRIT</entry> + <entry>conditions critiques</entry> + </row> + <row> + <entry>LOG_ERR</entry> + <entry>conditions d'erreur</entry> + </row> + <row> + <entry>LOG_WARNING</entry> + <entry>conditions d'alerte</entry> + </row> + <row> + <entry>LOG_NOTICE</entry> + <entry>condition normale, mais significative</entry> + </row> + <row> + <entry>LOG_INFO</entry> + <entry>message d'information</entry> + </row> + <row> + <entry>LOG_DEBUG</entry> + <entry>message de débuggage</entry> + </row> + </tbody> + </tgroup> + </table> + </para> <para> - Pour plus d'informations sur l'historique, reportez vous au manuel Unix (syslog). + <example> + <title>Utilisation de <function>syslog</function></title> + <programlisting role="php"> +<?php +define_syslog_variables(); +// ouverture de syslog, ajout du PID et envoie simultané du +// message à la sortie standard et à un mecanisme +// spécifique +openlog("myScripLog", LOG_PID | LOG_PERROR, LOG_LOCAL0); +// quelques lignes de code +if (authorized_client()) { + // faire quelquechose +} else { + // client non autorisé! + // notation de la tentative + $access = date("Y/m/d H:i:s"); + syslog(LOG_WARNING,"Client non autorisé: $access $REMOTE_ADDR ($HTTP_USER_AGENT)"); +} +closelog(); +?> + </programlisting> + </example> + Pour plus d'informations sur comment mettre en place un gestionnaire + d'historique, reportez vous au manuel Unix, page 5 + <citerefentry><refentrytitle>syslog.conf</refentrytitle> + <manvolnum>5</manvolnum></citerefentry>. D'autres informations + sur les systèmes d'historique et leurs options sont aussi + disponibles dans le manuel <citerefentry><refentrytitle>syslog</refentrytitle> + <manvolnum>3</manvolnum></citerefentry> des machines Unix. </para> <para> - Avec Windows NT, l'historique est pris en charge par Event Log.</para> + Avec Windows NT, l'historique est pris en charge par Event Log. + </para> </refsect1> </refentry> - </reference> <!-- Keep this comment at the end of the file Local variables: