dams Mon Jul 23 04:13:43 2001 EDT Modified files: /phpdoc/fr/functions apache.xml Log: Updated
Index: phpdoc/fr/functions/apache.xml diff -u phpdoc/fr/functions/apache.xml:1.8 phpdoc/fr/functions/apache.xml:1.9 --- phpdoc/fr/functions/apache.xml:1.8 Tue Jan 16 05:38:38 2001 +++ phpdoc/fr/functions/apache.xml Mon Jul 23 04:13:42 2001 @@ -1,220 +1,228 @@ - <reference id="ref.apache"> - <title>Apache</title> - <titleabbrev>Apache</titleabbrev> - <refentry id="function.apache-lookup-uri"> - <refnamediv> - <refname>apache_lookup_uri</refname> - <refpurpose> - Effectue une requête partielle pour l'URI spécifiée - et renvoie toutes les informations. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> +<reference id="ref.apache"> + <title>Apache</title> + <titleabbrev>Apache</titleabbrev> + <refentry id="function.ascii2ebcdic"> + <refnamediv> + <refname>ascii2ebcdic</refname> + <refpurpose>Transforme une chaîne ASCII en EBCDIC</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ascii2ebcdic</function></funcdef> + <paramdef>string <parameter>ascii_str</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ascii2ebcdic</function> est une fonction spéficique + à Apache, qui n'est disponible que sur les OS qui gèrent + le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne ASCII + <parameter>ascii_str</parameter> en son équivalent EBCDIC + (avec protection des données binaires) et retourne le résultat. + </para> + <para> + Voir aussi + <function>ebcdic2ascii</function> + </para> + </refsect1> + </refentry> + <refentry id="function.ebcdic2ascii"> + <refnamediv> + <refname>ebcdic2ascii</refname> + <refpurpose>Transforme une chaîne EBCDIC en ASCII</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ebcdic2ascii</function></funcdef> + <paramdef>string <parameter>ebcdic_str</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ebcdic2ascii</function> est une fonction spéficique + à Apache, qui n'est disponible que sur les OS qui gèrent + le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne EBCDIC + <parameter>ebcdic_str</parameter> en son équivalent ASCII + (avec protection des données binaires) et retourne le résultat. + </para> + <para> + Voir aussi + <function>ascii2ebcdic</function> + </para> + </refsect1> + </refentry> + <refentry id="function.apache-lookup-uri"> + <refnamediv> + <refname>apache_lookup_uri</refname> + <refpurpose> + Effectue une requête partielle pour l'URI spécifiée + et renvoie toutes les informations. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>class <function>apache_lookup_uri</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>apache_lookup_uri</function> effectue une requête partielle - pour l'URI spécifiée. Cette requête permet de - récupérer toutes les informations importantes à - propos de la ressource concernée. Les propriétés - de la classe renvoyée sont les suivantes : - <simplelist> - <member>status</member> - <member>the_request</member> - <member>status_line</member> - <member>method</member> - <member>content_type</member> - <member>handler</member> - <member>uri</member> - <member>filename</member> - <member>path_info</member> - <member>args</member> - <member>boundary</member> - <member>no_cache</member> - <member>no_local_copy</member> - <member>allowed</member> - <member>send_bodyct</member> - <member>bytes_sent</member> - <member>byterange</member> - <member>clength</member> - <member>unparsed_uri</member> - <member>mtime</member> - <member>request_time</member> - </simplelist> - </para> - <note> - <simpara> - Note: apache_lookup_uri ne fonctionne que lorsque le PHP est - installé sous la forme d'un module Apache. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.apache-note"> - <refnamediv> - <refname>apache_note</refname> - <refpurpose> - Affiche ou affecte le paramètre "apache request notes". - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>apache_lookup_uri</function> effectue une requête partielle + pour l'URI spécifiée. Cette requête permet de + récupérer toutes les informations importantes à + propos de la ressource concernée. Les propriétés + de la classe renvoyée sont les suivantes : + <simplelist> + <member>status</member> + <member>the_request</member> + <member>status_line</member> + <member>method</member> + <member>content_type</member> + <member>handler</member> + <member>uri</member> + <member>filename</member> + <member>path_info</member> + <member>args</member> + <member>boundary</member> + <member>no_cache</member> + <member>no_local_copy</member> + <member>allowed</member> + <member>send_bodyct</member> + <member>bytes_sent</member> + <member>byterange</member> + <member>clength</member> + <member>unparsed_uri</member> + <member>mtime</member> + <member>request_time</member> + </simplelist> + </para> + <note> + <simpara> + <function>apache_lookup_uri</function> ne fonctionne que lorsque le PHP est + installé sous la forme d'un module Apache. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.apache-note"> + <refnamediv> + <refname>apache_note</refname> + <refpurpose> + Affiche ou affecte le paramètre "apache request notes". + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>apache_note</function></funcdef> <paramdef>string <parameter>note_name</parameter></paramdef> <paramdef>string <parameter> - <optional>note_value</optional> + <optional>note_value</optional> </parameter> </paramdef> - </funcsynopsis> - <para> - <function>apache_note</function> est une fonction - spécifique au serveur Apache. Cette fonction affecte ou renvoie - la valeur de la variable contenue dans la table <literal>notes</literal> - d'Apache. Si la fonction est appelée avec un argument, elle renvoie - la valeur courante de la variable <literal>note_name</literal>. Si - la fonction est appelée avec deux arguments, la variable - <literal>note_name</literal> la valeur <literal>note_value</literal> - et la fonction retournera la valeur précédente de la - variable <literal>note_name</literal>. - </para> - </refsect1> - </refentry> - <refentry id="function.getallheaders"> - <refnamediv> - <refname>getallheaders</refname> - <refpurpose> - Récupère tous les entêtes des requêtes HTTP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>getallheaders</function></funcdef> - <paramdef>void<parameter></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>getallheaders</function> renvoie un tableau associatif de tous - les entêtes HTTP correspondants à la requête courante. - <note> - <para> - Note: Vous pouvez récupérer la valeur d'une variable - d'une CGI en la lisant à partir des variables d'environnement, - ce qui fonctionne aussi bien dans le cas d'une installation en module - ou en CGI. Utilisez la fonction <function>phpinfo</function> pour avoir - une liste de toutes les variables d'environnement disponibles. - </para> - </note> - <example> - <title> - Exemple d'utilisation de la fonction <function>getallheaders</function> - </title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>apache_note</function> est une fonction + spécifique au serveur Apache. Cette fonction affecte ou renvoie + la valeur de la variable contenue dans la table <literal>notes</literal> + d'Apache. Si la fonction est appelée avec un argument, elle renvoie + la valeur courante de la variable <literal>note_name</literal>. Si + <function>apache_note</function> est appelée avec deux arguments, + <function>apache_note</function> affecte à la note +<literal>note_value</literal> + la valeur <literal>note_name</literal> et <function>apache_note</function> + retournera la valeur précédente de la variable +<literal>note_name</literal>. + </para> + </refsect1> + </refentry> + <refentry id="function.getallheaders"> + <refnamediv> + <refname>getallheaders</refname> + <refpurpose> + Récupère toutes les en-têtes des requêtes HTTP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>getallheaders</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + <function>getallheaders</function> renvoie un tableau associatif de toutes + les en-têtes HTTP de la requête courante. + <note> + <para> + Vous pouvez récupérer la valeur d'une variable + d'une CGI en la lisant à partir des variables d'environnement, + ce qui fonctionne aussi bien dans le cas d'une installation en module + ou d'une installation en CGI. Utilisez la fonction <function>phpinfo</function> + pour avoir une liste de toutes les variables d'environnement disponibles. + </para> + </note> + <example> + <title> + Exemple avec <function>getallheaders</function> + </title> + <programlisting role="php"> <?php $headers = getallheaders(); while (list($entete, $valeur) = each($headers)) { echo "$entete: $valeur<br>\n"; } ?> - </programlisting> - </example> - Cette exemple est un exemple d'affichage de toutes les entêtes - de la requête courante. - <note> - <simpara> - Note: La fonction <function>getallheaders</function> ne fonctionne que si - PHP est installé comme module <productname>Apache</productname>. - </simpara> - </note> - </para> - </refsect1> - </refentry> - <refentry id="function.virtual"> - <refnamediv> - <refname>virtual</refname> - <refpurpose>Effectue une sous-requête Apache</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + Cet exemple est un exemple d'affichage de toutes les en-têtes + de la requête courante. + <note> + <simpara> + <function>getallheaders</function> ne fonctionne que si + PHP est installé comme module <productname>Apache</productname>. + </simpara> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.virtual"> + <refnamediv> + <refname>virtual</refname> + <refpurpose>Effectue une sous-requête Apache</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>virtual</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>virtual</function> est une fonction spécifique au - serveur Apache. Elle est équivalente à la directive - "<!--#include virtual...--?>" lorsque vous utilisez le module - include d'Apache. Cette fonction effectue une sous-requête Apache. - C'est très utile lorsque vous utilisez des scripts CGI, des - fichiers .shtml ou n'importe quel type de fichier qui doit être - analysé par le serveur Apache. Il est à noter que lors - de l'utilisation avec des scripts CGI, ces derniers doivent - générer une entête valide, c'est-à-dire, - au minimum une entête "Content-Type". Pour les fichiers PHP, il - est conseillé d'utiliser les fonctions <function>include</function> - et <function>require</function>. <function>virtual</function> ne peut pas - être utilisé pour inclure un fichier qui est lui même - un fichier PHP. - </para> - </refsect1> - </refentry> - <refentry id="function.ascii2ebcdic"> - <refnamediv> - <refname>ascii2ebcdic</refname> - <refpurpose>Transforme une chaîne ASCII en EBCDIC</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ascii2ebcdic</function></funcdef> - <paramdef>string <parameter>ascii_str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ascii2ebcdic</function> est une fonction spéficique - à Apache, qui n'est disponible que sur les OS qui gère - le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne ASCII - <parameter>ascii_str</parameter> en son équivalent EBCDIC - (avec protection des données binaires) et retourne le résultat. - </para> - <para> - Voir aussi la fonction complémentaire : <function>ebcdic2ascii</function> - </para> - </refsect1> - </refentry> - <refentry id="function.ebcdic2ascii"> - <refnamediv> - <refname>ebcdic2ascii</refname> - <refpurpose>Transforme une chaîne EBCDIC en ASCII</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ebcdic2ascii</function></funcdef> - <paramdef>string <parameter>ebcdic_str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ebcdic2ascii</function> est une fonction spéficique - à Apache, qui n'est disponible que sur les OS qui gère - le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne EBCDIC - <parameter>ebcdic_str</parameter> en son équivalent ASCII - (avec protection des données binaires) et retourne le résultat. - </para> - <para> - Voir aussi la fonction complémentaire : <function>ascii2ebcdic</function> - </para> - </refsect1> - </refentry> - </reference> + </funcprototype> + </funcsynopsis> + <para> + <function>virtual</function> est une fonction spécifique au + serveur Apache. Elle est équivalente à la directive + "<literal><!--#include virtual...--></literal>" lorsque vous utilisez le +module + include d'Apache. Cette fonction effectue une sous-requête Apache. + C'est très utile lorsque vous utilisez des scripts CGI, des + fichiers .shtml ou n'importe quel type de fichier qui doit être + analysé par le serveur Apache. Il est à noter que lors + de l'utilisation avec des scripts CGI, ces derniers doivent + générer une en-tête valide, c'est-à-dire, + au minimum une en-tête "Content-Type". Pour les fichiers PHP, il + est conseillé d'utiliser les fonctions <function>include</function> + et <function>require</function>. <function>virtual</function> ne peut pas + être utilisé pour inclure un fichier qui est lui-même + un fichier PHP. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml