cvs: phpdoc-fr /chapters config.xml install.apache.xml install.apache2.xml install.configure.databases.xml install.configure.graphics.xml
install.configure.misc.xml install.configure.php.xml install.configure.servers.xml install.windows.xml security.xml streams.constants.xml
streams.structs.xml tutorial.xml
| From: | Damien Seguy | Date: | Tue, 20 May 2003 01:57:09 +0000 |
| Subject: | cvs: phpdoc-fr /chapters config.xml install.apache.xml install.apache2.xml install.configure.databases.xml install.configure.graphics.xml install.configure.misc.xml install.configure.php.xml install.configure.servers.xml install.windows.xml security.xml streams.constants.xml streams.structs.xml tutorial.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-391@lists.php.net to get a copy of this message | ||
dams Mon May 19 21:57:09 2003 EDT
Modified files:
/phpdoc-fr/chapters config.xml install.apache.xml
install.apache2.xml
install.configure.databases.xml
install.configure.graphics.xml
install.configure.misc.xml
install.configure.php.xml
install.configure.servers.xml
install.windows.xml security.xml
streams.constants.xml streams.structs.xml
tutorial.xml
Log:
correcting example
Index: phpdoc-fr/chapters/config.xml diff -u phpdoc-fr/chapters/config.xml:1.24 phpdoc-fr/chapters/config.xml:1.25 --- phpdoc-fr/chapters/config.xml:1.24 Sat May 3 15:09:14 2003 +++ phpdoc-fr/chapters/config.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.24 $ --> +<!-- $Revision: 1.25 $ --> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> @@ -69,7 +69,7 @@ Lorsque vous utilisez le module Apache, vous pouvez aussi changer les paramètres de configuration en utilisant les directives dans les fichiers de configuration d'Apache et dans les fichiers - <filename>.htaccess</filename>. + &htaccess;. </simpara> <simpara> Dans la version 3.0, à chaque directive de configuration @@ -131,10 +131,10 @@ <para> Cette instruction affecte une valeur à la variable spécifiée. - Cette instruction NE peux PAS être utilisée dans un fichier <filename>.htaccess</filename>. + Cette instruction NE peux PAS être utilisée dans un fichier &htaccess;. 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>. + modifiée en utilisant le fichier &htaccess;. <informalexample> <programlisting role="ini"> <![CDATA[ @@ -155,10 +155,10 @@ <para> Cette directive est utilisée pour activer ou désactiver l'option précédente. - Cette instruction NE peux PAS être utilisée dans un fichier <filename>.htaccess</filename>. + Cette instruction NE peux PAS être utilisée dans un fichier &htaccess;. Toute directive 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>. + modifiée en utilisant le fichier &htaccess;. </para> </listitem> </varlistentry> @@ -183,7 +183,7 @@ <note> <para> Les constantes &php; n'existent pas en dehors de &php;. Par - exemple, dans le fichier <filename>httpd.conf</filename>, + exemple, dans le fichier &httpd.conf;, vous ne pouvez pas utiliser des constantes &php; telles que <constant>E_ALL</constant> ou <constant>E_NOTICE</constant> pour fixer le niveau de <link linkend="ini.error-reporting">rapport d'erreur</link>, @@ -227,8 +227,8 @@ <entry>2</entry> <entry> La directive peut être configurée dans le fichier &php.ini;, le - fichier <filename>.htaccess</filename> ou encore dans le fichier - <filename>httpd.conf</filename> + fichier &htaccess; ou encore dans le fichier + &httpd.conf; </entry> </row> <row> @@ -236,7 +236,7 @@ <entry>4</entry> <entry> La directive peut être configurée dans le fichier &php.ini; ou - dans <filename>httpd.conf</filename> + dans &httpd.conf; </entry> </row> <row> @@ -698,9 +698,9 @@ <para> Notez que <systemitem role="directive">register_globals</systemitem> ne peut être modifiée durant l'exécution du script (avec <function>ini_set</function>). - Cependant, vous pouvez utiliser le fichier <filename>.htaccess</filename> si + Cependant, vous pouvez utiliser le fichier &htaccess; si votre hôte les supporte, comme décrit ci-dessus. Par exemple, vous pouvez - inscrire dans votre fichier <filename>.htaccess</filename> : + inscrire dans votre fichier &htaccess; : <userinput>php_flag register_globals on</userinput>. </para> <note> Index: phpdoc-fr/chapters/install.apache.xml diff -u phpdoc-fr/chapters/install.apache.xml:1.3 phpdoc-fr/chapters/install.apache.xml:1.4 --- phpdoc-fr/chapters/install.apache.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.apache.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect1 id="install.apache"> <title>Installation avec le serveur Apache</title> <para> @@ -15,7 +15,7 @@ sous Windows. L'une passe par les CGI (php.exe), l'autre est d'utiliser la DLL de module d'apache. Dans les deux cas, vous devrez arrêter le serveur Apache, et éditer le fichier - <filename>srm.conf</filename> ou <filename>httpd.conf</filename>, + <filename>srm.conf</filename> ou &httpd.conf;, pour configurer Apache avec PHP. </simpara> <para> @@ -107,7 +107,7 @@ <para> Cette commande va créer une librairie partagée <filename>libphp4.so</filename> qui sera chargée par Apache avec - une ligne LoadModule dans le fichier <filename>httpd.conf</filename>. + une ligne LoadModule dans le fichier &httpd.conf;. Le support PostgreSQL est aussi inclut dans <filename>libphp4.so</filename>. </para> <para> @@ -307,7 +307,7 @@ You may find after using the windows installer for Apache that you need to define the <literal>AddModule</literal> directive for <filename>mod_php4.c</filename> in the - configuration file (<filename>httpd.conf</filename>). + configuration file (&httpd.conf;). This is done by adding <literal>AddModule mod_php4.c</literal> to the <literal>AddModule</literal> list, near the beginning of the configuration file. This is especially important if Index: phpdoc-fr/chapters/install.apache2.xml diff -u phpdoc-fr/chapters/install.apache2.xml:1.3 phpdoc-fr/chapters/install.apache2.xml:1.4 --- phpdoc-fr/chapters/install.apache2.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.apache2.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect1 id="install.apache2"> <title>Installation avec les serveurs Apache 2.0</title> <para> @@ -180,11 +180,11 @@ Il y a deux méthodes pour que &php; fonctionne avec Apache 2.0 sous Windows. La première est l'interface CGI, et l'autre est le module DLL APache. Dans les deux cas, commencez par stopper le serveur - Apache, et éditez le fichier <filename>httpd.conf</filename> pour configurer + Apache, et éditez le fichier &httpd.conf; pour configurer Apache avec le support &php;. </para> <para> - Vous devez insérer les lignes suivantes dans le fichier <filename>httpd.conf</filename> + Vous devez insérer les lignes suivantes dans le fichier &httpd.conf; pour réaliser la configuration en mode <emphasis>CGI</emphasis>: <example> <title>Configurer la version de développement de PHP avec Apache 2.0 en CGI</title> @@ -209,7 +209,7 @@ placez bien le fichier <filename>php4ts.dll</filename> dans votre dossier <filename>winnt/system32</filename>, en y écrasant tout autre fichier qui s'y trouverait. Puis vous devrez insérer les deux lignes suivantes - dans votre fichier de configuration d'Apache <filename>httpd.conf</filename> + dans votre fichier de configuration d'Apache &httpd.conf; pour y ajouter le module PHP d'Apache 2.0 : <example> <title>Configurer PHP avec Apache 2.0 en module</title> Index: phpdoc-fr/chapters/install.configure.databases.xml diff -u phpdoc-fr/chapters/install.configure.databases.xml:1.2 phpdoc-fr/chapters/install.configure.databases.xml:1.3 --- phpdoc-fr/chapters/install.configure.databases.xml:1.2 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.configure.databases.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.databases"> <title>Options bases de données</title> <variablelist> @@ -15,7 +15,7 @@ </varlistentry> <varlistentry id="install.configure.with-adabas"> <term> - <parameter>--with-adabas[=DIR]</parameter> + <parameter>--with-adabas[=dir]</parameter> </term> <listitem> <para> @@ -26,7 +26,7 @@ </varlistentry> <varlistentry id="install.configure.with-sapdb"> <term> - <parameter>--with-sapdb[=DIR]</parameter> + <parameter>--with-sapdb[=dir]</parameter> </term> <listitem> <para> @@ -37,7 +37,7 @@ </varlistentry> <varlistentry id="install.configure.with-solid"> <term> - <parameter>--with-solid[=DIR]</parameter> + <parameter>--with-solid[=dir]</parameter> </term> <listitem> <para> @@ -48,7 +48,7 @@ </varlistentry> <varlistentry id="install.configure.with-ibm-db2"> <term> - <parameter>--with-ibm-db2[=DIR]</parameter> + <parameter>--with-ibm-db2[=dir]</parameter> </term> <listitem> <para> @@ -59,7 +59,7 @@ </varlistentry> <varlistentry id="install.configure.with-empress"> <term> - <parameter>--with-empress[=DIR]</parameter> + <parameter>--with-empress[=dir]</parameter> </term> <listitem> <para> @@ -71,7 +71,7 @@ </varlistentry> <varlistentry id="install.configure.with-empress-bcs"> <term> - <parameter>--with-empress-bcs[=DIR]</parameter> + <parameter>--with-empress-bcs[=dir]</parameter> </term> <listitem> <para> @@ -83,7 +83,7 @@ </varlistentry> <varlistentry id="install.configure.with-birdstep"> <term> - <parameter>--with-birdstep[=DIR]</parameter> + <parameter>--with-birdstep[=dir]</parameter> </term> <listitem> <para> @@ -92,9 +92,22 @@ </para> </listitem> </varlistentry> + <varlistentry id="install.configure.with-mysql"> + <term> + <parameter>--with-mysql[=dir]</parameter> + </term> + <listitem> + <para> + Inclut le support MySQL. DIR est le dossier d'installation de MySQL, + et par défaut il pointe sur la librairie MySQL fournie avec la distribution + de &php;. Le support MySQL est activé par défaut. Pour le désactiver, + il faut utiliser l'option <parameter>--without-mysql</parameter>. + </para> + </listitem> + </varlistentry> <varlistentry id="install.configure.with-custom-odbc"> <term> - <parameter>--with-custom-odbc[=DIR]</parameter> + <parameter>--with-custom-odbc[=dir]</parameter> </term> <listitem> <para> @@ -113,7 +126,7 @@ </varlistentry> <varlistentry id="install.configure.with-iodbc"> <term> - <parameter>--with-iodbc[=DIR]</parameter> + <parameter>--with-iodbc[=dir]</parameter> </term> <listitem> <para> @@ -124,7 +137,7 @@ </varlistentry> <varlistentry id="install.configure.with-esoob"> <term> - <parameter>--with-esoob[=DIR]</parameter> + <parameter>--with-esoob[=dir]</parameter> </term> <listitem> <para> @@ -135,7 +148,7 @@ </varlistentry> <varlistentry id="install.configure.with-unixODBC"> <term> - <parameter>--with-unixODBC[=DIR]</parameter> + <parameter>--with-unixodbc[=dir]</parameter> </term> <listitem> <para> @@ -146,7 +159,7 @@ </varlistentry> <varlistentry id="install.configure.with-openlink"> <term> - <parameter>--with-openlink[=DIR]</parameter> + <parameter>--with-openlink[=dir]</parameter> </term> <listitem> <para> @@ -157,7 +170,7 @@ </varlistentry> <varlistentry id="install.configure.with-dbmaker"> <term> - <parameter>--with-dbmaker[=DIR]</parameter> + <parameter>--with-dbmaker[=dir]</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.graphics.xml diff -u phpdoc-fr/chapters/install.configure.graphics.xml:1.3 phpdoc-fr/chapters/install.configure.graphics.xml:1.4 --- phpdoc-fr/chapters/install.configure.graphics.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.configure.graphics.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect3 id="install.configure.options.graphics"> <title>Options graphiques</title> <variablelist> @@ -32,7 +32,7 @@ </varlistentry> <varlistentry id="install.configure.with-ming"> <term> - <parameter>--with-ming[=DIR]</parameter> + <parameter>--with-ming[=dir]</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.misc.xml diff -u phpdoc-fr/chapters/install.configure.misc.xml:1.3 phpdoc-fr/chapters/install.configure.misc.xml:1.4 --- phpdoc-fr/chapters/install.configure.misc.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.configure.misc.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect3 id="install.configure.options.misc"> <title>Options diverses</title> <variablelist> @@ -27,7 +27,7 @@ </varlistentry> <varlistentry id="install.configure.with-fastcgi"> <term> - <parameter>--with-fastcgi=SRCDIR</parameter> + <parameter>--with-fastcgi=srcdir</parameter> </term> <listitem> <para> @@ -47,7 +47,7 @@ </varlistentry> <varlistentry id="install.configure.with-layout"> <term> - <parameter>--with-layout=TYPE</parameter> + <parameter>--with-layout=type</parameter> </term> <listitem> <para> @@ -58,7 +58,7 @@ </varlistentry> <varlistentry id="install.configure.with-pear"> <term> - <parameter>--with-pear=DIR</parameter> + <parameter>--with-pear=dir</parameter> </term> <listitem> <para> @@ -121,7 +121,7 @@ </varlistentry> <varlistentry id="install.configure.with-zlib-dir"> <term> - <parameter>--with-zlib-dir=<DIR></parameter> + <parameter>--with-zlib-dir=<dir></parameter> </term> <listitem> <para> @@ -131,7 +131,7 @@ </varlistentry> <varlistentry id="install.configure.with-aspell"> <term> - <parameter>--with-aspell[=DIR]</parameter> + <parameter>--with-aspell[=dir]</parameter> </term> <listitem> <para> @@ -141,7 +141,7 @@ </varlistentry> <varlistentry id="install.configure.with-ccvs"> <term> - <parameter>--with-ccvs[=DIR]</parameter> + <parameter>--with-ccvs[=dir]</parameter> </term> <listitem> <para> @@ -151,7 +151,7 @@ </varlistentry> <varlistentry id="install.configure.with-cybercash"> <term> - <parameter>--with-cybercash[=DIR]</parameter> + <parameter>--with-cybercash[=dir]</parameter> </term> <listitem> <para> @@ -162,7 +162,7 @@ </varlistentry> <varlistentry id="install.configure.with-icap"> <term> - <parameter>--with-icap[=DIR]</parameter> + <parameter>--with-icap[=dir]</parameter> </term> <listitem> <para> @@ -202,7 +202,7 @@ </varlistentry> <varlistentry id="install.configure.with-muscat"> <term> - <parameter>--with-muscat[=DIR]</parameter> + <parameter>--with-muscat[=dir]</parameter> </term> <listitem> <para> @@ -212,7 +212,7 @@ </varlistentry> <varlistentry id="install.configure.with-satellite"> <term> - <parameter>--with-satellite[=DIR]</parameter> + <parameter>--with-satellite[=dir]</parameter> </term> <listitem> <para> @@ -233,7 +233,7 @@ </varlistentry> <varlistentry id="install.configure.with-regex"> <term> - <parameter>--with-regex[=TYPE]</parameter> + <parameter>--with-regex[=type]</parameter> </term> <listitem> <para> @@ -244,7 +244,7 @@ </varlistentry> <varlistentry id="install.configure.with-vpopmail"> <term> - <parameter>--with-vpopmail[=DIR]</parameter> + <parameter>--with-vpopmail[=dir]</parameter> </term> <listitem> <para> @@ -264,7 +264,7 @@ </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> - <parameter>--enable-shared[=PKGS]</parameter> + <parameter>--enable-shared[=pkgs]</parameter> </term> <listitem> <para> @@ -275,7 +275,7 @@ </varlistentry> <varlistentry id="install.configure.enable-static"> <term> - <parameter>--enable-static[=PKGS]</parameter> + <parameter>--enable-static[=pkgs]</parameter> </term> <listitem> <para> @@ -285,7 +285,7 @@ </varlistentry> <varlistentry id="install.configure.enable-fast-install"> <term> - <parameter>--enable-fast-install[=PKGS]</parameter> + <parameter>--enable-fast-install[=pkgs]</parameter> </term> <listitem> <para> @@ -359,7 +359,7 @@ </varlistentry> <varlistentry id="install.configure.with-ismp"> <term> - <parameter>--with-imsp[=DIR]</parameter> + <parameter>--with-imsp[=dir]</parameter> </term> <listitem> <para> @@ -371,7 +371,7 @@ </varlistentry> <varlistentry id="install.configure.with-mck"> <term> - <parameter>--with-mck[=DIR]</parameter> + <parameter>--with-mck[=dir]</parameter> </term> <listitem> <para> @@ -383,7 +383,7 @@ </varlistentry> <varlistentry id="install.configure.with-mod-dav"> <term> - <parameter>--with-mod-dav=DIR</parameter> + <parameter>--with-mod-dav=dir</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.php.xml diff -u phpdoc-fr/chapters/install.configure.php.xml:1.2 phpdoc-fr/chapters/install.configure.php.xml:1.3 --- phpdoc-fr/chapters/install.configure.php.xml:1.2 Mon Apr 28 06:53:25 2003 +++ phpdoc-fr/chapters/install.configure.php.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.php"> <title>Options PHP</title> <variablelist> @@ -16,7 +16,7 @@ </varlistentry> <varlistentry id="install.configure.with-config-file-path"> <term> - <parameter>--with-config-file-path=PATH</parameter> + <parameter>--with-config-file-path=path</parameter> </term> <listitem> <para> @@ -37,7 +37,7 @@ </varlistentry> <varlistentry id="install.configure.with-exec-dir"> <term> - <parameter>--with-exec-dir[=DIR]</parameter> + <parameter>--with-exec-dir[=dir]</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.servers.xml diff -u phpdoc-fr/chapters/install.configure.servers.xml:1.1 phpdoc-fr/chapters/install.configure.servers.xml:1.2 --- phpdoc-fr/chapters/install.configure.servers.xml:1.1 Thu Jan 30 08:44:43 2003 +++ phpdoc-fr/chapters/install.configure.servers.xml Mon May 19 21:57:08 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <sect3 id="install.configure.options.servers"> <title>Options Serveur</title> <variablelist> <varlistentry id="install.configure.with-aolserver"> <term> - <parameter>--with-aolserver=DIR</parameter> + <parameter>--with-aolserver=dir</parameter> </term> <listitem> <para> @@ -15,7 +15,7 @@ </varlistentry> <varlistentry id="install.configure.with-apxs"> <term> - <parameter>--with-apxs[=FILE]</parameter> + <parameter>--with-apxs[=file]</parameter> </term> <listitem> <para> @@ -28,7 +28,7 @@ </varlistentry> <varlistentry id="install.configure.with-apache"> <term> - <parameter>--with-apache[=DIR]</parameter> + <parameter>--with-apache[=dir]</parameter> </term> <listitem> <para> @@ -49,7 +49,7 @@ </varlistentry> <varlistentry id="install.configure.with-apxs2"> <term> - <parameter>--with-apxs2[=FILE]</parameter> + <parameter>--with-apxs2[=file]</parameter> </term> <listitem> <para> @@ -60,7 +60,7 @@ </varlistentry> <varlistentry id="install.configure.with-fhttpd"> <term> - <parameter>--with-fhttpd[=DIR]</parameter> + <parameter>--with-fhttpd[=dir]</parameter> </term> <listitem> <para> @@ -71,7 +71,7 @@ </varlistentry> <varlistentry id="install.configure.with-isapi"> <term> - <parameter>--with-isapi=DIR</parameter> + <parameter>--with-isapi=dir</parameter> </term> <listitem> <para> @@ -81,7 +81,7 @@ </varlistentry> <varlistentry id="install.configure.with-nsapi"> <term> - <parameter>--with-nsapi=DIR</parameter> + <parameter>--with-nsapi=dir</parameter> </term> <listitem> <para> @@ -91,7 +91,7 @@ </varlistentry> <varlistentry id="install.configure.with-phttpd"> <term> - <parameter>--with-phttpd=DIR</parameter> + <parameter>--with-phttpd=dir</parameter> </term> <listitem> <para> @@ -101,7 +101,7 @@ </varlistentry> <varlistentry id="install.configure.with-pi3web"> <term> - <parameter>--with-pi3web=DIR</parameter> + <parameter>--with-pi3web=dir</parameter> </term> <listitem> <para> @@ -111,7 +111,7 @@ </varlistentry> <varlistentry id="install.configure.with-roxen"> <term> - <parameter>--with-roxen=DIR</parameter> + <parameter>--with-roxen=dir</parameter> </term> <listitem> <para> @@ -132,7 +132,7 @@ </varlistentry> <varlistentry id="install.configure.with-servlet"> <term> - <parameter>--with-servlet[=DIR]</parameter> + <parameter>--with-servlet[=dir]</parameter> </term> <listitem> <para> @@ -144,7 +144,7 @@ </varlistentry> <varlistentry id="install.configure.with-thttpd"> <term> - <parameter>--with-thttpd=SRCDIR</parameter> + <parameter>--with-thttpd=srcdir</parameter> </term> <listitem> <para> @@ -154,7 +154,7 @@ </varlistentry> <varlistentry id="install.configure.with-tux"> <term> - <parameter>--with-tux=MODULEDIR</parameter> + <parameter>--with-tux=moduledir</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.windows.xml diff -u phpdoc-fr/chapters/install.windows.xml:1.7 phpdoc-fr/chapters/install.windows.xml:1.8 --- phpdoc-fr/chapters/install.windows.xml:1.7 Sat May 3 15:09:14 2003 +++ phpdoc-fr/chapters/install.windows.xml Mon May 19 21:57:08 2003 @@ -1,26 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <sect1 id="install.windows"> <title>Installation sous Windows</title> <para> Cette section s'applique aux systèmes Windows 98/Me et - Windows NT/2000/XP. Ne vous attendez pas à ce que PHP fonctionne sur + Windows NT/2000/XP. Ne vous attendez pas à ce que &php; fonctionne sur les plateformes 16 bits, comme Windows 3.1. Parfois, on décrira les plateformes supportées sous le nom de Win32. Windows 95 n'est plus - supporté à partir de la version 4.3.0 de PHP. + supporté à partir de la version 4.3.0 de &php;. </para> <para> - Il y a deux méthodes principales pour installer PHP sous Windows : + Il y a deux méthodes principales pour installer &php; sous Windows : soit <link linkend="install.windows.manual">manuellement</link>, soit avec <link linkend="install.windows.installer">InstallShield</link>. </para> <para> Si vous avez Microsoft Visual Studio, vous pouvez aussi <link linkend="install.windows.build">compiler</link> - PHP à partir des sources. + &php; à partir des sources. </para> <para> - Une fois que PHP est installé sur votre Windows, vous pouvez aussi + Une fois que &php; est installé sur votre Windows, vous pouvez aussi ajouter diverses <link linkend="install.windows.extensions">extensions</link>. </para> @@ -28,12 +28,16 @@ <sect2 id="install.windows.installer"> <title>InstallShield sous Windows</title> <para> - L'installeur Windows de PHP disponible depuis les pages de + L'installeur Windows de &php; disponible depuis les pages de <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>, installe la version - CGI de PHP, et configure les serveurs web IIS, PWS, et Xitami. + CGI de &php;, et configure les serveurs web IIS, PWS, et Xitami. + </para> + <para> Notez bien que bien que InstallShield soit une méthode simple - pour installer PHP, il est limité dans son fonctionnement, puisque + pour installer &php;, il est limité dans son fonctionnement, puisque l'installation automatique des extensions n'est pas prise en compte. + Le jeu complet des extensions &php; est disponible en téléchargeant + et décompressant manuellement l'archive. </para> <simpara> Installez votre serveur <acronym>HTTP</acronym> favori sur votre @@ -49,35 +53,31 @@ <simpara> Le wizard d'installation rassemble suffisamment d'informations pour configurer &php.ini; et le serveur web qui utilisera - PHP. Pour IIS, mais aussi PWS sous NT Workstation, une liste de l'arboresence + &php;. Pour IIS, mais aussi PWS sous NT Workstation, une liste de l'arboresence web est affichée, et vous pouvez sélectionner les dossiers - qui utiliseront PHP. + qui utiliseront &php;. </simpara> - - <simpara> Une fois l'installation terminée, l'installeur vous informera que vous devez redémarrer. Suivez ce conseil, ou commencez à - utiliser PHP immédiatement. + utiliser &php; immédiatement. </simpara> <warning> <para> - Gardez bien à l'esprit que cette installation de PHP n'est pas - sécurisée. Si vous voulez avoir une installation sécurisée de PHP, + Gardez bien à l'esprit que cette installation de &php; n'est pas + sécurisée. Si vous voulez avoir une installation sécurisée de &php;, vous devriez commencer par lire la documentation, et choisir toutes vos options avec soin. Cet installeur automatique vous permet de réaliser l'installation en un tour de main, mais n'est pas destinée à l'utilisation sur des serveurs de production. </para> </warning> - - </sect2> - - <sect2 id="install.windows.manual"> - <title>Instructions Générales d'installation</title> - <simpara> + </sect2> + <sect2 id="install.windows.manual"> + <title>Instructions Générales d'installation</title> + <simpara> Ce guide vous permet d'installer et de configurer manuellement - PHP sur vos stations Windows 9x/Me/NT/2000. Vous devrez commencer + &php; sur vos stations Windows 9x/Me/NT/2000. Vous devrez commencer par télécharger la distribution de &php; au format compressé ZIP à <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. La première version de ce @@ -85,137 +85,314 @@ La version originale est disponible (en anglais) à <ulink url="&url.win32install;">&url.win32install;</ulink>. </simpara> - <para> - Ce guide fournit une aide d'installation pour : - <itemizedlist> - <listitem> - <para> - Personal Web Server (Version la plus récente recommandée) - </para> - </listitem> - <listitem> - <para> - Internet Information Server 3 ou 4 - </para> - </listitem> - <listitem> - <para> - Apache 1.3.x - </para> - </listitem> - <listitem> - <para> - Omni HTTPd 2.0b1 et plus récent - </para> - </listitem> - <listitem> - <para> - Oreilly Website Pro - </para> - </listitem> - <listitem> - <para> - Xitami - </para> - </listitem> - <listitem> + <simpara> + Installez votre serveur <acronym>HTTP</acronym> sur votre système, et + assurez vous qu'il fonctionne. + </simpara> + + <simpara> + Exécutez l'installeur et suivez les instructions fournies par l'installeur. + Deux types d'installations sont supportés : <literal>standard</literal>, qui fournit des + valeurs sécuritaires pour la plupart des configurations, et + <literal>advanced</literal>, qui pose plus de questions. + </simpara> + + <simpara> + L'installeur rassemble suffisament d'informations pour créer le fichier + &php.ini; et configurer le serveur web pour qu'il utilise &php;. Pour + IIS et aussi PWS sur NT Workstation, une liste de tous les noeuds du serveur + avec configuration pour les scripts est affichés, et vous pourrez alors choisir + ceux qui vous intéressent, pour leur ajouter &php;. + </simpara> + + <simpara> + Une fois l'installation fine,, l'installeur vous informera que vous devez + redémarrer votre système, le serveur web ou simplement utiliser &php;. + </simpara> + + <warning> + <para> + Attention, cette configuration de &php; n'est pas sécuritaire. Si vous souhaitez + une configuration sûre de &php;, vous devriez passer par la méthoe manuelle, + et choisir vous même toutes les configurations. Cette installation est rapide + et permet d'obtenir rapidement une installation de &php;, mais elle n'est pas + destinée à être utilisée sur des serveurs en ligne. + </para> + </warning> + </sect2> + + + <sect2 id="install.windows.manual"> + <title>Installation manuelle sous Windows</title> + <simpara> + Ce guide d'installation vous aide à installer manuellement et configurer + &php; sur votr serveur web Windows. La version initiale de ce guide a été + compilée par &link.bob;, et est disponible en anglais, à + <ulink url="&url.win32install;">&url.win32install;</ulink>. + Vous devrez télécharger la distribution binaire Zip sur la page + <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. + </simpara> + <para> - Netscape Enterprise Server, iPlanet + &php; 4 pour Windows est distribué en trois versions : éxécutable <acronym>CGI</acronym>, + un exécutable CLI (sapi/php.exe) et d'autres modules SAPI : + <simplelist> + <member> + <filename>php4apache.dll</filename> - module Apache 1.3.x. + </member> + <member> + <filename>php4apache2.dll</filename> - module Apache 2.0.x. + </member> + <member> + <filename>php4isapi.dll</filename> - module ISAPI compatible avec les serveurs + comme IIS 4.0/PWS 4.0 ou plus récent. + </member> + <member> + <filename>php4nsapi.dll</filename> - module Netscape/iPlanet. + </member> + </simplelist> + Cette dernière forme est nouvelle en &php; 4, et fourni des performances + améliorées et de nouvelles fonctionnalités. La version CLI est conçue pour + utiliser &php; en ligne de commande. Plus d'informations sur la forme + CLI est disponible dans le chapitre + "<link linkend="features.commandline">utiliser &php; en ligne de commande</link>". </para> - </listitem> - </itemizedlist> - </para> - <para> - PHP 4 pour Windows est décliné en deux versions : un exécutable - CGI (<filename>php.exe</filename>), et plusieurs modules SAPI - (par exemple php4isapi.dll). Cette dernière forme est nouvelle - pour PHP 4 et founit des performances améliorées ainsi que des - fonctionnalités supplémentaires. - </para> <warning> <simpara> - Les modules SAPI ont été significativement améliorés en version 4.1. - Toutefois, vous pouvez rencontrer des erreurs de serveur ou des - erreurs de modules tels qu'ASP, dans les anciens systèmes. + Les modules SAPI ont été significativement amélioré dans la version + 4.1, mais vous pourrez rencontrer des erreurs avec le serveur ou + d'autres modules (tels ASP), dans les autres systèmes. </simpara> </warning> -<para> - Si vous choisissez l'un des modules SAPI et utilisez Windows 95, - pensez à télécharger la mise à jour DCOM à - <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>. - Pour le module ISAPI, comme un serveur web - compatible est nécessaire (testé avec IIS 4.0, PWS 4.0 et IIS 5.0). - IIS 3.0 <emphasis>n'est pas</emphasis> supporté; vous devez - télécharger et installer le Windows NT 4.0 Option Pack avec IIS 4.0 si - vous voulez le support natif de PHP. - </para> + <note> + <title>Pré-requis DCOM et MDAC</title> + <para> + Si vous choisissez d'installer le module SAPI sur + <emphasis>Windows 95</emphasis>, assurez vous de télécharger et installer + la mise à jour DCOM, disponible à <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>. + Si vous utilisez Microsoft <emphasis>Windows 9x/NT4</emphasis>, téléchargez + la dernière version de Microsoft Data Access Components (MDAC) pour votre + plate-forme. MDAC est disponible à <ulink url="&url.mdac;">&url.mdac;</ulink>. + </para> + </note> <para> Voici les différentes étapes d'installation avant les étapes spécifiques au serveur. - <itemizedlist> - <listitem> - <para> - Extrayez la distribution dans le dossier de votre - choix. <filename>"C:\php\"</filename> est une bonne idée. - </para> - </listitem> - <listitem> - <para> - Vous devez vous assurer que les DLL que PHP utilise sont - disponibles. La liste précise des DLL dépend du serveur - web que vous utilisez, et de la méthode que vous utilisez - pour faire exécuter vos script (CGI ou module). - <filename>php4ts.dll</filename> est toujours nécessaire. - Si vous utilisez PHP en module, (e.g. ISAPI or Apache), vous - aurez besoin de la DLL ad hoc, dans le dossier <filename>sapi</filename>. - Si vous utilisez des extensions PHP, vous aurez besoin des - DLL associées. Pour être certains que les DLL sont accessibles, - vous pouvez les copier dans le dossier système (i.e. - <filename>winnt/system32</filename> ou - <filename>windows/system</filename>) ou vous pouvez vous - assurer qu'elles sont dans le même dossier que l'exécutable - PHP ou les autres DLL de votre serveur web (i.e. php.exe, - ou php4apache.dll). + <itemizedlist> + <listitem> + <simpara> + Extrayez la distribution dans un dossier de votre choix, + comme par exemple <filename>c:\</filename>. L'archive zip devient un + dossier appelé <filename>php-4.3.1-Win32</filename> qui est supposé être + renommé en <filename>php</filename>. Par sourci de clareté, nous supposerons + alors que vous avez placé votre distribution dans le dossier + <filename>c:\php</filename>. Vous pouve choisir un autre dossier, mais vous + serez prudents d'éviter les espaces dans le nom du chemin au dossier + (comme par exemple <filename>c:\program files\php</filename> n'est pas une bonne idée). + car certains serveurs web vont crasher sinon. La structure du dossier que vous + avez extrait ressemble à ceci : + </simpara> + </listitem> + </itemizedlist> + <informalexample> + <programlisting> +<![CDATA[ + +c:\php + | + +--cli + | | + | |-php.exe -- Exécutable CLI - UNIQUEMENT pour la ligne de commande + | + | + +--dlls -- DLL de support des extensions --> dossier système Windows + | | + | |-expat.dll + | | + | |-fdftk.dll + | | + | |-... + | + +--extensions -- extension dlls pour PHP + | | + | |-php_bz2.dll + | | + | |-php_cpdf.dll + | | + | |-.. + | + +--mibs -- fichiers de support de SNMP + | + | + +--openssl -- fichiers de support de Openssl + | + | + +--pdf-related -- fichiers de support de PDF + | + | + +--sapi -- DLL SAPI + | | + | |-php4apache.dll + | | + | |-php4apache2.dll + | | + | |-php4isapi.dll + | | + | |-.. + | + |-install.txt + | + |-.. + | + |-php.exe -- exécutable CGI + | + |-.. + | + |-php.ini-dist + | + |-php.ini-recommended + | + |-php4ts.dll -- DLL principale --> dossier système Windows + | + |-... + + +]]> + </programlisting> + </informalexample> </para> <para> - L'exécutable binaire PHP, les modules SAPI, et certaines extensions - utilisent des DLL externes. Assurez-vous que ces DLL sont dans votre - distribution, et dans un dossier qui est cité dans le - PATH Windows. Le mieux à faire est de copier les fichiers ci-dessous - dans votre dossier système, qui est généralement : + Le binaire CGI "<filename>C:/php/php.exe</filename>", le binaire + CLI (<filename>c:\php\cli\php.exe</filename>), et les modules SAPI + "<filename>c:\php\sapi\*.dll</filename>" dépendent de la DLL principale + <filename>c:\php\php4ts.dll</filename>. Vous devez vous assurer que cette + DLL est disponible pour votre installation &php;. L'ordre des dossiers + lors de la recherche est le suivant : <simplelist> - <member>c:\windows\system pour Windows 9x/Me</member> - <member>c:\winnt\system32 pour Windows NT/2000</member> - </simplelist> - Les fichiers à copier sont : - <simplelist> - <member> - "php4ts.dll", s'il existe, écrasez le - </member> - <member> - 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ù - quelque chose irait de travers). - </member> + <member> + Le dossier d'où <filename>php.exe</filename> est appelé. + Lorsque vous utilisez le module SAPI, c'est le dossier d'où le + serveur web charge la DLL (i.e. <filename>php4apache.dll</filename>). + </member> + <member> + Tout dossier dans la variable d'environnement Windows <varname>PATH</varname>. + </member> </simplelist> + <itemizedlist> + <listitem> + <para> + La meilleure chose à faire est de rendre <filename>php4ts.dll</filename> accessible, + indépendemmant de l'intarface utilisée (CGI ou module SAPI). Pour cela, + vous devez copier la DLL dans un dossier de votre PATH Windows. La meilleure + place est alors le dossier système Windws : + <simplelist> + <member> + <filename>c:\windows\system</filename> pour Windows 9x/ME + </member> + <member> + <filename>c:\winnt\system32</filename> pour Windows NT/2000 ou + <filename>c:\winnt40\system32</filename> pour NT/2000 server + </member> + <member> + <filename>c:\windows\system32</filename> pour Windows XP + </member> + </simplelist> + Si vous voulez utiliser le module SAPI depuis <filename>c:\php\sapi</filename> + et que vous ne voulez pas copier vos DLL dans le dossier système Windows, + vous avez les possibilités de copier simplement <filename>php4ts.dll</filename> + dans le dossier SQPI de votre archive décompressée <filename>c:\php\sapi</filename>. + </para> + </listitem> + <listitem> + <para> + L'étape suivante est de faire un fichier de configuration valide pour &php;, + c'est à dire le fichier &php.ini;. Il y a deux versions de ce fichier disponibles + dans l'archive : + <filename>php.ini-dist</filename> et + <filename>php.ini-recommended</filename>. Nous vous recommandons d'utiliser + <filename>php.ini-recommended</filename>, car nous avons optimisé les + configurations par défaut dans ce fichier pour les performances et la sécurité. + Lisez bien ce fichier documenté, et étudiez toutes les + <link linkend="configuration.file">configurations</link>, puis faites vos + propres choix. Si vous voulez atteindre la meilleure sécurité, c'est + la meilleure méthode. Copiez votre fichier de configuration de choix + dans un dossier où &php; est capable de le lire, et renommez le + &php.ini;. Par défaut, &php; recherche &php.ini; dans votre dossier Windows : + <simplelist> + <member> + Sur Windows 9x/ME/XP, copiez le fichier &php.ini; dans votre dossier + <filename> %WINDIR%</filename>, qui est généralement <filename>c:\windows</filename>. + </member> + <member> + Sur Windows NT/2000, copiez le fichier &php.ini; dans votre dossier + <filename>%WINDIR%</filename> ou <filename>%SYSTEMROOT%</filename>, + qui est typiquement <filename>c:\winnt</filename> ou + <filename>c:\winnt40</filename> pour les serveurs NT/2000. + </member> + </simplelist> + </para> + </listitem> + <listitem> + <simpara> + Si vous utilisez NTFS sur Windows NT, 2000 ou XP, assurez vous que + l'utilisateur qui fait tourner le serveur web a les droits de lecture + de votre fichier &php.ini; (e.g. rendez le lisible par tout le monde). + </simpara> + </listitem> + </itemizedlist> </para> <para> - Téléchargez la dernière version de Microsoft Data Access Components - (MDAC) pour votre plateforme, spécialement si vous utilisez - Microsoft Windows 9x/NT4. MDAC est disponible à - <ulink url="&url.mdac;">&url.mdac;</ulink>. - </para> - </listitem> - <listitem> + Les étapes suivantes sont optionnelles : + <itemizedlist> + <listitem> + <para> + Editez votre nouveau fichier &php.ini;. + Si vous envisagez d'utiliser <link linkend="install.omnihttpd">OmniHTTPd</link>, + ignorez l'étape suivante. Configurez + <link linkend="ini.doc-root">doc_root</link> pour qu'il pointe sur la racine de + votre serveur web. Par exemple : + <informalexample> + <programlisting role="ini"> +<![CDATA[ +doc_root = c:\inetpub // pour IIS/PWS + +doc_root = c:\apache\htdocs // pour Apache +]]> + </programlisting> + </informalexample> + </para> + </listitem> + <listitem> + <simpara> + Choisissez les extensions que vous voulez que &php; démarre. Voyez la + section sur les <link linkend="install.windows.extensions">extensions Windows</link>, + pour les configurer, si elles ne sont pas intégrées. Notez que + sur une nouvelle installation, il est recommandé de commencer par faire fonctionner + &php; avant d'ajouter ou retirer des extenesions via le &php.ini;. + </simpara> + </listitem> + <listitem> + <simpara> + Sur PWS et IIS, vous pouvez utiliser la directive + <link linkend="ini.browscap">browscap</link> pour qu'elle pointe sur : + <filename>c:\windows\system\inetsrv\browscap.ini</filename> sur + Windows 9x/Me, + <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sur + NT/2000, and + <filename>c:\windows\system32\inetsrv\browscap.ini</filename> + sur XP. + </simpara> + </listitem> + </itemizedlist> + </para> <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 + <filename>%WINDOWS</filename> sous Windows 95/98, ou vers votre + dossier <filename>%SYSTEMROOT%</filename> sous Windows NT ou Windows + 2000 et renommez-le en &php.ini;. Votre dossier + <filename>%WINDOWS%</filename> ou <filename>%SYSTEMROOT%</filename> + 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> @@ -235,99 +412,63 @@ pourrez le faire, même si PHP fonctionne parfaitement avec les configurations par défaut. </para> - </listitem> - <listitem> <para> Editez votre fichier &php.ini; : <itemizedlist> <listitem> <simpara> - Vous devez changer votre option 'extension_dir' pour qu'il - pointe sur votre dossier d'installation PHP, ou vers l'endroit - où vous avez installé vos 'php_*.dll'. ex: c:\php\extensions - </simpara> + la famille <link linkend="install.iis">des serveurs Windows</link>, + Personal Web server (PWS) 3 et 4 ou plus récent; + Internet Information Server (IIS) 3 et 4 ou plus récent. + </simpara> </listitem> <listitem> <simpara> - Si vous utilisez Omni Httpd, sautez l'étape suivante. - Modifiez 'doc_root' pour qu'il pointe sur votre - racine de serveur web. ex: <filename>c:\apache\htdocs</filename> - ou <filename>c:\webroot</filename>. + les serveurs Apache + <link linkend="install.apache.windows">Apache 1.3.x</link>, et + <link linkend="install.apache2.windows">Apache 2.x</link>. </simpara> </listitem> + <listitem> <simpara> - Choisissez les modules que vous voulez charger lorsque - PHP démarre. Voyez la - section sur les - <link linkend="install.windows.extensions">extensions Windows</link>, - pour savoir comment les installer et quelles sont celles qui sont - déjà inclues. Notez aussi qu'il est préférable de commencer - par faire fonctionner &php; sur une nouvelle installation avant - d'activer des extensions supplémentaires avec &php.ini;. + les serveurs + <link linkend="install.netscape.windows">Netscape/iPlanet</link>. </simpara> </listitem> - <listitem> - <simpara> - Sous PWS et IIS, vous pouvez configurer le fichier - <filename>browscap.ini</filename> pour qu'il pointe sur - <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous Windows 9x/Me, - <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sous NT/2000 et - <filename>c:\windows\system32\inetsrv\browscap.ini</filename> sous XP. - </simpara> - </listitem> + <listitem> <simpara> - Notez que le dossier <filename>mibs</filename> fourni avec - la distribution Windows, contient des fichiers de support - du protocole SNMP. Ce dpssier doit être déplacé dans le dossier - <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> - est le périphérique où PHP est installé.) - </simpara> + le serveur <link linkend="install.omnihttpd">OmniHTTPd</link>. + </simpara> </listitem> - <listitem> - <simpara> - Si vous n'utilisez pas NTFS sous Windows NT, 2000 et XP, assurez-vous - que l'utilisateur qui fait tourner le serveur web a bien les - permission pour accéder à votre &php.ini;. - </simpara> - </listitem> - </itemizedlist> - </para> + + <listitem> + <simpara> + le serveur <link linkend="install.oreilly">Oreilly Website Pro</link>. + </simpara> </listitem> + <listitem> - <para> - Avec PWS, donnez les droits d'exécution au webmestre : - <itemizedlist> - <listitem> - <simpara> - Démarrez le PWS Web Manager - </simpara> - </listitem> - <listitem> - <simpara> - Editez les Properties du dossier "Home" - </simpara> - </listitem> - <listitem> - <simpara> - Sélectionnez la coche "execute" - </simpara> - </listitem> - </itemizedlist> - </para> + <simpara> + le serveur <link linkend="install.sambar">Sambar</link>. + </simpara> </listitem> - + <listitem> + <simpara> + le serveur <link linkend="install.xitami">Xitami</link>. + </simpara> + </listitem> </itemizedlist> - </para> + </para> </sect2> <sect2 id="install.windows.build"> <title>Compilation des sources</title> <para> Avant de commencer, il est bon de se poser la question suivante : - "Pourquoi la compilation de PHP sous Windows est si difficile?". + "Pourquoi la compilation de &php; sous Windows est si difficile?". Deux raisons viennent immédiatement à l'esprit : </para> <orderedlist> @@ -389,7 +530,7 @@ </listitem> </itemizedlist> <simpara> - Finalement, vous aurez besoin des sources PHP 4 elles-mêmes!! + Finalement, vous aurez besoin des sources &php; 4 elles-mêmes!! Les dernières versions sont accessibles sur le serveur CVS <ulink url="&url.php.anoncvs;">anonyme</ulink>. Si vous téléchargez une version @@ -627,7 +768,7 @@ <sect2 id="install.windows.extensions"> <title>Installation des extensions sous Windows</title> <para> - Après avoir installé PHP et votre serveur web sous Windows, + Après avoir installé &php; et votre serveur web sous Windows, vous voudrez sûrement ajouter quelques extensions bien pratiques. La table suivante liste une partie des extensions disponibles. Comme indiqué dans le manuel, vous pouvez choisir quelles @@ -637,23 +778,63 @@ <function>dl</function>. </para> <para> - Les fichiers DLLs des extensions PHP sont préfixés - par 'php_' en PHP 4, et 'php3_' en PHP 3. Cela évite la confusion - des extensions PHP et de leurs librairies. + Les fichiers DLLs des extensions &php; sont préfixés + par <literal>php_</literal> en &php; 4, et <literal>php3_</literal> en &php; 3. + Cela évite la confusion des extensions &php; et de leurs librairies. </para> <note> <para> - En PHP 4.0.6 le support des extensions BCMath, Calendar, COM, FTP, MySQL, ODBC, PCRE, - Session, WDDX et XML est activé <emphasis>par défaut</emphasis>. - Vous n'avez pas à charger d'extensions particulière pour utiliser - ces fonctions. Lisez le fichier <filename>README.txt</filename> inclus - dans la distribution, ou bien <filename>install.txt</filename> pour - connaitre la liste des modules automatiquement activés. + En &php; 4.3.1, les extensions BCMath, Calendar, COM, Ctype, FTP, MySQL, ODBC, Overload, + PCRE, Session, Tokenizer, WDDX, XML et Zlib sont + <emphasis>intégrée</emphasis>. Vous n'avez pas besoin d'ajouter d'autres + extensions pour pouvoir utiliser ces fonctions. Voyez le fichier + <filename>README.txt</filename> ou <filename>install.txt</filename> + de votre distribution, ou bien + <link linkend="install.extensions.overview">cette table</link> + pour une liste des modules intégrés. </para> </note> - <note> - <para> + <para> + Editez votre fichier &php.ini; : + <itemizedlist> + <listitem> + <para> + Vous devez modifier l'option de + <link linkend="ini.extension-dir">extension_dir</link> pour qu'elle pointe + sur le dossier qui contient les extensions, là où vous avez placé vos + fichiers <filename>php_*.dll</filename>. N'oubliez surtout pas l'anti-slash + final. Par exemple : + <informalexample> + <programlisting role="ini"> +<![CDATA[ +extension_dir = c:/php/extensions/ +]]> + </programlisting> + </informalexample> + </para> + </listitem> + <listitem> + <para> + Pour activer les extensions dans le &php.ini;, il suffit de décommenter + les lignes <literal>extension=php_*.dll</literal> dans le &php.ini;. Ceci est fait + en effaçant le point-virgule initial de la ligne : + <example> + <title>Activer l'extension <link linkend="ref.bzip2">Bzip2</link> sous Windows</title> + <programlisting role="ini"> +<![CDATA[ +// changez la ligne ... +;extension=php_bz2.dll + +// ... en +extension=php_bz2.dll +]]> + </programlisting> + </example> + </para> + </listitem> + <listitem> + <para> Certaines de ces extensions requièrent des librairies DLL supplémentaires pour fonctionner correctement. Certaines d'entre elles sont disponibles dans la distribution. dans le dossier <filename>dlls</filename> mais @@ -668,15 +849,18 @@ <member>c:\winnt\system32 pour Windows NT/2000</member> <member>c:\windows\system32 pour Windows XP</member> </simplelist> - Si vous les avez déjà d'installées sur votre système, ne les écrasez - que si PHP ne fonctionne pas correctement (et de toutes manières, faites - une sauvegarde de ces DLL, en cas de problème). - </para> - </note> + Si vous les avez déjà d'installées sur votre système, + ne les écrasez que si &php; ne fonctionne pas correctement + (et de toutes manières, faites une sauvegarde de ces DLL, + en cas de problème). + </para> + </listitem> + </itemizedlist> + </para> <para> - <table> - <title>PHP Extensions</title> + <table id="install.extensions.overview"> + <title>Extensions &php; pour Windows</title> <tgroup cols="3"> <thead> <row> @@ -695,7 +879,7 @@ <row> <entry>php_calendar.dll</entry> <entry>Fonctions de conversions calendaires <link linkend="ref.calendar">Calendar</link></entry> - <entry>Disponible depuis PHP 4.0.3</entry> + <entry>Disponible depuis &php; 4.0.3</entry> </row> <row> <entry>php_cpdf.dll</entry> @@ -720,7 +904,8 @@ <row> <entry>php_curl.dll</entry> <entry><link linkend="ref.curl">CURL</link>, Client URL library functions</entry> - <entry>Requiert : libeay32.dll, ssleay32.dll (fournies)</entry> + <entry>Requiert : <filename>libeay32.dll</filename>, + <filename>ssleay32.dll</filename> (fournies)</entry> </row> <row> <entry>php_cybercash.dll</entry> @@ -730,7 +915,8 @@ <row> <entry>php_db.dll</entry> <entry>Fonctions <link linkend="ref.dbm">DBM</link></entry> - <entry>Obsolètes. Utilisez DBA à la place (php_dba.dll)</entry> + <entry>Obsolètes. Utilisez DBA à la place (<filename>php_dba.dll</filename>) + </entry> </row> <row> <entry>php_dba.dll</entry> @@ -748,9 +934,14 @@ <entry>Inconnu</entry> </row> <row> + <entry>php_dbx.dll</entry> + <entry>Fonctions <link linkend="ref.dbx">dbx</link></entry> + <entry></entry> + </row> + <row> <entry>php_domxml.dll</entry> <entry>Fonctions de <link linkend="ref.domxml">DOM XML</link></entry> - <entry>Requiert : libxml2.dll (fournie)</entry> + <entry>Requiert : <filename>libxml2.dll</filename> (fournie)</entry> </row> <row> <entry>php_dotnet.dll</entry> @@ -770,7 +961,7 @@ <row> <entry>php_fdf.dll</entry> <entry>Fonctions <link linkend="ref.fdf">FDF</link>: Forms Data Format.</entry> - <entry>Requiert : fdftk.dll (fournies)</entry> + <entry>Requiert : <filename>fdftk.dll</filename> (fournies)</entry> </row> <row> <entry>php_filepro.dll</entry> @@ -780,7 +971,7 @@ <row> <entry>php_ftp.dll</entry> <entry>Fonctions <link linkend="ref.ftp">FTP</link></entry> - <entry>Disponible depuis PHP 4.0.3</entry> + <entry>Disponible depuis &php; 4.0.3</entry> </row> <row> <entry>php_gd.dll</entry> @@ -788,9 +979,15 @@ <entry>Aucune</entry> </row> <row> + <entry>php_gd2.dll</entry> + <entry>Fonctions de traitement des images <link linkend="ref.image">GD2</link></entry> + <entry>None</entry> + </row> + <row> <entry>php_gettext.dll</entry> <entry>Fonctions <link linkend="ref.gettext">Gettext</link></entry> - <entry>Requiert : gnu_gettext.dll (fournies)</entry> + <entry>&php; <= 4.2.0 requiert : <filename>gnu_gettext.dll</filename> (fournie), + &php; >= 4.2.3 requiert <filename>libintl-1.dll</filename> (fournie).</entry> </row> <row> <entry>php_hyperwave.dll</entry> @@ -800,7 +997,7 @@ <row> <entry>php_iconv.dll</entry> <entry>Fonctions de conversions de jeux de caractères <link linkend="ref.iconv">ICONV</link></entry> - <entry>Requiert : iconv-1.3.dll (fournies)</entry> + <entry>Requiert : <filename>iconv-1.3.dll</filename> (fournies)</entry> </row> <row> <entry>php_ifx.dll</entry> @@ -815,27 +1012,39 @@ <row> <entry>php_imap.dll</entry> <entry>Fonctions <link linkend="ref.imap">IMAP</link>, POP3 et NNTP</entry> - <entry>PHP 3: php3_imap4r1.dll</entry> + <entry>&php; 3 : <filename>php3_imap4r1.dll</filename></entry> </row> <row> <entry>php_ingres.dll</entry> <entry>Fonctions <link linkend="ref.ingres">Ingres II</link></entry> - <entry>Requiert : Ingres II libraries</entry> + <entry>Requiert : librairies Ingres II</entry> </row> <row> <entry>php_interbase.dll</entry> <entry>Fonctions <link linkend="ref.ibase">InterBase</link></entry> - <entry>Requiert : gds32.dll (fournies)</entry> + <entry>Requiert : <filename>gds32.dll</filename> (fournies)</entry> </row> <row> <entry>php_java.dll</entry> <entry>Extension <link linkend="ref.java">Java</link></entry> - <entry>Requiert : jvm.dll (fournies)</entry> + <entry>Requiert : <filename>jvm.dll</filename> (fournies)</entry> </row> <row> <entry>php_ldap.dll</entry> <entry>Fonctions <link linkend="ref.ldap">LDAP</link></entry> - <entry>Requiert : libsasl.dll (fournies)</entry> + <entry>PHP <= 4.2.0 requiert <filename>libsasl.dll</filename> (fournie), + PHP >= 4.3.0 requiert <filename>libeay32.dll</filename>, + <filename>ssleay32.dll</filename> (fournies).</entry> + </row> + <row> + <entry>php_mbstring.dll</entry> + <entry>Fonctions <link linkend="ref.mbstring">chaînes multi-octets</link></entry> + <entry>Aucune</entry> + </row> + <row> + <entry>php_mcrypt.dll</entry> + <entry><link linkend="ref.mcrypt">Mcrypt Encryption</link> functions</entry> + <entry>Requiert : <filename>libmcrypt.dll</filename></entry> </row> <row> <entry>php_mhash.dll</entry> @@ -843,6 +1052,11 @@ <entry>Aucune</entry> </row> <row> + <entry>php_mime_magic.dll</entry> + <entry><link linkend="ref.mime-magic">Mimetype</link> functions</entry> + <entry>Requiert : <filename>magic.mime</filename> (fournie)</entry> + </row> + <row> <entry>php_ming.dll</entry> <entry>Fonctions de générations de fichiers Flash avec <link linkend="ref.ming">Ming</link></entry> <entry>Aucune</entry> @@ -850,7 +1064,7 @@ <row> <entry>php_msql.dll</entry> <entry>Fonctions de <link linkend="ref.msql">mSQL</link></entry> - <entry>Requiert : msql.dll (fournies)</entry> + <entry>Requiert : <filename>msql.dll</filename> (fournies)</entry> </row> <row> <entry>php3_msql1.dll</entry> @@ -865,12 +1079,12 @@ <row> <entry>php_mssql.dll</entry> <entry>Fonctions <link linkend="ref.mssql">MSSQL</link></entry> - <entry>Requiert : ntwdblib.dll (fournies)</entry> + <entry>Requiert : <filename>ntwdblib.dll</filename> (fournies)</entry> </row> <row> <entry>php3_mysql.dll</entry> <entry>Fonctions <link linkend="ref.mysql">MySQL</link></entry> - <entry>Built-in in PHP 4</entry> + <entry>Intégré à &php; 4</entry> </row> <row> <entry>php3_nsmail.dll</entry> @@ -890,7 +1104,7 @@ <row> <entry>php_openssl.dll</entry> <entry>Fonctions <link linkend="ref.openssl">OpenSSL</link></entry> - <entry>Requiert : libeay32.dll (fournies)</entry> + <entry>Requiert : <filename>libeay32.dll</filename> (fournies)</entry> </row> <row> <entry>php_oracle.dll</entry> @@ -898,6 +1112,11 @@ <entry>Requiert : librairies clientes Oracle 7</entry> </row> <row> + <entry>php_overload.dll</entry> + <entry><link linkend="ref.overload">Object overloading</link> functions</entry> + <entry>Intégrée depuis &php; 4.3.0</entry> + </row> + <row> <entry>php_pdf.dll</entry> <entry>Fonctions de <link linkend="ref.pdf">PDF</link></entry> <entry>Aucune</entry> @@ -913,14 +1132,19 @@ <entry>Aucune</entry> </row> <row> - <entry>php_xslt.dll</entry> - <entry>Fonctions <link linkend="ref.xslt">XSLT</link></entry> - <entry>Requiert : sablot.dll (fournies)</entry> + <entry>php_shmop.dll</entry> + <entry>Fonctions de <link linkend="ref.shmop">mémoire partagée</link></entry> + <entry>Aucune</entry> </row> <row> <entry>php_snmp.dll</entry> <entry>Fonctions <link linkend="ref.snmp">SNMP</link></entry> - <entry>NT only!</entry> + <entry>NT uniquement!</entry> + </row> + <row> + <entry>php_sockets.dll</entry> + <entry>Fonctions de <link linkend="ref.sockets">socket</link></entry> + <entry>Aucune</entry> </row> <row> <entry>php_sybase_ct.dll</entry> @@ -928,9 +1152,34 @@ <entry>Requiert : librairies clientes Sybase</entry> </row> <row> + <entry>php_tokenizer.dll</entry> + <entry><link linkend="ref.tokenizer">Tokenizer</link></entry> + <entry>Intégrée depuis &php; 4.3.0</entry> + </row> + <row> + <entry>php_w32api.dll</entry> + <entry>Fonctions <link linkend="ref.w32api">W32api</link></entry> + <entry>Aucune</entry> + </row> + <row> + <entry>php_xmlrpc.dll</entry> + <entry>Fonctions <link linkend="ref.xmlrpc">XML-RPC</link></entry> + <entry>&php; >= 4.2.1 requiert <filename>iconv.dll</filename> (fournie)</entry> + </row> + <row> + <entry>php_xslt.dll</entry> + <entry>Fonctions <link linkend="ref.xslt">XSLT</link></entry> + <entry>Requiert : <filename>sablot.dll</filename>, <filename>expat.dll</filename> (fournies)</entry> + </row> + <row> <entry>php_yaz.dll</entry> <entry>Fonctions <link linkend="ref.yaz">YAZ</link></entry> <entry>Aucune</entry> + </row> + <row> + <entry>php_zib.dll</entry> + <entry>Fonctions de compression <link linkend="ref.zip">Zip</link></entry> + <entry>Accès en lecture seule</entry> </row> <row> <entry>php_zlib.dll</entry> Index: phpdoc-fr/chapters/security.xml diff -u phpdoc-fr/chapters/security.xml:1.22 phpdoc-fr/chapters/security.xml:1.23 --- phpdoc-fr/chapters/security.xml:1.22 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/security.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> +<!-- $Revision: 1.23 $ --> <chapter id="security"> <title>Sécurité</title> <simpara> @@ -1222,7 +1222,7 @@ <para> Une autre astuce est de configurer le serveur web, comme Apache, pour qu'il utilise plusieurs types de fichiers différents avec PHP, - soit localement avec le fichier <filename>.htaccess</filename>, soit + soit localement avec le fichier &htaccess;, soit dans le fichier de configuration lui-même. Vous pouvez utiliser des informations déroutantes comme ceci : <example> Index: phpdoc-fr/chapters/streams.constants.xml diff -u phpdoc-fr/chapters/streams.constants.xml:1.2 phpdoc-fr/chapters/streams.constants.xml:1.3 --- phpdoc-fr/chapters/streams.constants.xml:1.2 Mon Apr 28 06:53:25 2003 +++ phpdoc-fr/chapters/streams.constants.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- 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 @@ -12,7 +12,7 @@ <refentry id="streams.options"> <refnamediv> - <refname>Options d'ouverture de flôt</refname> + <refname>options d'ouverture de flôt</refname> <refpurpose>Affectent les fonctions de flôt</refpurpose> </refnamediv> <refsect1> Index: phpdoc-fr/chapters/streams.structs.xml diff -u phpdoc-fr/chapters/streams.structs.xml:1.1 phpdoc-fr/chapters/streams.structs.xml:1.2 --- phpdoc-fr/chapters/streams.structs.xml:1.1 Thu Jan 30 08:44:44 2003 +++ phpdoc-fr/chapters/streams.structs.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- 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 @@ -13,7 +13,7 @@ <refentry id="streams.struct-php-stream-statbuf"> <refnamediv> <refname>struct php_stream_statbuf</refname> - <refpurpose>Contient des information sur le fichier ou l'URL</refpurpose> + <refpurpose>Conserve des information sur le fichier ou l'URL</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -31,7 +31,7 @@ <refentry id="streams.struct-php-stream-dirent"> <refnamediv> <refname>struct php_stream_dirent</refname> - <refpurpose>Contient des informations sur un fichier durant une analyse de dossier</refpurpose> + <refpurpose>Conserve des informations sur un fichier durant une analyse de dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -70,6 +70,105 @@ int (*cast)(php_stream *stream, int castas, void **ret TSRMLS_DC); int (*stat)(php_stream *stream, php_stream_statbuf *ssb TSRMLS_DC); } php_stream_ops; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-wrapper"> + <refnamediv> + <refname>struct php_stream_wrapper</refname> + <refpurpose>Conserve les proprits et pointeur d'un gestionnaire de flt</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + struct _php_stream_wrapper { + php_stream_wrapper_ops *wops; /* operations the wrapper can perform */ + void *abstract; /* context for the wrapper */ + int is_url; /* so that PG(allow_url_fopen) can be respected */ + + /* support for wrappers to return (multiple) error messages to the stream opener */ + int err_count; + char **err_stack; + } php_stream_wrapper; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-wrapper-ops"> + <refnamediv> + <refname>struct php_stream_wrapper_ops</refname> + <refpurpose>Conserve les fonctions d'un gestionnaire de flt</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + typedef struct _php_stream_wrapper_ops { + /* open/create a wrapped stream */ + php_stream *(*stream_opener)(php_stream_wrapper *wrapper, char *filename, char *mode, + int options, char **opened_path, php_stream_context *context STREAMS_DC TSRMLS_DC); + /* close/destroy a wrapped stream */ + int (*stream_closer)(php_stream_wrapper *wrapper, php_stream *stream TSRMLS_DC); + /* stat a wrapped stream */ + int (*stream_stat)(php_stream_wrapper *wrapper, php_stream *stream, php_stream_statbuf *ssb TSR$ + /* stat a URL */ + int (*url_stat)(php_stream_wrapper *wrapper, char *url, php_stream_statbuf *ssb TSRMLS_DC); + /* open a "directory" stream */ + php_stream *(*dir_opener)(php_stream_wrapper *wrapper, char *filename, char *mode, + int options, char **opened_path, php_stream_context *context STREAMS_DC TSRMLS_DC); + + const char *label; + + /* Delete/Unlink a file */ + int (*unlink)(php_stream_wrapper *wrapper, char *url, int options, php_stream_context *context TSRMLS_DC); + } php_stream_wrapper_ops; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-filter"> + <refnamediv> + <refname>struct php_stream_filter</refname> + <refpurpose>Conserve les proprits et le pointeur de filtre</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + struct _php_stream_filter { + php_stream_filter_ops *fops; + void *abstract; /* for use by filter implementation */ + php_stream_filter *next; + php_stream_filter *prev; + int is_persistent; + + /* link into stream and chain */ + php_stream_filter_chain *chain; + + /* buffered buckets */ + php_stream_bucket_brigade buffer; + } php_stream_filter; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-filter-ops"> + <refnamediv> + <refname>struct php_stream_filter_ops</refname> + <refpurpose>Conserver les fonctions membres pour un filtre de flt</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + typedef struct _php_stream_filter_ops { + php_stream_filter_status_t (*filter)( + php_stream *stream, + php_stream_filter *thisfilter, + php_stream_bucket_brigade *buckets_in, + php_stream_bucket_brigade *buckets_out, + size_t *bytes_consumed, + int flags + TSRMLS_DC); + + void (*dtor)(php_stream_filter *thisfilter TSRMLS_DC); + + const char *label; +} php_stream_filter_ops; </programlisting> </refsect1> </refentry> Index: phpdoc-fr/chapters/tutorial.xml diff -u phpdoc-fr/chapters/tutorial.xml:1.7 phpdoc-fr/chapters/tutorial.xml:1.8 --- phpdoc-fr/chapters/tutorial.xml:1.7 Tue Feb 18 04:38:54 2003 +++ phpdoc-fr/chapters/tutorial.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <chapter id="tutorial"> <title>Une introduction à PHP</title> @@ -74,8 +74,19 @@ </html> ]]> </programlisting> + <simpara> + Utilisez votre navigateur pour accéder au fichier via votre serveur web, + en ajoutant le nom de fichier "/bonjour.php". Si vous développez localement, + votre URL ressemblera à <literal>http://localhost/bonjour.php</literal> + ou encore <literal>http://127.0.0.1/hello.php</literal> mais cela dépend + de la configuration de votre serveur web. Bien que cela soit hors du contexte + de ce tutoriel, étudiez <varname>DocumentRoot</varname> et + <varname>ServerName</varname> dans le fichier de configuration de votre + serveur web (sous Apache, c'est &httpd.conf;). + Si ceci est configuré correctement, le fichier sera analysé par &php; et + le résultat suivant sera affiché : + </simpara> <para> - Le résultat de ce script sera : <screen role="html"> <![CDATA[ <html>
Index: phpdoc-fr/chapters/config.xml diff -u phpdoc-fr/chapters/config.xml:1.24 phpdoc-fr/chapters/config.xml:1.25 --- phpdoc-fr/chapters/config.xml:1.24 Sat May 3 15:09:14 2003 +++ phpdoc-fr/chapters/config.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.24 $ --> +<!-- $Revision: 1.25 $ --> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> @@ -69,7 +69,7 @@ Lorsque vous utilisez le module Apache, vous pouvez aussi changer les paramètres de configuration en utilisant les directives dans les fichiers de configuration d'Apache et dans les fichiers - <filename>.htaccess</filename>. + &htaccess;. </simpara> <simpara> Dans la version 3.0, à chaque directive de configuration @@ -131,10 +131,10 @@ <para> Cette instruction affecte une valeur à la variable spécifiée. - Cette instruction NE peux PAS être utilisée dans un fichier <filename>.htaccess</filename>. + Cette instruction NE peux PAS être utilisée dans un fichier &htaccess;. 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>. + modifiée en utilisant le fichier &htaccess;. <informalexample> <programlisting role="ini"> <![CDATA[ @@ -155,10 +155,10 @@ <para> Cette directive est utilisée pour activer ou désactiver l'option précédente. - Cette instruction NE peux PAS être utilisée dans un fichier <filename>.htaccess</filename>. + Cette instruction NE peux PAS être utilisée dans un fichier &htaccess;. Toute directive 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>. + modifiée en utilisant le fichier &htaccess;. </para> </listitem> </varlistentry> @@ -183,7 +183,7 @@ <note> <para> Les constantes &php; n'existent pas en dehors de &php;. Par - exemple, dans le fichier <filename>httpd.conf</filename>, + exemple, dans le fichier &httpd.conf;, vous ne pouvez pas utiliser des constantes &php; telles que <constant>E_ALL</constant> ou <constant>E_NOTICE</constant> pour fixer le niveau de <link linkend="ini.error-reporting">rapport d'erreur</link>, @@ -227,8 +227,8 @@ <entry>2</entry> <entry> La directive peut être configurée dans le fichier &php.ini;, le - fichier <filename>.htaccess</filename> ou encore dans le fichier - <filename>httpd.conf</filename> + fichier &htaccess; ou encore dans le fichier + &httpd.conf; </entry> </row> <row> @@ -236,7 +236,7 @@ <entry>4</entry> <entry> La directive peut être configurée dans le fichier &php.ini; ou - dans <filename>httpd.conf</filename> + dans &httpd.conf; </entry> </row> <row> @@ -698,9 +698,9 @@ <para> Notez que <systemitem role="directive">register_globals</systemitem> ne peut être modifiée durant l'exécution du script (avec <function>ini_set</function>). - Cependant, vous pouvez utiliser le fichier <filename>.htaccess</filename> si + Cependant, vous pouvez utiliser le fichier &htaccess; si votre hôte les supporte, comme décrit ci-dessus. Par exemple, vous pouvez - inscrire dans votre fichier <filename>.htaccess</filename> : + inscrire dans votre fichier &htaccess; : <userinput>php_flag register_globals on</userinput>. </para> <note> Index: phpdoc-fr/chapters/install.apache.xml diff -u phpdoc-fr/chapters/install.apache.xml:1.3 phpdoc-fr/chapters/install.apache.xml:1.4 --- phpdoc-fr/chapters/install.apache.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.apache.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect1 id="install.apache"> <title>Installation avec le serveur Apache</title> <para> @@ -15,7 +15,7 @@ sous Windows. L'une passe par les CGI (php.exe), l'autre est d'utiliser la DLL de module d'apache. Dans les deux cas, vous devrez arrêter le serveur Apache, et éditer le fichier - <filename>srm.conf</filename> ou <filename>httpd.conf</filename>, + <filename>srm.conf</filename> ou &httpd.conf;, pour configurer Apache avec PHP. </simpara> <para> @@ -107,7 +107,7 @@ <para> Cette commande va créer une librairie partagée <filename>libphp4.so</filename> qui sera chargée par Apache avec - une ligne LoadModule dans le fichier <filename>httpd.conf</filename>. + une ligne LoadModule dans le fichier &httpd.conf;. Le support PostgreSQL est aussi inclut dans <filename>libphp4.so</filename>. </para> <para> @@ -307,7 +307,7 @@ You may find after using the windows installer for Apache that you need to define the <literal>AddModule</literal> directive for <filename>mod_php4.c</filename> in the - configuration file (<filename>httpd.conf</filename>). + configuration file (&httpd.conf;). This is done by adding <literal>AddModule mod_php4.c</literal> to the <literal>AddModule</literal> list, near the beginning of the configuration file. This is especially important if Index: phpdoc-fr/chapters/install.apache2.xml diff -u phpdoc-fr/chapters/install.apache2.xml:1.3 phpdoc-fr/chapters/install.apache2.xml:1.4 --- phpdoc-fr/chapters/install.apache2.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.apache2.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect1 id="install.apache2"> <title>Installation avec les serveurs Apache 2.0</title> <para> @@ -180,11 +180,11 @@ Il y a deux méthodes pour que &php; fonctionne avec Apache 2.0 sous Windows. La première est l'interface CGI, et l'autre est le module DLL APache. Dans les deux cas, commencez par stopper le serveur - Apache, et éditez le fichier <filename>httpd.conf</filename> pour configurer + Apache, et éditez le fichier &httpd.conf; pour configurer Apache avec le support &php;. </para> <para> - Vous devez insérer les lignes suivantes dans le fichier <filename>httpd.conf</filename> + Vous devez insérer les lignes suivantes dans le fichier &httpd.conf; pour réaliser la configuration en mode <emphasis>CGI</emphasis>: <example> <title>Configurer la version de développement de PHP avec Apache 2.0 en CGI</title> @@ -209,7 +209,7 @@ placez bien le fichier <filename>php4ts.dll</filename> dans votre dossier <filename>winnt/system32</filename>, en y écrasant tout autre fichier qui s'y trouverait. Puis vous devrez insérer les deux lignes suivantes - dans votre fichier de configuration d'Apache <filename>httpd.conf</filename> + dans votre fichier de configuration d'Apache &httpd.conf; pour y ajouter le module PHP d'Apache 2.0 : <example> <title>Configurer PHP avec Apache 2.0 en module</title> Index: phpdoc-fr/chapters/install.configure.databases.xml diff -u phpdoc-fr/chapters/install.configure.databases.xml:1.2 phpdoc-fr/chapters/install.configure.databases.xml:1.3 --- phpdoc-fr/chapters/install.configure.databases.xml:1.2 Wed Feb 19 07:41:35 2003 +++ phpdoc-fr/chapters/install.configure.databases.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.databases"> <title>Options bases de données</title> <variablelist> @@ -15,7 +15,7 @@ </varlistentry> <varlistentry id="install.configure.with-adabas"> <term> - <parameter>--with-adabas[=DIR]</parameter> + <parameter>--with-adabas[=dir]</parameter> </term> <listitem> <para> @@ -26,7 +26,7 @@ </varlistentry> <varlistentry id="install.configure.with-sapdb"> <term> - <parameter>--with-sapdb[=DIR]</parameter> + <parameter>--with-sapdb[=dir]</parameter> </term> <listitem> <para> @@ -37,7 +37,7 @@ </varlistentry> <varlistentry id="install.configure.with-solid"> <term> - <parameter>--with-solid[=DIR]</parameter> + <parameter>--with-solid[=dir]</parameter> </term> <listitem> <para> @@ -48,7 +48,7 @@ </varlistentry> <varlistentry id="install.configure.with-ibm-db2"> <term> - <parameter>--with-ibm-db2[=DIR]</parameter> + <parameter>--with-ibm-db2[=dir]</parameter> </term> <listitem> <para> @@ -59,7 +59,7 @@ </varlistentry> <varlistentry id="install.configure.with-empress"> <term> - <parameter>--with-empress[=DIR]</parameter> + <parameter>--with-empress[=dir]</parameter> </term> <listitem> <para> @@ -71,7 +71,7 @@ </varlistentry> <varlistentry id="install.configure.with-empress-bcs"> <term> - <parameter>--with-empress-bcs[=DIR]</parameter> + <parameter>--with-empress-bcs[=dir]</parameter> </term> <listitem> <para> @@ -83,7 +83,7 @@ </varlistentry> <varlistentry id="install.configure.with-birdstep"> <term> - <parameter>--with-birdstep[=DIR]</parameter> + <parameter>--with-birdstep[=dir]</parameter> </term> <listitem> <para> @@ -92,9 +92,22 @@ </para> </listitem> </varlistentry> + <varlistentry id="install.configure.with-mysql"> + <term> + <parameter>--with-mysql[=dir]</parameter> + </term> + <listitem> + <para> + Inclut le support MySQL. DIR est le dossier d'installation de MySQL, + et par défaut il pointe sur la librairie MySQL fournie avec la distribution + de &php;. Le support MySQL est activé par défaut. Pour le désactiver, + il faut utiliser l'option <parameter>--without-mysql</parameter>. + </para> + </listitem> + </varlistentry> <varlistentry id="install.configure.with-custom-odbc"> <term> - <parameter>--with-custom-odbc[=DIR]</parameter> + <parameter>--with-custom-odbc[=dir]</parameter> </term> <listitem> <para> @@ -113,7 +126,7 @@ </varlistentry> <varlistentry id="install.configure.with-iodbc"> <term> - <parameter>--with-iodbc[=DIR]</parameter> + <parameter>--with-iodbc[=dir]</parameter> </term> <listitem> <para> @@ -124,7 +137,7 @@ </varlistentry> <varlistentry id="install.configure.with-esoob"> <term> - <parameter>--with-esoob[=DIR]</parameter> + <parameter>--with-esoob[=dir]</parameter> </term> <listitem> <para> @@ -135,7 +148,7 @@ </varlistentry> <varlistentry id="install.configure.with-unixODBC"> <term> - <parameter>--with-unixODBC[=DIR]</parameter> + <parameter>--with-unixodbc[=dir]</parameter> </term> <listitem> <para> @@ -146,7 +159,7 @@ </varlistentry> <varlistentry id="install.configure.with-openlink"> <term> - <parameter>--with-openlink[=DIR]</parameter> + <parameter>--with-openlink[=dir]</parameter> </term> <listitem> <para> @@ -157,7 +170,7 @@ </varlistentry> <varlistentry id="install.configure.with-dbmaker"> <term> - <parameter>--with-dbmaker[=DIR]</parameter> + <parameter>--with-dbmaker[=dir]</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.graphics.xml diff -u phpdoc-fr/chapters/install.configure.graphics.xml:1.3 phpdoc-fr/chapters/install.configure.graphics.xml:1.4 --- phpdoc-fr/chapters/install.configure.graphics.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.configure.graphics.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect3 id="install.configure.options.graphics"> <title>Options graphiques</title> <variablelist> @@ -32,7 +32,7 @@ </varlistentry> <varlistentry id="install.configure.with-ming"> <term> - <parameter>--with-ming[=DIR]</parameter> + <parameter>--with-ming[=dir]</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.misc.xml diff -u phpdoc-fr/chapters/install.configure.misc.xml:1.3 phpdoc-fr/chapters/install.configure.misc.xml:1.4 --- phpdoc-fr/chapters/install.configure.misc.xml:1.3 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/install.configure.misc.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <sect3 id="install.configure.options.misc"> <title>Options diverses</title> <variablelist> @@ -27,7 +27,7 @@ </varlistentry> <varlistentry id="install.configure.with-fastcgi"> <term> - <parameter>--with-fastcgi=SRCDIR</parameter> + <parameter>--with-fastcgi=srcdir</parameter> </term> <listitem> <para> @@ -47,7 +47,7 @@ </varlistentry> <varlistentry id="install.configure.with-layout"> <term> - <parameter>--with-layout=TYPE</parameter> + <parameter>--with-layout=type</parameter> </term> <listitem> <para> @@ -58,7 +58,7 @@ </varlistentry> <varlistentry id="install.configure.with-pear"> <term> - <parameter>--with-pear=DIR</parameter> + <parameter>--with-pear=dir</parameter> </term> <listitem> <para> @@ -121,7 +121,7 @@ </varlistentry> <varlistentry id="install.configure.with-zlib-dir"> <term> - <parameter>--with-zlib-dir=<DIR></parameter> + <parameter>--with-zlib-dir=<dir></parameter> </term> <listitem> <para> @@ -131,7 +131,7 @@ </varlistentry> <varlistentry id="install.configure.with-aspell"> <term> - <parameter>--with-aspell[=DIR]</parameter> + <parameter>--with-aspell[=dir]</parameter> </term> <listitem> <para> @@ -141,7 +141,7 @@ </varlistentry> <varlistentry id="install.configure.with-ccvs"> <term> - <parameter>--with-ccvs[=DIR]</parameter> + <parameter>--with-ccvs[=dir]</parameter> </term> <listitem> <para> @@ -151,7 +151,7 @@ </varlistentry> <varlistentry id="install.configure.with-cybercash"> <term> - <parameter>--with-cybercash[=DIR]</parameter> + <parameter>--with-cybercash[=dir]</parameter> </term> <listitem> <para> @@ -162,7 +162,7 @@ </varlistentry> <varlistentry id="install.configure.with-icap"> <term> - <parameter>--with-icap[=DIR]</parameter> + <parameter>--with-icap[=dir]</parameter> </term> <listitem> <para> @@ -202,7 +202,7 @@ </varlistentry> <varlistentry id="install.configure.with-muscat"> <term> - <parameter>--with-muscat[=DIR]</parameter> + <parameter>--with-muscat[=dir]</parameter> </term> <listitem> <para> @@ -212,7 +212,7 @@ </varlistentry> <varlistentry id="install.configure.with-satellite"> <term> - <parameter>--with-satellite[=DIR]</parameter> + <parameter>--with-satellite[=dir]</parameter> </term> <listitem> <para> @@ -233,7 +233,7 @@ </varlistentry> <varlistentry id="install.configure.with-regex"> <term> - <parameter>--with-regex[=TYPE]</parameter> + <parameter>--with-regex[=type]</parameter> </term> <listitem> <para> @@ -244,7 +244,7 @@ </varlistentry> <varlistentry id="install.configure.with-vpopmail"> <term> - <parameter>--with-vpopmail[=DIR]</parameter> + <parameter>--with-vpopmail[=dir]</parameter> </term> <listitem> <para> @@ -264,7 +264,7 @@ </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> - <parameter>--enable-shared[=PKGS]</parameter> + <parameter>--enable-shared[=pkgs]</parameter> </term> <listitem> <para> @@ -275,7 +275,7 @@ </varlistentry> <varlistentry id="install.configure.enable-static"> <term> - <parameter>--enable-static[=PKGS]</parameter> + <parameter>--enable-static[=pkgs]</parameter> </term> <listitem> <para> @@ -285,7 +285,7 @@ </varlistentry> <varlistentry id="install.configure.enable-fast-install"> <term> - <parameter>--enable-fast-install[=PKGS]</parameter> + <parameter>--enable-fast-install[=pkgs]</parameter> </term> <listitem> <para> @@ -359,7 +359,7 @@ </varlistentry> <varlistentry id="install.configure.with-ismp"> <term> - <parameter>--with-imsp[=DIR]</parameter> + <parameter>--with-imsp[=dir]</parameter> </term> <listitem> <para> @@ -371,7 +371,7 @@ </varlistentry> <varlistentry id="install.configure.with-mck"> <term> - <parameter>--with-mck[=DIR]</parameter> + <parameter>--with-mck[=dir]</parameter> </term> <listitem> <para> @@ -383,7 +383,7 @@ </varlistentry> <varlistentry id="install.configure.with-mod-dav"> <term> - <parameter>--with-mod-dav=DIR</parameter> + <parameter>--with-mod-dav=dir</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.php.xml diff -u phpdoc-fr/chapters/install.configure.php.xml:1.2 phpdoc-fr/chapters/install.configure.php.xml:1.3 --- phpdoc-fr/chapters/install.configure.php.xml:1.2 Mon Apr 28 06:53:25 2003 +++ phpdoc-fr/chapters/install.configure.php.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect3 id="install.configure.options.php"> <title>Options PHP</title> <variablelist> @@ -16,7 +16,7 @@ </varlistentry> <varlistentry id="install.configure.with-config-file-path"> <term> - <parameter>--with-config-file-path=PATH</parameter> + <parameter>--with-config-file-path=path</parameter> </term> <listitem> <para> @@ -37,7 +37,7 @@ </varlistentry> <varlistentry id="install.configure.with-exec-dir"> <term> - <parameter>--with-exec-dir[=DIR]</parameter> + <parameter>--with-exec-dir[=dir]</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.configure.servers.xml diff -u phpdoc-fr/chapters/install.configure.servers.xml:1.1 phpdoc-fr/chapters/install.configure.servers.xml:1.2 --- phpdoc-fr/chapters/install.configure.servers.xml:1.1 Thu Jan 30 08:44:43 2003 +++ phpdoc-fr/chapters/install.configure.servers.xml Mon May 19 21:57:08 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <sect3 id="install.configure.options.servers"> <title>Options Serveur</title> <variablelist> <varlistentry id="install.configure.with-aolserver"> <term> - <parameter>--with-aolserver=DIR</parameter> + <parameter>--with-aolserver=dir</parameter> </term> <listitem> <para> @@ -15,7 +15,7 @@ </varlistentry> <varlistentry id="install.configure.with-apxs"> <term> - <parameter>--with-apxs[=FILE]</parameter> + <parameter>--with-apxs[=file]</parameter> </term> <listitem> <para> @@ -28,7 +28,7 @@ </varlistentry> <varlistentry id="install.configure.with-apache"> <term> - <parameter>--with-apache[=DIR]</parameter> + <parameter>--with-apache[=dir]</parameter> </term> <listitem> <para> @@ -49,7 +49,7 @@ </varlistentry> <varlistentry id="install.configure.with-apxs2"> <term> - <parameter>--with-apxs2[=FILE]</parameter> + <parameter>--with-apxs2[=file]</parameter> </term> <listitem> <para> @@ -60,7 +60,7 @@ </varlistentry> <varlistentry id="install.configure.with-fhttpd"> <term> - <parameter>--with-fhttpd[=DIR]</parameter> + <parameter>--with-fhttpd[=dir]</parameter> </term> <listitem> <para> @@ -71,7 +71,7 @@ </varlistentry> <varlistentry id="install.configure.with-isapi"> <term> - <parameter>--with-isapi=DIR</parameter> + <parameter>--with-isapi=dir</parameter> </term> <listitem> <para> @@ -81,7 +81,7 @@ </varlistentry> <varlistentry id="install.configure.with-nsapi"> <term> - <parameter>--with-nsapi=DIR</parameter> + <parameter>--with-nsapi=dir</parameter> </term> <listitem> <para> @@ -91,7 +91,7 @@ </varlistentry> <varlistentry id="install.configure.with-phttpd"> <term> - <parameter>--with-phttpd=DIR</parameter> + <parameter>--with-phttpd=dir</parameter> </term> <listitem> <para> @@ -101,7 +101,7 @@ </varlistentry> <varlistentry id="install.configure.with-pi3web"> <term> - <parameter>--with-pi3web=DIR</parameter> + <parameter>--with-pi3web=dir</parameter> </term> <listitem> <para> @@ -111,7 +111,7 @@ </varlistentry> <varlistentry id="install.configure.with-roxen"> <term> - <parameter>--with-roxen=DIR</parameter> + <parameter>--with-roxen=dir</parameter> </term> <listitem> <para> @@ -132,7 +132,7 @@ </varlistentry> <varlistentry id="install.configure.with-servlet"> <term> - <parameter>--with-servlet[=DIR]</parameter> + <parameter>--with-servlet[=dir]</parameter> </term> <listitem> <para> @@ -144,7 +144,7 @@ </varlistentry> <varlistentry id="install.configure.with-thttpd"> <term> - <parameter>--with-thttpd=SRCDIR</parameter> + <parameter>--with-thttpd=srcdir</parameter> </term> <listitem> <para> @@ -154,7 +154,7 @@ </varlistentry> <varlistentry id="install.configure.with-tux"> <term> - <parameter>--with-tux=MODULEDIR</parameter> + <parameter>--with-tux=moduledir</parameter> </term> <listitem> <para> Index: phpdoc-fr/chapters/install.windows.xml diff -u phpdoc-fr/chapters/install.windows.xml:1.7 phpdoc-fr/chapters/install.windows.xml:1.8 --- phpdoc-fr/chapters/install.windows.xml:1.7 Sat May 3 15:09:14 2003 +++ phpdoc-fr/chapters/install.windows.xml Mon May 19 21:57:08 2003 @@ -1,26 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <sect1 id="install.windows"> <title>Installation sous Windows</title> <para> Cette section s'applique aux systèmes Windows 98/Me et - Windows NT/2000/XP. Ne vous attendez pas à ce que PHP fonctionne sur + Windows NT/2000/XP. Ne vous attendez pas à ce que &php; fonctionne sur les plateformes 16 bits, comme Windows 3.1. Parfois, on décrira les plateformes supportées sous le nom de Win32. Windows 95 n'est plus - supporté à partir de la version 4.3.0 de PHP. + supporté à partir de la version 4.3.0 de &php;. </para> <para> - Il y a deux méthodes principales pour installer PHP sous Windows : + Il y a deux méthodes principales pour installer &php; sous Windows : soit <link linkend="install.windows.manual">manuellement</link>, soit avec <link linkend="install.windows.installer">InstallShield</link>. </para> <para> Si vous avez Microsoft Visual Studio, vous pouvez aussi <link linkend="install.windows.build">compiler</link> - PHP à partir des sources. + &php; à partir des sources. </para> <para> - Une fois que PHP est installé sur votre Windows, vous pouvez aussi + Une fois que &php; est installé sur votre Windows, vous pouvez aussi ajouter diverses <link linkend="install.windows.extensions">extensions</link>. </para> @@ -28,12 +28,16 @@ <sect2 id="install.windows.installer"> <title>InstallShield sous Windows</title> <para> - L'installeur Windows de PHP disponible depuis les pages de + L'installeur Windows de &php; disponible depuis les pages de <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>, installe la version - CGI de PHP, et configure les serveurs web IIS, PWS, et Xitami. + CGI de &php;, et configure les serveurs web IIS, PWS, et Xitami. + </para> + <para> Notez bien que bien que InstallShield soit une méthode simple - pour installer PHP, il est limité dans son fonctionnement, puisque + pour installer &php;, il est limité dans son fonctionnement, puisque l'installation automatique des extensions n'est pas prise en compte. + Le jeu complet des extensions &php; est disponible en téléchargeant + et décompressant manuellement l'archive. </para> <simpara> Installez votre serveur <acronym>HTTP</acronym> favori sur votre @@ -49,35 +53,31 @@ <simpara> Le wizard d'installation rassemble suffisamment d'informations pour configurer &php.ini; et le serveur web qui utilisera - PHP. Pour IIS, mais aussi PWS sous NT Workstation, une liste de l'arboresence + &php;. Pour IIS, mais aussi PWS sous NT Workstation, une liste de l'arboresence web est affichée, et vous pouvez sélectionner les dossiers - qui utiliseront PHP. + qui utiliseront &php;. </simpara> - - <simpara> Une fois l'installation terminée, l'installeur vous informera que vous devez redémarrer. Suivez ce conseil, ou commencez à - utiliser PHP immédiatement. + utiliser &php; immédiatement. </simpara> <warning> <para> - Gardez bien à l'esprit que cette installation de PHP n'est pas - sécurisée. Si vous voulez avoir une installation sécurisée de PHP, + Gardez bien à l'esprit que cette installation de &php; n'est pas + sécurisée. Si vous voulez avoir une installation sécurisée de &php;, vous devriez commencer par lire la documentation, et choisir toutes vos options avec soin. Cet installeur automatique vous permet de réaliser l'installation en un tour de main, mais n'est pas destinée à l'utilisation sur des serveurs de production. </para> </warning> - - </sect2> - - <sect2 id="install.windows.manual"> - <title>Instructions Générales d'installation</title> - <simpara> + </sect2> + <sect2 id="install.windows.manual"> + <title>Instructions Générales d'installation</title> + <simpara> Ce guide vous permet d'installer et de configurer manuellement - PHP sur vos stations Windows 9x/Me/NT/2000. Vous devrez commencer + &php; sur vos stations Windows 9x/Me/NT/2000. Vous devrez commencer par télécharger la distribution de &php; au format compressé ZIP à <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. La première version de ce @@ -85,137 +85,314 @@ La version originale est disponible (en anglais) à <ulink url="&url.win32install;">&url.win32install;</ulink>. </simpara> - <para> - Ce guide fournit une aide d'installation pour : - <itemizedlist> - <listitem> - <para> - Personal Web Server (Version la plus récente recommandée) - </para> - </listitem> - <listitem> - <para> - Internet Information Server 3 ou 4 - </para> - </listitem> - <listitem> - <para> - Apache 1.3.x - </para> - </listitem> - <listitem> - <para> - Omni HTTPd 2.0b1 et plus récent - </para> - </listitem> - <listitem> - <para> - Oreilly Website Pro - </para> - </listitem> - <listitem> - <para> - Xitami - </para> - </listitem> - <listitem> + <simpara> + Installez votre serveur <acronym>HTTP</acronym> sur votre système, et + assurez vous qu'il fonctionne. + </simpara> + + <simpara> + Exécutez l'installeur et suivez les instructions fournies par l'installeur. + Deux types d'installations sont supportés : <literal>standard</literal>, qui fournit des + valeurs sécuritaires pour la plupart des configurations, et + <literal>advanced</literal>, qui pose plus de questions. + </simpara> + + <simpara> + L'installeur rassemble suffisament d'informations pour créer le fichier + &php.ini; et configurer le serveur web pour qu'il utilise &php;. Pour + IIS et aussi PWS sur NT Workstation, une liste de tous les noeuds du serveur + avec configuration pour les scripts est affichés, et vous pourrez alors choisir + ceux qui vous intéressent, pour leur ajouter &php;. + </simpara> + + <simpara> + Une fois l'installation fine,, l'installeur vous informera que vous devez + redémarrer votre système, le serveur web ou simplement utiliser &php;. + </simpara> + + <warning> + <para> + Attention, cette configuration de &php; n'est pas sécuritaire. Si vous souhaitez + une configuration sûre de &php;, vous devriez passer par la méthoe manuelle, + et choisir vous même toutes les configurations. Cette installation est rapide + et permet d'obtenir rapidement une installation de &php;, mais elle n'est pas + destinée à être utilisée sur des serveurs en ligne. + </para> + </warning> + </sect2> + + + <sect2 id="install.windows.manual"> + <title>Installation manuelle sous Windows</title> + <simpara> + Ce guide d'installation vous aide à installer manuellement et configurer + &php; sur votr serveur web Windows. La version initiale de ce guide a été + compilée par &link.bob;, et est disponible en anglais, à + <ulink url="&url.win32install;">&url.win32install;</ulink>. + Vous devrez télécharger la distribution binaire Zip sur la page + <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. + </simpara> + <para> - Netscape Enterprise Server, iPlanet + &php; 4 pour Windows est distribué en trois versions : éxécutable <acronym>CGI</acronym>, + un exécutable CLI (sapi/php.exe) et d'autres modules SAPI : + <simplelist> + <member> + <filename>php4apache.dll</filename> - module Apache 1.3.x. + </member> + <member> + <filename>php4apache2.dll</filename> - module Apache 2.0.x. + </member> + <member> + <filename>php4isapi.dll</filename> - module ISAPI compatible avec les serveurs + comme IIS 4.0/PWS 4.0 ou plus récent. + </member> + <member> + <filename>php4nsapi.dll</filename> - module Netscape/iPlanet. + </member> + </simplelist> + Cette dernière forme est nouvelle en &php; 4, et fourni des performances + améliorées et de nouvelles fonctionnalités. La version CLI est conçue pour + utiliser &php; en ligne de commande. Plus d'informations sur la forme + CLI est disponible dans le chapitre + "<link linkend="features.commandline">utiliser &php; en ligne de commande</link>". </para> - </listitem> - </itemizedlist> - </para> - <para> - PHP 4 pour Windows est décliné en deux versions : un exécutable - CGI (<filename>php.exe</filename>), et plusieurs modules SAPI - (par exemple php4isapi.dll). Cette dernière forme est nouvelle - pour PHP 4 et founit des performances améliorées ainsi que des - fonctionnalités supplémentaires. - </para> <warning> <simpara> - Les modules SAPI ont été significativement améliorés en version 4.1. - Toutefois, vous pouvez rencontrer des erreurs de serveur ou des - erreurs de modules tels qu'ASP, dans les anciens systèmes. + Les modules SAPI ont été significativement amélioré dans la version + 4.1, mais vous pourrez rencontrer des erreurs avec le serveur ou + d'autres modules (tels ASP), dans les autres systèmes. </simpara> </warning> -<para> - Si vous choisissez l'un des modules SAPI et utilisez Windows 95, - pensez à télécharger la mise à jour DCOM à - <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>. - Pour le module ISAPI, comme un serveur web - compatible est nécessaire (testé avec IIS 4.0, PWS 4.0 et IIS 5.0). - IIS 3.0 <emphasis>n'est pas</emphasis> supporté; vous devez - télécharger et installer le Windows NT 4.0 Option Pack avec IIS 4.0 si - vous voulez le support natif de PHP. - </para> + <note> + <title>Pré-requis DCOM et MDAC</title> + <para> + Si vous choisissez d'installer le module SAPI sur + <emphasis>Windows 95</emphasis>, assurez vous de télécharger et installer + la mise à jour DCOM, disponible à <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>. + Si vous utilisez Microsoft <emphasis>Windows 9x/NT4</emphasis>, téléchargez + la dernière version de Microsoft Data Access Components (MDAC) pour votre + plate-forme. MDAC est disponible à <ulink url="&url.mdac;">&url.mdac;</ulink>. + </para> + </note> <para> Voici les différentes étapes d'installation avant les étapes spécifiques au serveur. - <itemizedlist> - <listitem> - <para> - Extrayez la distribution dans le dossier de votre - choix. <filename>"C:\php\"</filename> est une bonne idée. - </para> - </listitem> - <listitem> - <para> - Vous devez vous assurer que les DLL que PHP utilise sont - disponibles. La liste précise des DLL dépend du serveur - web que vous utilisez, et de la méthode que vous utilisez - pour faire exécuter vos script (CGI ou module). - <filename>php4ts.dll</filename> est toujours nécessaire. - Si vous utilisez PHP en module, (e.g. ISAPI or Apache), vous - aurez besoin de la DLL ad hoc, dans le dossier <filename>sapi</filename>. - Si vous utilisez des extensions PHP, vous aurez besoin des - DLL associées. Pour être certains que les DLL sont accessibles, - vous pouvez les copier dans le dossier système (i.e. - <filename>winnt/system32</filename> ou - <filename>windows/system</filename>) ou vous pouvez vous - assurer qu'elles sont dans le même dossier que l'exécutable - PHP ou les autres DLL de votre serveur web (i.e. php.exe, - ou php4apache.dll). + <itemizedlist> + <listitem> + <simpara> + Extrayez la distribution dans un dossier de votre choix, + comme par exemple <filename>c:\</filename>. L'archive zip devient un + dossier appelé <filename>php-4.3.1-Win32</filename> qui est supposé être + renommé en <filename>php</filename>. Par sourci de clareté, nous supposerons + alors que vous avez placé votre distribution dans le dossier + <filename>c:\php</filename>. Vous pouve choisir un autre dossier, mais vous + serez prudents d'éviter les espaces dans le nom du chemin au dossier + (comme par exemple <filename>c:\program files\php</filename> n'est pas une bonne idée). + car certains serveurs web vont crasher sinon. La structure du dossier que vous + avez extrait ressemble à ceci : + </simpara> + </listitem> + </itemizedlist> + <informalexample> + <programlisting> +<![CDATA[ + +c:\php + | + +--cli + | | + | |-php.exe -- Exécutable CLI - UNIQUEMENT pour la ligne de commande + | + | + +--dlls -- DLL de support des extensions --> dossier système Windows + | | + | |-expat.dll + | | + | |-fdftk.dll + | | + | |-... + | + +--extensions -- extension dlls pour PHP + | | + | |-php_bz2.dll + | | + | |-php_cpdf.dll + | | + | |-.. + | + +--mibs -- fichiers de support de SNMP + | + | + +--openssl -- fichiers de support de Openssl + | + | + +--pdf-related -- fichiers de support de PDF + | + | + +--sapi -- DLL SAPI + | | + | |-php4apache.dll + | | + | |-php4apache2.dll + | | + | |-php4isapi.dll + | | + | |-.. + | + |-install.txt + | + |-.. + | + |-php.exe -- exécutable CGI + | + |-.. + | + |-php.ini-dist + | + |-php.ini-recommended + | + |-php4ts.dll -- DLL principale --> dossier système Windows + | + |-... + + +]]> + </programlisting> + </informalexample> </para> <para> - L'exécutable binaire PHP, les modules SAPI, et certaines extensions - utilisent des DLL externes. Assurez-vous que ces DLL sont dans votre - distribution, et dans un dossier qui est cité dans le - PATH Windows. Le mieux à faire est de copier les fichiers ci-dessous - dans votre dossier système, qui est généralement : + Le binaire CGI "<filename>C:/php/php.exe</filename>", le binaire + CLI (<filename>c:\php\cli\php.exe</filename>), et les modules SAPI + "<filename>c:\php\sapi\*.dll</filename>" dépendent de la DLL principale + <filename>c:\php\php4ts.dll</filename>. Vous devez vous assurer que cette + DLL est disponible pour votre installation &php;. L'ordre des dossiers + lors de la recherche est le suivant : <simplelist> - <member>c:\windows\system pour Windows 9x/Me</member> - <member>c:\winnt\system32 pour Windows NT/2000</member> - </simplelist> - Les fichiers à copier sont : - <simplelist> - <member> - "php4ts.dll", s'il existe, écrasez le - </member> - <member> - 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ù - quelque chose irait de travers). - </member> + <member> + Le dossier d'où <filename>php.exe</filename> est appelé. + Lorsque vous utilisez le module SAPI, c'est le dossier d'où le + serveur web charge la DLL (i.e. <filename>php4apache.dll</filename>). + </member> + <member> + Tout dossier dans la variable d'environnement Windows <varname>PATH</varname>. + </member> </simplelist> + <itemizedlist> + <listitem> + <para> + La meilleure chose à faire est de rendre <filename>php4ts.dll</filename> accessible, + indépendemmant de l'intarface utilisée (CGI ou module SAPI). Pour cela, + vous devez copier la DLL dans un dossier de votre PATH Windows. La meilleure + place est alors le dossier système Windws : + <simplelist> + <member> + <filename>c:\windows\system</filename> pour Windows 9x/ME + </member> + <member> + <filename>c:\winnt\system32</filename> pour Windows NT/2000 ou + <filename>c:\winnt40\system32</filename> pour NT/2000 server + </member> + <member> + <filename>c:\windows\system32</filename> pour Windows XP + </member> + </simplelist> + Si vous voulez utiliser le module SAPI depuis <filename>c:\php\sapi</filename> + et que vous ne voulez pas copier vos DLL dans le dossier système Windows, + vous avez les possibilités de copier simplement <filename>php4ts.dll</filename> + dans le dossier SQPI de votre archive décompressée <filename>c:\php\sapi</filename>. + </para> + </listitem> + <listitem> + <para> + L'étape suivante est de faire un fichier de configuration valide pour &php;, + c'est à dire le fichier &php.ini;. Il y a deux versions de ce fichier disponibles + dans l'archive : + <filename>php.ini-dist</filename> et + <filename>php.ini-recommended</filename>. Nous vous recommandons d'utiliser + <filename>php.ini-recommended</filename>, car nous avons optimisé les + configurations par défaut dans ce fichier pour les performances et la sécurité. + Lisez bien ce fichier documenté, et étudiez toutes les + <link linkend="configuration.file">configurations</link>, puis faites vos + propres choix. Si vous voulez atteindre la meilleure sécurité, c'est + la meilleure méthode. Copiez votre fichier de configuration de choix + dans un dossier où &php; est capable de le lire, et renommez le + &php.ini;. Par défaut, &php; recherche &php.ini; dans votre dossier Windows : + <simplelist> + <member> + Sur Windows 9x/ME/XP, copiez le fichier &php.ini; dans votre dossier + <filename> %WINDIR%</filename>, qui est généralement <filename>c:\windows</filename>. + </member> + <member> + Sur Windows NT/2000, copiez le fichier &php.ini; dans votre dossier + <filename>%WINDIR%</filename> ou <filename>%SYSTEMROOT%</filename>, + qui est typiquement <filename>c:\winnt</filename> ou + <filename>c:\winnt40</filename> pour les serveurs NT/2000. + </member> + </simplelist> + </para> + </listitem> + <listitem> + <simpara> + Si vous utilisez NTFS sur Windows NT, 2000 ou XP, assurez vous que + l'utilisateur qui fait tourner le serveur web a les droits de lecture + de votre fichier &php.ini; (e.g. rendez le lisible par tout le monde). + </simpara> + </listitem> + </itemizedlist> </para> <para> - Téléchargez la dernière version de Microsoft Data Access Components - (MDAC) pour votre plateforme, spécialement si vous utilisez - Microsoft Windows 9x/NT4. MDAC est disponible à - <ulink url="&url.mdac;">&url.mdac;</ulink>. - </para> - </listitem> - <listitem> + Les étapes suivantes sont optionnelles : + <itemizedlist> + <listitem> + <para> + Editez votre nouveau fichier &php.ini;. + Si vous envisagez d'utiliser <link linkend="install.omnihttpd">OmniHTTPd</link>, + ignorez l'étape suivante. Configurez + <link linkend="ini.doc-root">doc_root</link> pour qu'il pointe sur la racine de + votre serveur web. Par exemple : + <informalexample> + <programlisting role="ini"> +<![CDATA[ +doc_root = c:\inetpub // pour IIS/PWS + +doc_root = c:\apache\htdocs // pour Apache +]]> + </programlisting> + </informalexample> + </para> + </listitem> + <listitem> + <simpara> + Choisissez les extensions que vous voulez que &php; démarre. Voyez la + section sur les <link linkend="install.windows.extensions">extensions Windows</link>, + pour les configurer, si elles ne sont pas intégrées. Notez que + sur une nouvelle installation, il est recommandé de commencer par faire fonctionner + &php; avant d'ajouter ou retirer des extenesions via le &php.ini;. + </simpara> + </listitem> + <listitem> + <simpara> + Sur PWS et IIS, vous pouvez utiliser la directive + <link linkend="ini.browscap">browscap</link> pour qu'elle pointe sur : + <filename>c:\windows\system\inetsrv\browscap.ini</filename> sur + Windows 9x/Me, + <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sur + NT/2000, and + <filename>c:\windows\system32\inetsrv\browscap.ini</filename> + sur XP. + </simpara> + </listitem> + </itemizedlist> + </para> <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 + <filename>%WINDOWS</filename> sous Windows 95/98, ou vers votre + dossier <filename>%SYSTEMROOT%</filename> sous Windows NT ou Windows + 2000 et renommez-le en &php.ini;. Votre dossier + <filename>%WINDOWS%</filename> ou <filename>%SYSTEMROOT%</filename> + 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> @@ -235,99 +412,63 @@ pourrez le faire, même si PHP fonctionne parfaitement avec les configurations par défaut. </para> - </listitem> - <listitem> <para> Editez votre fichier &php.ini; : <itemizedlist> <listitem> <simpara> - Vous devez changer votre option 'extension_dir' pour qu'il - pointe sur votre dossier d'installation PHP, ou vers l'endroit - où vous avez installé vos 'php_*.dll'. ex: c:\php\extensions - </simpara> + la famille <link linkend="install.iis">des serveurs Windows</link>, + Personal Web server (PWS) 3 et 4 ou plus récent; + Internet Information Server (IIS) 3 et 4 ou plus récent. + </simpara> </listitem> <listitem> <simpara> - Si vous utilisez Omni Httpd, sautez l'étape suivante. - Modifiez 'doc_root' pour qu'il pointe sur votre - racine de serveur web. ex: <filename>c:\apache\htdocs</filename> - ou <filename>c:\webroot</filename>. + les serveurs Apache + <link linkend="install.apache.windows">Apache 1.3.x</link>, et + <link linkend="install.apache2.windows">Apache 2.x</link>. </simpara> </listitem> + <listitem> <simpara> - Choisissez les modules que vous voulez charger lorsque - PHP démarre. Voyez la - section sur les - <link linkend="install.windows.extensions">extensions Windows</link>, - pour savoir comment les installer et quelles sont celles qui sont - déjà inclues. Notez aussi qu'il est préférable de commencer - par faire fonctionner &php; sur une nouvelle installation avant - d'activer des extensions supplémentaires avec &php.ini;. + les serveurs + <link linkend="install.netscape.windows">Netscape/iPlanet</link>. </simpara> </listitem> - <listitem> - <simpara> - Sous PWS et IIS, vous pouvez configurer le fichier - <filename>browscap.ini</filename> pour qu'il pointe sur - <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous Windows 9x/Me, - <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sous NT/2000 et - <filename>c:\windows\system32\inetsrv\browscap.ini</filename> sous XP. - </simpara> - </listitem> + <listitem> <simpara> - Notez que le dossier <filename>mibs</filename> fourni avec - la distribution Windows, contient des fichiers de support - du protocole SNMP. Ce dpssier doit être déplacé dans le dossier - <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> - est le périphérique où PHP est installé.) - </simpara> + le serveur <link linkend="install.omnihttpd">OmniHTTPd</link>. + </simpara> </listitem> - <listitem> - <simpara> - Si vous n'utilisez pas NTFS sous Windows NT, 2000 et XP, assurez-vous - que l'utilisateur qui fait tourner le serveur web a bien les - permission pour accéder à votre &php.ini;. - </simpara> - </listitem> - </itemizedlist> - </para> + + <listitem> + <simpara> + le serveur <link linkend="install.oreilly">Oreilly Website Pro</link>. + </simpara> </listitem> + <listitem> - <para> - Avec PWS, donnez les droits d'exécution au webmestre : - <itemizedlist> - <listitem> - <simpara> - Démarrez le PWS Web Manager - </simpara> - </listitem> - <listitem> - <simpara> - Editez les Properties du dossier "Home" - </simpara> - </listitem> - <listitem> - <simpara> - Sélectionnez la coche "execute" - </simpara> - </listitem> - </itemizedlist> - </para> + <simpara> + le serveur <link linkend="install.sambar">Sambar</link>. + </simpara> </listitem> - + <listitem> + <simpara> + le serveur <link linkend="install.xitami">Xitami</link>. + </simpara> + </listitem> </itemizedlist> - </para> + </para> </sect2> <sect2 id="install.windows.build"> <title>Compilation des sources</title> <para> Avant de commencer, il est bon de se poser la question suivante : - "Pourquoi la compilation de PHP sous Windows est si difficile?". + "Pourquoi la compilation de &php; sous Windows est si difficile?". Deux raisons viennent immédiatement à l'esprit : </para> <orderedlist> @@ -389,7 +530,7 @@ </listitem> </itemizedlist> <simpara> - Finalement, vous aurez besoin des sources PHP 4 elles-mêmes!! + Finalement, vous aurez besoin des sources &php; 4 elles-mêmes!! Les dernières versions sont accessibles sur le serveur CVS <ulink url="&url.php.anoncvs;">anonyme</ulink>. Si vous téléchargez une version @@ -627,7 +768,7 @@ <sect2 id="install.windows.extensions"> <title>Installation des extensions sous Windows</title> <para> - Après avoir installé PHP et votre serveur web sous Windows, + Après avoir installé &php; et votre serveur web sous Windows, vous voudrez sûrement ajouter quelques extensions bien pratiques. La table suivante liste une partie des extensions disponibles. Comme indiqué dans le manuel, vous pouvez choisir quelles @@ -637,23 +778,63 @@ <function>dl</function>. </para> <para> - Les fichiers DLLs des extensions PHP sont préfixés - par 'php_' en PHP 4, et 'php3_' en PHP 3. Cela évite la confusion - des extensions PHP et de leurs librairies. + Les fichiers DLLs des extensions &php; sont préfixés + par <literal>php_</literal> en &php; 4, et <literal>php3_</literal> en &php; 3. + Cela évite la confusion des extensions &php; et de leurs librairies. </para> <note> <para> - En PHP 4.0.6 le support des extensions BCMath, Calendar, COM, FTP, MySQL, ODBC, PCRE, - Session, WDDX et XML est activé <emphasis>par défaut</emphasis>. - Vous n'avez pas à charger d'extensions particulière pour utiliser - ces fonctions. Lisez le fichier <filename>README.txt</filename> inclus - dans la distribution, ou bien <filename>install.txt</filename> pour - connaitre la liste des modules automatiquement activés. + En &php; 4.3.1, les extensions BCMath, Calendar, COM, Ctype, FTP, MySQL, ODBC, Overload, + PCRE, Session, Tokenizer, WDDX, XML et Zlib sont + <emphasis>intégrée</emphasis>. Vous n'avez pas besoin d'ajouter d'autres + extensions pour pouvoir utiliser ces fonctions. Voyez le fichier + <filename>README.txt</filename> ou <filename>install.txt</filename> + de votre distribution, ou bien + <link linkend="install.extensions.overview">cette table</link> + pour une liste des modules intégrés. </para> </note> - <note> - <para> + <para> + Editez votre fichier &php.ini; : + <itemizedlist> + <listitem> + <para> + Vous devez modifier l'option de + <link linkend="ini.extension-dir">extension_dir</link> pour qu'elle pointe + sur le dossier qui contient les extensions, là où vous avez placé vos + fichiers <filename>php_*.dll</filename>. N'oubliez surtout pas l'anti-slash + final. Par exemple : + <informalexample> + <programlisting role="ini"> +<![CDATA[ +extension_dir = c:/php/extensions/ +]]> + </programlisting> + </informalexample> + </para> + </listitem> + <listitem> + <para> + Pour activer les extensions dans le &php.ini;, il suffit de décommenter + les lignes <literal>extension=php_*.dll</literal> dans le &php.ini;. Ceci est fait + en effaçant le point-virgule initial de la ligne : + <example> + <title>Activer l'extension <link linkend="ref.bzip2">Bzip2</link> sous Windows</title> + <programlisting role="ini"> +<![CDATA[ +// changez la ligne ... +;extension=php_bz2.dll + +// ... en +extension=php_bz2.dll +]]> + </programlisting> + </example> + </para> + </listitem> + <listitem> + <para> Certaines de ces extensions requièrent des librairies DLL supplémentaires pour fonctionner correctement. Certaines d'entre elles sont disponibles dans la distribution. dans le dossier <filename>dlls</filename> mais @@ -668,15 +849,18 @@ <member>c:\winnt\system32 pour Windows NT/2000</member> <member>c:\windows\system32 pour Windows XP</member> </simplelist> - Si vous les avez déjà d'installées sur votre système, ne les écrasez - que si PHP ne fonctionne pas correctement (et de toutes manières, faites - une sauvegarde de ces DLL, en cas de problème). - </para> - </note> + Si vous les avez déjà d'installées sur votre système, + ne les écrasez que si &php; ne fonctionne pas correctement + (et de toutes manières, faites une sauvegarde de ces DLL, + en cas de problème). + </para> + </listitem> + </itemizedlist> + </para> <para> - <table> - <title>PHP Extensions</title> + <table id="install.extensions.overview"> + <title>Extensions &php; pour Windows</title> <tgroup cols="3"> <thead> <row> @@ -695,7 +879,7 @@ <row> <entry>php_calendar.dll</entry> <entry>Fonctions de conversions calendaires <link linkend="ref.calendar">Calendar</link></entry> - <entry>Disponible depuis PHP 4.0.3</entry> + <entry>Disponible depuis &php; 4.0.3</entry> </row> <row> <entry>php_cpdf.dll</entry> @@ -720,7 +904,8 @@ <row> <entry>php_curl.dll</entry> <entry><link linkend="ref.curl">CURL</link>, Client URL library functions</entry> - <entry>Requiert : libeay32.dll, ssleay32.dll (fournies)</entry> + <entry>Requiert : <filename>libeay32.dll</filename>, + <filename>ssleay32.dll</filename> (fournies)</entry> </row> <row> <entry>php_cybercash.dll</entry> @@ -730,7 +915,8 @@ <row> <entry>php_db.dll</entry> <entry>Fonctions <link linkend="ref.dbm">DBM</link></entry> - <entry>Obsolètes. Utilisez DBA à la place (php_dba.dll)</entry> + <entry>Obsolètes. Utilisez DBA à la place (<filename>php_dba.dll</filename>) + </entry> </row> <row> <entry>php_dba.dll</entry> @@ -748,9 +934,14 @@ <entry>Inconnu</entry> </row> <row> + <entry>php_dbx.dll</entry> + <entry>Fonctions <link linkend="ref.dbx">dbx</link></entry> + <entry></entry> + </row> + <row> <entry>php_domxml.dll</entry> <entry>Fonctions de <link linkend="ref.domxml">DOM XML</link></entry> - <entry>Requiert : libxml2.dll (fournie)</entry> + <entry>Requiert : <filename>libxml2.dll</filename> (fournie)</entry> </row> <row> <entry>php_dotnet.dll</entry> @@ -770,7 +961,7 @@ <row> <entry>php_fdf.dll</entry> <entry>Fonctions <link linkend="ref.fdf">FDF</link>: Forms Data Format.</entry> - <entry>Requiert : fdftk.dll (fournies)</entry> + <entry>Requiert : <filename>fdftk.dll</filename> (fournies)</entry> </row> <row> <entry>php_filepro.dll</entry> @@ -780,7 +971,7 @@ <row> <entry>php_ftp.dll</entry> <entry>Fonctions <link linkend="ref.ftp">FTP</link></entry> - <entry>Disponible depuis PHP 4.0.3</entry> + <entry>Disponible depuis &php; 4.0.3</entry> </row> <row> <entry>php_gd.dll</entry> @@ -788,9 +979,15 @@ <entry>Aucune</entry> </row> <row> + <entry>php_gd2.dll</entry> + <entry>Fonctions de traitement des images <link linkend="ref.image">GD2</link></entry> + <entry>None</entry> + </row> + <row> <entry>php_gettext.dll</entry> <entry>Fonctions <link linkend="ref.gettext">Gettext</link></entry> - <entry>Requiert : gnu_gettext.dll (fournies)</entry> + <entry>&php; <= 4.2.0 requiert : <filename>gnu_gettext.dll</filename> (fournie), + &php; >= 4.2.3 requiert <filename>libintl-1.dll</filename> (fournie).</entry> </row> <row> <entry>php_hyperwave.dll</entry> @@ -800,7 +997,7 @@ <row> <entry>php_iconv.dll</entry> <entry>Fonctions de conversions de jeux de caractères <link linkend="ref.iconv">ICONV</link></entry> - <entry>Requiert : iconv-1.3.dll (fournies)</entry> + <entry>Requiert : <filename>iconv-1.3.dll</filename> (fournies)</entry> </row> <row> <entry>php_ifx.dll</entry> @@ -815,27 +1012,39 @@ <row> <entry>php_imap.dll</entry> <entry>Fonctions <link linkend="ref.imap">IMAP</link>, POP3 et NNTP</entry> - <entry>PHP 3: php3_imap4r1.dll</entry> + <entry>&php; 3 : <filename>php3_imap4r1.dll</filename></entry> </row> <row> <entry>php_ingres.dll</entry> <entry>Fonctions <link linkend="ref.ingres">Ingres II</link></entry> - <entry>Requiert : Ingres II libraries</entry> + <entry>Requiert : librairies Ingres II</entry> </row> <row> <entry>php_interbase.dll</entry> <entry>Fonctions <link linkend="ref.ibase">InterBase</link></entry> - <entry>Requiert : gds32.dll (fournies)</entry> + <entry>Requiert : <filename>gds32.dll</filename> (fournies)</entry> </row> <row> <entry>php_java.dll</entry> <entry>Extension <link linkend="ref.java">Java</link></entry> - <entry>Requiert : jvm.dll (fournies)</entry> + <entry>Requiert : <filename>jvm.dll</filename> (fournies)</entry> </row> <row> <entry>php_ldap.dll</entry> <entry>Fonctions <link linkend="ref.ldap">LDAP</link></entry> - <entry>Requiert : libsasl.dll (fournies)</entry> + <entry>PHP <= 4.2.0 requiert <filename>libsasl.dll</filename> (fournie), + PHP >= 4.3.0 requiert <filename>libeay32.dll</filename>, + <filename>ssleay32.dll</filename> (fournies).</entry> + </row> + <row> + <entry>php_mbstring.dll</entry> + <entry>Fonctions <link linkend="ref.mbstring">chaînes multi-octets</link></entry> + <entry>Aucune</entry> + </row> + <row> + <entry>php_mcrypt.dll</entry> + <entry><link linkend="ref.mcrypt">Mcrypt Encryption</link> functions</entry> + <entry>Requiert : <filename>libmcrypt.dll</filename></entry> </row> <row> <entry>php_mhash.dll</entry> @@ -843,6 +1052,11 @@ <entry>Aucune</entry> </row> <row> + <entry>php_mime_magic.dll</entry> + <entry><link linkend="ref.mime-magic">Mimetype</link> functions</entry> + <entry>Requiert : <filename>magic.mime</filename> (fournie)</entry> + </row> + <row> <entry>php_ming.dll</entry> <entry>Fonctions de générations de fichiers Flash avec <link linkend="ref.ming">Ming</link></entry> <entry>Aucune</entry> @@ -850,7 +1064,7 @@ <row> <entry>php_msql.dll</entry> <entry>Fonctions de <link linkend="ref.msql">mSQL</link></entry> - <entry>Requiert : msql.dll (fournies)</entry> + <entry>Requiert : <filename>msql.dll</filename> (fournies)</entry> </row> <row> <entry>php3_msql1.dll</entry> @@ -865,12 +1079,12 @@ <row> <entry>php_mssql.dll</entry> <entry>Fonctions <link linkend="ref.mssql">MSSQL</link></entry> - <entry>Requiert : ntwdblib.dll (fournies)</entry> + <entry>Requiert : <filename>ntwdblib.dll</filename> (fournies)</entry> </row> <row> <entry>php3_mysql.dll</entry> <entry>Fonctions <link linkend="ref.mysql">MySQL</link></entry> - <entry>Built-in in PHP 4</entry> + <entry>Intégré à &php; 4</entry> </row> <row> <entry>php3_nsmail.dll</entry> @@ -890,7 +1104,7 @@ <row> <entry>php_openssl.dll</entry> <entry>Fonctions <link linkend="ref.openssl">OpenSSL</link></entry> - <entry>Requiert : libeay32.dll (fournies)</entry> + <entry>Requiert : <filename>libeay32.dll</filename> (fournies)</entry> </row> <row> <entry>php_oracle.dll</entry> @@ -898,6 +1112,11 @@ <entry>Requiert : librairies clientes Oracle 7</entry> </row> <row> + <entry>php_overload.dll</entry> + <entry><link linkend="ref.overload">Object overloading</link> functions</entry> + <entry>Intégrée depuis &php; 4.3.0</entry> + </row> + <row> <entry>php_pdf.dll</entry> <entry>Fonctions de <link linkend="ref.pdf">PDF</link></entry> <entry>Aucune</entry> @@ -913,14 +1132,19 @@ <entry>Aucune</entry> </row> <row> - <entry>php_xslt.dll</entry> - <entry>Fonctions <link linkend="ref.xslt">XSLT</link></entry> - <entry>Requiert : sablot.dll (fournies)</entry> + <entry>php_shmop.dll</entry> + <entry>Fonctions de <link linkend="ref.shmop">mémoire partagée</link></entry> + <entry>Aucune</entry> </row> <row> <entry>php_snmp.dll</entry> <entry>Fonctions <link linkend="ref.snmp">SNMP</link></entry> - <entry>NT only!</entry> + <entry>NT uniquement!</entry> + </row> + <row> + <entry>php_sockets.dll</entry> + <entry>Fonctions de <link linkend="ref.sockets">socket</link></entry> + <entry>Aucune</entry> </row> <row> <entry>php_sybase_ct.dll</entry> @@ -928,9 +1152,34 @@ <entry>Requiert : librairies clientes Sybase</entry> </row> <row> + <entry>php_tokenizer.dll</entry> + <entry><link linkend="ref.tokenizer">Tokenizer</link></entry> + <entry>Intégrée depuis &php; 4.3.0</entry> + </row> + <row> + <entry>php_w32api.dll</entry> + <entry>Fonctions <link linkend="ref.w32api">W32api</link></entry> + <entry>Aucune</entry> + </row> + <row> + <entry>php_xmlrpc.dll</entry> + <entry>Fonctions <link linkend="ref.xmlrpc">XML-RPC</link></entry> + <entry>&php; >= 4.2.1 requiert <filename>iconv.dll</filename> (fournie)</entry> + </row> + <row> + <entry>php_xslt.dll</entry> + <entry>Fonctions <link linkend="ref.xslt">XSLT</link></entry> + <entry>Requiert : <filename>sablot.dll</filename>, <filename>expat.dll</filename> (fournies)</entry> + </row> + <row> <entry>php_yaz.dll</entry> <entry>Fonctions <link linkend="ref.yaz">YAZ</link></entry> <entry>Aucune</entry> + </row> + <row> + <entry>php_zib.dll</entry> + <entry>Fonctions de compression <link linkend="ref.zip">Zip</link></entry> + <entry>Accès en lecture seule</entry> </row> <row> <entry>php_zlib.dll</entry> Index: phpdoc-fr/chapters/security.xml diff -u phpdoc-fr/chapters/security.xml:1.22 phpdoc-fr/chapters/security.xml:1.23 --- phpdoc-fr/chapters/security.xml:1.22 Tue Mar 4 19:06:07 2003 +++ phpdoc-fr/chapters/security.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> +<!-- $Revision: 1.23 $ --> <chapter id="security"> <title>Sécurité</title> <simpara> @@ -1222,7 +1222,7 @@ <para> Une autre astuce est de configurer le serveur web, comme Apache, pour qu'il utilise plusieurs types de fichiers différents avec PHP, - soit localement avec le fichier <filename>.htaccess</filename>, soit + soit localement avec le fichier &htaccess;, soit dans le fichier de configuration lui-même. Vous pouvez utiliser des informations déroutantes comme ceci : <example> Index: phpdoc-fr/chapters/streams.constants.xml diff -u phpdoc-fr/chapters/streams.constants.xml:1.2 phpdoc-fr/chapters/streams.constants.xml:1.3 --- phpdoc-fr/chapters/streams.constants.xml:1.2 Mon Apr 28 06:53:25 2003 +++ phpdoc-fr/chapters/streams.constants.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- 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 @@ -12,7 +12,7 @@ <refentry id="streams.options"> <refnamediv> - <refname>Options d'ouverture de flôt</refname> + <refname>options d'ouverture de flôt</refname> <refpurpose>Affectent les fonctions de flôt</refpurpose> </refnamediv> <refsect1> Index: phpdoc-fr/chapters/streams.structs.xml diff -u phpdoc-fr/chapters/streams.structs.xml:1.1 phpdoc-fr/chapters/streams.structs.xml:1.2 --- phpdoc-fr/chapters/streams.structs.xml:1.1 Thu Jan 30 08:44:44 2003 +++ phpdoc-fr/chapters/streams.structs.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- 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 @@ -13,7 +13,7 @@ <refentry id="streams.struct-php-stream-statbuf"> <refnamediv> <refname>struct php_stream_statbuf</refname> - <refpurpose>Contient des information sur le fichier ou l'URL</refpurpose> + <refpurpose>Conserve des information sur le fichier ou l'URL</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -31,7 +31,7 @@ <refentry id="streams.struct-php-stream-dirent"> <refnamediv> <refname>struct php_stream_dirent</refname> - <refpurpose>Contient des informations sur un fichier durant une analyse de dossier</refpurpose> + <refpurpose>Conserve des informations sur un fichier durant une analyse de dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -70,6 +70,105 @@ int (*cast)(php_stream *stream, int castas, void **ret TSRMLS_DC); int (*stat)(php_stream *stream, php_stream_statbuf *ssb TSRMLS_DC); } php_stream_ops; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-wrapper"> + <refnamediv> + <refname>struct php_stream_wrapper</refname> + <refpurpose>Conserve les proprits et pointeur d'un gestionnaire de flt</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + struct _php_stream_wrapper { + php_stream_wrapper_ops *wops; /* operations the wrapper can perform */ + void *abstract; /* context for the wrapper */ + int is_url; /* so that PG(allow_url_fopen) can be respected */ + + /* support for wrappers to return (multiple) error messages to the stream opener */ + int err_count; + char **err_stack; + } php_stream_wrapper; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-wrapper-ops"> + <refnamediv> + <refname>struct php_stream_wrapper_ops</refname> + <refpurpose>Conserve les fonctions d'un gestionnaire de flt</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + typedef struct _php_stream_wrapper_ops { + /* open/create a wrapped stream */ + php_stream *(*stream_opener)(php_stream_wrapper *wrapper, char *filename, char *mode, + int options, char **opened_path, php_stream_context *context STREAMS_DC TSRMLS_DC); + /* close/destroy a wrapped stream */ + int (*stream_closer)(php_stream_wrapper *wrapper, php_stream *stream TSRMLS_DC); + /* stat a wrapped stream */ + int (*stream_stat)(php_stream_wrapper *wrapper, php_stream *stream, php_stream_statbuf *ssb TSR$ + /* stat a URL */ + int (*url_stat)(php_stream_wrapper *wrapper, char *url, php_stream_statbuf *ssb TSRMLS_DC); + /* open a "directory" stream */ + php_stream *(*dir_opener)(php_stream_wrapper *wrapper, char *filename, char *mode, + int options, char **opened_path, php_stream_context *context STREAMS_DC TSRMLS_DC); + + const char *label; + + /* Delete/Unlink a file */ + int (*unlink)(php_stream_wrapper *wrapper, char *url, int options, php_stream_context *context TSRMLS_DC); + } php_stream_wrapper_ops; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-filter"> + <refnamediv> + <refname>struct php_stream_filter</refname> + <refpurpose>Conserve les proprits et le pointeur de filtre</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + struct _php_stream_filter { + php_stream_filter_ops *fops; + void *abstract; /* for use by filter implementation */ + php_stream_filter *next; + php_stream_filter *prev; + int is_persistent; + + /* link into stream and chain */ + php_stream_filter_chain *chain; + + /* buffered buckets */ + php_stream_bucket_brigade buffer; + } php_stream_filter; + </programlisting> + </refsect1> + </refentry> + <refentry id="streams.struct-php-stream-filter-ops"> + <refnamediv> + <refname>struct php_stream_filter_ops</refname> + <refpurpose>Conserver les fonctions membres pour un filtre de flt</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <programlisting role="c"> + typedef struct _php_stream_filter_ops { + php_stream_filter_status_t (*filter)( + php_stream *stream, + php_stream_filter *thisfilter, + php_stream_bucket_brigade *buckets_in, + php_stream_bucket_brigade *buckets_out, + size_t *bytes_consumed, + int flags + TSRMLS_DC); + + void (*dtor)(php_stream_filter *thisfilter TSRMLS_DC); + + const char *label; +} php_stream_filter_ops; </programlisting> </refsect1> </refentry> Index: phpdoc-fr/chapters/tutorial.xml diff -u phpdoc-fr/chapters/tutorial.xml:1.7 phpdoc-fr/chapters/tutorial.xml:1.8 --- phpdoc-fr/chapters/tutorial.xml:1.7 Tue Feb 18 04:38:54 2003 +++ phpdoc-fr/chapters/tutorial.xml Mon May 19 21:57:08 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <chapter id="tutorial"> <title>Une introduction à PHP</title> @@ -74,8 +74,19 @@ </html> ]]> </programlisting> + <simpara> + Utilisez votre navigateur pour accéder au fichier via votre serveur web, + en ajoutant le nom de fichier "/bonjour.php". Si vous développez localement, + votre URL ressemblera à <literal>http://localhost/bonjour.php</literal> + ou encore <literal>http://127.0.0.1/hello.php</literal> mais cela dépend + de la configuration de votre serveur web. Bien que cela soit hors du contexte + de ce tutoriel, étudiez <varname>DocumentRoot</varname> et + <varname>ServerName</varname> dans le fichier de configuration de votre + serveur web (sous Apache, c'est &httpd.conf;). + Si ceci est configuré correctement, le fichier sera analysé par &php; et + le résultat suivant sera affiché : + </simpara> <para> - Le résultat de ce script sera : <screen role="html"> <![CDATA[ <html>