cvs: phpdoc-fr /chapters config.xml install.apache.xml install.apache2.xml install.caudium.xml install.configure.graphics.xml
install.configure.misc.xml install.configure.xml install.problems.xml install.windows.xml intro.xml security.xml streams.common.xml
| From: | Damien Seguy | Date: | Wed, 05 Mar 2003 00:06:08 +0000 |
| Subject: | cvs: phpdoc-fr /chapters config.xml install.apache.xml install.apache2.xml install.caudium.xml install.configure.graphics.xml install.configure.misc.xml install.configure.xml install.problems.xml install.windows.xml intro.xml security.xml streams.common.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-266@lists.php.net to get a copy of this message | ||
dams Tue Mar 4 19:06:08 2003 EDT
Modified files:
/phpdoc-fr/chapters config.xml install.apache.xml
install.apache2.xml install.caudium.xml
install.configure.graphics.xml
install.configure.misc.xml
install.configure.xml install.problems.xml
install.windows.xml intro.xml security.xml
streams.common.xml
Log:
spring commit
Index: phpdoc-fr/chapters/config.xml diff -u phpdoc-fr/chapters/config.xml:1.21 phpdoc-fr/chapters/config.xml:1.22 --- phpdoc-fr/chapters/config.xml:1.21 Thu Feb 20 10:08:32 2003 +++ phpdoc-fr/chapters/config.xml Tue Mar 4 19:06:06 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> @@ -40,6 +40,7 @@ <example> <title>Extrait du &php.ini;</title> <programlisting role="ini"> +<![CDATA[ ; tout texte sur une ligne, situé après un point-virgule ";" est ignoré [php] ; les marqueur de section (texte entre crochets) sont aussi ignorés ; Les valeurs booléenne peuvent être spécifiées comme ceci : @@ -53,6 +54,8 @@ include_path = ".;c:\php\lib" </programlisting> <!-- TODO: add more details about values and expressions --> +]]> + </programlisting> </example> </para> </sect1> @@ -132,6 +135,13 @@ Toute diretive de &php; configurée avec le type <systemitem role="directive">php_admin_value</systemitem> ne peut pas être modifiée en utilisant le fichier <filename>.htaccess</filename>. + <informalexample> + <programlisting role="ini"> +<![CDATA[ +php_admin_value open_basedir none +]]> + </programlisting> + </informalexample> </para> </listitem> </varlistentry> @@ -329,7 +339,7 @@ <varlistentry id="ini.short-open-tag"> <term> <parameter>short_open_tag</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -355,7 +365,7 @@ <varlistentry id="ini.asp-tags"> <term> <parameter>asp_tags</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -385,7 +395,7 @@ <varlistentry id="ini.y2k-compliance"> <term> <parameter>y2k_compliance</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <simpara> @@ -397,7 +407,7 @@ <varlistentry id="ini.allow-call-time-pass-reference"> <term> <parameter>allow_call_time_pass_reference</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -420,7 +430,7 @@ <varlistentry id="ini.expose-php"> <term> <parameter>expose_php</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -581,7 +591,7 @@ <varlistentry id="ini.track-vars"> <term> <parameter>track_vars</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -656,7 +666,7 @@ <varlistentry id="ini.register-globals"> <term> <parameter>register_globals</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -705,7 +715,7 @@ <varlistentry id="ini.register-argc-argv"> <term> <parameter>register_argc_argv</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <simpara> @@ -830,7 +840,7 @@ <varlistentry id="ini.always-populate-raw-post-data"> <term> <parameter>always_populate_raw_post_data</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -842,7 +852,7 @@ <varlistentry id="ini.allow-webdav-methods"> <term> <parameter>allow_webdav_methods</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1024,7 +1034,7 @@ <varlistentry id="ini.cgi.force-redirect"> <term> <parameter>cgi.force_redirect</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1123,7 +1133,7 @@ <varlistentry id="ini.file-uploads"> <term> <parameter>file_uploads</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1196,7 +1206,7 @@ <varlistentry id="ini.sql.safe-mode"> <term> <parameter>sql.safe_mode</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1238,7 +1248,7 @@ <varlistentry id="ini.debugger.enabled"> <term> <parameter>debugger.enabled</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.apache.xml diff -u phpdoc-fr/chapters/install.apache.xml:1.2 phpdoc-fr/chapters/install.apache.xml:1.3 --- phpdoc-fr/chapters/install.apache.xml:1.2 Thu Feb 20 04:32:12 2003 +++ phpdoc-fr/chapters/install.apache.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect1 id="install.apache"> <title>Installation avec le serveur Apache</title> <para> @@ -27,6 +27,7 @@ <example id="install.apache.unix.longer"> <title>Instructions d'installation avec Apache (version module)</title> <programlisting> +<![CDATA[ 1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar 3. gunzip php-x.x.x.tar.gz @@ -59,6 +60,7 @@ 18. Utilisez votre procédure habituelle pour démarrer votre serveur Apache. (vous devez l'éteindre et le redémarrer, pas seulement lui envoyer un signal HUP ou USR1.) +]]> </programlisting> </example> <para> @@ -70,7 +72,8 @@ <example> <title>Redémarrage d'apache</title> <programlisting> -1. Nombreuses variantes Linux SysV : +<![CDATA[ +[1. Nombreuses variantes Linux SysV : /etc/rc.d/init.d/httpd restart 2. Avec les scripts apachectl : /path/to/apachectl stop @@ -81,6 +84,7 @@ 4. En utilisant mod_ssl, ou un autre seveur SSL, manuellement : /path/to/apachectl stop /path/to/apachectl startssl +]]> </programlisting> </example> Les exécutables apachectl et http(s)dctl peuvent être situés Index: phpdoc-fr/chapters/install.apache2.xml diff -u phpdoc-fr/chapters/install.apache2.xml:1.2 phpdoc-fr/chapters/install.apache2.xml:1.3 --- phpdoc-fr/chapters/install.apache2.xml:1.2 Thu Feb 20 04:32:12 2003 +++ phpdoc-fr/chapters/install.apache2.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect1 id="install.apache2"> <title>Installation avec les serveurs Apache 2.0</title> <para> @@ -204,18 +204,6 @@ bonne directive pour Apache. </para> </note> - <para> - <example> - <title>Configurer PHP 4.3.0 avec Apache 2.0 en CGI</title> - <programlisting role="apache"> -<![CDATA[ -ScriptAlias /php/ "c:/php/" -AddType application/x-httpd-php .php -Action application/x-httpd-php "/php/php-cgi.exe" -]]> - </programlisting> - </example> - </para> <para> Si vous souhaitez utiliser &php; comme module dans Apache 2.0, placez bien le fichier <filename>php4ts.dll</filename> dans votre Index: phpdoc-fr/chapters/install.caudium.xml diff -u phpdoc-fr/chapters/install.caudium.xml:1.2 phpdoc-fr/chapters/install.caudium.xml:1.3 --- phpdoc-fr/chapters/install.caudium.xml:1.2 Thu Feb 20 04:32:12 2003 +++ phpdoc-fr/chapters/install.caudium.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect1 id="install.caudium"> <title>Installation sur le serveur Caudium</title> <para> @@ -10,7 +10,8 @@ </para> <example id="install.caudium.instructions"> <title>Instructions d'installation Caudium</title> - <programlisting> + <screen> +<![CDATA[ 1. Assurez-vous que vous avez un serveur Caudium installé avant de tenter l'installation PHP 4. Pour que PHP 4 fonctionne correctement, vous devez installer Pike 7.0.268 ou plus récent. Pour cet exemple, nous supposerons @@ -32,7 +33,8 @@ que caudium/server/lib/[pike-version]/PHP4.so est présent. 10. Configurez le module "PHP Script Support" si nécessaire. - </programlisting> +]]> + </screen> </example> <para> Vous pouvez bien sûr compiler votre module Caudium avec les diverses Index: phpdoc-fr/chapters/install.configure.graphics.xml diff -u phpdoc-fr/chapters/install.configure.graphics.xml:1.2 phpdoc-fr/chapters/install.configure.graphics.xml:1.3 --- phpdoc-fr/chapters/install.configure.graphics.xml:1.2 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.configure.graphics.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.graphics"> <title>Options graphiques</title> <variablelist> @@ -19,9 +19,14 @@ </term> <listitem> <para> - Inclus le support de ImageMagick. DIR est le dossier d'installation, - et par défaut, &php; essaiera de le trouver de lui-même. - [expérimental]. PHP 3 uniquement! + L'extension imagick a été placé dans PECL de PEAR et peut être + trouvé <ulink url="&url.php.pear;imagick">ici</ulink>. Les instructions + d'installation pour &php; 4 sont disponibles sur le site de PEAR. + </para> + <para> + En bref, <literal>--with-imagick</literal> est uniquement supporté + en &php; 3, à moins que vous ne suiviez les instructions disponibles sur + le site de PEAR. </para> </listitem> </varlistentry> Index: phpdoc-fr/chapters/install.configure.misc.xml diff -u phpdoc-fr/chapters/install.configure.misc.xml:1.2 phpdoc-fr/chapters/install.configure.misc.xml:1.3 --- phpdoc-fr/chapters/install.configure.misc.xml:1.2 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.configure.misc.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.misc"> <title>Options diverses</title> <variablelist> @@ -231,13 +231,14 @@ </para> </listitem> </varlistentry> - <varlistentry id="install.configure.with-system-regex"> + <varlistentry id="install.configure.with-regex"> <term> - <parameter>--with-system-regex</parameter> + <parameter>--with-regex[=TYPE]</parameter> </term> <listitem> <para> - Utilise la librairie d'expression régulières du système (obsolète). + Utilise la librairie d'expression régulières + du système (obsolète). </para> </listitem> </varlistentry> Index: phpdoc-fr/chapters/install.configure.xml diff -u phpdoc-fr/chapters/install.configure.xml:1.1 phpdoc-fr/chapters/install.configure.xml:1.2 --- phpdoc-fr/chapters/install.configure.xml:1.1 Thu Jan 30 08:44:43 2003 +++ phpdoc-fr/chapters/install.configure.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <sect1 id="install.configure"> <title>Liste complète des options de configuration</title> <note> @@ -104,7 +104,9 @@ &chapters.install.configure.misc; &chapters.install.configure.php; &chapters.install.configure.servers; +<!-- &chapters.install.configure.xml; +--> </sect2> </sect1> Index: phpdoc-fr/chapters/install.problems.xml diff -u phpdoc-fr/chapters/install.problems.xml:1.1 phpdoc-fr/chapters/install.problems.xml:1.2 --- phpdoc-fr/chapters/install.problems.xml:1.1 Thu Jan 30 08:44:43 2003 +++ phpdoc-fr/chapters/install.problems.xml Tue Mar 4 19:06:07 2003 @@ -29,7 +29,7 @@ de diffusion PHP, essayez d'être concis et clair, et pensez à donner tous les détails sur votre environnement (OS, version de PHP, serveur web, CGI ou module, - &safemode;...), et n'hésitez pas à envoyer + &safemode;, etc...), et n'hésitez pas à envoyer suffisamment de code pour que nous puissions reproduire l'erreur. </simpara> </sect2> Index: phpdoc-fr/chapters/install.windows.xml diff -u phpdoc-fr/chapters/install.windows.xml:1.5 phpdoc-fr/chapters/install.windows.xml:1.6 --- phpdoc-fr/chapters/install.windows.xml:1.5 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.windows.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <sect1 id="install.windows"> <title>Installation sous Windows</title> <para> @@ -191,10 +191,10 @@ Les fichiers à copier sont : <simplelist> <member> - 'php4ts.dll', s'il existe, écrasez le + "php4ts.dll", s'il existe, écrasez le </member> <member> - Les fichiers 'dlls' de votre distribution. Si vous les + Les fichiers "dlls" de votre distribution. Si vous les avez déjà installés, ne les remplacez pas, sauf si quelque chose ne fonctionne pas correctement (avant de les écraser, il est recommandé de les sauver de toute manière, au cas où @@ -211,11 +211,11 @@ </listitem> <listitem> <para> - Copiez le fichier '<filename>php.ini-dist</filename>' dans votre dossier - '%WINDOWS%' sous Windows 95/98, ou vers votre - dossier '%SYSTEMROOT%' sous Windows NT ou Windows - 2000 et renommez-le en '&php.ini;'. Votre dossier - '%WINDOWS%' ou '%SYSTEMROOT%' est généralement : + Copiez le fichier "<filename>php.ini-dist</filename>" dans votre dossier + "%WINDOWS%" sous Windows 95/98, ou vers votre + dossier "%SYSTEMROOT%" sous Windows NT ou Windows + 2000 et renommez-le en "&php.ini;". Votre dossier + "%WINDOWS%" ou "%SYSTEMROOT%" est généralement : <simplelist> <member>c:\windows pour Windows 9x/Me</member> <member>c:\winnt ou c:\winnt40 pour les serveurs NT/2000</member> Index: phpdoc-fr/chapters/intro.xml diff -u phpdoc-fr/chapters/intro.xml:1.20 phpdoc-fr/chapters/intro.xml:1.21 --- phpdoc-fr/chapters/intro.xml:1.20 Tue Feb 18 04:44:51 2003 +++ phpdoc-fr/chapters/intro.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<!-- $Revision: 1.21 $ --> <chapter id="introduction"> <title>Introduction</title> <sect1 id="intro-whatis"> @@ -42,7 +42,7 @@ à l'intérieur afin de réaliser une action précise (dans ce cas là, afficher du texte). Le code PHP est inclus entre <link linkend="language.basic-syntax.phpmode">une balise de début - et une balise de fin</link> qui permettent au navigateur de passer en "mode PHP". + et une balise de fin</link> qui permettent au serveur web de passer en "mode PHP". </para> <para> Ce qui distingue le PHP des langages de script comme le Javascript est que Index: phpdoc-fr/chapters/security.xml diff -u phpdoc-fr/chapters/security.xml:1.21 phpdoc-fr/chapters/security.xml:1.22 --- phpdoc-fr/chapters/security.xml:1.21 Thu Feb 20 10:55:59 2003 +++ phpdoc-fr/chapters/security.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <chapter id="security"> <title>Sécurité</title> <simpara> @@ -208,8 +208,10 @@ grâce aux directives suivantes : </simpara> <programlisting role="apache-conf"> -Action.php-script /cgi-bin/php -AddHandler.php-script .php +<![CDATA[ +Action php-script /cgi-bin/php +AddHandler php-script .php +]]> </programlisting> <simpara> Cette option a uniquement été testée avec Apache et @@ -300,7 +302,9 @@ rajouter la ligne suivante : <informalexample> <programlisting role="cgi"> +<![CDATA[ #!/usr/local/bin/php +]]> </programlisting> </informalexample> dans tous les fichiers contenant des tags PHP. Vous devrez aussi rendre le @@ -397,8 +401,8 @@ <programlisting role="php"> <![CDATA[ <?php -// efface un fichier dans un dossier racine -$username = $HTTP_POST_VARS['user_submitted_name']; +// Efface un fichier dans un dossier racine +$username = $_POST['user_submitted_name']; $homedir = "/home/$username"; $file_to_delete = "$userfile"; unlink ($homedir/$userfile); @@ -452,7 +456,7 @@ <![CDATA[ <?php // Efface un fichier sur le disque où l'utilisateur à le droit d'aller - $username = $HTTP_SERVER_VARS['REMOTE_USER']; + $username = $_SERVER['REMOTE_USER']; // utilise un mécanisme d'authentification $homedir = "/home/$username"; $file_to_delete = basename("$userfile"); @@ -477,7 +481,7 @@ <programlisting role="php"> <![CDATA[ <?php - $username = $HTTP_SERVER_VARS['REMOTE_USER'];; + $username = $_SERVER['REMOTE_USER'];; $homedir = "/home/$username"; if (!ereg('^[^./][^/]*$', $username)) die('Erreur de nom de fichier'); @@ -879,12 +883,14 @@ <title>Une navigation de fiches plus sécuritaire</title> <programlisting role="php"> <![CDATA[ +<?php settype($offset, 'integer'); $query = "SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET $offset;"; // notez que %d dans la chaîne de format : %s serait inutile $query = sprintf("SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET %d;", $offset); +?> ]]> </programlisting> </example> @@ -948,7 +954,7 @@ <title>Attaque de site avec une page HTML personnalisée</title> <programlisting role="php"> <![CDATA[ -<form method="post" action="http://www.site.cible.com/?username=badfoo&password=badfoo"> +<form method="post" action="http://www.site.cible.com/?username=badfoo&password=badfoo"> <input type="hidden" name="username" value="badfoo"> <input type="hidden" name="password" value="badfoo"> </form> @@ -976,7 +982,7 @@ <title>Exploiter des variables classiques de débogage</title> <programlisting role="php"> <![CDATA[ -<form method="post" action="http://www.site.cible.com/?errors=Y&showerrors=1"&debug=1"> +<form method="post" action="http://www.site.cible.com/?errors=Y&showerrors=1"&debug=1"> <input type="hidden" name="errors" value="Y"> <input type="hidden" name="showerrors" value="1"> <input type="hidden" name="debug" value="1"> @@ -1067,7 +1073,7 @@ écrire un script PHP, les bénéfices peuvent en être nettement plus interessants. <example> - <title>Travailler avec register_globals actif</title> + <title>Travailler avec register_globals = on</title> <programlisting role="php"> <![CDATA[ <?php @@ -1084,11 +1090,11 @@ </programlisting> </example> <example> - <title>Travailler avec register_globals actif</title> + <title>Travailler avec register_globals = off</title> <programlisting role="php"> <![CDATA[ <?php - if($HTTP_COOKIE_VARS["username"]){ + if($_COOKIE["username"]){ // ne peut provenir que d'un cookie, corrompu ou pas $good_login = 1; // Impossible à parasiter @@ -1109,14 +1115,14 @@ <programlisting role="php"> <![CDATA[ <?php - if ($HTTP_COOKIE_VARS['username'] && - !$HTTP_POST_VARS['username'] && - !$HTTP_GET_VARS['username'] ) { + if ($_COOKIE['username'] && + !$_POST['username'] && + !$_GET['username'] ) { // D'autres vérifications pour vérifier l'origine du nom d'utilisateur fourni $good_login = 1; fpassthru ("/données/très/très/sensibles/index.html"); } else { - mail("admin@example.com", "Tentative de piratage", $HTTP_SERVER_VARS['REMOTE_ADDR']); + mail("admin@example.com", "Tentative de piratage", $_SERVER['REMOTE_ADDR']); echo "Problème de sécurité, l'administrateur est alerté."; exit; } @@ -1221,17 +1227,21 @@ informations déroutantes comme ceci : <example> <title>Masquer PHP avec un autre langage</title> - <programlisting role="php"> -// Faire que le code PHP ressemble à un autre type + <programlisting role="apache-conf"> +<![CDATA[ +# Faire que le code PHP ressemble à un autre langage AddType application/x-httpd-php .asp .py .pl +]]> </programlisting> </example> Ou masquez le complètement : <example> <title>Masquer PHP avec des types inconnus</title> - <programlisting role="php"> -// Faire que le code PHP ressemble à un autre langage qui n'existe pas + <programlisting role="apache-conf"> +<![CDATA[ +# Faire que le code PHP ressemble à un autre langage qui n'existe pas AddType application/x-httpd-php .bop .foo .133t +]]> </programlisting> </example> Ou encore, cachez-le sous forme de html. Cela a un léger impact négatif @@ -1239,9 +1249,11 @@ analysés et traités par le moteur PHP : <example> <title>Utiliser le type html pour les extensions PHP</title> - <programlisting role="php"> -// Faire que le code PHP ressemble à du html + <programlisting role="apache-conf"> +<![CDATA[ +# Faire que le code PHP ressemble à du html AddType application/x-httpd-php .htm .html +]]> </programlisting> </example> Pour que cela fonctionne efficacement, pensez à renommer tous vos Index: phpdoc-fr/chapters/streams.common.xml diff -u phpdoc-fr/chapters/streams.common.xml:1.4 phpdoc-fr/chapters/streams.common.xml:1.5 --- phpdoc-fr/chapters/streams.common.xml:1.4 Thu Feb 6 19:52:01 2003 +++ phpdoc-fr/chapters/streams.common.xml Tue Mar 4 19:06:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- Author: Wez Furlong <wez@thebrainroom.com> Please contact me before making any major amendments to the content of this section. Splitting/Merging are fine if they are @@ -257,7 +257,7 @@ </methodsynopsis> <para> <function>php_stream_write</function> écrit <parameter>count</parameter> - octets du buffer <parameter>buf</parameter> dans le flot <parameter>stream</parameter>. + octets du buffer <parameter>buf</parameter> dans le flôt <parameter>stream</parameter>. </para> <para> <function>php_stream_write</function> retourne le nombre d'octets qui ont
Index: phpdoc-fr/chapters/config.xml diff -u phpdoc-fr/chapters/config.xml:1.21 phpdoc-fr/chapters/config.xml:1.22 --- phpdoc-fr/chapters/config.xml:1.21 Thu Feb 20 10:08:32 2003 +++ phpdoc-fr/chapters/config.xml Tue Mar 4 19:06:06 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> @@ -40,6 +40,7 @@ <example> <title>Extrait du &php.ini;</title> <programlisting role="ini"> +<![CDATA[ ; tout texte sur une ligne, situé après un point-virgule ";" est ignoré [php] ; les marqueur de section (texte entre crochets) sont aussi ignorés ; Les valeurs booléenne peuvent être spécifiées comme ceci : @@ -53,6 +54,8 @@ include_path = ".;c:\php\lib" </programlisting> <!-- TODO: add more details about values and expressions --> +]]> + </programlisting> </example> </para> </sect1> @@ -132,6 +135,13 @@ Toute diretive de &php; configurée avec le type <systemitem role="directive">php_admin_value</systemitem> ne peut pas être modifiée en utilisant le fichier <filename>.htaccess</filename>. + <informalexample> + <programlisting role="ini"> +<![CDATA[ +php_admin_value open_basedir none +]]> + </programlisting> + </informalexample> </para> </listitem> </varlistentry> @@ -329,7 +339,7 @@ <varlistentry id="ini.short-open-tag"> <term> <parameter>short_open_tag</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -355,7 +365,7 @@ <varlistentry id="ini.asp-tags"> <term> <parameter>asp_tags</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -385,7 +395,7 @@ <varlistentry id="ini.y2k-compliance"> <term> <parameter>y2k_compliance</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <simpara> @@ -397,7 +407,7 @@ <varlistentry id="ini.allow-call-time-pass-reference"> <term> <parameter>allow_call_time_pass_reference</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -420,7 +430,7 @@ <varlistentry id="ini.expose-php"> <term> <parameter>expose_php</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -581,7 +591,7 @@ <varlistentry id="ini.track-vars"> <term> <parameter>track_vars</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -656,7 +666,7 @@ <varlistentry id="ini.register-globals"> <term> <parameter>register_globals</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -705,7 +715,7 @@ <varlistentry id="ini.register-argc-argv"> <term> <parameter>register_argc_argv</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <simpara> @@ -830,7 +840,7 @@ <varlistentry id="ini.always-populate-raw-post-data"> <term> <parameter>always_populate_raw_post_data</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -842,7 +852,7 @@ <varlistentry id="ini.allow-webdav-methods"> <term> <parameter>allow_webdav_methods</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1024,7 +1034,7 @@ <varlistentry id="ini.cgi.force-redirect"> <term> <parameter>cgi.force_redirect</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1123,7 +1133,7 @@ <varlistentry id="ini.file-uploads"> <term> <parameter>file_uploads</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1196,7 +1206,7 @@ <varlistentry id="ini.sql.safe-mode"> <term> <parameter>sql.safe_mode</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> @@ -1238,7 +1248,7 @@ <varlistentry id="ini.debugger.enabled"> <term> <parameter>debugger.enabled</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.apache.xml diff -u phpdoc-fr/chapters/install.apache.xml:1.2 phpdoc-fr/chapters/install.apache.xml:1.3 --- phpdoc-fr/chapters/install.apache.xml:1.2 Thu Feb 20 04:32:12 2003 +++ phpdoc-fr/chapters/install.apache.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect1 id="install.apache"> <title>Installation avec le serveur Apache</title> <para> @@ -27,6 +27,7 @@ <example id="install.apache.unix.longer"> <title>Instructions d'installation avec Apache (version module)</title> <programlisting> +<![CDATA[ 1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar 3. gunzip php-x.x.x.tar.gz @@ -59,6 +60,7 @@ 18. Utilisez votre procédure habituelle pour démarrer votre serveur Apache. (vous devez l'éteindre et le redémarrer, pas seulement lui envoyer un signal HUP ou USR1.) +]]> </programlisting> </example> <para> @@ -70,7 +72,8 @@ <example> <title>Redémarrage d'apache</title> <programlisting> -1. Nombreuses variantes Linux SysV : +<![CDATA[ +[1. Nombreuses variantes Linux SysV : /etc/rc.d/init.d/httpd restart 2. Avec les scripts apachectl : /path/to/apachectl stop @@ -81,6 +84,7 @@ 4. En utilisant mod_ssl, ou un autre seveur SSL, manuellement : /path/to/apachectl stop /path/to/apachectl startssl +]]> </programlisting> </example> Les exécutables apachectl et http(s)dctl peuvent être situés Index: phpdoc-fr/chapters/install.apache2.xml diff -u phpdoc-fr/chapters/install.apache2.xml:1.2 phpdoc-fr/chapters/install.apache2.xml:1.3 --- phpdoc-fr/chapters/install.apache2.xml:1.2 Thu Feb 20 04:32:12 2003 +++ phpdoc-fr/chapters/install.apache2.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect1 id="install.apache2"> <title>Installation avec les serveurs Apache 2.0</title> <para> @@ -204,18 +204,6 @@ bonne directive pour Apache. </para> </note> - <para> - <example> - <title>Configurer PHP 4.3.0 avec Apache 2.0 en CGI</title> - <programlisting role="apache"> -<![CDATA[ -ScriptAlias /php/ "c:/php/" -AddType application/x-httpd-php .php -Action application/x-httpd-php "/php/php-cgi.exe" -]]> - </programlisting> - </example> - </para> <para> Si vous souhaitez utiliser &php; comme module dans Apache 2.0, placez bien le fichier <filename>php4ts.dll</filename> dans votre Index: phpdoc-fr/chapters/install.caudium.xml diff -u phpdoc-fr/chapters/install.caudium.xml:1.2 phpdoc-fr/chapters/install.caudium.xml:1.3 --- phpdoc-fr/chapters/install.caudium.xml:1.2 Thu Feb 20 04:32:12 2003 +++ phpdoc-fr/chapters/install.caudium.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect1 id="install.caudium"> <title>Installation sur le serveur Caudium</title> <para> @@ -10,7 +10,8 @@ </para> <example id="install.caudium.instructions"> <title>Instructions d'installation Caudium</title> - <programlisting> + <screen> +<![CDATA[ 1. Assurez-vous que vous avez un serveur Caudium installé avant de tenter l'installation PHP 4. Pour que PHP 4 fonctionne correctement, vous devez installer Pike 7.0.268 ou plus récent. Pour cet exemple, nous supposerons @@ -32,7 +33,8 @@ que caudium/server/lib/[pike-version]/PHP4.so est présent. 10. Configurez le module "PHP Script Support" si nécessaire. - </programlisting> +]]> + </screen> </example> <para> Vous pouvez bien sûr compiler votre module Caudium avec les diverses Index: phpdoc-fr/chapters/install.configure.graphics.xml diff -u phpdoc-fr/chapters/install.configure.graphics.xml:1.2 phpdoc-fr/chapters/install.configure.graphics.xml:1.3 --- phpdoc-fr/chapters/install.configure.graphics.xml:1.2 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.configure.graphics.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.graphics"> <title>Options graphiques</title> <variablelist> @@ -19,9 +19,14 @@ </term> <listitem> <para> - Inclus le support de ImageMagick. DIR est le dossier d'installation, - et par défaut, &php; essaiera de le trouver de lui-même. - [expérimental]. PHP 3 uniquement! + L'extension imagick a été placé dans PECL de PEAR et peut être + trouvé <ulink url="&url.php.pear;imagick">ici</ulink>. Les instructions + d'installation pour &php; 4 sont disponibles sur le site de PEAR. + </para> + <para> + En bref, <literal>--with-imagick</literal> est uniquement supporté + en &php; 3, à moins que vous ne suiviez les instructions disponibles sur + le site de PEAR. </para> </listitem> </varlistentry> Index: phpdoc-fr/chapters/install.configure.misc.xml diff -u phpdoc-fr/chapters/install.configure.misc.xml:1.2 phpdoc-fr/chapters/install.configure.misc.xml:1.3 --- phpdoc-fr/chapters/install.configure.misc.xml:1.2 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.configure.misc.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.misc"> <title>Options diverses</title> <variablelist> @@ -231,13 +231,14 @@ </para> </listitem> </varlistentry> - <varlistentry id="install.configure.with-system-regex"> + <varlistentry id="install.configure.with-regex"> <term> - <parameter>--with-system-regex</parameter> + <parameter>--with-regex[=TYPE]</parameter> </term> <listitem> <para> - Utilise la librairie d'expression régulières du système (obsolète). + Utilise la librairie d'expression régulières + du système (obsolète). </para> </listitem> </varlistentry> Index: phpdoc-fr/chapters/install.configure.xml diff -u phpdoc-fr/chapters/install.configure.xml:1.1 phpdoc-fr/chapters/install.configure.xml:1.2 --- phpdoc-fr/chapters/install.configure.xml:1.1 Thu Jan 30 08:44:43 2003 +++ phpdoc-fr/chapters/install.configure.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <sect1 id="install.configure"> <title>Liste complète des options de configuration</title> <note> @@ -104,7 +104,9 @@ &chapters.install.configure.misc; &chapters.install.configure.php; &chapters.install.configure.servers; +<!-- &chapters.install.configure.xml; +--> </sect2> </sect1> Index: phpdoc-fr/chapters/install.problems.xml diff -u phpdoc-fr/chapters/install.problems.xml:1.1 phpdoc-fr/chapters/install.problems.xml:1.2 --- phpdoc-fr/chapters/install.problems.xml:1.1 Thu Jan 30 08:44:43 2003 +++ phpdoc-fr/chapters/install.problems.xml Tue Mar 4 19:06:07 2003 @@ -29,7 +29,7 @@ de diffusion PHP, essayez d'être concis et clair, et pensez à donner tous les détails sur votre environnement (OS, version de PHP, serveur web, CGI ou module, - &safemode;...), et n'hésitez pas à envoyer + &safemode;, etc...), et n'hésitez pas à envoyer suffisamment de code pour que nous puissions reproduire l'erreur. </simpara> </sect2> Index: phpdoc-fr/chapters/install.windows.xml diff -u phpdoc-fr/chapters/install.windows.xml:1.5 phpdoc-fr/chapters/install.windows.xml:1.6 --- phpdoc-fr/chapters/install.windows.xml:1.5 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.windows.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <sect1 id="install.windows"> <title>Installation sous Windows</title> <para> @@ -191,10 +191,10 @@ Les fichiers à copier sont : <simplelist> <member> - 'php4ts.dll', s'il existe, écrasez le + "php4ts.dll", s'il existe, écrasez le </member> <member> - Les fichiers 'dlls' de votre distribution. Si vous les + Les fichiers "dlls" de votre distribution. Si vous les avez déjà installés, ne les remplacez pas, sauf si quelque chose ne fonctionne pas correctement (avant de les écraser, il est recommandé de les sauver de toute manière, au cas où @@ -211,11 +211,11 @@ </listitem> <listitem> <para> - Copiez le fichier '<filename>php.ini-dist</filename>' dans votre dossier - '%WINDOWS%' sous Windows 95/98, ou vers votre - dossier '%SYSTEMROOT%' sous Windows NT ou Windows - 2000 et renommez-le en '&php.ini;'. Votre dossier - '%WINDOWS%' ou '%SYSTEMROOT%' est généralement : + Copiez le fichier "<filename>php.ini-dist</filename>" dans votre dossier + "%WINDOWS%" sous Windows 95/98, ou vers votre + dossier "%SYSTEMROOT%" sous Windows NT ou Windows + 2000 et renommez-le en "&php.ini;". Votre dossier + "%WINDOWS%" ou "%SYSTEMROOT%" est généralement : <simplelist> <member>c:\windows pour Windows 9x/Me</member> <member>c:\winnt ou c:\winnt40 pour les serveurs NT/2000</member> Index: phpdoc-fr/chapters/intro.xml diff -u phpdoc-fr/chapters/intro.xml:1.20 phpdoc-fr/chapters/intro.xml:1.21 --- phpdoc-fr/chapters/intro.xml:1.20 Tue Feb 18 04:44:51 2003 +++ phpdoc-fr/chapters/intro.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<!-- $Revision: 1.21 $ --> <chapter id="introduction"> <title>Introduction</title> <sect1 id="intro-whatis"> @@ -42,7 +42,7 @@ à l'intérieur afin de réaliser une action précise (dans ce cas là, afficher du texte). Le code PHP est inclus entre <link linkend="language.basic-syntax.phpmode">une balise de début - et une balise de fin</link> qui permettent au navigateur de passer en "mode PHP". + et une balise de fin</link> qui permettent au serveur web de passer en "mode PHP". </para> <para> Ce qui distingue le PHP des langages de script comme le Javascript est que Index: phpdoc-fr/chapters/security.xml diff -u phpdoc-fr/chapters/security.xml:1.21 phpdoc-fr/chapters/security.xml:1.22 --- phpdoc-fr/chapters/security.xml:1.21 Thu Feb 20 10:55:59 2003 +++ phpdoc-fr/chapters/security.xml Tue Mar 4 19:06:07 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <chapter id="security"> <title>Sécurité</title> <simpara> @@ -208,8 +208,10 @@ grâce aux directives suivantes : </simpara> <programlisting role="apache-conf"> -Action.php-script /cgi-bin/php -AddHandler.php-script .php +<![CDATA[ +Action php-script /cgi-bin/php +AddHandler php-script .php +]]> </programlisting> <simpara> Cette option a uniquement été testée avec Apache et @@ -300,7 +302,9 @@ rajouter la ligne suivante : <informalexample> <programlisting role="cgi"> +<![CDATA[ #!/usr/local/bin/php +]]> </programlisting> </informalexample> dans tous les fichiers contenant des tags PHP. Vous devrez aussi rendre le @@ -397,8 +401,8 @@ <programlisting role="php"> <![CDATA[ <?php -// efface un fichier dans un dossier racine -$username = $HTTP_POST_VARS['user_submitted_name']; +// Efface un fichier dans un dossier racine +$username = $_POST['user_submitted_name']; $homedir = "/home/$username"; $file_to_delete = "$userfile"; unlink ($homedir/$userfile); @@ -452,7 +456,7 @@ <![CDATA[ <?php // Efface un fichier sur le disque où l'utilisateur à le droit d'aller - $username = $HTTP_SERVER_VARS['REMOTE_USER']; + $username = $_SERVER['REMOTE_USER']; // utilise un mécanisme d'authentification $homedir = "/home/$username"; $file_to_delete = basename("$userfile"); @@ -477,7 +481,7 @@ <programlisting role="php"> <![CDATA[ <?php - $username = $HTTP_SERVER_VARS['REMOTE_USER'];; + $username = $_SERVER['REMOTE_USER'];; $homedir = "/home/$username"; if (!ereg('^[^./][^/]*$', $username)) die('Erreur de nom de fichier'); @@ -879,12 +883,14 @@ <title>Une navigation de fiches plus sécuritaire</title> <programlisting role="php"> <![CDATA[ +<?php settype($offset, 'integer'); $query = "SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET $offset;"; // notez que %d dans la chaîne de format : %s serait inutile $query = sprintf("SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET %d;", $offset); +?> ]]> </programlisting> </example> @@ -948,7 +954,7 @@ <title>Attaque de site avec une page HTML personnalisée</title> <programlisting role="php"> <![CDATA[ -<form method="post" action="http://www.site.cible.com/?username=badfoo&password=badfoo"> +<form method="post" action="http://www.site.cible.com/?username=badfoo&password=badfoo"> <input type="hidden" name="username" value="badfoo"> <input type="hidden" name="password" value="badfoo"> </form> @@ -976,7 +982,7 @@ <title>Exploiter des variables classiques de débogage</title> <programlisting role="php"> <![CDATA[ -<form method="post" action="http://www.site.cible.com/?errors=Y&showerrors=1"&debug=1"> +<form method="post" action="http://www.site.cible.com/?errors=Y&showerrors=1"&debug=1"> <input type="hidden" name="errors" value="Y"> <input type="hidden" name="showerrors" value="1"> <input type="hidden" name="debug" value="1"> @@ -1067,7 +1073,7 @@ écrire un script PHP, les bénéfices peuvent en être nettement plus interessants. <example> - <title>Travailler avec register_globals actif</title> + <title>Travailler avec register_globals = on</title> <programlisting role="php"> <![CDATA[ <?php @@ -1084,11 +1090,11 @@ </programlisting> </example> <example> - <title>Travailler avec register_globals actif</title> + <title>Travailler avec register_globals = off</title> <programlisting role="php"> <![CDATA[ <?php - if($HTTP_COOKIE_VARS["username"]){ + if($_COOKIE["username"]){ // ne peut provenir que d'un cookie, corrompu ou pas $good_login = 1; // Impossible à parasiter @@ -1109,14 +1115,14 @@ <programlisting role="php"> <![CDATA[ <?php - if ($HTTP_COOKIE_VARS['username'] && - !$HTTP_POST_VARS['username'] && - !$HTTP_GET_VARS['username'] ) { + if ($_COOKIE['username'] && + !$_POST['username'] && + !$_GET['username'] ) { // D'autres vérifications pour vérifier l'origine du nom d'utilisateur fourni $good_login = 1; fpassthru ("/données/très/très/sensibles/index.html"); } else { - mail("admin@example.com", "Tentative de piratage", $HTTP_SERVER_VARS['REMOTE_ADDR']); + mail("admin@example.com", "Tentative de piratage", $_SERVER['REMOTE_ADDR']); echo "Problème de sécurité, l'administrateur est alerté."; exit; } @@ -1221,17 +1227,21 @@ informations déroutantes comme ceci : <example> <title>Masquer PHP avec un autre langage</title> - <programlisting role="php"> -// Faire que le code PHP ressemble à un autre type + <programlisting role="apache-conf"> +<![CDATA[ +# Faire que le code PHP ressemble à un autre langage AddType application/x-httpd-php .asp .py .pl +]]> </programlisting> </example> Ou masquez le complètement : <example> <title>Masquer PHP avec des types inconnus</title> - <programlisting role="php"> -// Faire que le code PHP ressemble à un autre langage qui n'existe pas + <programlisting role="apache-conf"> +<![CDATA[ +# Faire que le code PHP ressemble à un autre langage qui n'existe pas AddType application/x-httpd-php .bop .foo .133t +]]> </programlisting> </example> Ou encore, cachez-le sous forme de html. Cela a un léger impact négatif @@ -1239,9 +1249,11 @@ analysés et traités par le moteur PHP : <example> <title>Utiliser le type html pour les extensions PHP</title> - <programlisting role="php"> -// Faire que le code PHP ressemble à du html + <programlisting role="apache-conf"> +<![CDATA[ +# Faire que le code PHP ressemble à du html AddType application/x-httpd-php .htm .html +]]> </programlisting> </example> Pour que cela fonctionne efficacement, pensez à renommer tous vos Index: phpdoc-fr/chapters/streams.common.xml diff -u phpdoc-fr/chapters/streams.common.xml:1.4 phpdoc-fr/chapters/streams.common.xml:1.5 --- phpdoc-fr/chapters/streams.common.xml:1.4 Thu Feb 6 19:52:01 2003 +++ phpdoc-fr/chapters/streams.common.xml Tue Mar 4 19:06:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- Author: Wez Furlong <wez@thebrainroom.com> Please contact me before making any major amendments to the content of this section. Splitting/Merging are fine if they are @@ -257,7 +257,7 @@ </methodsynopsis> <para> <function>php_stream_write</function> écrit <parameter>count</parameter> - octets du buffer <parameter>buf</parameter> dans le flot <parameter>stream</parameter>. + octets du buffer <parameter>buf</parameter> dans le flôt <parameter>stream</parameter>. </para> <para> <function>php_stream_write</function> retourne le nombre d'octets qui ont