cvs: phpdoc-fr /chapters config.xml install.apache.xml install.apache2.xml install.caudium.xml install.commandline.xml install.configure.databases.xml
install.configure.graphics.xml install.configure.misc.xml install.configure.php.xml install.configure.servers.xml install.configure.xml
install.configure.xml.xml install.fhttpd.xml install.general.xml install.hpux.xml install.iis.xml install.iplanet.xml install.linux.xml
install.macosx.xml install.omnihttpd.xml install.openbsd.xml install.oreilly.xml install.otherhttpd.xml install.problems.xml install.sambar.xml
install.solaris.xml install.unix.xml install.windows.xml install.xitami.xml install.xml streams.common.xml streams.constants.xml streams.dir.xml
streams.file.xml streams.socket.xml streams.structs.xml streams.xml tutorial.xml

From: Date: Thu, 30 Jan 2003 13:44:44 +0000
Subject: cvs: phpdoc-fr /chapters config.xml install.apache.xml install.apache2.xml install.caudium.xml install.commandline.xml install.configure.databases.xml
install.configure.graphics.xml install.configure.misc.xml install.configure.php.xml install.configure.servers.xml install.configure.xml
install.configure.xml.xml install.fhttpd.xml install.general.xml install.hpux.xml install.iis.xml install.iplanet.xml install.linux.xml
install.macosx.xml install.omnihttpd.xml install.openbsd.xml install.oreilly.xml install.otherhttpd.xml install.problems.xml install.sambar.xml
install.solaris.xml install.unix.xml install.windows.xml install.xitami.xml install.xml streams.common.xml streams.constants.xml streams.dir.xml
streams.file.xml streams.socket.xml streams.structs.xml streams.xml tutorial.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-176@lists.php.net to get a copy of this message
dams Thu Jan 30 08:44:44 2003 EDT Added files: /phpdoc-fr/chapters install.apache.xml install.apache2.xml install.caudium.xml install.commandline.xml install.configure.databases.xml install.configure.graphics.xml install.configure.misc.xml install.configure.php.xml install.configure.servers.xml install.configure.xml install.configure.xml.xml install.fhttpd.xml install.general.xml install.hpux.xml install.iis.xml install.iplanet.xml install.linux.xml install.macosx.xml install.omnihttpd.xml install.openbsd.xml install.oreilly.xml install.otherhttpd.xml install.problems.xml install.sambar.xml install.solaris.xml install.unix.xml install.windows.xml install.xitami.xml streams.common.xml streams.constants.xml streams.dir.xml streams.file.xml streams.socket.xml streams.structs.xml streams.xml Modified files: /phpdoc-fr/chapters install.xml config.xml tutorial.xml Log: late winter update

Index: phpdoc-fr/chapters/install.xml diff -u /dev/null phpdoc-fr/chapters/install.xml:1.39 --- /dev/null Thu Jan 30 08:44:44 2003 +++ phpdoc-fr/chapters/install.xml Thu Jan 30 08:44:43 2003 @@ -0,0 +1 @@ +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.39 $ --><chapter id="installation"> <title>Installation</title> &install.general; &install.unix; &install.linux; &install.hpux; &install.solaris; &install.openbsd; &install.macosx; &install.configure; &install.windows; &install.apache; &install.apache2; &install.commandline; &install.fhttpd; &install.caudium; &install.iis; &install.iplanet; &install.omnihttpd; &install.oreilly; &install.xitami; &install.otherhttpd; &install.problems;</chapter><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tindent-tabs-mode:nilsgml-parent-document:nilsgml-default-dtd-file:"../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:--> \ No newline at end of file Index: phpdoc-fr/chapters/config.xml diff -u phpdoc-fr/chapters/config.xml:1.19 phpdoc-fr/chapters/config.xml:1.20 --- phpdoc-fr/chapters/config.xml:1.19 Sat Jan 18 20:37:36 2003 +++ phpdoc-fr/chapters/config.xml Thu Jan 30 08:44:43 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> @@ -394,7 +394,7 @@ </simpara> </listitem> </varlistentry> - <varlistentry id="allow-call-time-pass-reference"> + <varlistentry id="ini.allow-call-time-pass-reference"> <term> <parameter>allow_call_time_pass_reference</parameter> <type>boolean</type> @@ -417,7 +417,7 @@ </listitem> </varlistentry> - <varlistentry id="expose-php"> + <varlistentry id="ini.expose-php"> <term> <parameter>expose_php</parameter> <type>boolean</type> @@ -614,7 +614,7 @@ </listitem> </varlistentry> - <varlistentry id="arg-separator.input"> + <varlistentry id="ini.arg-separator.input"> <term> <parameter>arg_separator.input</parameter> <type>string</type> @@ -1065,7 +1065,7 @@ </listitem> </varlistentry> - <varlistentry id="fastcgi.impersonate"> + <varlistentry id="ini.fastcgi.impersonate"> <term> <parameter>fastcgi.impersonate</parameter> <type>string</type> Index: phpdoc-fr/chapters/tutorial.xml diff -u phpdoc-fr/chapters/tutorial.xml:1.4 phpdoc-fr/chapters/tutorial.xml:1.5 --- phpdoc-fr/chapters/tutorial.xml:1.4 Sat Jan 18 18:41:44 2003 +++ phpdoc-fr/chapters/tutorial.xml Thu Jan 30 08:44:44 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <chapter id="tutorial"> <title>Une introduction &agrave; PHP</title> @@ -35,6 +35,22 @@ vous allez utiliser des balises magiques, qui feront beaucoup de choses pour vous. </para> + <para> + Supposons que vous souhaitiez &eacute;conomiser du temps en ligne et travailler + localement. Dans ce cas, vous devez installer un serveur web comme + <link linkend="install.apache">Apache</link>, et bien sur + <ulink url="&url.php.downloads;">PHP</ulink>. Vous souhaiterez + aussi installer une base de donn&eacute;es comme par exemple + <ulink url="&url.mysql.docs;">MySQL</ulink>. Vous pouvez + installer ces logiciels individuellement, ou bien avec + <ulink url="&url.installkits;">des installeurs</ulink> + qui prennent en charge l'ensemble de l'installation en quelques + clics. Il est facile de configurer un serveur web avec le support + de &php; sur n'importe quel syst&egrave;me d'exploitation, y compris + Linux et Windows. Sous Linux, vous pouvez aussi trouver + des commandes comme <ulink url="&url.rpmfind;">rpmfind</ulink>, + tr&egrave;s pratique pour rechercher les paquets pr&eacute; compil&eacute;s. + </para> </sect1> <sect1 id="tutorial.firstpage"> @@ -98,7 +114,8 @@ <ulink url="&url.php.downloads;">t&eacute;l&eacute;chargements</ulink>. Vous pouvez d&eacute;velopper en PHP, localement, sur tous les syst&egrave;mes d'exploitation. N'oubliez pas d'installer aussi un serveur - web appropri&eacute;. + web appropri&eacute;. Si le probl&egrave;me persiste, n'h&eacute;sitez pas &agrave; + utiliser l'une des options de <ulink url="&url.php.support;">support</ulink>. </para> <para> Le point important de cet exemple &eacute;tait de montrer le format des Index: phpdoc-fr/chapters/install.apache.xml +++ phpdoc-fr/chapters/install.apache.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.apache"> <title>Installation avec le serveur Apache</title> <para> Cette section contient des notes sp&eacute;cifiques pour l'installation de PHP avec Apache, aussi bien pour la version <link linkend="install.apache.unix">Unix</link> que <link linkend="install.apache.windows">Windows</link>. </para> <sect2 id="install.apache.unix"> <title>D&eacute;tails pour l'installation de PHP sous Apache sous Unix.</title> <simpara> Il y a deux m&eacute;thodes d'installation de PHP avec Apache 1.3.x 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&ecirc;ter le serveur Apache, et &eacute;diter le fichier <filename>srm.conf</filename> ou <filename>httpd.conf</filename>, pour configurer Apache avec PHP. </simpara> <para> Vous pouvez s&eacute;lectionner des options &agrave; ajouter au fichier <command>configure</command> &agrave; la ligne 8 depuis la <link linkend="install.configure">liste compl&egrave;te des options de configuration</link>. </para> <example id="install.apache.unix.longer"> <title>Instructions d'installation avec Apache (version module)</title> <programlisting> 1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar 3. gunzip php-x.x.x.tar.gz 4. tar xvf php-x.x.x.tar 5. cd apache_1.3.x 6. ./configure --prefix=/www 7. cd ../php-x.x.x 8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars 9. make 10. make install 11. cd ../apache_1.3.x 12. for PHP 3: ./configure --activate-module=src/modules/php3/libphp3.a for PHP 4: ./configure --activate-module=src/modules/php4/libphp4.a 13. make 14. make install Au lieu de cette &eacute;tape, vous pouvez aussi copier le binaire httpd et remplacer votre ex&eacute;cutable actuel. Assurez-vous tout de m&ecirc;me que le serveur est bien &eacute;teint. 15. cd ../php-x.x.x 16. for PHP 3: cp php3.ini-dist /usr/local/lib/php3.ini for PHP 4: cp php.ini-dist /usr/local/lib/php.ini Vous pouvez &eacute;diter votre fichier php.ini pour modifier certaines options PHP. Si vous pr&eacute;f&eacute;rez placer ce fichier ailleurs, utilisez --with-config-file-path=/path lors de l'&eacute;tape 8. 17. Editez votre fichier httpd.conf ou srm.conf file et ajoutez : Pour PHP 3: AddType application/x-httpd-php3 .php3 Pour PHP 4: AddType application/x-httpd-php .php Vous pouvez choisir n'importe quelle extension que vous voulez ici. .php est uniquement une suggestion. Vous pouvez aussi inclure .html. 18. Utilisez votre proc&eacute;dure habituelle pour d&eacute;marrer votre serveur Apache. (vous devez l'&eacute;teindre et le red&eacute;marrer, pas seulement lui envoyer un signal HUP ou USR1.) </programlisting> </example> <para> Suivant votre installation d'Apache et votre variante d'Unix, il existe de nombreuses fa&ccedil;ons d'arr&ecirc;ter et red&eacute;marrer Apache. Voici une liste des commandes typiques, pour diff&eacute;rentes installations. Remplacez <literal>/path/to/</literal> par le chemin d'acc&egrave;s &agrave; vos applications sur votre syst&egrave;me. <example> <title>Red&eacute;marrage d'apache</title> <programlisting> 1. Nombreuses variantes Linux SysV : /etc/rc.d/init.d/httpd restart 2. Avec les scripts apachectl : /path/to/apachectl stop /path/to/apachectl start 3. httpdctl et httpsdctl (utilisant OpenSSL), similaire &agrave; apachectl: /path/to/httpsdctl stop /path/to/httpsdctl start 4. En utilisant mod_ssl, ou un autre seveur SSL, manuellement : /path/to/apachectl stop /path/to/apachectl startssl </programlisting> </example> Les ex&eacute;cutables apachectl et http(s)dctl peuvent &ecirc;tre situ&eacute;s dans diff&eacute;rents dossiers. Si votre syst&egrave;me a <literal>locate</literal> ou <literal>whereis</literal> ou <literal>which</literal>, utilisez-les pour retrouver vos programmes. </para> <para> Diff&eacute;rents exemples de compilation PHP pour Apache suivent : <example> <title>Compilation sur Apache avec l'extension PostGreSQL</title> <programlisting role="shell"> <![CDATA[ /configure --with-apxs --with-pgsql ]]> </programlisting> </example> </para> <para> Cette commande va cr&eacute;er une librairie partag&eacute;e <filename>libphp4.so</filename> qui sera charg&eacute;e par Apache avec une ligne LoadModule dans le fichier <filename>httpd.conf</filename>. Le support PostgreSQL est aussi inclut dans <filename>libphp4.so</filename>. </para> <para> <example> <title>Compilation sur Apache avec l'extension PostGreSQL (librairie partag&eacute;e)</title> <programlisting> <![CDATA[ /configure --with-apxs --with-pgsql=shared ]]> </programlisting> </example> </para> <para> Cette commande va cr&eacute;er une librairie partag&eacute;e <filename>libphp4.so</filename> pour Apache, mais va aussi cr&eacute;er la librairie partag&eacute;e <filename>pgsql.so</filename> qui sera charg&eacute;e dans PHP avec une directive du fichier &php.ini; file ou en la chargeant explicitement dans le script avec la fonction <function>dl</function>. </para> <para> <example> <title>Compilation sur Apache avec l'extension PostGreSQL (2)</title> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql ]]> </programlisting> </example> </para> <para> Cette commande va cr&eacute;er une autre librairie partag&eacute;e <filename>libmodphp4.a</filename>, un fichier <filename>mod_php4.c</filename> et quelques fichiers compagnons dans le dossier <literal>src/modules/php4</literal> de dossier Apache. Puis, vous devez compiler Apache avec <literal>--activate-module=src/modules/php4/libphp4.a</literal> et le syst&egrave;me de compilation d'Apache va cr&eacute;er un fichier <filename>libphp4.a</filename> et le lien statiquement avec <filename>httpd</filename>. Le support PostgreSQL est alors inclut directement dans l'ex&eacute;cutable <filename>httpd</filename>, ce qui fait que le r&eacute;sultat final est un fichier unique <filename>httpd</filename>, qui inclut Apache et PHP. </para> <para> <example> <title>Compilation sur Apache avec l'extension PostGreSQL (2) (librairie partag&eacute;e)</title> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql=shared ]]> </programlisting> </example> </para> <para> Identique &agrave; la version pr&eacute;c&eacute;dente, mais au lieu d'inclure le support PostgreSQL directement dans l'ex&eacute;cutable final <filename>httpd</filename>, vous allez obtenir une librairie partag&eacute;e <filename>pgsql.so</filename> que vous pouvez charger dans PHP soit gr&acirc;ce au fichier de configuration &php.ini; ou dynamiquement avec <function>dl</function>. </para> <para> Lorsque vous faites le choix entre les diff&eacute;rents modes de compilation de PHP, vous devez prendre en compte leurs avantages et inconv&eacute;nients respectifs. Les objets partag&eacute;s permettent de compiler PHP et Apache de mani&egrave;re s&eacute;par&eacute;e, et vous n'aurez pas &agrave; compiler l'ensemble pour faire &eacute;voluer PHP. La compilation statique permet de charger et d'&eacute;x&eacute;cuter plus rapidement PHP. Pour plus d'informations, voyez la page web sur le <ulink url="&url.apachedso;">support des DSO</ulink>. </para> <note> <para> Le fichier de configuation d'Apache actuel est fourni avec une section qui ressemble &agrave; ceci : <informalexample> <programlisting> <![CDATA[ User nobody Group "#-1" ]]> </programlisting> </informalexample> A moins que vous ne changiez cette valeur par <literal>Group nogroup</literal> ou quelques chose comme &ccedil;a (<literal>Group daemon</literal> est aussi classique), PHP ne sera pas capable d'ouvrir des fichiers. </para> </note> <note> <para> Assurez vous que vous sp&eacute;cifiez la version install&eacute;e de apxs avec l'option --with-apxs=/path/to/apxs. Vous ne devez PAS utiliser la version d'apxs qui dans les sources d'Apache, mais celle qui est r&eacute;ellement install&eacute;e sur votre syst&egrave;me. </para> </note> </sect2> <sect2 id="install.apache.windows"> <title>Installer PHP sous Windows avec Apache 1.3.x</title> <simpara> Il y a deux m&eacute;thodes pour faire fonctionner PHP avec Apache 1.3.x sous Windows. La premi&egrave;re est d'utiliser l'ex&eacute;cutable CGI (php.exe), l'autre est d'utiliser les modules Apache DLL. Dans les deux cas, vous devez arr&ecirc;ter le serveur Apache, &eacute;diter votre fichier <literal>srm.conf</literal> ou <literal>httpd.conf</literal> pour configurer Apache. </simpara> <simpara> Bien qu'il puisse y avoir quelques diff&eacute;rences de configurations de PHP sous Apache, le processus reste simple et &agrave; la port&eacute;e du n&eacute;ophyte. Reportez-vous aux documentations Apache pour plus de d&eacute;tails sur ces directives. </simpara> <para> Si vous avez d&eacute;zipp&eacute; le package dans <filename>C:\PHP\</filename> comme indiqu&eacute; dans <link linkend="install.windows.manual">Instructions G&eacute;n&eacute;rales d'installation</link>, vous devez ins&eacute;rer les lignes suivantes dans votre fichier <literal>srm.conf</literal> ou <literal>httpd.conf</literal> pour qu'il fonctionne en CGI : <itemizedlist> <listitem> <simpara> <literal> ScriptAlias /php/ "c:/php/" </literal> </simpara> </listitem> <listitem> <simpara> <literal> AddType application/x-httpd-php .php .phtml </literal> </simpara> </listitem> <listitem> <simpara> <literal> Action application/x-httpd-php "/php/php.exe" </literal> </simpara> </listitem> </itemizedlist> N'oubliez pas de red&eacute;marrer le serveur, avec la commande <literal>NET STOP APACHE</literal> suivie de <literal>NET START APACHE</literal>. </para> <warning> <para> En utilisant la configuration en CGI, votre serveur sera ouvert &agrave; plusieurs attaques potentielles. Lisez donc la section <link linkend="security.cgi-bin">s&eacute;curit&eacute; des CGI</link> pour savoir comment vous en d&eacute;fendre. </para> </warning> <para> Si vous voulez utiliser PHP comme module Apache, vous devez d&eacute;placer le fichier <filename>php4ts.dll</filename> dans le dossier <filename>windows/system</filename> (pour Windows 9x/Me) ou <filename>winnt/system32</filename> (pour Windows NT/2000), en &eacute;crasant les anciennes versions. Puis, vous devez ajouter les deux lignes suivantes dans le fichier de configuration Apache : <itemizedlist> <listitem> <simpara> <literal> LoadModule php4_module c:/php/sapi/php4apache.dll </literal> </simpara> </listitem> <listitem> <simpara> <literal> AddType application/x-httpd-php .php .phtml </literal> </simpara> </listitem> </itemizedlist> </para> <simpara> Apr&egrave;s avoir modifi&eacute; le fichier de configuration, pensez &agrave; red&eacute;marrer le serveur web, par exemple avec <literal>NET STOP APACHE</literal> suivi de <literal>NET START APACHE</literal>, si vous utilisez Apache comme service Windows, ou bien utilisez les alias classiques. </simpara> <note> <simpara> 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>). 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 the <literal>ClearModuleList</literal> directive is defined. Failure to do this may mean PHP will not be registered as an Apache module. </simpara> </note> <simpara> Il y a deux m&eacute;thodes pour utiliser la fonctionnalit&eacute; de coloration syntaxique, elles d&eacute;pendent de votre installation. Si vous avez configur&eacute; Apache comme module ISAPI, alors il suffit d'ajouter la ligne suivante dans votre fichier de configuration : <literal>AddType application/x-httpd-php-source .phps</literal> </simpara> <simpara> Si vous choisissez de configurer Apache pour utiliser PHP comme ex&eacute;cutable CGI, vous aurez besoin de la fonction <function>show_source</function>. Pour cela, cr&eacute;ez simplement un script PHP et ajoutez-y le code suivant : <literal>&lt;?php show_source ("original_php_script.php"); ?></literal>. Substitutez <literal>original_php_script.php</literal> par le nom du fichier que vous souhaitez afficher. </simpara> <note> <simpara> Sous Win-Apache tous les antislash des noms de chemins tels que "<filename>c:\directory\file.ext</filename>", doivent &ecirc;tre convertis en slash c'est &agrave; dire "c:/directory/file.ext". </simpara> </note> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.apache2.xml +++ phpdoc-fr/chapters/install.apache2.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.apache2"> <title>Installation avec les serveurs Apache 2.0</title> <para> Cette section contient les notes et conseils d'installation de &php; avec le serveur Apache 2.0, aussi bien pour <link linkend="install.apache2.unix">Unix</link> que pour <link linkend="install.apache2.windows">Windows</link> versions. </para> <warning> <para> N'utilisez pas Apache 2.0 et &php; sur un serveur de production, ni sur Windows, ni sur Unix. </para> </warning> <para> Il est tr&egrave;s recommand&eacute; de lire la <ulink url="&url.apache2.docs;">Documentation Apache</ulink> pour avoir une meilleure connaissance du serveur web Apache 2.0. </para> <sect2 id="compat.apache2"> <title>Notes sur la compatibilit&eacute; de PHP avec Apache 2.0</title> <para> Les versions de &php; suivantes sont reconnues pour fonctionner avec la plus r&eacute;cente version d'Apache 2.0 : <itemizedlist spacing="compact"> <listitem> <simpara> PHP 4.3.0 ou plus r&eacute;cent, disponible &agrave; <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. </simpara> </listitem> <listitem> <simpara> Les derni&egrave;res versions de d&eacute;veloppement. Le code source est disponbile &agrave; <ulink url="&url.php.snapshots;php4-latest.tar.gz">&url.php.snapshots;php4-latest.tar.gz</ulink>, et les ex&eacute;cutables compil&eacute;s de Windows &agrave; <ulink url="&url.php.snapshots;win32/php4-win32-latest.zip">&url.php.snapshots;win32/php4-win32-latest.zip</ulink>. </simpara> </listitem> <listitem> <simpara> une version non-stable, t&eacute;l&eacute;chargeable sur <ulink url="&url.php.prerelease;">&url.php.prerelease;</ulink>. </simpara> </listitem> <listitem> <simpara> Vous pouvez obtenir &php; sur le <ulink url="&url.php.anoncvs;">serveur CVS anonyme</ulink>. </simpara> </listitem> </itemizedlist> Ces versions de &php; sont compatible avec Apache 2.0.40 et plus r&eacute;cent. </para> <note> <simpara> Le supoprt des SAPI d'Apache 2.0 a commenc&eacute; avec PHP 4.2.0. PHP 4.2.3 est connu pour fonctionner avec 2.0.39. N'essayez pas d'utiliser cette version de &php; avec une autre version d'Apache 2.0. Nous ne recommandons pas l'utilisation de PHP 4.2.3 avec Apache 2.0.39. </simpara> <simpara> Toutes les versions mentionn&eacute;es de &php; fonctionnent avec Apache 1.3.x. </simpara> </note> </sect2> <sect2 id="install.apache2.unix"> <title>Installer PHP et Apache 2 sur Linux</title> <para> T&eacute;l&eacute;chargez la plus r&eacute;cente version de <ulink url="&url.apache;">Apache 2.0</ulink> et une version appropri&eacute;e de &php;, tel que d&eacute;crit ci-dessus. Ce guide rapide couvre les manipulations de base, n&eacute;cessaire &agrave; l'installation de Apache 2.0 et &php;. Pour plus d'informations, lisez la <ulink url="&url.apache2.docs;">Documentation Apache</ulink>. Les num&eacute;ros de version sont omis ici, poru s'assurer que les instructions ne soient pas incorrectes. Il faudra donc remplacer les s&eacute;quences 'NN' avec les valeurs correctes que vous utilisez. </para> <example> <title>Instruction d'installation (Module partag&eacute; Apache 2)</title> <screen> <![CDATA[ 1. gzip -d httpd-2_0_NN.tar.gz 2. tar xvf httpd-2_0_NN.tar 3. gunzip php-NN.tar.gz 4. tar -xvf php-NN.tar 5. cd httpd-2_0_NN 6. ./configure --enable-so 7. make 8. make install Maintenant, vous avez un dossier Apache 2.0.NN install&eacute; dans /usr/local/apache2, configur&eacute; avec le support des modules dynamiques, et le pr&eacute;fork standard MPM. Pour tester l'installation, utilisez votre proc&eacute;dure standard de d&eacute;marrage d'Apache : /usr/local/apache2/bin/apachectl start et pour stopper le serveur, utiliser /usr/local/apache2/bin/apachectl stop. 9. cd ../php4-NN 10. ./configure --with-apxs2=/usr/local/apache2/bin/apxs 11. make 12. make install 13. cp php.ini-dist /usr/local/lib/php.ini Editez votre fichier php.ini pour configurer les options PHP. Si vous pr&eacute;f&eacute;rez placez ce fichier &agrave; un autre endroit, utilisez l'option --with-config-file-path=/path en &eacute;tape 10. 14. Edites votre fichier httpd.conf et v&eacute;rifiez la pr&eacute;sence des lignes suivantes : LoadModule php4_module modules/libphp4.so AddType application/x-httpd-php .php Vous pouvez installer toutes les extensions que vous souhaitez. .php est simplement celle que nous sugg&eacute;rons. Le chemin sur la driot de la directive LoadModule doit indiquer le chemin du module PHP de votre syst&egrave;me. La directive ci-dessus est correcte si vous avez suivi les autres &eacute;tapes &agrave; la lettre. 15. Utilisez votre proc&eacute;dure standard pour red&eacute;marrer Apache : /usr/local/apache2/bin/apachectl start ]]> </screen> </example> <para> Suivez les &eacute;tapes ci-dessus, et vous disposerez d'un serveur Apache 2.0 avec le support de &php; module comme module SAPI. Bien sur, il y a bien d'autres options de configuration disponibles pour les deux logiciels, Apache et &php;. Pour plus de d&eacute;tails, utilisez la commande <command>./configure --help</command> dans le dossier de souces appropri&eacute;. Si vous souhaitez compiler uen version multi-thread&eacute; de Apache 2.0 vous devrez remplacer le module standard MPM <filename>prefork</filename> avec <filename>worker</filename> ou <filename>perchild</filename>. Pour ce faire, ajoutez &agrave; la ligne de configuration de l'&eacute;tape 6, l'option <option role="configure">--with-mpm=worker</option> ou <option role="configure">--with-mpm=perchild</option>. Soyez conscient des cons&eacute;quences, et comprenez bien ce que vous faites. Pour plus de d&eacute;tails sur ce sujet, lisez la documentation Apache sur <ulink url="&url.apache2.mpm;">le module MPM</ulink>. </para> <note> <para> Pour compiler une version multi-thread&eacute;e d'Apache, votre syst&egrave;me doit supporter les threads. Cela implique aussi de compiler &php; avec le module exp&eacute;rimental de Zend Thread Safety (ZTS). Par cons&eacute;quent, toutes les extensions ne seront pas disponibles. La configuration recommand&eacute;e actuellement est celle avec le module standard MPM <filename>prefork</filename>. </para> </note> </sect2> <sect2 id="install.apache2.windows"> <title>Installation de PHP et Apache 2.0 sur Windows</title> <para> Lisez donc les <ulink url="&url.apache2.windows;">notes sp&eacute;cifiques &agrave; Windows</ulink> pour Apache 2.0. </para> <warning> <para> Apache 2.0 est con&ccedil;u pour fonctionner sur Windows NT 4.0 et Windows 2000. Actuellement, le support des versions Windows 9x est incomplet. Apache 2.0 n'est pas pr&eacute;vu pour fonctionner sur ces plate-formes a ce moment. </para> </warning> <para> T&eacute;l&eacute;chargez la plus r&eacute;cente version de <ulink url="&url.apache;">Apache 2.0</ulink> et une version de PHP appropri&eacute;e, tel que mentionn&eacute; au d&eacute;but de ce chapiter. Suivez les instructions <link linkend="install.windows.manual">d'installation manuelle</link> puis revenez ici pour r&eacute;aliser l'int&eacute;gration de &php; et Apache. </para> <para> Il ya deux m&eacute;thodes pour que &php; fonctionne avec Apache 2.0 sous Windows. La premi&egrave;re est l'interface CGI, et l'autre est le module DLL APache. Dans les deux cas, commencez par stopper le serveur Apache, et &eacute;ditez le fichier <filename>httpd.conf</filename> pour configurer Apache avec le support &php;. </para> <para> Vous devez ins&eacute;rer les lignes suivantes dans le fichier <filename>httpd.conf</filename> pour r&eacute;aliser la configuration en mode <emphasis>CGI</emphasis>: <example> <title>Configurer la version de d&eacute;veloppement de PHP avec Apache 2.0 en CGI</title> <programlisting role="apache"> <![CDATA[ ScriptAlias /php/ "c:/php/" AddType application/x-httpd-php .php Action application/x-httpd-php "/php/php.exe" ]]> </programlisting> </example> </para> <note> <para> A partir de PHP 4.3.0, le nom de l'ex&eacute;cutable CGI a chang&eacute;, et il est devenu <filename>php-cgi.exe</filename>. Prenez le en compte, et utilisez la bonne directive pour Apache. </para> </note> <para> <example> <title>Configurer PHP 4.3.0 avec Apache 2.0 en CGI</title> <programlisting role="apache"> <![CDATA[ ScriptAlias /php/ "c:/php/" AddType application/x-httpd-php .php Action application/x-httpd-php "/php/php-cgi.exe" ]]> </programlisting> </example> </para> <para> Si vous souhaitez utiliser &php; comme module dans Apache 2.0, placez bien le fichier <filename>php4ts.dll</filename> dans votre dossier <filename>winnt/system32</filename>, en y &eacute;crasant tout autre fichier qui s'y trouverait. Puis vous devrez ins&eacute;rer les deux lignes suivantes dans votre fichier de configuration d'Apache <filename>httpd.conf</filename> pour y ajouter le module PHP d'Apache 2.0 : <example> <title>Configurer PHP avec Apache 2.0 en module</title> <programlisting role="apache"> <![CDATA[ LoadModule php4_module c:/php/sapi/php4apache2.dll AddType application/x-httpd-php .php ]]> </programlisting> </example> </para> <note> <para> N'oubliez pas de remplacer <filename>c:/php/</filename> par votre chemin r&eacute;el de &php; dans les exemples ci-dessus. Ne m&eacute;langez pas votre installation en module (DLL) avec <emphasis>diff&eacute;rentes versions de PHP</emphasis>. Vous avez &agrave; utiliser uniquement les DLL et extensions qui sont fournies avec la version de PHP que vous t&eacute;l&eacute;chargez. </para> </note> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.caudium.xml +++ phpdoc-fr/chapters/install.caudium.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.caudium"> <title>Installation sur le serveur Caudium</title> <para> PHP 4 peut &ecirc;tre compil&eacute; comme module Pike pour <ulink url="&url.caudium;">le serveur web Caudium</ulink>. Notez que ce mode n'est pas support&eacute; en PHP 3. Suivez simplement les instructions suivantes pour installer PHP 4 sur un serveur Caudium. </para> <example id="install.caudium.instructions"> <title>Instructions d'installation Caudium</title> <programlisting> 1. Assurez-vous que vous avez un serveur Caudium install&eacute; avant de tenter l'installation PHP 4. Pour que PHP 4 fonctionne correctement, vous devez installer Pike 7.0.268 ou plus r&eacute;cent. Pour cet exemple, nous supposerons que vous avez install&eacute; Caudium dans le dossier /opt/caudium/server/. 2. Renommez le dossier en php-x.y.z (o&ugrave; x.y.z est le num&eacute;ro de version). 3. ./configure --with-caudium=/opt/caudium/server 4. make 5. make install 6. Red&eacute;marrez Caudium s'il &eacute;tait en fonctionnement 7. Connectez-vous &agrave; l'interface de configuration graphique et allez dans le serveur virtuel auquel vous voulez ajouter le support PHP. 8. Cliquez sur "Add Module" et recherchez puis ajoutez le module "PHP 4 Script Support". 9. Si la documentation dit que 'PHP 4 interpreter isn't available', assurez-vous que vous avez bien red&eacute;marr&eacute; le serveur. Si vous l'avez fait, v&eacute;rifiez le fichier /opt/caudium/logs/debug/default.1 : il contient peut-&ecirc;tre des erreurs li&eacute;es &agrave; PHP4.so. De m&ecirc;me, assurez-vous que caudium/server/lib/[pike-version]/PHP4.so est pr&eacute;sent. 10. Configurez le module "PHP Script Support" si n&eacute;cessaire. </programlisting> </example> <para> Vous pouvez bien s&ucirc;r compiler votre module Caudium avec les diverses extensions disponibles. Voyez la <link linkend="install.configure">liste compl&egrave;te des options de configuration</link> pour une liste exhaustive. </para> <note> <para> Lorsque vous ajoutez le support MySQL &agrave; PHP 4, vous devez-vous assurer que le client MySQL normal est utilis&eacute;. Sinon, il peut y avoir des conflits avec Pike, qui dispose d&eacute;j&agrave; du support MySQL. Vous pouvez le faire en sp&eacute;cifiant le dossier d'installation de MySQL gr&acirc;ce &agrave; l'option <option role="configure">--with-mysql</option>. </para> </note> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.commandline.xml +++ phpdoc-fr/chapters/install.commandline.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.commandline"> <title>CGI/ Installation pour ex&eacute;cution en ligne de commande</title> <para> Par d&eacute;faut, PHP est compil&eacute; comme une CGI. Si PHP peut &ecirc;tre incorpor&eacute; au serveur web que vous utilisez en tant que module, de mani&egrave;re g&eacute;n&eacute;rale c'est cette solution que vous devriez adopter pour des raisons de performances. Cependant, la version CGI permet aux utilisateurs de lancer des scripts PHP sous leur UID respectives. Lisez attentivement le chapitre consacr&eacute; &agrave; la <link linkend="security">s&eacute;curit&eacute;</link> si vous souhaitez utiliser cette solution. </para> <sect2 id="install.commandline.testing"> <title>Tests</title> <simpara> Si vous avez compil&eacute; PHP comme programme CGI, vous pouvez tester votre produit en tapant : <command>make test</command>. C'est toujours une bonne chose de tester le r&eacute;sultat d'une compilation. Cela vous permet de rep&eacute;rer des probl&egrave;mes entre PHP et votre plate-forme, bien plus facilement que si vous attendez. </simpara> </sect2> <sect2 id="install.commandline.benchmarking"> <title>Performances</title> <simpara> Si vous avez compil&eacute; PHP comme programme CGI, vous pouvez &eacute;valuer les performances de PHP 3 avec la commande <command>make bench</command>. Notez que si le &safemode; est activ&eacute; (par d&eacute;faut), vous ne risquez pas de voir l'&eacute;valuation s'arr&ecirc;ter une fois les 30 secondes r&eacute;glementaires &eacute;coul&eacute;es. En effet, la fonction <function>set_time_limit</function> ne peut pas &ecirc;tre utilis&eacute;e si le &safemode; fonctionne. Utilisez l'option <link linkend="ini.max-execution-time">max_execution_time</link> pour contr&ocirc;ler le temps d'&eacute;x&eacute;cution de vos scripts. <command>make bench</command> ignore le fichier de <link linkend="configuration.file">configuration file</link>. </simpara> <note> <simpara> <command>make bench</command> n'est disponible qu'en PHP 3. </simpara> </note> </sect2> <sect2 id="install.commandline.using-variables"> <title>Utiliser les variables pr&eacute;d&eacute;finies</title> <simpara> Certaines variables d'environnements fournies par les serveurs web ne sont pas disponibles dans les sp&eacute;cifications actuelles <ulink url="&url.cgispec;">CGI/1.1 specification</ulink>. Seules, les variables suivantes sont d&eacute;finies, et les autres doivent &ecirc;tre consid&eacute;r&eacute;es comme sp&eacute;cifiques aux serveurs web : AUTH_TYPE, CONTENT_LENGTH, CONTENT_TYPE, GATEWAY_INTERFACE, PATH_INFO, PATH_TRANSLATED, QUERY_STRING, REMOTE_ADDR, REMOTE_HOST, REMOTE_IDENT, REMOTE_USER, REQUEST_METHOD, SCRIPT_NAME, SERVER_NAME, SERVER_PORT, SERVER_PROTOCOL et SERVER_SOFTWARE </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.configure.databases.xml +++ phpdoc-fr/chapters/install.configure.databases.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.databases"> <title>Options bases de donn&eacute;es</title> <variablelist> <varlistentry id="install.configure.with-dbplus"> <term> <parameter>--with-dbplus</parameter> </term> <listitem> <para> Inclut le support dbplus. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-adabas"> <term> <parameter>--with-adabas[=DIR]</parameter> </term> <listitem> <para> Inclut le support Adabas D. DIR est le dossier d'installation d'Adabas D. Par d&eacute;faut, c'est /usr/local. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-sapdb"> <term> <parameter>--with-sapdb[=DIR]</parameter> </term> <listitem> <para> Inclut le support SAP DB. DIR est le dossier d'installation de SAP DB. Par d&eacute;faut, c'est /usr/local. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-solid"> <term> <parameter>--with-solid[=DIR]</parameter> </term> <listitem> <para> Inclut le support Solid. DIR est le dossier d'installation de Solid. Par d&eacute;faut, c'est /usr/local/solid. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ibm-db2"> <term> <parameter>--with-ibm-db2[=DIR]</parameter> </term> <listitem> <para> Inclut le support IBM DB2. DIR est le dossier d'installation de DB2. Par d&eacute;faut, c'est /home/db2inst1/sqllib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-empress"> <term> <parameter>--with-empress[=DIR]</parameter> </term> <listitem> <para> Inclut le support Empress. DIR est le dossier d'installation de Empress. Par d&eacute;faut, c'est $EMPRESSPATH. Depuis PHP4, cette option ne supporte que Empress Version 8.60 et plus r&eacute;cent. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-empress-bcs"> <term> <parameter>--with-empress-bcs[=DIR]</parameter> </term> <listitem> <para> Inclut le support Empress Local Access. DIR est le dossier d'installation de Empress. Par d&eacute;faut, c'est $EMPRESSPATH. Depuis PHP4, cette option ne supporte que Empress Version 8.60 et plus r&eacute;cent. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-birdstep"> <term> <parameter>--with-birdstep[=DIR]</parameter> </term> <listitem> <para> Inclut le support Birdstep. DIR est le dossier d'installation de Birdstep. Par d&eacute;faut, c'est /usr/local/birdstep. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-custom-odbc"> <term> <parameter>--with-custom-odbc[=DIR]</parameter> </term> <listitem> <para> Inclut le support a user defined ODBC. DIR est le dossier d'installation d'ODBC. Par d&eacute;faut, c'est /usr/local. Assurez vous que la variable CUSTOM_ODBC_LIBS est d&eacute;finie, et que le fichier odbc.h est dans votre chemin d'inclusion, c'est &agrave; dire que vous devriez d&eacute;finir les lignes suivantes pour Sybase SQL Anywhere 5.5.00 sous QNX, avant d'utiliser le script de configuration : <![CDATA[ CPPFLAGS="-DODBC_QNX -DSQLANY_BUG" LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib -lodbc". ]]> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-iodbc"> <term> <parameter>--with-iodbc[=DIR]</parameter> </term> <listitem> <para> Inclut le support iODBC. DIR est le dossier d'installation de iODBCBirdstep. Par d&eacute;faut, c'est /usr/local. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-esoob"> <term> <parameter>--with-esoob[=DIR]</parameter> </term> <listitem> <para> Inclut le support Easysoft OOB. DIR est le dossier d'installation de OOB. Par d&eacute;faut, c'est /usr/local/easysoft/oob/client. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-unixODBC"> <term> <parameter>--with-unixODBC[=DIR]</parameter> </term> <listitem> <para> Inclut le support unixODBC. DIR est le dossier d'installation d'unixODBC. Par d&eacute;faut, c'est /usr/local. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-openlink"> <term> <parameter>--with-openlink[=DIR]</parameter> </term> <listitem> <para> Inclut le support OpenLink ODBC. DIR est le dossier d'installation OpenLink. Par d&eacute;faut, c'est /usr/local. C'est le m&ecirc;me que pour iODBC. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-dbmaker"> <term> <parameter>--with-dbmaker[=DIR]</parameter> </term> <listitem> <para> Inclut le support DBMaker. DIR est le dossier d'installation DBMaker. Par d&eacute;faut, c'est le chemin de la derni&egrave;re installation de DBMaker (par exemple /home/dbmaker/3.6). </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-unified-odbc"> <term> <parameter>--disable-unified-odbc</parameter> </term> <listitem> <para> Inactive le support de l'ODBC unifi&eacute;. Uniquement utilisable si iODBC, Adabas, Solid, Velocis ou une interface ODBC sp&eacute;ciale st activ&eacute;e. Valable uniquement pour PHP 3. </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.configure.graphics.xml +++ phpdoc-fr/chapters/install.configure.graphics.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.graphics"> <title>Options graphiques</title> <variablelist> <varlistentry id="install.configure.without-gd"> <term> <parameter>--without-gd</parameter> </term> <listitem> <para> Inactive le support de GD. PHP 3 uniquement! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-imagick"> <term> <parameter>--with-imagick</parameter> </term> <listitem> <para> Inclus le support de ImageMagick. DIR est le dossier d'installation, et par d&eacute;faut, &php; essaiera de le trouver de lui-m&ecirc;me. [exp&eacute;rimental]. PHP 3 uniquement! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ming"> <term> <parameter>--with-ming[=DIR]</parameter> </term> <listitem> <para> Inclus le support de Ming. </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.configure.misc.xml +++ phpdoc-fr/chapters/install.configure.misc.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.misc"> <title>Options diverses</title> <variablelist> <varlistentry id="install.configure.enable-force-cgi-redirect"> <term> <parameter>--enable-force-cgi-redirect</parameter> </term> <listitem> <para> Active la v&eacute;rification de s&eacute;curit&eacute; des redirections internes du serveur. Utilisez cette configuration si vous utilisez PHP comme CGI avec Apache. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-discard-path"> <term> <parameter>--enable-discard-path</parameter> </term> <listitem> <para> Si cette option est activ&eacute;e, l'ex&eacute;cutable PHP peut &ecirc;tre plac&eacute;s hors de l'arborescence web, afin que le fichier .htaccess ne soit pas contournable. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fastcgi"> <term> <parameter>--with-fastcgi=SRCDIR</parameter> </term> <listitem> <para> Compile PHP comme application FastCGI. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debug"> <term> <parameter>--enable-debug</parameter> </term> <listitem> <para> Compile PHP avec les symbole de d&eacute;bogage. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-layout"> <term> <parameter>--with-layout=TYPE</parameter> </term> <listitem> <para> Indique comment les fichiers install&eacute;s doivent &ecirc;tre rang&eacute;s. Les valeurs possibles sont Type (valeur par d&eacute;faut) et GNU. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pear"> <term> <parameter>--with-pear=DIR</parameter> </term> <listitem> <para> Installe PEAR dans le dossier DIR. Par d&eacute;faut, c'est PREFIX/lib/php. </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-pear"> <term> <parameter>--without-pear</parameter> </term> <listitem> <para> Exclut l'installation de PEAR. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sigchild"> <term> <parameter>--enable-sigchild</parameter> </term> <listitem> <para> Active le gestionnaire de SIGCHLD propre &agrave; PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-rpath"> <term> <parameter>--disable-rpath</parameter> </term> <listitem> <para> Inactive le passage de chemins suppl&eacute;mentaires pour chercher les librairies additionnelles. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-libgcc"> <term> <parameter>--enable-libgcc</parameter> </term> <listitem> <para> Active explicitement le linkage avec libgcc. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-php-streams"> <term> <parameter>--enable-php-streams</parameter> </term> <listitem> <para> Inclut le support des fl&ocirc;ts de PHP (exp&eacute;rimental). Ne pas utiliser a moins que vous ne testiez le code. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zlib-dir"> <term> <parameter>--with-zlib-dir=&lt;DIR&gt;</parameter> </term> <listitem> <para> D&eacute;finit le chemin de the location of zlib install directory. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-aspell"> <term> <parameter>--with-aspell[=DIR]</parameter> </term> <listitem> <para> Inclut le support d'ASPELL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ccvs"> <term> <parameter>--with-ccvs[=DIR]</parameter> </term> <listitem> <para> Inclut le support de CCVS. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cybercash"> <term> <parameter>--with-cybercash[=DIR]</parameter> </term> <listitem> <para> Inclut le support de CyberCash. DIR est le dossier d'installation de CyberCash MCK. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-icap"> <term> <parameter>--with-icap[=DIR]</parameter> </term> <listitem> <para> Inclut le support d'ICAP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ircg-config"> <term> <parameter>--with-ircg-config</parameter> </term> <listitem> <para> Chemin jusqu'au script de configuration ircg-config. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ircg"> <term> <parameter>--with-ircg</parameter> </term> <listitem> <para> Inclut le support de ircg. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-mailparse"> <term> <parameter>--enable-mailparse</parameter> </term> <listitem> <para> Active le support de mailparse. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-muscat"> <term> <parameter>--with-muscat[=DIR]</parameter> </term> <listitem> <para> Inclut le support de muscat. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-satellite"> <term> <parameter>--with-satellite[=DIR]</parameter> </term> <listitem> <para> Active le support exp&eacute;rimental de CORBA via Satellite. DIR est le dossier d'installation d'ORBit. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-trans-sid"> <term> <parameter>--enable-trans-sid</parameter> </term> <listitem> <para> Active la propagation transparente des sessions. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-system-regex"> <term> <parameter>--with-system-regex</parameter> </term> <listitem> <para> Utilise la librairie d'expression r&eacute;guli&egrave;res du syst&egrave;me (obsol&egrave;te). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-vpopmail"> <term> <parameter>--with-vpopmail[=DIR]</parameter> </term> <listitem> <para> Inclut le support de vpopmail. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tsrm-pthreads"> <term> <parameter>--with-tsrm-pthreads</parameter> </term> <listitem> <para> Utilise les threads POSIX (configur&eacute; par d&eacute;faut). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> <parameter>--enable-shared[=PKGS]</parameter> </term> <listitem> <para> Compile les librairies partag&eacute;es. Par d&eacute;faut, c'est yes. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-static"> <term> <parameter>--enable-static[=PKGS]</parameter> </term> <listitem> <para> Compile les librairies statiques. Par d&eacute;faut, c'est yes. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-fast-install"> <term> <parameter>--enable-fast-install[=PKGS]</parameter> </term> <listitem> <para> Optimise pour l'installation rapide. Par d&eacute;faut, c'est yes. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gnu-ld"> <term> <parameter>--with-gnu-ld</parameter> </term> <listitem> <para> Suppose que le compilateur utilise GNU ld. Par d&eacute;faut, c'est no. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-libtool-lock"> <term> <parameter>--disable-libtool-lock</parameter> </term> <listitem> <para> Evite les verrouillages (mais cela risque de corrompre des compilations paralleles). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pic"> <term> <parameter>--with-pic</parameter> </term> <listitem> <para> Essaie d'utiliser uniquement des objets PIC/non-PIC. Par d&eacute;faut, c'est <literal>both</literal> (les deux). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-memory-limit"> <term> <parameter>--enable-memory-limit</parameter> </term> <listitem> <para> Compile PHP avec le support de la limitation de m&eacute;moire. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-url-fopen-wrapper"> <term> <parameter>--disable-url-fopen-wrapper</parameter> </term> <listitem> <para> Inactive les gestionnaires HTTP et FTP avec les fonctions d'acc&egrave;s aux fichiers. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning.php4"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> Exporte uniquement les symboles n&eacute;cessaires. Voir le fichier INSTALL pour plus de d&eacute;tails. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ismp"> <term> <parameter>--with-imsp[=DIR]</parameter> </term> <listitem> <para> Inclut le support de IMSP. DIR est le dossier d'IMSP qui contient les fichiers d'ent&ecirc;tes et le fichier libimsp.a. Valable uniquement pour PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mck"> <term> <parameter>--with-mck[=DIR]</parameter> </term> <listitem> <para> Inclut le support de Cybercash MCK. DIR est le dossier d'installation de cybercash mck. Par d&eacute;faut, c'est /usr/src/mck-3.2.0.3-linux. Pour de l'aide, regardez dans extra/cyberlib. Valable uniquement pour PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod-dav"> <term> <parameter>--with-mod-dav=DIR</parameter> </term> <listitem> <para> Inclut le support de DAV, gr&acirc;ce &agrave; l'interface Apache mod_dav. DIR est le dossier d'installation de mod_dav. Fonctionne uniquement pour la version module d'Apache. Valable uniquement pour PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debugger"> <term> <parameter>--enable-debugger</parameter> </term> <listitem> <para> Compile PHP avec les fonctionnalit&eacute;s de d&eacute;bogage &agrave; distance. Valable uniquement pour PHP 3! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning.php3"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> Profite du syst&egrave;me de versionnage et de gestion d'environnement de Solaris 2.x et Linux. Valable uniquement pour PHP 3! </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.configure.php.xml +++ phpdoc-fr/chapters/install.configure.php.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.php"> <title>Options PHP</title> <variablelist> <varlistentry id="install.configure.enable-maintainer-mode"> <term> <parameter>--enable-maintainer-mode</parameter> </term> <listitem> <para> Active des r&egrave;gles de compilation (make) et des d&eacute;pendances par toujours utiles aux utilisateurs occasionnels. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-config-file-path"> <term> <parameter>--with-config-file-path=PATH</parameter> </term> <listitem> <para> Indique le chemin dans lequel r&eacute;side le fichier &php.ini;. Par d&eacute;faut, c'est PREFIX/lib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-safe-mode"> <term> <parameter>--enable-safe-mode</parameter> </term> <listitem> <para> Active le safe mode par d&eacute;faut. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-exec-dir"> <term> <parameter>--with-exec-dir[=DIR]</parameter> </term> <listitem> <para> Autorise uniquement les ex&eacute;cutables situ&eacute;s dans le dossier DIR lorsque le safe mode est activ. Par d&eacute;faut, c'est DIR vaut /usr/local/php/bin. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-magic-quotes"> <term> <parameter>--enable-magic-quotes</parameter> </term> <listitem> <para> Active les guillemets magiques. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-short-tags"> <term> <parameter>--disable-short-tags</parameter> </term> <listitem> <para> Inactive les balises courtes <literal>&lt;?</literal>. </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.configure.servers.xml +++ phpdoc-fr/chapters/install.configure.servers.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.servers"> <title>Options Serveur</title> <variablelist> <varlistentry id="install.configure.with-aolserver"> <term> <parameter>--with-aolserver=DIR</parameter> </term> <listitem> <para> Sp&eacute;cifie le chemin d'installation du serveur AOLserver. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-apxs"> <term> <parameter>--with-apxs[=FILE]</parameter> </term> <listitem> <para> Compile un module Apache partag&eacute;. FILE est un chemin d'acc&egrave;s optionnel vers les outils apxs d'Apache. Par d&eacute;faut, c'est apxs. Assurez vous de sp&eacute;cifier la version d'apxs qui est r&eacute;ellement install&eacute;e sur votre syst&egrave;me, et non pas celle qui est fournie avec Apache. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-apache"> <term> <parameter>--with-apache[=DIR]</parameter> </term> <listitem> <para> Compile le module Apache. DIR est le chemin du dossier d'installation d'Apache. Par d&eacute;faut, c'est /usr/local/apache. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod_charset"> <term> <parameter>--with-mod_charset</parameter> </term> <listitem> <para> Active les tables de transferts pour mod_charset (Rus Apache). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-apxs2"> <term> <parameter>--with-apxs2[=FILE]</parameter> </term> <listitem> <para> Compile le module partag&eacute; Apache 2.0. FILE est un chemin d'acc&egrave;s optionnel vers les outils apxs d'Apache. Par d&eacute;faut, c'est apxs. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fhttpd"> <term> <parameter>--with-fhttpd[=DIR]</parameter> </term> <listitem> <para> Compile le module fhttpd. DIR est le dossier d'installation de fhttpd. Par d&eacute;faut, c'est /usr/local/src/fhttpd. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-isapi"> <term> <parameter>--with-isapi=DIR</parameter> </term> <listitem> <para> Compile PHP sous forme de module ISAPI pour utiliser avec le serveur Zeus. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-nsapi"> <term> <parameter>--with-nsapi=DIR</parameter> </term> <listitem> <para> Sp&eacute;cifie le chemin vers le serveur Netscape Server. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-phttpd"> <term> <parameter>--with-phttpd=DIR</parameter> </term> <listitem> <para> Aucune information fournie. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pi3web"> <term> <parameter>--with-pi3web=DIR</parameter> </term> <listitem> <para> Compile PHP sous forme de module pour utiliser avec le serveur Pi3Web. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-roxen"> <term> <parameter>--with-roxen=DIR</parameter> </term> <listitem> <para> Compile PHP sous forme de module Pike. DIR est le chemin d'installation de Roxen. Par d&eacute;faut, c'est /usr/local/roxen/server. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-roxen-zts"> <term> <parameter>--enable-roxen-zts</parameter> </term> <listitem> <para> Compile PHP sous forme de module Roxen, en utilisant Zend Thread Safety. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-servlet"> <term> <parameter>--with-servlet[=DIR]</parameter> </term> <listitem> <para> Inclut le support des servlets. DIR est le chemin d'installation du JSDK. Cette SAPI impose que l'extension java soit compil&eacute;e comme une librairie partag&eacute;e. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-thttpd"> <term> <parameter>--with-thttpd=SRCDIR</parameter> </term> <listitem> <para> Compile PHP comme module thttpd. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tux"> <term> <parameter>--with-tux=MODULEDIR</parameter> </term> <listitem> <para> Compile PHP comme module TUX (Linux uniquement). </para> </listitem> </varlistentry> </variablelist> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.configure.xml +++ phpdoc-fr/chapters/install.configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.configure"> <title>Liste compl&egrave;te des options de configuration</title> <note> <para> Ces options sont utilis&eacute;es uniquement au moment de la compilation. Si vous voulez modifier le comportement de PHP lors de l'ex&eacute;cution, reportez vous au chapitre <link linkend="configuration">configuration</link>. </para> </note> <para> Ci-dessous, vous trouverez une liste compl&egrave;te des options support&eacute;es par le script de configuration de PHP 4, <filename>configure</filename> (depuis PHP 4.1.0), utilis&eacute; lors de la compilation dans les environnements Unix. Certaines options sont disponibles en PHP 3, d'autres en PHP 4, d'autres encore dans les deux. <!-- There are many options the names of which have changed between PHP 3 and PHP 4, but which accomplish the same things. These entries are cross-referenced to each other, so if you have a problem getting your PHP 3-era configuration options to work, check here to see whether the names have changed. --> </para> <para> Il y a des options de configuration g&eacute;n&eacute;rales pour le script <command>configure</command>, consultez les pages appropri&eacute;es du manuel de GNU <command>autoconf</command> ou bien utilisez la commande <command>configure --help</command> pour avoir une liste compl&egrave;te et &agrave; jour des options. </para> <itemizedlist> <listitem> <para> <link linkend="install.configure.options.databases">Bases de donn&eacute;es</link> </para> </listitem> <!-- <listitem> <para> <link linkend="install.configure.options.ecommerce">Ecommerce</link> </para> </listitem> --> <listitem> <para> <link linkend="install.configure.options.graphics">Graphisme</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.options.misc">Divers</link> </para> </listitem> <!-- <listitem> <para> <link linkend="install.configure.options.networking">Networking</link> </para> </listitem> --> <listitem> <para> <link linkend="install.configure.options.php">PHP</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.options.servers">Serveur</link> </para> </listitem> <!-- <listitem> <para> <link linkend="install.configure.options.text">Text and language</link> </para> </listitem> --> <listitem> <para> <link linkend="install.configure.options.xml">XML</link> </para> </listitem> </itemizedlist> <sect2 id="install.configure.options"> <title>Options de configuration en PHP 4</title> <note> <para> Ces options ne sont utilis&eacute;es qu'en PHP 4, depuis la version PHP 4.1.0. Certaines sont disponibles dans les anciennes versions PHP 4, certaines m&ecirc;me en PHP 3, certains uniquement en PHP 4.1.0. Si vous essayez de compiler une version plus ancienne, certaines options peuvent simplement ne pas exister. </para> </note> &chapters.install.configure.databases; &chapters.install.configure.graphics; &chapters.install.configure.misc; &chapters.install.configure.php; &chapters.install.configure.servers; &chapters.install.configure.xml; </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.configure.xml.xml +++ phpdoc-fr/chapters/install.configure.xml.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect3 id="install.configure.options.xml"> <title>Options XML</title> <para> </para> </sect3> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.fhttpd.xml +++ phpdoc-fr/chapters/install.fhttpd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.fhttpd"> <title>Installation avec les serveurs fhttpd</title> <para> Pour compiler PHP comme un module fhttpd, r&eacute;pondre "yes" &agrave; la question "Build as an fhttpd module ?" (cela correspond &agrave; l'option de configuration <link linkend="install.configure.with-fhttpd">--with-fhttpd</link>=<replaceable>DIR</replaceable> et sp&eacute;cifier la racine de la distribution fhttpd. Le r&eacute;pertoire par d&eacute;faut est: <filename class="directory">/usr/local/src/fhttpd</filename>. Si vous utilisez fhttpd, compiler PHP en module vous permettra d'obtenir des performances sup&eacute;rieures, plus de contr&ocirc;le et la possibilit&eacute; d'ex&eacute;cution &agrave; distance. </para> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.general.xml +++ phpdoc-fr/chapters/install.general.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.general"> <title>Consid&eacute;rations g&eacute;n&eacute;rales sur l'installation</title> <para> Avant d'installer PHP, vous devez savoir ce que vous voulez faire de PHP. Il y a trois cas d'utilisation que vous a d&eacute;crit la section <link linkend="intro-whatcando">Que peut faire?</link> section: <itemizedlist> <listitem><simpara>Scripts web</simpara></listitem> <listitem><simpara>Scripts de ligne de commande</simpara></listitem> <listitem><simpara>Application &agrave; interface graphique</simpara></listitem> </itemizedlist> </para> <para> Pour la premi&egrave;re t&acirc;che, qui est de loin la plus r&eacute;pandue, vous avez besoin de trois choses : PHP lui-m&ecirc;me, un serveur web et un navigateur. Vous avez probablement un navigateur, et en fonction de votre syst&egrave;me d'exploitation, vous pouvez aussi disposer d'un serveur Web (i.e. Apache sous Linux ou IIS sous Windows). Vous pouvez aussi louer un espace &agrave; une soci&eacute;t&eacute;. De cette fa&ccedil;on, vous n'aurez pas &agrave; mettre en place PHP, mais uniquement &agrave; &eacute;crire vos scripts, les charger sur le serveur et voir le r&eacute;sultat sur votre navigateur. </para> <para> Si vous installez PHP et le serveur par vous-m&ecirc;me, vous avez deux choix. Soit sous la forme d'un module du serveur web (via une interface directe appel&eacute;e SAPI). Les serveurs qui supportent cette solution comptent notamment Apache, Microsoft Internet Information Server, Netscape et iPlanet. D'autres serveurs ont aussi le support ISAPI, l'interface de module Microsoft (OmniHTTPd par exemple). Si PHP ne supporte pas l'interface de module de votre serveur web, vous pouvez toujours l'utiliser comme processeur CGI. Cela signifie que vous devez configurer votre serveur pour qu'il utilise l'ex&eacute;cutable PHP (<filename>php.exe</filename> sous Windows), pour qu'il traite les fichiers PHP sur le serveur. </para> <para> Si vous souhaitez aussi utiliser PHP en ligne de commande (&eacute;crire des scripts de g&eacute;n&eacute;ration d'image hors ligne, par exemple, ou bien traiter des textes en fonctions d'information que vous leur passeriez), vous aurez besoin d'un ex&eacute;cutable PHP. Pour plus de d&eacute;tails, lisez la section <link linkend="install.commandline"> &eacute;crire des applications PHP en ligne de commande</link>. Dans ce cas, vous n'aurez pas besoin de serveur web, ni de navigateur. </para> <para> Avec PHP, vous pouvez aussi &eacute;crire des interfaces graphiques clientes, en utilisant l'extension PHP-GTK. C'est une approche compl&egrave;tement diff&eacute;rente de l'&eacute;criture des pages web, car vous ne g&eacute;n&eacute;rerez pas de fichiers HTML, mais vous aurez &agrave; g&eacute;rer des fen&ecirc;tres et des objets. Pour plus de d&eacute;tails sur PHP-GTK, voyez le <ulink url="&url.php.gtk;">site officiel</ulink>. PHP-GTK n'est pas inclus dans la distribution officielle de PHP. </para> <para> A partir de maintenant, cette section d&eacute;crit l'installation de PHP avec un serveur web sous Unix et Windows, sous forme de module ou d'ex&eacute;cutables CGI. </para> <simpara> Les codes source et les ex&eacute;cutables compil&eacute;s de certains OS (y compris Windows), sont disponibles &agrave; <ulink url="&url.php;">&url.php;</ulink>. Nous recommandons l'utilisation du <ulink url="&url.mirrors;">miroir</ulink> le plus proche pour acc&eacute;l&eacute;rer les chargements. </simpara> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.hpux.xml +++ phpdoc-fr/chapters/install.hpux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.hpux"> <title>Installation sous HP-UX</title> <para> Cette section contient les notes et conseils d'installation de PHP sur les distributions HP-UX. </para> <example id="install.hpux.example"> <title> Instructions d'installation pour HP-UX 10 </title> <screen> <![CDATA[ From: paul_mckay@clearwater-it.co.uk 04-Jan-2001 09:49 (Ces conseils sont destin&eacute;s &agrave; PHP 4.0.4 et Apache v1.3.9) Vous voulez installer PHP et Apache sur une HP-UX 10.20? 1. Vous aurez besoin de gzip. T&eacute;l&eacute;chargez la distribution compil&eacute;e &agrave; http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z, puis d&eacute;compressez la, et utilisez swinstall pour installer. 2. Vous aurez besoin de gcc. T&eacute;l&eacute;chargez une distribution compil&eacute;e &agrave; http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz, puis d&eacute;compressez la, et utilisez swinstall pour installer. 3. Vous aurez besoin de GNU binutils. T&eacute;l&eacute;chargez une distribution compil&eacute;e &agrave; http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz , puis d&eacute;compressez la, et utilisez swinstall pour installer. 4. Vous aurez besoin de bison. T&eacute;l&eacute;chargez une distribution compil&eacute;e &agrave; http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz , puis d&eacute;compressez la, et utilisez swinstall pour installer. 5. Vous aurez besoin de flex. T&eacute;l&eacute;chargez une distribution source sur l'un des miroirs http://www.gnu.org. Il se trouve dans le dossier non-gnu du site FTP. T&eacute;l&eacute;chargez le fichier, d&eacute;compressez leur, puis utilisez tar -xvf avec. Allez dans le nouveau dossier flex ainsi cr&eacute;&eacute;, et ex&eacute;cutez la commande "./configure", puis faites un "make", puis un "make install". Si vous avez des erreurs &agrave; cette &eacute;tape, c'est probablement par ce que gcc et les autres ne sont pas inscrites dans votre PATH. Ajoutez les. Maintenant, la partie d&eacute;licate. 6. T&eacute;l&eacute;chargez les sources d'Apache et de PHP. 7. D&eacute;compressez les avec gunzip puis faites "tar -xvf" avec les deux archives. Nous devons modifier quelques fichiers avant de les compiler. 8. Premi&egrave;rement, le fichier de configuration doit &ecirc;tre modifi&eacute; car il semble oublier qu'il est sur une machine HP-UX. Il y a des m&eacute;thodes plus rus&eacute;es, mais le plus simple et le plus efficace est d'ajouter "lt_target=hpux10.20" &agrave; la ligne 47286 du script de configuration. 9. Le fichier d'Apache GuessOS doit &ecirc;tre modifi&eacute;. Sous apache_1.3.9/src/helpers, modifier la ligne 89, en rempla&ccedil;ant "echo "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0" par : "echo "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0" 10. Il n'est pas possible d'installer PHP sous forme de shared object sous HP-UX, ce qui fait que vous devez le compiler en statique. Suivez simplement les instructions de la section Apache. 11. PHP et Apache sont maintenant compil&eacute;s correctement, mais Apache ne d&eacute;marre pas. Vous devez cr&eacute;er un nouvel utilisateur Apache, par exemple www, ou apache. Puis, modifiez les lignes 252 et 253 de conf/httpd.conf pour remplacer User nobody Group nogroup par vos valeurs, par exemple : User www Group sys Il n'est pas possible d'&eacute;x&eacute;cuter Apache avec l'utilisateur nobody sous HP-UX. A partir de ce moment l&agrave;, PHP et Apache doivent fonctionner. J'esp&egrave;re que cela aidera quelqu'un. Paul Mckay. ]]> </screen> </example> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.iis.xml +++ phpdoc-fr/chapters/install.iis.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.iis"> <title>Installation avec les serveurs IIS/PWS</title> <para> Cette section contient des notes sur l'installation de PHP avec IIS ( Microsoft Internet Information Server) : <link linkend="install.iis.iis3">PWS/IIS 3</link>, <link linkend="install.iis.pws4">PWS 4 ou plus r&eacute;cent</link> et <link linkend="install.iis.iis4">IIS 4 ou plus r&eacute;cent</link>. </para> <sect2 id="install.iis.iis3"> <title>Windows et PWS/IIS 3</title> <simpara> La m&eacute;thode recommand&eacute;e pour configurer ces serveurs est d'utiliser le fichier INF inclus dans la distribution (<filename>php_iis_reg.inf</filename>). Vous pouvez &eacute;diter ce fichier, pour vous assurer que les extenstions et les dossiers d'installation de PHP sont bien ceux de votre configuration. Ou alors, vous pouvez suivre les instructions suivantes : </simpara> <warning> <para> ATTENTION: Ces instructions requi&egrave;rent la manipulation du fichier de registry de Windows. Une erreur peut laisser votre syst&egrave;me dans un &eacute;tat instable. Nous vous recommandons vivement de sauvegarder ce fichier en lieu s&ucirc;r. L'&eacute;quipe de d&eacute;veloppement et les traducteurs de cette documentation ne pourront pas &ecirc;tre tenus responsable d'un quelconque dommage qui pourrait survenir dans votre registry. </para> </warning> <para> <itemizedlist> <listitem> <simpara> Lancez Regedit. </simpara> </listitem> <listitem> <simpara> Naviguez jusqu'&agrave; : <literal>HKEY_LOCAL_MACHINE /System /CurrentControlSet /Services /W3Svc /Parameters /ScriptMap</literal>. </simpara> </listitem> <listitem> <simpara> Dans le menu "edit", s&eacute;lectionnez : <literal>New->String Value</literal>. </simpara> </listitem> <listitem> <simpara> Entrez l'extension que vous voulez utiliser pour les scripts PHP. Par exemple : <literal>.php</literal> </simpara> </listitem> <listitem> <simpara> Double-cliquez sur la cha&icirc;ne, et entrez le chemin jusqu'&agrave; <literal>php.exe</literal> dans le champ "value data". ex: <literal>c:\php\php.exe</literal>. </simpara> </listitem> </itemizedlist> </para> <para> Les &eacute;tapes suivantes n'affectent pas la configuration du serveur web, et ne s'appliquent que si vous voulez que vos scripts PHP soient ex&eacute;cut&eacute;s lorsqu'il sont ex&eacute;cut&eacute;s en ligne de commande (par exemple, run <filename>c:\messcripts\test.php</filename>) ou en double-cliquant sur l'icone. Vous pouvez ignorer ces &eacute;tapes si vous pr&eacute;f&eacute;rez que vos scripts PHP s'ouvrent dans &eacute;diteur de texte, plut&ocirc;t que de les voir s'ex&eacute;cuter lorsque vous double-cliquez dessus. </para> <para> <itemizedlist> <listitem> <simpara> R&eacute;p&eacute;tez ces instructions pour toutes les extensions que vous voulez associer aux scripts PHP. </simpara> </listitem> <listitem> <simpara> Naviguez jusqu'&agrave; : <literal>HKEY_CLASSES_ROOT</literal> </simpara> </listitem> <listitem> <simpara> Dans le menu edit, s&eacute;lectionnez: <literal>New->Key</literal>. </simpara> </listitem> <listitem> <simpara> Donnez le nom de votre extension &agrave; la cl&eacute; : ex: <literal>.php</literal> </simpara> </listitem> <listitem> <simpara> S&eacute;lectionnez le nom de la nouvelle cl&eacute;e dans le panneau de droite, et double cliquez dans "default value", puis entrez <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> R&eacute;p&eacute;tez ces instructions pour toutes les extensions que vous avez associ&eacute;es aux scripts PHP. </simpara> </listitem> <listitem> <simpara> Cr&eacute;ez une autre <literal>New->Key</literal> sous <literal>HKEY_CLASSES_ROOT</literal> et nommez-la <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> S&eacute;lectionnez la nouvelle cl&eacute; <literal>phpfile</literal> et dans le panneau de doite, double-cliquez dans "default value" et entrez <literal>PHP Script</literal>. </simpara> </listitem> <listitem> <simpara> Faites un clic droit dans <literal>phpfile</literal> et s&eacute;lectionnez <literal>New->Key</literal>, appelez-le <literal>Shell</literal>. </simpara> </listitem> <listitem> <simpara> Faites un clic droit dans <literal>Shell</literal> et s&eacute;lectionnez <literal>New->Key</literal>, appelez-le <literal>open</literal>. </simpara> </listitem> <listitem> <simpara> Faites un clic droit dans <literal>open</literal> et s&eacute;lectionnez <literal>New->Key</literal>, appelez-le <literal>command</literal>. </simpara> </listitem> <listitem> <simpara> S&eacute;lectionnez la nouvelle cl&eacute; <literal>command</literal> et dans le panneau de droite, faites un double clic dans "default value", puis entrez le chemin jusqu'&agrave; <literal>php.exe</literal>. ex: <literal>c:\php\php.exe -q %1</literal>. (n'oubliez pas le <literal>%1</literal>). </simpara> </listitem> <listitem> <simpara> Quittez Regedit. </simpara> </listitem> <listitem> <simpara> Si vous utilisez PWS sous Windows, red&eacute;marrez pour prendre en compte la nouvelle registry. </simpara> </listitem> </itemizedlist> </para> <simpara> Les utilisateurs de PWS et IIS 3 sont pr&ecirc;ts &agrave; utiliser leur serveur. Avec IIS 3, vous pouvez utiliser un <ulink url="&url.iiscfg;">outil</ulink> bien pratique de Steven Genusa pour configurer votre carte des scripts. </simpara> </sect2> <sect2 id="install.iis.pws4"> <title>Windows et PWS 4 ou plus r&eacute;cent</title> <simpara> Pour installer PHP sous Windows avec PWS 4 ou plus r&eacute;cent, vous avez deux options : l'une est d'avoir PHP sous forme de CGI, l'autre est d'utiliser les modules SAPI, sous forme de DLL. </simpara> <para> Si vous optez pour le CGI, faites ceci : <itemizedlist> <listitem> <simpara> Editez le fichier <filename>pws-php4cgi.reg</filename> (dans le dossier <filename>sapi</filename>) pour indiquer la localisation de votre fichier <filename>php.exe</filename>. Les slash doivent &ecirc;tre &eacute;chapp&eacute;s. Par exemple : <literal>[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="C:\\PHP\\php.exe"</literal> </simpara> </listitem> <listitem> <simpara> Dans le gestionnaire PWS Manager, faites un clic droit sur les dossiers qui supporteront PHP, et s&eacute;lectionnez "Properties". Cochez l'option "Execute" et confirmez. </simpara> </listitem> </itemizedlist> </para> <para> Si vous optez pour les modules ISAPI, faites ceci : <itemizedlist> <listitem> <simpara> Editez le fichier <filename>pws-php4isapi.reg</filename> (dans le dossier <filename>sapi</filename>) pour indiquer la localisation de votre fichier <filename>php4isapi.dll</filename>. Les slash doivent &ecirc;tre &eacute;chapp&eacute;s. Par exemple : <literal>[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="C:\\PHP\\sapi\\php4isapi.dll"</literal> </simpara> </listitem> <listitem> <simpara> Dans le gestionnaire PWS Manager, faites un clic droit sur les dossiers qui supporteront PHP, et s&eacute;lectionnez "Properties". Cochez l'option "Execute" et confirmez. </simpara> </listitem> </itemizedlist> </para> </sect2> <sect2 id="install.iis.iis4"> <title>Windows NT/2000 et IIS 4 ou plus r&eacute;cent</title> <simpara> Pour installer PHP sous Windows NT/2000 serveyr avec IIS 4 ou plus r&eacute;cent, vous avez deux options : l'une est d'avoir PHP sous forme de CGI, l'autre est d'utiliser les modules SAPI, sous forme de DLL. </simpara> <simpara> Dans les deux cas, vous devez lancer la console "Microsoft Management" (elle peut aussi s'appeler "Internet Services Manager". Elle est situ&eacute;e soit dans "Windows NT 4.0 Option Pack" ou dans "Control Panel=&gt;Administrative Tools" sous Windows 2000). Puis, faites un clic droit sur votre dossier web (qui apparaitra probablement comme <filename>Default Web Server</filename>), et s&eacute;lectionnez "Properties". </simpara> <para> Si vous optez pour le CGI, faites ceci : <itemizedlist> <listitem> <simpara> Sous "Home Directory", "Virtual Directory", ou "Directory", cliquez sur le bouton "Configuration", et s&eacute;lectionnez l'onglet "App Mappings". </simpara> </listitem> <listitem> <simpara> Cliquez sur "Add", puis dans la bo&icirc;te "Executable", tapez : <literal>c:\php\php.exe</literal> (si vous avez install&eacute; PHP dans le dossier <literal>c:\php\</literal>.) </simpara> </listitem> <listitem> <simpara> Dans la bo&icirc;te "Extension", tapez le nom de l'extension que vous voulez associer aux scripts PHP. Laissez "Method exclusions" vide, et cochez "Script engine". Vous pouvez aussi pr&eacute;f&eacute;rer cocher la bo&icirc;te 'check that file exists' - pour un co&ucirc;t faible, IIS (ou PWS) s'assirurera que le script existe, et r&eacute;soudra les probl&egrave;mes d'autentification avant de d&eacute;marrer PHP. Cela signifie que vous obtiendrez des messages d'erreur 404 intelligents, plut&ocirc;t que d'avoir simplement une plainte du serveur comme quoi les CGI n'ont rien retourn&eacute;s. </simpara> <simpara> R&eacute;p&eacute;tez les &eacute;tapes 3 et 4 pour chaque extension que vous souhaitez associer aux scripts PHP. (<literal>.php</literal> et <literal>.phtml</literal> sont les plus r&eacute;pandues.) </simpara> </listitem> <listitem> <simpara> Configurer la s&eacute;curit&eacute; n&eacute;cessaire (dans "Internet Service Manager"), et si votre serveur NT utilise NTFS, ajoutez les droits ad&eacute;quats pour I_USR_, au dossier qui contient <literal>php.exe</literal>. </simpara> </listitem> </itemizedlist> </para> <para> Si vous optez pour les modules ISAPI, faites ceci : <itemizedlist> <listitem> <simpara> Si vous ne voulez pas effectuer des authentifications HTTP avec PHP, vous pouvez (et devez) sauter cette &eacute;tape. Avec ISAPI Filters, ajoutez un nouveau filtre ISAPI. Utilisez PHP comme nom de filtre, et ajoutez simplement le chemin jusqu'&agrave; <filename>php4isapi.dll</filename>. </simpara> </listitem> <listitem> <simpara> Sous "Home Directory", cliquez sur le bouton "Configuration". Ajoutez une nouvelle entr&eacute;e dans "Application Mappings". Utilisez le chemin jusqu'&agrave; <filename>php4isapi.dll</filename> comme "Executable", indiquez ".php" comme extension, laissez "Method exclusions" vide, et cochez "Script engine". </simpara> </listitem> <listitem> <simpara> Arr&ecirc;tez totalement IIS (NET STOP iisadmin) </simpara> </listitem> <listitem> <simpara> D&eacute;marrez IIS (NET START w3svc) </simpara> </listitem> </itemizedlist> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.iplanet.xml +++ phpdoc-fr/chapters/install.iplanet.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.netscape-enterprise"> <title>Installation sous Netscape et iPlanet Enterprise Serveur</title> <para> Cette section contient les notes et d&eacute;tails sp&eacute;cifique &agrave; l'installation Netscape et iPlanet, aussi bien pour <link linkend="install.netscape.sun">Sun Solaris</link> que <link linkend="install.netscape.windows">Windows</link>. </para> <para> Vous pouvez trouvez plus d'informations sur la configuration de PHP avec Netscape Enterprise Server : <ulink url="&url.netscape.nsapi;">&url.netscape.nsapi;</ulink> </para> <sect2 id="install.netscape.sun"> <title>Installer PHP avec Netscape sous Sun Solaris</title> <para> Pour compiler PHP avec NES ou iPlanet, indiquez le bon dossier d'installation pour l'option de configuration <link linkend="install.configure.with-nsapi">--with-nsapi</link> = <replaceable>DIR</replaceable> option. Le dossier par d&eacute;faut est g&eacute;n&eacute;ralement <filename class="directory">/opt/netscape/suitespot/</filename>. Lisez aussi <filename>/php-xxx-version/sapi/nsapi/nsapi-readme.txt</filename>. </para> <para> <example id="install.netscape-enterprise.solaris"> <title>Exemple d'installation pour Netscape Enterprise sous Solaris</title> <screen> <![CDATA[ Instructions pour Sun Solaris 2.6 avec Netscape Enterprise Server 3.6 From: bhager@invacare.com 1. Installez les packages suivants depuis le serveur www.sunfreeware.com ou un miroir ad hoc : flex-2_5_4a-sol26-sparc-local gcc-2_95_2-sol26-sparc-local gzip-1.2.4-sol26-sparc-local perl-5_005_03-sol26-sparc-local bison-1_25-sol26-sparc-local make-3_76_1-sol26-sparc-local m4-1_4-sol26-sparc-local autoconf-2.13 automake-1.4 mysql-3.23.24-beta (if you want mysql support) tar-1.13 (GNU tar) 2. Assurez-vous que le path inclut bien les dossiers n&eacute;cessaires : PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin export PATH 3. gunzip php-x.x.x.tar.gz (si vous avez une distribution .gz, ou bien allez en 4) 4. tar xvf php-x.x.x.tar 5. cd ../php-x.x.x 6. Pour les &eacute;tapes suivantes, assurez-vous que /opt/netscape/suitespot/ correspond bien &agrave; votre installation du serveur netscape. Sinon, indiquez le chemin correct : /configure --with-mysql=/usr/local/mysql --with-nsapi=/opt/netscape/suitespot/ --enable-track-vars --enable-libgcc 7. make 8. make install ]]> </screen> </example> Apr&egrave;s avoir fait l'installation de base et lu les fichiers readme.txt, vous pouvez avoir besoin de faire des configurations suppl&eacute;mentaires. </para> <para> D'abord, vous devez ajouter des chemins dans la variable LD_LIBRARY_PATH pour que PHP trouve toutes les librairies partag&eacute;es. Le mieux est de le faire dans le script de d&eacute;marrage de votre serveur Netscape. Les utilisateurs Windows peuvent probablement ignorer cette &eacute;tape. Le script de d&eacute;marrage est situ&eacute; dans : <filename class="directory">/path/to/server/https-servername/start</filename> </para> <para> Vous pouvez aussi avoir besoin d'&eacute;diter les fichiers de configuration qui sont situ&eacute;s dans : <filename class="directory">/path/to/server/https-servername/config/</filename>. </para> <example id="install.netscape-enterprise.configure"> <title> Exemple de configuration pour Netscape Enterprise </title> <screen> <![CDATA[ Instructions de configuration for Netscape Enterprise Server From: bhager@invacare.com 1. Ajoutez les lignes suivantes dans mime.types: type=magnus-internal/x-httpd-php exts=php 2. Ajoutez les lignes suivantes dans obj.conf. shlib peut d&eacute;pendre de votre OS, pour Unix c'est quelque chose de proche de /opt/netscape/suitespot/bin/libphp4.so. Il est conseill&eacute; de placer les lignes suivantes apr&egrave;s les lignes de types mime : Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="/php4/nsapiPHP4.dll" Init fn=php4_init errorString="Failed to initialize PHP!" <object name="default"> . . . .#NOTE La ligne suivante doit &ecirc;tre plac&eacute;e apr&egrave;s toutes .#les lignes 'ObjectType' .# et avant les lignes 'AddLog' Service fn="php4_execute" type="magnus-internal/x-httpd-php" . . </Object> <Object name="x-httpd-php"> ObjectType fn="force-type" type="magnus-internal/x-httpd-php" Service fn=php4_execute </Object> Configuration d'authentification L'authentification PHP ne peut pas &ecirc;tre utilis&eacute;e avec d'autre authentification. TOUTES LES FORMES D'AUTHENTIFICATION SONT PASSEES AU SCRIPT PHP. Pour configurer l'authentification PHP pour le serveur entier, ajoutez la ligne suivante : <Object name="default"> AuthTrans fn=php4_auth_trans . . . . </Object> Pour configurer l'authentification PHP pour un dossier, ajoutez la ligne suivante : <Object ppath="d:\path\to\authenticated\dir\*"> AuthTrans fn=php4_auth_trans </Object> ]]> </screen> </example> <para> Si vous utilisez Netscape Enterprise 4.x, alors, il faut utiliser ceci : </para> <example> <title>Exemple de configuration pour Netscape Enterprise 4.x</title> <programlisting> <![CDATA[ Placez ces lignes apr&egrave;s les types MIME, et tout le reste ressemble &agrave; l'exemple ci-dessus : From: Graeme Hoose (GraemeHoose@BrightStation.com) Init fn="load-modules" shlib="/path/to/server4/bin/libphp4.so" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" Init fn="php4_init" LateInit="yes" ]]> </programlisting> </example> </sect2> <sect2 id="install.netscape.windows"> <title>Installer PHP avec Netscape Enterprise sous Windows</title> <para> Pour installer PHP sous forme de CGI (pour Netscape Enterprise Server, iPlanet, peut &ecirc;tre Fastrack), suivez ces instructions : </para> <itemizedlist> <listitem> <simpara> Copiez le fichier <filename>php4ts.dll</filename> dans votre dossier systemroot (le dossier o&ugrave; vous avez install&eacute; windows) </simpara> </listitem> <listitem> <para> Fa&icirc;tes un fichier d'association depuis la ligne de commande. Tapez les lignes suivantes : <programlisting> <![CDATA[ assoc .php=PHPScript ftype PHPScript=c:\php\php.exe %1 %* ]]> </programlisting> </para> </listitem> <listitem> <simpara> Dans le serveur Netscape Enterprise Administration Server, cr&eacute;ez un dossier shellcgi et supprimez le aussit&ocirc;t (cette op&eacute;ration cr&eacute;ee 5 lignes importantes dans le fichier obj.conf et permet au serveur de g&eacute;rer les scripts CGI). </simpara> </listitem> <listitem> <simpara> Dans le serveur Netscape Enterprise Administration Server, cr&eacute;eez un nouveau type MIME (Category: type, Content-Type: magnus-internal/shellcgi, File Suffix:php). </simpara> </listitem> <listitem> <simpara> Recommencez pour chaque instance de serveur web qui devra ex&eacute;cuter PHP. </simpara> </listitem> </itemizedlist> <para> Plus de d&eacute;tails sur la configuration de PHP comme CGI sont disponibles &agrave; <ulink url="&url.netscape.cgi;">&url.netscape.cgi;</ulink> </para> <para> Pour installer PHP avec l'interface NSAPI (pour Netscape Enterprise Server, iPlanet, peut-&ecirc;tre Fastrack), fa&icirc;tes ceci : </para> <itemizedlist> <listitem> <simpara> Copiez le fichier <filename>php4ts.dll</filename> dans votre dossier systemroot (le dossier o&ugrave; vous avez install&eacute; windows) </simpara> </listitem> <listitem> <para> Fa&icirc;tes un fichier d'association depuis la ligne de commande. Tapez les lignes suivantes : <programlisting> <![CDATA[ assoc .php=PHPScript ftype PHPScript=c:\php\php.exe %1 %* ]]> </programlisting> </para> </listitem> <listitem> <simpara> Dans le serveur Netscape Enterprise Administration Server, cr&eacute;eez un nouveau type MIME (Category: type, Content-Type: magnus-internal/shellcgi, File Suffix:php). </simpara> </listitem> <listitem> <para> Stoppez votre serveur web et &eacute;ditez le fichier <filename>obj.conf</filename>. A la fin de la section Init, placez ces deux lignes (obligatoirement apr&egrave;s l'init de type MIME) : <programlisting> <![CDATA[ Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="c:/php/sapi/php4nsapi.dll" Init fn="php4_init" errorString="Failed to initialise PHP!" ]]> </programlisting> </para> </listitem> <listitem> <para> Dans la section <literal>&lt; Object name="default" &gt;</literal>, placez cette ligne, obligatoirement apr&egrave;s toutes les lignes 'ObjectType' et avamt les lignes 'AddLog' : <programlisting> <![CDATA[ Service fn="php4_execute" type="magnus-internal/x-httpd-php" ]]> </programlisting> </para> </listitem> <listitem> <para> A la fin du fichier, cr&eacute;ez un nouvel objet appel&eacute; <literal>x-httpd-php</literal>, en ins&eacute;rant ces lignes : <programlisting> <![CDATA[ <Object name="x-httpd-php"> ObjectType fn="force-type" type="magnus-internal/x-httpd-php" Service fn=php4_execute </Object> ]]> </programlisting> </para> </listitem> <listitem> <simpara> Red&eacute;marrez votre serveur web, et validez les modifications </simpara> </listitem> <listitem> <simpara> Recommencez pour chaque serveur qui doit utiliser PHP. </simpara> </listitem> </itemizedlist> <para> Plus ded d&eacute;tails sur la configiration de PHP en filtre NSAPI sont disponibles : <ulink url="&url.netscape.nsapi;">&url.netscape.nsapi;</ulink> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.linux.xml +++ phpdoc-fr/chapters/install.linux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.linux"> <title>Installation sous Linux/Unix</title> <para> Cette section contient les notes et conseils d'installation de PHP sur les distributions Linux. </para> <sect2 id="install.linux.packages"> <title>Utilisation des packages</title> <simpara> De nombreuses distributions Linux disposent d'un syst&egrave;me d'installation par package, comme le fameux RPM. Ils vous permettent de faire des installations standard, mais si vous avez des configurations sp&eacute;cifiques (comme par exemple un serveur s&eacute;curis&eacute;, ou un pilote de base de donn&eacute;es exotique), vous aurez probablement &agrave; compiler vous-m&ecirc;me votre PHP et votre serveur web. Si vous n'&ecirc;tes pas familier avec la compilation de vos propres logiciels, il vaut mieux rechercher le package qui pourra r&eacute;pondre &agrave; vos besoins. </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.macosx.xml +++ phpdoc-fr/chapters/install.macosx.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.macosx"> <title>Installation sous Unix et Mac OS X</title> <para> Cette section contient les notes et conseils pour installer &php; sur un serveur Mac OS X Server. </para> <sect2 id="install.macosx.packages"> <title>Utilisation des paquets</title> <simpara> Il existe quelques versions pr&eacute;-packag&eacute;es et pr&eacute;-compil&eacute;e de &php; pour MacOSX. Cela &ecirc;tre utile pour mettre en place une configuration standard, mais si vous avez besoin d'acc&eacute;der a des fonctionnalit&eacute;s sp&eacute;cifiques (comme un serveur s&eacute;curis&eacute;, ou un pilote de base de donn&eacute;es exotique), vous aurez &agrave; compiler &php; et/ou votre serveur web vous m&ecirc;me. Si vous n'&ecirc;tes pas familiers avec la compilation et la mise en place d'applications, il est bon de v&eacute;rifier si personne d'autre n'a r&eacute;alis&eacute; un package. </simpara> </sect2> <sect2 id="install.macosx.compile"> <title>Compilation pour OS X server</title> <simpara> Il existe deux versions l&eacute;g&egrave;rement diff&eacute;rentes de Mac OS X, le client et le serveur. Les lignes ci-dessous sont pour OS X Server. </simpara> <example id="install.macosx.compile.example"> <title>Installation sur Mac OS X server</title> <screen> <![CDATA[ 1. Get the latest distributions of Apache and PHP 2. Untar them, and run the configure program on Apache like so. ./configure --exec-prefix=/usr \ --localstatedir=/var \ --mandir=/usr/share/man \ --libexecdir=/System/Library/Apache/Modules \ --iconsdir=/System/Library/Apache/Icons \ --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \ --enable-shared=max \ --enable-module=most \ --target=apache 4. You may also want to add this line: setenv OPTIM=-O2 If you want the compiler to do some optimization. 5. Next, go to the PHP 4 source directory and configure it. ./configure --prefix=/usr \ --sysconfdir=/etc \ --localstatedir=/var \ --mandir=/usr/share/man \ --with-xml \ --with-apache=/src/apache_1.3.12 If you have any other additions (MySQL, GD, etc.), be sure to add them here. For the --with-apache string, put in the path to your apache source directory, for example "/src/apache_1.3.12". 6. make 7. make install This will add a directory to your Apache source directory under src/modules/php4. 8. Now, reconfigure Apache to build in PHP 4. ./configure --exec-prefix=/usr \ --localstatedir=/var \ --mandir=/usr/share/man \ --libexecdir=/System/Library/Apache/Modules \ --iconsdir=/System/Library/Apache/Icons \ --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \ --enable-shared=max \ --enable-module=most \ --target=apache \ --activate-module=src/modules/php4/libphp4.a You may get a message telling you that libmodphp4.a is out of date. If so, go to the src/modules/php4 directory inside your apache source directory and run this command: ranlib libmodphp4.a Then go back to the root of the apache source directory and run the above configure command again. That'll bring the link table up to date. 9. make 10. make install 11. copy and rename the php.ini-dist file to your "bin" directory from your PHP 4 source directory: cp php.ini-dist /usr/local/bin/php.ini or (if your don't have a local directory) cp php.ini-dist /usr/bin/php.ini ]]> </screen> </example> </sect2> <sect2 id="install.macosx.client"> <title>Compilation pour MacOS X client</title> <simpara> Ces conseils sont fournis gracieusement par <ulink url="&url.macosx;">Marc Liyanage</ulink>. </simpara> <simpara> Le module &php; d'Apache est inclus dans l'installation de Mac OS X. Cette version inclut le support des bases de donn&eacute;es MySQL et PostgreSQL. </simpara> <simpara> NOTE: Attention lors des manipulations ci-dessous : vous pourriez d&eacute;truire la configuration de votre serveur. </simpara> <para> Faites ceci : <itemizedlist> <listitem> <simpara> 1. Ouvrez une fen&ecirc;tre de terminal </simpara> </listitem> <listitem> <simpara> 2. Tapez "wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz", et attendez le t&eacute;l&eacute;chargement. </simpara> </listitem> <listitem> <simpara> 3. Tapez "gunzip libphp4.so.gz" </simpara> </listitem> <listitem> <simpara> 4. Tapez "sudo apxs -i -a -n php4 libphp4.so" </simpara> </listitem> </itemizedlist> Maintenant, tapez "<literal>sudo open -a TextEdit /etc/httpd/httpd.conf</literal>" TextEdit va ouvrir le fichier de configuration de votre serveur web. Recherchez les deux lignes suivantes, &agrave; la fin du fichier (utilisez la commande de recherche) : <programlisting role="apache"> <![CDATA[ #AddType application/x-httpd-php .php #AddType application/x-httpd-php-source .phps ]]> </programlisting> Supprimez les deux signes di&egrave;se (<literal>#</literal>), puis sauvez le fichier, et quittez TextEdit. </para> <para> Finalement, tapez "<literal>sudo apachectl graceful</literal>" pour red&eacute;marrer le serveur Apache. </para> <para> &php; devrait &ecirc;tre fonctionnel. Vous pouvez le tester en cr&eacute;ant un fichier dans votre dossier "Sites", appel&eacute; "test.php". Dans ce fichier, &eacute;crivez la ligne ci-contre : "<literal>&lt;?php phpinfo() ?&gt;</literal>". </para> <para> Maintenant, ouvrez votre navigateur &agrave; l'adresse suivante : <literal>127.0.0.1/~your_username/test.php</literal>. Vous devriez obtenir la page d'information de <literal>phpinfo</literal>. </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.omnihttpd.xml +++ phpdoc-fr/chapters/install.omnihttpd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.omnihttpd"> <title>Installation pour les serveurs OmniHTTPd</title> <para> Cette section contient les notes et conseils pour installer PHP sur un serveur OmniHTTPd. </para> <sect2 id="install.omnihttpd.windows"> <title>OmniHTTPd 2.0b1 et plus r&eacute;cent pour Windows</title> <simpara> Vous devez r&eacute;aliser les &eacute;tapes suivantes pour configurer PHP sur votre serveur OmniHTTPd. C'est une configuration en ex&eacute;cutable CGI. SAPI est support&eacute; par OmniHTTPd, mais des tests on prouv&eacute; que ce n'est pas une solution stable. </simpara> <para> <itemizedlist> <listitem> <para> Step 1: Installez le serveur OmniHTTPd. </para> </listitem> <listitem> <para> Step 2: Faites un clic droit sur l'icone bleue d'OmniHTTPd sur le syst&egrave;me, et s&eacute;lectionnez <literal>Properties</literal> </para> </listitem> <listitem> <para> Step 3: Cliquez sur <literal>Web Server Global Settings</literal> </para> </listitem> <listitem> <para> Step 4: Dans l'onglet 'External', entrez : <literal>virtual = .php | actual = c:\path-to-php-dir\php.exe</literal>, et utilisez le bouton "Add" (ajout). </para> </listitem> <listitem> <para> Step 5: Dans l'onglet <literal>Mime</literal>, entrez : <literal>virtual = wwwserver/stdcgi | actual = .php</literal>, et utilisez le bouton "Add" (ajout). </para> </listitem> <listitem> <para> Step 6: Cliquez sur <literal>OK</literal> </para> </listitem> </itemizedlist> </para> <simpara> R&eacute;petez les &eacute;tapes de 2 &agrave; 6 pour chaque extension que vous voulez associer &agrave; PHP. </simpara> <note> <para> Certains packages OmniHTTPd sont fournis avec le support de PHP. Vous pouvez le choisir au moment de l'installation, et d&eacute;cocher le composant PHP. Nous recommandons d'utiliser les derni&egrave;res versions de PHP. Certains serveurs OmniHTTPd sont livr&eacute;s avec des versions b&eacute;ta de PHP, et il vaut donc mieux &eacute;viter de les installer, et choisir une autre version, stable. Si le serveur est d&eacute;j&agrave; sur votre machine, utilisez le bouton "Replace" (remplacer) dans les &eacute;tapes 4 et 5 pour configurer un nouveau PHP. </para> </note> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.openbsd.xml +++ phpdoc-fr/chapters/install.openbsd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.openbsd"> <title>Installations Unix/OpenBSD</title> <para> Cette section contient les notes sp&eacute;cifiques &agrave; l'installation de PHP sous <ulink url="&url.openbsd;">OpenBSD 3.2</ulink>. </para> <sect2 id="install.openbsd.packages"> <title>Utilisation des paquets binaires</title> <simpara> Cette m&eacute;thode est la m&eacute;thode recommand&eacute;e pour installer &php; sur OpenBSD. C'est aussi la m&eacute;thode la plus simple. Le paquet core a &eacute;t&eacute; s&eacute;par&eacute; des modules et chacun d'entre eux peut &ecirc;tre install&eacute; et supprim&eacute; ind&eacute;pendamment des autres. Les fichiers dont vous avez besoin sont sur le CD OpenBSD ou sur le site FTP. </simpara> <simpara> Le package principal que vous devez installer est <filename>php4-core-4.2.3.tgz</filename>, qui contient le moteur de base, plus gettext et iconv). Puis, jetez un oeil aux packages de module, comme <filename>php4-mysql-4.2.3.tgz</filename> ou <filename>php4-imap-4.2.3.tgz</filename>. Vous devez utiliser la commande <command>phpxs</command> pour activer et d&eacute;sactiver ces modules dans votre &php.ini;. </simpara> <example id="install.openbsd.ports.example"> <title>Exemple d'installation de PHP sous OpenBSD avec Ports</title> <programlisting> <![CDATA[ # pkg_add php4-core-4.2.3.tgz # /usr/local/sbin/phpxs -s # cp /usr/local/share/doc/php4/php.ini-recommended /var/www/conf/php.ini (add in mysql) # pkg_add php4-mysql-4.2.3.tgz # /usr/local/sbin/phpxs -a mysql (add in imap) # pkg_add php4-imap-4.2.3.tgz # /usr/local/sbin/phpxs -a imap (remove mysql as a test) # pkg_delete php4-mysql-4.2.3 # /usr/local/sbin/phpxs -r mysql (install the PEAR libraries) # pkg_add php4-pear-4.2.3.tgz ]]> </programlisting> </example> <simpara> Lisez le manuel Unix page <ulink url="&url.openbsd.packages;">packages(7)</ulink> pour plus de d&eacute;tails sur les packages binaires d'OpenBSD. </simpara> </sect2> <sect2 id="install.openbsd.ports"> <title>Utilisation des ports</title> <simpara> Vous pouvez aussi compiler &php; en utilisant le <ulink url="&url.openbsd.ports;">ports tree</ulink>. Cette m&eacute;thode est recommand&eacute;e aux utilisateurs exp&eacute;riment&eacute;s de OpenBSD. Le port PHP4 est scind&eacute; en trois sous-dossier : core, extensions et pear. Le dossier extensions g&eacute;n&egrave;re les sous paquets de tous les modules &php;. Si vous souhaitez ne pas cr&eacute;er ces modules, vous pouvez utiliser la commande en ligne <command>no_*</command> FLAVOR. Par exemple, pour ne pas compiler le module imap, utilisez FLAVOR avec la valeur <command>no_imap</command>. </simpara> </sect2> <sect2 id="install.openbsd.older"> <title>Versions plus anciennes</title> <simpara> Les anciennes versions de OpenBSD utilisait le syst&egrave;me des FLAVORS pour compiler statiquement PHP. Comme il est trop difficile de g&eacute;n&eacute;rer des packages binaires avec cette m&eacute;thode, elle est consid&eacute;r&eacute;e comme obsol&egrave;te. Vous pouvez touours utiliser les anciennes versions stables, mais sachez qu'elles ne sont plus support&eacute;es par l'&eacute;quipe d'OpenBSD. Si vous avez des commentaires sur le sujet, le responsable actuel est <ulink url="mailto:avsm@openbsd.org">Anil Madhavapeddy</ulink>. </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.oreilly.xml +++ phpdoc-fr/chapters/install.oreilly.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.oreilly"> <title>Installation Oreilly Website Pro Server</title> <para> Cette section contient les conseils d'installation sp&eacute;cifiques &agrave; Oreilly Website Pro. </para> <sect2 id="install.oreilly.windows"> <title>Oreilly Website Pro 2.5 et plus r&eacute;cent pour Windows</title> <simpara> Cette liste d&eacute;crit comment installer PHP comme CGI ex&eacute;cutable ou module ISAPI avec Oreilly Website Pro sous Windows. </simpara> <para> <itemizedlist> <listitem> <para> Editez les "Server Properties" et s&eacute;lectionnez l'onglet "Mapping". </para> </listitem> <listitem> <para> Dans la "List" s&eacute;lectionnez "Associations" et entrez le nom de l'extension voulue (".php") et le chemin jusqu'&agrave; l'ex&eacute;cutable (ex. c:\php\php.exe) ou la DLL ISAPI (ex. c:\php\sapi\php4isapi.dll). </para> </listitem> <listitem> <para> S&eacute;lectionnez "Content Types", ajoutez la m&ecirc;me extension "<literal>.php</literal>" et entrez le "content type". Si vous choisissez la forme CGI, entrez "wwwserver/shellcgi"; si vous choisissez la forme module ISAPI, entrez "wwwserver/isapi" (sans les guillemets). </para> </listitem> </itemizedlist> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.otherhttpd.xml +++ phpdoc-fr/chapters/install.otherhttpd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.otherhttpd"> <title>Autres serveurs web</title> <para> PHP peut &ecirc;tre compil&eacute; pour fonctionner avec de nombreux autres serveurs web. Reportez-vous &agrave; <link linkend="install.configure.options.servers">Options particuli&egrave;res aux serveurs web</link> pour une liste compl&egrave;te des options de configuration. Les ex&eacute;cutables PHP CGI sont compatibles avec la majorit&eacute; des serveurs supportant les interfaces CGI. </para> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.problems.xml +++ phpdoc-fr/chapters/install.problems.xml <?xml version="1.0" encoding="iso-8859-1"?> <sect1 id="install.problems"> <title>Des probl&egrave;mes?</title> <sect2> <title>Lisez la FAQ</title> <simpara> Certains probl&egrave;mes sont r&eacute;currents : les plus communs sont list&eacute;s dans la FAQ PHP, disponible &agrave; <link linkend="faq">dans ce manuel</link>. </simpara> </sect2> <sect2 id="install.otherproblems"> <title>Autres probl&egrave;mes</title> <simpara> Si vous &ecirc;tes compl&egrave;tement bloqu&eacute;s, quelqu'un sur la liste de diffusion PHP pourra probablement vous aider. Essayez de consulter les archives, au cas o&ugrave; quelqu'un aurait d&eacute;j&agrave; rencontr&eacute; votre probl&egrave;me. Les archives sont toujours accessibles &agrave; : <ulink url="&url.php;">&url.php;</ulink>. Pour souscrire &agrave; la liste de diffusion, envoyez un mail vide &agrave; <ulink url="mailto:&email.php.install.subscribe;">&email.php.install.subscribe;</ulink>. L'adresse de la mailing liste : <literal>&email.php.install;</literal>. </simpara> <simpara> Si vous voulez obtenir de l'aide sur la liste de diffusion PHP, essayez d'&ecirc;tre concis et clair, et pensez &agrave; donner tous les d&eacute;tails sur votre environnement (OS, version de PHP, serveur web, CGI ou module, &safemode;...), et n'h&eacute;sitez pas &agrave; envoyer suffisamment de code pour que nous puissions reproduire l'erreur. </simpara> </sect2> <sect2 id="install.bugreports"> <title>Rapports de Bug</title> <simpara> Si vous pensez avoir trouv&eacute; un bug dans PHP, n'oubliez pas de le signaler. L'&eacute;quipe de d&eacute;veloppement PHP ne le conna&icirc;t peut &ecirc;tre pas, et si vous ne le signaler pas, vos chances de voir le bug corrig&eacute; sont nulles. Vous pouvez rapporter des bugs gr&acirc;ce au syst&egrave;me de suivi, accessible &agrave; <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. </simpara> <simpara> Lisez les <ulink url="&url.php.bugs.howtoreport;">guides</ulink> (Les bugs : ce qu'il faut faire, et ce qu'il ne faut pas faire) avant d'envoyer n'importe quel rapport! </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.sambar.xml +++ phpdoc-fr/chapters/install.sambar.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.sambar"> <title>Servers-Sambar</title> <para> Cette section contient les notes et conseils d'installation de PHP sur les serveurs Sambar, sur Windows. </para> <sect2 id="install.sambar.windows"> <title>Installation pour Sambar sur Windows</title> <simpara> Cette liste d&eacute;crit comment configurer le module ISAPI avec le serveur Sambar sous Windows. </simpara> <para> <itemizedlist> <listitem> <para> Trouvez le fichier appel&eacute; <filename>mappings.ini</filename> (dans le dossier de configuration), dans le dossier d'installation de Sambar. </para> </listitem> <listitem> <para> Ouvrez <filename>mappings.ini</filename> et ajoutez la ligne suivante, sous la section <literal>[ISAPI]</literal> : <informalexample> <screen> <![CDATA[ *.php = c:\php\php4isapi.dll ]]> </screen> </informalexample> (Cette ligne suppose que PHP a &eacute;t&eacute; install&eacute; dans le dossier <filename>c:\php</filename>.) </para> </listitem> <listitem> <para> Maintenant, red&eacute;marrez le serveur Sambar pour que les modifications prennent effet. </para> </listitem> </itemizedlist> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.solaris.xml +++ phpdoc-fr/chapters/install.solaris.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.solaris"> <title>Installation sous Solaris</title> <para> Cette section contient les notes et conseils d'installation de PHP sur les distributions Solaris. </para> <sect2 id="install.solaris.required"> <title>Logiciels n&eacute;cessaires</title> <para> L'installation Solaris oublie g&eacute;n&eacute;ralement les compilateurs C, et leurs utilitaires. Voici la liste des outils n&eacute;cessaires : <itemizedlist> <listitem> <simpara> gcc (recommand&eacute;, mais d'autres compilateurs C peuvent fonctionner) </simpara> </listitem> <listitem> <simpara> make </simpara> </listitem> <listitem> <simpara> flex </simpara> </listitem> <listitem> <simpara> bison </simpara> </listitem> <listitem> <simpara> m4 </simpara> </listitem> <listitem> <simpara> autoconf </simpara> </listitem> <listitem> <simpara> automake </simpara> </listitem> <listitem> <simpara> perl </simpara> </listitem> <listitem> <simpara> gzip </simpara> </listitem> <listitem> <simpara> tar </simpara> </listitem> </itemizedlist> De plus, vous devrez aussi installer (et peut &ecirc;tre aussi compiler) toutes les librairies n&eacute;cessaires aux extensions (MySQL, ORACLE..). </para> </sect2> <sect2 id="install.solaris.packages"> <title>Utilisation des packages</title> <simpara> Vous pouvez simplifier l'installation Solaris en utilisant pkgadd pour installer la plupart des composants. </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.unix.xml +++ phpdoc-fr/chapters/install.unix.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.unix"> <title>Installation sous UNIX</title> <para> Cette section va vous guider lors du processus d'installation et de configuration de PHP sous Unix. Commencez par &eacute;tudier les sections sp&eacute;cifiques &agrave; votre plate-forme ou &agrave; votre serveur web avant de passer &agrave; l'installation. </para> <para> Pr&eacute;-requis : <itemizedlist> <listitem> <simpara> Connaissance de base d'UNIX (savoir faire un "make" et compiler en C, si besoin). </simpara> </listitem> <listitem> <simpara> Un compilateur ANSI C (pour les codes sources) </simpara> </listitem> <listitem> <simpara> flex (pour compiler) </simpara> </listitem> <listitem> <simpara> bison (pour compiler) </simpara> </listitem> <listitem> <simpara> Un serveur web </simpara> </listitem> <listitem> <simpara> Tous les composants n&eacute;cessaires aux extensions (librairie <acronym>GD</acronym>, <acronym>PDF</acronym>, etc...) </simpara> </listitem> </itemizedlist> </para> <para> Il y a plusieurs fa&ccedil;ons d'installer PHP sur une plate-forme UNIX : soit un processus de compilation-configuration, ou bien avec des packages d&eacute;j&agrave; tout pr&ecirc;ts. Cette documentation se concentre sur la premi&egrave;re solution. </para> <para> La premi&egrave;re partie du processus est faite en ligne de commande, gr&acirc;ce aux options du script <filename>configure</filename>. Cette section pr&eacute;sente l'utilisation des options les plus courantes, mais il y en a beaucoup d'autres &agrave; essayer. Reportez-vous &agrave; la <link linkend="install.configure">liste compl&egrave;te des options de configuration </link> pour une liste exhaustive. Voici les diff&eacute;rentes m&eacute;thodes d'installation de PHP : <itemizedlist> <listitem> <simpara> Comme <link linkend="install.apache">module Apache</link> </simpara> </listitem> <listitem> <simpara> Comme <link linkend="install.fhttpd">module fhttpd</link> </simpara> </listitem> <listitem> <simpara> Pour l'utiliser avec <link linkend="install.otherhttpd">AOLServer, NSAPI, phttpd, Pi3Web, Roxen, thttpd, ou Zeus.</link> </simpara> </listitem> <listitem> <simpara> Comme <link linkend="install.commandline">ex&eacute;cutable CGI</link> </simpara> </listitem> </itemizedlist> </para> <sect2 id="install.unix.apache-module"> <title>Installer PHP comme module Apache</title> <para> PHP peut &ecirc;tre compil&eacute; de nombreuses mani&egrave;res diff&eacute;rentes, mais la plus populaire est le module Apache. La liste suivante est un r&eacute;capitulatif de l'installation. </para> <example id="install.unix.apache-module.quick"> <title>Installer PHP comme module Apache</title> <programlisting role="shell"> <![CDATA[ 1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar 3. gunzip php-x.x.x.tar.gz 4. tar xvf php-x.x.x.tar 5. cd apache_1.3.x 6. ./configure --prefix=/www 7. cd ../php-x.x.x 8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars 9. make 10. make install 11. cd ../apache_1.3.x 12. ./configure --activate-module=src/modules/php4/libphp4.a 13. make 14. make install 15. cd ../php-x.x.x 16. cp php.ini-dist /usr/local/lib/php.ini 17. "Editez votre fichier httpd.conf ou srm.conf et ajoutez : " AddType application/x-httpd-php .php 18. "Utilisez votre proc&eacute;dure habituelle pour red&eacute;marrer le serveur Apache. (vous devez arr&ecirc;ter puis red&eacute;marrer le serveur, et pas seulement forcer le serveur &agrave; relire la configuration initiale). ]]> </programlisting> </example> </sect2> <sect2 id="install.building"> <title>Compilation</title> <simpara> Lorsque PHP est configur&eacute;, vous &ecirc;tes pr&ecirc;ts &agrave; compiler l'ex&eacute;cutable CGI. La commande <command>make</command> doit prendre tout en charge. Si ce n'est pas le cas et que vous restez bloqu&eacute;, reportez-vous aux <link linkend="install.problems">probl&egrave;mes courants</link>. </simpara> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.windows.xml +++ phpdoc-fr/chapters/install.windows.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.windows"> <title>Installation sous Windows</title> <para> Cette section s'applique aux syst&egrave;mes Windows 95/98/Me et Windows NT/2000/XP. (La configuration n'est actuellement pas confirm&eacute;e sous XP). Ne vous attendez pas &agrave; ce que PHP fonctionne sur les plateformes 16 bits, comme Windows 3.1. Parfois, on d&eacute;crira les plateformes support&eacute;es sous le nom de Win32. </para> <para> Il y a deux m&eacute;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 &agrave; partir des sources. </para> <para> Une fois que PHP est install&eacute; sur votre Windows, vous pouvez aussi ajouter diverses <link linkend="install.windows.extensions">extensions</link>. </para> <sect2 id="install.windows.installer"> <title>InstallShield sous Windows</title> <para> 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. Notez bien que bien que InstallShield soit une m&eacute;thode simple pour installer PHP, il est limit&eacute; dans son fonctionnement, puisque l'installation automatique des extensions n'est pas prise en compte. </para> <simpara> Installez votre serveur <acronym>HTTP</acronym> favori sur votre syst&egrave;me et assurez-vous qu'il fonctionne. </simpara> <simpara> Ex&eacute;cutez l'installeur et suivez les instructions fournies par le wizard. Deux types d'installation sont fournis : standard, qui utilise toutes les configurations par d&eacute;faut les plus pratiques, et avanc&eacute;e, qui pose un maximum de questions pour param&eacute;trer le plus finement. </simpara> <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 web est affich&eacute;e, et vous pouvez s&eacute;lectionner les dossiers qui utiliseront PHP. </simpara> <simpara> Une fois l'installation termin&eacute;e, l'installeur vous informera que vous devez red&eacute;marrer. Suivez ce conseil, ou commencez &agrave; utiliser PHP imm&eacute;diatement. </simpara> <warning> <para> Gardez bien &agrave; l'esprit que cette installation de PHP n'est pas s&eacute;curis&eacute;e. Si vous voulez avoir une installation s&eacute;curis&eacute;e de PHP, vous devriez commencer par lire la documentation, et choisir toutes vos options avec soin. Cet installeur automatique vous permet de r&eacute;aliser l'installation en un tour de main, mais n'est pas destin&eacute;e &agrave; l'utilisation sur des serveurs de production. </para> </warning> </sect2> <sect2 id="install.windows.manual"> <title>Manual Installation Steps</title> <title>Instructions G&eacute;n&eacute;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 par t&eacute;l&eacute;charger la distribution de &php; au format compress&eacute; ZIP &agrave; <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. La premi&egrave;re version de ce guide a &eacute;t&eacute; compil&eacute;e par &link.bob;. La version originale est disponible (en anglais) &agrave; <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&eacute;cente recommand&eacute;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&eacute;cent </para> </listitem> <listitem> <para> Oreilly Website Pro </para> </listitem> <listitem> <para> Xitami </para> </listitem> <listitem> <para> Netscape Enterprise Server, iPlanet </para> </listitem> </itemizedlist> </para> <para> PHP 4 pour Windows est d&eacute;clin&eacute; en deux versions : un ex&eacute;cutable CGI (<filename>php.exe</filename>), et plusieurs modules SAPI (par exemple php4isapi.dll). Cette derni&egrave;re forme est nouvelle pour PHP 4 et founit des performances am&eacute;lior&eacute;es ainsi que des fonctionnalit&eacute;s suppl&eacute;mentaires. </para> <warning> <simpara> Les modules SAPI ont &eacute;t&eacute; significativement am&eacute;lior&eacute;e en version 4.1. Toutes fois, vous pouvez rencontrer des erreurs de serveur ou des erreurs de modules tels qu'ASP, dans les anciens syst&egrave;mes. </simpara> </warning> <para> Si vous choisissez l'un des modules SAPI et utilisez Windows 95, pensez &agrave; t&eacute;l&eacute;charger la mise &agrave; jour DCOM &agrave; <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>. Pour le module ISAPI, comme un serveur web compatible est n&eacute;cessaire (test&eacute; avec IIS 4.0, PWS 4.0 et IIS 5.0). IIS 3.0 <emphasis>n'est pas</emphasis> support&eacute;; vous devez t&eacute;l&eacute;charger et installer le Windows NT 4.0 Option Pack avec IIS 4.0 si vous voulez le support natif de PHP. </para> <para> Voici les diff&eacute;rentes &eacute;tapes d'installation avant les &eacute;tapes sp&eacute;cifiques au serveur. <itemizedlist> <listitem> <para> Extrayez la distribution dans le dossier de votre choix. <filename>"C:\php\"</filename> est une bonne id&eacute;e. </para> </listitem> <listitem> <para> Vous devez vous assurer que les DLL que PHP utilise sont disponibles. La liste pr&eacute;cise des DLL d&eacute;pend du serveur web que vous utiliser, et de la m&eacute;thode que vous utiliser pour faire ex&eacute;cuter vos script (CGI ou module). <filename>php4ts.dll</filename> est toujours n&eacute;cessaire. Si vous utiliser 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&eacute;es. Pour &ecirc;tre certains que les DLL sont accessibles, vous pouvez les copier dans le dossier syst&egrave;me (i.e. <filename>winnt/system32</filename> ou <filename>windows/system</filename>) ou vous pouvez vous assurer qu'elles sont dans le m&ecirc;me dossier que l'ex&eacute;cutable PHP ou les autres DLL de votre serveur web (i.e. php.exe, ou php4apache.dll). </para> <para> L'ex&eacute;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&eacute; dans le PATH Windows. Le mieux &agrave; faire est de copier les fichiers ci-dessous dans votre dossier syst&egrave;me, qui est g&eacute;n&eacute;ralement : <simplelist> <member>c:\windows\system pour Windows 9x/Me</member> <member>c:\winnt\system32 pour Windows NT/2000</member> </simplelist> Les fichiers &agrave; copier sont : <simplelist> <member> &apos;php4ts.dll&apos;, s'il existe, &eacute;crasez le </member> <member> Les fichiers &apos;dlls&apos; de votre distribution. Si vous les avez d&eacute;j&agrave; install&eacute;, ne les remplacez pas, sauf si quelquechose ne fonctionne pas correctement (avant de les &eacute;craser, il est recommand&eacute; de les sauver de toutes mani&egrave;res, au cas o&ugrave; quelque chose irait de travers). </member> </simplelist> </para> <para> T&eacute;l&eacute;chargez la derni&egrave;re version de Microsoft Data Access Components (MDAC) pour votre plateforme, sp&eacute;cialement si vous utilisez Microsoft Windows 9x/NT4. MDAC est disponible &agrave; <ulink url="&url.mdac;">&url.mdac;</ulink>. </para> </listitem> <listitem> <para> Copiez le fichier &apos;<filename>php.ini-dist</filename>&apos; dans votre dossier &apos;%WINDOWS%&apos; sous Windows 95/98, ou vers votre dossier &apos;%SYSTEMROOT%&apos; sous Windows NT ou Windows 2000 et renommez le en &apos;&php.ini;&apos;. Votre dossier &apos;%WINDOWS%&apos; ou &apos;%SYSTEMROOT%&apos; est g&eacute;n&eacute;ralement : <simplelist> <member>c:\windows pour Windows 9x/Me</member> <member>c:\winnt ou c:\winnt40 pour les serveurs NT/2000</member> </simplelist> </para> <para> Il y a deux fichiers ini, distribu&eacute;s dans le fichier zip, <filename>php.ini-dist</filename> et <filename>php.ini-optimized</filename>. Nous vous recommandons d'utiliser <filename>php.ini-optimized</filename>, car nous l'avons optimis&eacute; d'un point de vue s&eacute;curit&eacute; et vitesse d'ex&eacute;cution. Le mieux est tout de m&ecirc;me de lire le fichier de configuration <link linkend="configuration.file">php.ini</link> et de choisir vos options manuellement. Si vous voulez atteindre un meilleur niveau de s&eacute;curit&eacute;, c'est par ce moyen que vous pourez le faire, m&ecirc;me si PHP focntionne parfaitement avec les configurations par d&eacute;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&ugrave; vous avez install&eacute; vos 'php_*.dll'. ex: c:\php\extensions </simpara> </listitem> <listitem> <simpara> Si vous utilisez Omni Httpd, sautez l'&eacute;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>. </simpara> </listitem> <listitem> <simpara> Choisissez les modules que vous voulez charger lorsque PHP d&eacute;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&eacute;j&agrave; inclues. Notez aussi qu'il est pr&eacute;f&eacute;rable de commencer par faire fonctionner &php; sur une nouvelle installation avant d'activer des extensions suppl&eacute;mentaires avec &php.ini;. </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 &ecirc;tre d&eacute;plac&eacute; dans le dossier <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> est le p&eacute;riph&eacute;rique o&ugrave; PHP est install&eacute;.) </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&eacute;der &agrave; votre &php.ini;. </simpara> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> Avec PWS, donnez les droits d'ex&eacute;cution au webmestre : <itemizedlist> <listitem> <simpara> D&eacute;marrez le PWS Web Manager </simpara> </listitem> <listitem> <simpara> Editez les Properties du dossier "Home" </simpara> </listitem> <listitem> <simpara> S&eacute;lectionnez la coche "execute" </simpara> </listitem> </itemizedlist> </para> </listitem> </itemizedlist> </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?". Deux raisons viennent imm&eacute;diatement &agrave; l'esprit : </para> <orderedlist> <listitem> <simpara> Windows ne dispose pas (encore) d'une grande communaut&eacute; de d&eacute;veloppeurs qui partagent librement leurs sources. La cons&eacute;quence directe est que les investissements n&eacute;cessaires en infrastructure pour supporter ce type de d&eacute;veloppement n'ont pas &eacute;t&eacute; faits. Ce qui fait que le portage des utilitaires Unix a &eacute;t&eacute; la solution pour pallier ce manque. Ne soyez donc pas surpris de rencontrer cette parent&eacute; de temps en temps. </simpara> </listitem> <listitem> <simpara> La majorit&eacute; des instructions que vous allez rencontrer sont du type : "faire et oublier". Alors, asseyez-vous confortablement et suivez aussi scrupuleusement que possible les instructions. </simpara> </listitem> </orderedlist> <sect3 id="install.windows.build.requirement"> &reftitle.required; <para> Pour compilerl'ex&eacute;cutable &php;, vous avez besoin d'un Microsoft Development Environment. Microsoft Visual C++ 6.0 est recommend&eacute;. Pour &eacute;xtraire le fichier t&eacute;l&eacute;charg&eacute;, vous avez besoin d'un outil de d&eacute;compression (e.g.: Winzip). Si vous n'avez pas encore d'utilitaire de d&eacute;compression, vous pouvez en t&eacute;l&eacute;charger un chez <ulink url="&url.infozip;">InfoZip</ulink>. </para> <para> Avant de commencer, vous devez t&eacute;l&eacute;charger... </para> <itemizedlist> <listitem> <simpara> les win32 buildtools de &php, sur <ulink url="&url.win32.buildtools;">&url.win32.buildtools;</ulink>. </simpara> </listitem> <listitem> <simpara> le code source du r&eacute;solveur de noms DNS utilis&eacute; par &php; sur <ulink url="&url.win32.dnsresolver;">&url.win32.dnsresolver;</ulink>. C'est un remplacement pour la librairie <filename>resolv.lib</filename> inclue dans <filename>win32build.zip</filename>. </simpara> </listitem> <listitem> <simpara> Si vous pr&eacute;voyez de compiler &php; comme module pour Apache, vous aurez aussi besion des <ulink url="&url.apache.source;">sources d'Apache</ulink>. </simpara> </listitem> </itemizedlist> <simpara> Finalement, vous aurez besoin des sources PHP 4 elles-m&ecirc;mes!! Les derni&egrave;res versions sont accessibles sur le serveur CVS <ulink url="&url.php.anoncvs;">anonyme</ulink>. Si vous t&eacute;l&eacute;chargez une version <ulink url="&url.php.snapshots;">interm&eacute;diaire</ulink> ou la <ulink url="&url.php.downloads;">source</ulink>, </simpara> </sect3> <sect3 id="install.windows.build.install"> <title>Compiler tout ensemble</title> <para> Apr&egrave;s t&eacute;l&eacute;chargement des paquets n&eacute;cessaires, vous devez les extraire au bon endroit. <itemizedlist> <listitem> <simpara> Cr&eacute;ez un dossier o&ugrave; tous les fichiers seront plac&eacute;s apr&egrave;s l'extraction, comme par exemple :<filename>c:\work</filename>. </simpara> </listitem> <listitem> <simpara> Cr&eacute;ez le dossier <filename>win32build</filename> dans votre dossier de travail (ici <filename>c:\work</filename>) et d&eacute;compressez <filename>win32build.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> Cr&eacute;ez le dossier <filename>bindlib_w32</filename> sous votre dossier de travail (ici <filename>c:\work</filename>) et d&eacute;compressez <filename>bindlib_w32.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> D&eacute;compressez le code source de &php; dans votre dossier de travail (<filename>c:\work</filename>). </simpara> </listitem> </itemizedlist> Apr&egrave;s avoir suivi ces instructions, vous devriez obtenir un dossier qui ressemble &agrave; ceci : <informalexample> <programlisting> <![CDATA[ +--c:\work | | | +--bindlib_w32 | | | | | +--arpa | | | | | +--conf | | | | | +--... | | | +--php-4.x.x | | | | | +--build | | | | | +--... | | | | | +--win32 | | | | | +--... | | | +--win32build | | | | | +--bin | | | | | +--include | | | | | +--lib ]]> </programlisting> </informalexample> Cr&eacute;ez les dossiers <filename>c:\usr\local\lib</filename>. Copiez le fichier <filename>bison.simple</filename> depuis <filename>c:\work\win32build\bin</filename> vers <filename>c:\usr\local\lib</filename>. </para> <note> <simpara> Les utilisateurs de <ulink url="&url.cygwin;">Cygwin</ulink> peuvent omettre la derni&egrave;re &eacute;table. Un environnement Cygwin correctement install&eacute; fournit les fichiers obligatoires de <filename>bison.simple</filename> et <filename>bison.exe</filename>. </simpara> </note> </sect3> <sect3 id="install.windows.build.configure"> <title>Configuration de MVC ++</title> <para> Lancez Microsoft Visual C++, et allez dans le menu "select Tools =&gt; Options". Dans le dialogue, s&eacute;lectionnez l'onglet "directories". Modifiez les valeurs pour les items du menu Executables, Includes et Library files. Votre configuration doit alors ressembler &agrave; <itemizedlist> <listitem> <simpara> Fichiers &eacute;x&eacute;cutables : <filename>c:\work\win32build\bin</filename>, Utilisateurs Cygwin : <filename>cygwin\bin</filename> </simpara> </listitem> <listitem> <simpara> Fichiers include: <filename>c:\work\win32build\include</filename> </simpara> </listitem> <listitem> <simpara> Fichiers library : <filename>c:\work\win32build\lib</filename> </simpara> </listitem> </itemizedlist> </para> </sect3> <sect3 id="install.windows.build.resolvlib"> <title>Compilation de resolv.lib</title> <para> Vous devez compiler la librairie <filename>resolv.lib</filename>. Decidez si vous avez besoin des symboles de d&eacute;bogage (bindlib - Win32 Debug) ou non (bindlib - Win32 Release). Compilez la configuration ad hoc : <itemizedlist> <listitem> <simpara> Pour les utilisateurs de l'interface graphique, lancez VC++, puis s&eacute;lectionnez le menu "File =&gt; Open Workspace" et "bindlib". Puis s&eacute;lectionnez "Build=&gt;Set Active Configuration" et s&eacute;lectionnez la configuration voulue. Enfin, s&eacute;lectionnez "Build=&gt;Rebuild All". </simpara> </listitem> <listitem> <simpara> Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistr&eacute; les variables d'environnement C++, ou que vous avez ex&eacute;cut&eacute; <command>vcvars.bat</command>. Ex&eacute;cutez maintenant l'une des commandes suivantes : </simpara> <itemizedlist> <listitem> <simpara> <userinput>msdev bindlib.dsp /MAKE "bindlib - Win32 Debug"</userinput> </simpara> </listitem> <listitem> <simpara> <userinput>msdev bindlib.dsp /MAKE "bindlib - Win32 Release"</userinput> </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> A ce stade, vous avez une librairie <filename>resolv.lib</filename> utilisable, soit dans votre dossier <filename>Debug</filename>, soit sans le dossier <filename>Release</filename>. Copiez ce fichier dans votre dossier <filename>win32build\lib</filename>, en rempla&ccedil;ant le fichier du m&ecirc;me nom. </para> </sect3> <sect3 id="install.windows.build.compile"> <title>Compilation</title> <simpara> La meilleure fa&ccedil;on de compiler est de commander par la version CGI/ex&eacute;cutable. </simpara> <itemizedlist> <listitem> <simpara> Pour les utilisateurs GUI, lancez VC++, puis s&eacute;lectionnez le menu "File =&gt; Open Workspace" et s&eacute;lectionnez "php4ts". Ensuite, s&eacute;lectionnez le menu "Build=&gt;Set Active Configuration", et s&eacute;lectionnez la configuration voulue. Finalement, s&eacute;lectionnez le menu "Build=&gt;Rebuild All". </simpara></listitem> <listitem> <simpara> Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistr&eacute; les variables d'environnement C++, ou que vous avez ex&eacute;cut&eacute; <command>vcvars.bat</command>. Ex&eacute;cutez maintenant l'une des commandes suivantes : </simpara> <itemizedlist> <listitem><simpara> <userinput>msdev php4ts.dsp /MAKE "php4ts - Win32 Debug_TS"</userinput> </simpara></listitem> <listitem><simpara> <userinput>msdev php4ts.dsp /MAKE "php4ts - Win32 Release_TS"</userinput> </simpara></listitem> <listitem> <simpara> A ce stade, vous avez un ex&eacute;cutable <filename>php.exe</filename> utilisable, soit dans votre dossier <filename>Debug_TS</filename> soit sans le dossier <filename>Release_TS</filename>. </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> <simpara> Il est possible de faire des modifications particuli&egrave;res mineures en &eacute;ditant le fichier <filename>main/config.win32.h.in</filename>. </simpara> <simpara> Ensuite, vous pouvez compiler la version CLI qui est con&ccedil;ue pour un usage en <link linkend="features.commandline">ligne de commande</link>. Les &eacute;tapes sont les m&ecirc;mes que pour la compilation en mode CGI, hormis le fait que vous devez s&eacute;lectionner <literal>php4ts_cli - Win32 Debug_TS</literal> ou <literal>php4ts_cli - Win32 Release_TS</literal> dans le fichier de proejt. Apr&egrave;s une compilation r&eacute;ussie, vous pouvez ex&eacute;cuter le fichier <filename>php.exe</filename> dans l'un des dossiers <filename>Release_TS\cli\</filename> ou <filename>Debug_TS\cli\</filename>. </simpara> <note> <simpara> Si vous voulez utiliser PEAR et l'installeur en ligne de commande, la version CLI-SAPI est obligatoire. Pour plus d'informations sur le projet PEAR et l'installeur, lisez la documentation sur le site de <ulink url="&.url.php.pear;manual/">PEAR</ulink>. </simpara> </note> <simpara> Afin de compiler le module SAPI (<filename>php4isapi.dll</filename> pour l'int&eacute;grer dans Microsoft IIS, vous devez utiliser la configuration <filename>php4isapi-whatever-config</filename> et compiler la DLL n&eacute;cessaire. </simpara> </sect3> </sect2> <sect2 id="install.windows.extensions"> <title>Installation des extensions sous Windows</title> <para> Apr&egrave;s avoir install&eacute; PHP et votre serveur web sous Windows, vous voudrez s&ucirc;rement ajouter quelques extensions bien pratiques. La table suivante liste une partie des extensions disponibles. Comme indiqu&eacute; dans le manuel, vous pouvez choisir quelles extensions vous voulez charger en d&eacute;commentant la ligne 'extension=php_*.dll' dans le fichier &php.ini;. Vous pouvez aussi charger dynamiquement un module avec la fonction <function>dl</function>. </para> <para> Les fichiers DLLs des extensions PHP sont pr&eacute;fix&eacute;s par 'php_' en PHP 4, et 'php3_' en PHP 3. Cela &eacute;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&eacute; <emphasis>par d&eacute;faut</emphasis>. Vous n'avez pas &agrave; charger d'extensions particuli&egrave;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&eacute;s. </para> </note> <note> <para> Certaines de ces extensions requi&egrave;rent des librairies DLL suppl&eacute;mentaires pour fonctionner correctement. Certaines d'entre elles sont disponibles dans la distribution. dans le dossier <filename>dlls</filename> mais certaines (comme Oracle (php_oci8.dll)), demandent des dlls qui ne sont pas dans la distribution. </para> <para> Copiez les dlls fournies depuis le dossier <filename>dlls</filename> dans votre PATH Windows. Les bons emplacements sont typiquement <simplelist> <member>c:\windows\system pour Windows 9x/Me</member> <member>c:\winnt\system32 pour Windows NT/2000</member> <member>c:\windows\system32 pour Windows XP</member> </simplelist> Si vous les avez d&eacute;j&agrave; d'install&eacute;es sur votre syst&egrave;me, ne les &eacute;crasez que si PHP ne fonctionne pas correctement (et de toutes mani&egrave;res, faites une sauvegarde de ces DLL, en cas de probl&egrave;me). </para> </note> <para> <table> <title>PHP Extensions</title> <tgroup cols="3"> <thead> <row> <entry>Extension</entry> <entry>Description</entry> <entry>Notes</entry> </row> </thead> <tbody> <row> <entry>php_bz2.dll</entry> <entry>Fonctions de compression <link linkend="ref.bzip2">bzip2</link></entry> <entry>Aucune</entry> </row> <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> </row> <row> <entry>php_cpdf.dll</entry> <entry>Fonctions <link linkend="ref.cpdf">ClibPDF</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_crack.dll</entry> <entry>Fonctions de <link linkend="ref.crack">CrackLib</link></entry> <entry>Aucune</entry> </row> <row> <entry>php3_crypt.dll</entry> <entry>Fonctions de Crypt</entry> <entry>Inconnu</entry> </row> <row> <entry>php_ctype.dll</entry> <entry>Fonctions <link linkend="ref.ctype">ctype</link></entry> <entry>Aucune</entry> </row> <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> </row> <row> <entry>php_cybercash.dll</entry> <entry>Fonctions de paiement <link linkend="ref.cybercash">Cybercash</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_db.dll</entry> <entry>Fonctions <link linkend="ref.dbm">DBM</link></entry> <entry>Obsol&egrave;tes. Utilisez DBA &agrave; la place (php_dba.dll)</entry> </row> <row> <entry>php_dba.dll</entry> <entry><link linkend="ref.dba">DBA</link>: DataBase (dbm-style) Abstraction layer functions</entry> <entry>Aucune</entry> </row> <row> <entry>php_dbase.dll</entry> <entry>Fonctions <link linkend="ref.dbase">dBase</link></entry> <entry>Aucune</entry> </row> <row> <entry>php3_dbm.dll</entry> <entry>Fonctions Berkeley DB2</entry> <entry>Inconnu</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> </row> <row> <entry>php_dotnet.dll</entry> <entry>Fonctions <link linkend="ref.dotnet">.NET</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_exif.dll</entry> <entry>Fonctions de lecture des ent&ecirc;tes JPEG <link linkend="function.read-exif-data">Read EXIF</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_fbsql.dll</entry> <entry>Fonctions de <link linkend="ref.fbsql">FrontBase</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_fdf.dll</entry> <entry>Fonctions <link linkend="ref.fdf">FDF</link>: Forms Data Format.</entry> <entry>Requiert : fdftk.dll (fournies)</entry> </row> <row> <entry>php_filepro.dll</entry> <entry>Fonctions <link linkend="ref.filepro">filePro</link></entry> <entry>Acc&egrave;s en lecture seule</entry> </row> <row> <entry>php_ftp.dll</entry> <entry>Fonctions <link linkend="ref.ftp">FTP</link></entry> <entry>Disponible depuis PHP 4.0.3</entry> </row> <row> <entry>php_gd.dll</entry> <entry>Fonctions de traitement des images <link linkend="ref.image">GD</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_gettext.dll</entry> <entry>Fonctions <link linkend="ref.gettext">Gettext</link></entry> <entry>Requiert : gnu_gettext.dll (fournies)</entry> </row> <row> <entry>php_hyperwave.dll</entry> <entry>Fonctions <link linkend="ref.hyperwave">HyperWave</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_iconv.dll</entry> <entry>Fonctions de conversions de jeux de caract&egrave;res <link linkend="ref.iconv">ICONV</link></entry> <entry>Requiert : iconv-1.3.dll (fournies)</entry> </row> <row> <entry>php_ifx.dll</entry> <entry>Fonctions <link linkend="ref.ifx">Informix</link></entry> <entry>Requiert : Informix libraries</entry> </row> <row> <entry>php_iisfunc.dll</entry> <entry>Fonctions de gestion de IIS</entry> <entry>Aucune</entry> </row> <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> </row> <row> <entry>php_ingres.dll</entry> <entry>Fonctions <link linkend="ref.ingres">Ingres II</link></entry> <entry>Requiert : Ingres II libraries</entry> </row> <row> <entry>php_interbase.dll</entry> <entry>Fonctions <link linkend="ref.ibase">InterBase</link></entry> <entry>Requiert : gds32.dll (fournies)</entry> </row> <row> <entry>php_java.dll</entry> <entry>Extension <link linkend="ref.java">Java</link></entry> <entry>Requiert : jvm.dll (fournies)</entry> </row> <row> <entry>php_ldap.dll</entry> <entry>Fonctions <link linkend="ref.ldap">LDAP</link></entry> <entry>Requiert : libsasl.dll (fournies)</entry> </row> <row> <entry>php_mhash.dll</entry> <entry>Fonctions <link linkend="ref.mhash">Mhash</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_ming.dll</entry> <entry>Fonctions de g&eacute;n&eacute;rations de fichiers Flash avec <link linkend="ref.ming">Ming</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_msql.dll</entry> <entry>Fonctions de <link linkend="ref.msql">mSQL</link></entry> <entry>Requiert : msql.dll (fournies)</entry> </row> <row> <entry>php3_msql1.dll</entry> <entry>mSQL 1 client</entry> <entry>Inconnu</entry> </row> <row> <entry>php3_msql2.dll</entry> <entry>mSQL 2 client</entry> <entry>Inconnu</entry> </row> <row> <entry>php_mssql.dll</entry> <entry>Fonctions <link linkend="ref.mssql">MSSQL</link></entry> <entry>Requiert : ntwdblib.dll (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> </row> <row> <entry>php3_nsmail.dll</entry> <entry>Fonctions de email Netscape</entry> <entry>Inconnu</entry> </row> <row> <entry>php3_oci73.dll</entry> <entry>Fonctions Oracle</entry> <entry>Inconnu</entry> </row> <row> <entry>php_oci8.dll</entry> <entry>Fonctions <link linkend="ref.oci8">Oracle 8</link></entry> <entry>Requiert : librairies clientes Oracle 8 </entry> </row> <row> <entry>php_openssl.dll</entry> <entry>Fonctions <link linkend="ref.openssl">OpenSSL</link></entry> <entry>Requiert : libeay32.dll (fournies)</entry> </row> <row> <entry>php_oracle.dll</entry> <entry>Fonctions de <link linkend="ref.oracle">Oracle 7</link></entry> <entry>Requiert : librairies clientes Oracle 7</entry> </row> <row> <entry>php_pdf.dll</entry> <entry>Fonctions de <link linkend="ref.pdf">PDF</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_pgsql.dll</entry> <entry>Fonctions de <link linkend="ref.pgsql">PostgreSQL</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_printer.dll</entry> <entry>Fonctions d'<link linkend="ref.printer">impressions</link></entry> <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> </row> <row> <entry>php_snmp.dll</entry> <entry>Fonctions <link linkend="ref.snmp">SNMP</link></entry> <entry>NT only!</entry> </row> <row> <entry>php_sybase_ct.dll</entry> <entry>Fonctions <link linkend="ref.sybase">Sybase</link></entry> <entry>Requiert : librairies clientes Sybase</entry> </row> <row> <entry>php_yaz.dll</entry> <entry>Fonctions <link linkend="ref.yaz">YAZ</link></entry> <entry>Aucune</entry> </row> <row> <entry>php_zlib.dll</entry> <entry>Fonctions de compression <link linkend="ref.zlib">ZLib</link></entry> <entry>Aucune</entry> </row> </tbody> </tgroup> </table> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/install.xitami.xml +++ phpdoc-fr/chapters/install.xitami.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="install.xitami"> <title>Installation Xitami</title> <para> Cette section contient les conseils d'installation sp&eacute;cifiques &agrave; Xitami. </para> <sect2 id="install.xitami.windows"> <title>Xitami pour Windows</title> <simpara> Cette liste d&eacute;crit comment installer PHP comme CGI ex&eacute;cutable ou module ISAPI avec Xitami sous Windows. </simpara> <para> <itemizedlist> <listitem> <para> Assurez-vous que le serveur web fonctionne, et allez dans la console d'administration du serveur (g&eacute;n&eacute;ralement <literal>http://127.0.0.1/admin</literal>), puis cliquez sur "Configuration". </para> </listitem> <listitem> <para> Naviguez dans les "Filters", et ajoutez l'extension que vous souhaitez (souvent ".php") dans le champs "File extensions". </para> </listitem> <listitem> <para> Dans la commande "Filter", ajoutez le nom et le chemin de votre ex&eacute;cutable PHP (souvent <filename>c:\php\php.exe</filename>). </para> </listitem> <listitem> <para> Cliquez sur le bouton "Save". </para> </listitem> <listitem> <para> Red&eacute;marrez le serveur pour prendre en compte les modifications. </para> </listitem> </itemizedlist> </para> </sect2> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/streams.common.xml +++ phpdoc-fr/chapters/streams.common.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- 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 required for php-doc restructuring purposes - just drop me a line if you make a change (so I can update my local copy). --> <sect1 id="stream.common-api"> <title>R&eacute;f&eacute;rence des API communes de fl&ocirc;ts</title> <refentry id="streams.php-stream-stat-path"> <refnamediv> <refname>php_stream_stat_path</refname> <refpurpose>Lit l'&eacute;tat du fichier ou de l'URL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_stat_path</methodname> <methodparam><type>char *</type><parameter>path</parameter></methodparam> <methodparam><type>php_stream_statbuf *</type><parameter>ssb</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_stat_path</function> &eacute;xamine le fichier ou l'URL sp&eacute;cifi&eacute; par <parameter>path</parameter> et retourne des informations telles que la taille, les droits d'acc&egrave;s, la date de cr&eacute;ation, etc... La valeur retourn&eacute;e est 0 en cas de succ&egrave;s, et -1 en cas d'&eacute;chec. Pour plus d'informations, voyez <link linkend="streams.struct-php-stream-statbuf">php_stream_statbuf</link>. </para> </refsect1> </refentry> <refentry id="streams.php-stream-stat"> <refnamediv> <refname>php_stream_stat</refname> <refpurpose>Lit le statut du cache associ&eacute; au fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_stat</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>php_stream_statbuf *</type><parameter>ssb</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_stat</function> examine le syst&egrave;me de stocker du fl&ocirc;t <parameter>stream</parameter>, et retourne des informations telles que la taille de fichier, les droits d'acc&egrave;s, la date de cr&eacute;ation, etc... La valeur retourn&eacute;e est 0 en cas de succ&egrave;s, et -1 en cas d'&eacute;chec. Pour plus d'informations sur les informations retourn&eacute;es, voyez <link linkend="streams.struct-php-stream-statbuf">php_stream_statbuf</link>. </para> </refsect1> </refentry> <refentry id="streams.php-stream-open-wrapper"> <refnamediv> <refname>php_stream_open_wrapper</refname> <refpurpose>Ouvre un fl&ocirc;t sur un fichier ou une URL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_open_wrapper</methodname> <methodparam><type>char *</type><parameter>path</parameter></methodparam> <methodparam><type>char *</type><parameter>mode</parameter></methodparam> <methodparam><type>int</type><parameter>options</parameter></methodparam> <methodparam><type>char **</type><parameter>opened</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_open_wrapper</function> ouvre un fichier, une URL ou n'importe quelle ressource g&eacute;r&eacute;, sp&eacute;cifi&eacute;e par <parameter>path</parameter>. Suivant la valeur de <parameter>mode</parameter>, le fl&ocirc;t peut &ecirc;tre ouvert en lecture, &eacute;criture, ajout ou une combinaison des trois. Voyez la table ci-dessous pour conna&icirc;tres les modes utilis&eacute;es. De plus vous pouvez aussi int&eacute;grer le caract&egrave;re 'b' comme deuxi&egrave;me ou derni&egrave;re option. Sa pr&eacute;sence indiquera que le fl&ocirc;t fonctionnera en mode binaire. </para> <para> L'option 'b' est ignor&eacute;e sur les syst&egrave;mes POSIX, qui traitent les fichiers textes et binaires de la m&ecirc;me fa&ccedil;on. C'est une bonne id&eacute;e que de sp&eacute;cifier 'b' &agrave; chaque fois que votre fl&ocirc;t acc&egrave;de &agrave; des donn&eacute;es binaires, pour que votre code fonctionne lorsqu'il est compil&eacute; sur un syst&egrave;me où 'b' serait important. </para> <para> Tous les fichiers locaux cr&eacute;&eacute;s par l'API des fl&ocirc;ts recevront les droits par d&eacute;faut du syst&egrave;me : sous Unix, cela signifie que le masque utilisateur du processus sera utilis&eacute;. Sous Windows, le fichier sera donn&eacute; au propri&eacute;taire du processus. Tous les fichiers distants seront cr&eacute;&eacute; suivant le protocole utilis&eacute;, et les droits utilis&eacute;s seront ceux du serveur distant. </para> <para> <variablelist> <varlistentry> <term> <constant>r</constant> </term> <listitem> <simpara> Ouvre le fichier texte en mode lecture. Le pointeur du fl&ocirc;t est plac&eacute; au d&eacute;but du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>r+</constant> </term> <listitem> <simpara> Ouvre le fichier texte en lecture et &eacute;criture. Le pointeur du fl&ocirc;t est plac&eacute; au d&eacute;but du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>w</constant> </term> <listitem> <simpara> Tronque le fichier &agrave; une taille de 0 ou bien cr&eacute;e le fichier, puis l'ouvre en mode &eacute;criture. Le pointeur du fl&ocirc;t est plac&eacute; au d&eacute;but du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>w+</constant> </term> <listitem> <simpara> Tronque le fichier &agrave; une taille de 0 ou bien cr&eacute;e le fichier, puis l'ouvre en mode &eacute;criture et lecture. Le pointeur du fl&ocirc;t est plac&eacute; au d&eacute;but du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>a</constant> </term> <listitem> <simpara> Ouvre le fichier en mode d'&eacute;criture. Le fichier est cr&eacute;&eacute; si il n'existe pas. Le pointeur de fl&ocirc;t est positionn&eacute; &agrave; la fin du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>a+</constant> </term> <listitem> <simpara> Ouvre le fichier en mode d'&eacute;criture et lecture. Le fichier est cr&eacute;&eacute; si il n'existe pas. Le pointeur de fl&ocirc;t est positionn&eacute; &agrave; la fin du fichier. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> <parameter>options</parameter> affecte l'interpr&eacute;tation du path ou de l'URL, les v&eacute;rifications du safe_mode et les actions &agrave; prendre lorsqu'il y a une erreur. Voyez <link linkend="streams.options">Stream open options</link> pour plus de d&eacute;tails sur ces options. </para> <para> Si <parameter>opened</parameter> est non NULL, il sera assign&eacute; avec le nom du fichier ou de la ressource qui aura &eacute;t&eacute; r&eacute;ellement ouverte. C'est important lorsque l'option inclus <constant>USE_PATH</constant>, qui permet de fouiller l'include_path pour rechercher le fichier. Vous, l'appelant, &ecirc;tes responsable de l'appel de <function>efree</function> sur le nom de fichier retourn&eacute; par ce param&egrave;tre. </para> <note> <simpara> Si vous avez sp&eacute;cifi&eacute; l'option <constant>STREAM_MUST_SEEK</constant> dans <parameter>options</parameter>, le chemin retourn&eacute; dans <parameter>opened</parameter> peut ne pas &ecirc;tre le m&ecirc;me que celui qui vous a &eacute;t&eacute; r&eacute;ellemetn retourn&eacute;. Toutes fois, ce sera le nom de la ressource originale &agrave; partir de laquelle un fl&ocirc;t &agrave; pointeur variable a &eacute;t&eacute; cr&eacute;&eacute;. </simpara> </note> </refsect1> </refentry> <refentry id="streams.php-stream-read"> <refnamediv> <refname>php_stream_read</refname> <refpurpose>Lit des octets depuis un fl&ocirc;t dans un buffer</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>size_t</type><methodname>php_stream_read</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>char *</type><parameter>buf</parameter></methodparam> <methodparam><type>size_t</type><parameter>count</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_read</function> lit jusqu'&agrave; <parameter>count</parameter> octets dans le fl&ocirc;t <parameter>stream</parameter> puis les copie dans le buffer <parameter>buf</parameter>. </para> <para> <function>php_stream_read</function> retourne le nombre d'octets lus. Il n'y a pas de disctinction entre une lecture qui &eacute;choue et la fin du fichier : utilisez <function>php_stream_eof</function> pour tester la fin du fichier avec <constant>EOF</constant>. </para> <para> Le pointeur de position dans le fl&ocirc;t est avanc&eacute; d'autant d'octets que le nombre qui en a &eacute;t&eacute; lu. Par cons&eacute;quent, la prochaine lecture reprendra l&agrave; ou la lecture pr&eacute;c&eacute;dente s'est arr&ecirc;t&eacute;e. </para> <para> Si moins de <parameter>count</parameter> octets ont &eacute;t&eacute; lus, cet appel bloquera l'application jusqu'&agrave; ce que le nombre d'octets n&eacute;cessaire soit atteint, en fonction de la configuration du fl&ocirc;t (bloquant, non bloquant). Par d&eacute;faut, un fl&ocirc;t est ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant ne vous g&egrave;nera pas. Lors que le fl&ocirc;t atteint <constant>EOF</constant> <function>php_stream_read</function> retournera un nombre d'octets lus inf&eacute;rieur &agrave; <parameter>count</parameter>, puis il retournera 0 aux prochaines lectures. </para> </refsect1> </refentry> <refentry id="streams.php-stream-write"> <refnamediv> <refname>php_stream_write</refname> <refpurpose>ƒcrit des octets depuis un buffer vers un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>size_t</type><methodname>php_stream_write</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>const char *</type><parameter>buf</parameter></methodparam> <methodparam><type>size_t</type><parameter>count</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_write</function> &eacute;crit <parameter>count</parameter> octets du buffer <parameter>buf</parameter> dans le flot <parameter>stream</parameter>. </para> <para> <function>php_stream_write</function> retourne le nombre d'octets qui ont &eacute;t&eacute; &eacute;crit. Si il y a eu une erreur, le nombre d'octets &eacute;crit sera inf&eacute;rieur au param&egrave;tre <parameter>count</parameter>. </para> <para> Le pointeur de position dans le fl&ocirc;t est avanc&eacute; d'autant d'octets que le nombre qui en a &eacute;t&eacute; &eacute;crit. Par cons&eacute;quent, la prochaine &eacute;criture reprendra l&agrave; ou la lecture pr&eacute;c&eacute;dente s'est arr&eacute;t&eacute;. </para> </refsect1> </refentry> <refentry id="streams.php-stream-eof"> <refnamediv> <refname>php_stream_eof</refname> <refpurpose>V&eacute;rifie que le pointeur n'est pas au bout du fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_eof</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_eof</function> v&eacute;rifie que le pointeur n'est pas au bout du fl&ocirc;t <parameter>stream</parameter>. </para> <para> <function>php_stream_read</function> retourne 1 pour indiquer la fin du fl&ocirc;t (<constant>EOF</constant>), 0 si il n'y a pas de fin de fl&ocirc;t, et -1 pour indiquer une erreur. </para> </refsect1> </refentry> <refentry id="streams.php-stream-getc"> <refnamediv> <refname>php_stream_getc</refname> <refpurpose>Lit un octet dans un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_getc</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_getc</function> lit un octet dans le fl&ocirc;t <parameter>stream</parameter> puis le retourne de type unsigned char transtyp&eacute; en int, ou <constant>EOF</constant> si la fin du fl&ocirc;t est atteinte, ou bien si une erreur est survenue. </para> <para> <function>php_stream_getc</function> peut bloquer l'application de la m&ecirc;me fa&ccedil;on que <function>php_stream_read</function> bloque. </para> <para> Le pointeur de position est avanc&eacute; d'une position si la lecture r&eacute;ussit. </para> </refsect1> </refentry> <refentry id="streams.php-stream-gets"> <refnamediv> <refname>php_stream_gets</refname> <refpurpose>Lit une ligne de donn&eacute;es d'un fl&ocirc;t dans un buffer</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>char *</type><methodname>php_stream_gets</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>char *</type><parameter>buf</parameter></methodparam> <methodparam><type>size_t</type><parameter>maxlen</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_gets</function> lit jusqu'&agrave; <parameter>count</parameter>-1 octets de donn&eacute;es dans le fl&ocirc;t <parameter>stream</parameter> puis les copies dans le buffer <parameter>buf</parameter>. La lecture s'arr&ecirc;te apr&egrave;s la rencontre de la fin du fichier (<constant>EOF</constant>) ou une nouvelle ligne. Si la nouvelle ligne est lue, elle est stock&eacute;e dans <parameter>buf</parameter> dans les donn&eacute;es retourn&eacute;es. Un caract&egrave;re NUL de fin de cha&icirc;ne est stock&eacute; comme dernier caract&egrave;re dans le buffer. </para> <para> <function>php_stream_read</function> retourne <parameter>buf</parameter> lorsque cela focntionn, et NULL sinon. </para> <para> Le pointeur de position est avanc&eacute; d'une position si la lecture r&eacute;ussit. </para> <para> <function>php_stream_gets</function> peut bloquer l'application de la m&ecirc;me fa&ccedil;on que <function>php_stream_read</function> bloque. </para> </refsect1> </refentry> <refentry id="streams.php-stream-close"> <refnamediv> <refname>php_stream_close</refname> <refpurpose>Ferme un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_close</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_close</function> ferme correctement le fl&ocirc;t <parameter>stream</parameter> et lib&egrave;re les ressources qui lui sont associ&eacute;es. Apr&agrave;s la fermeture de <parameter>stream</parameter>, il prend une valeur ind&eacute;finie, et ne devrait plus &ecirc;tre utilis&eacute;. </para> <para> <function>php_stream_close</function> retourne 0 si le fl&ocirc;t a &eacute;t&eacute; ferm&eacute;, ou bien <constant>EOF</constant> pour indiquer une erreur. Ind&eacute;pendamment du succ&egrave;s de l'op&eacute;ration, <parameter>stream</parameter> prend une valeur ind&eacute;finie, et ne devrait plus &ecirc;tre utilis&eacute;. </para> </refsect1> </refentry> <refentry id="streams.php-stream-flush"> <refnamediv> <refname>php_stream_flush</refname> <refpurpose>Vide les buffers dans le fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_flush</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_flush</function> vide toutes les donn&eacute;es contenues dans les buffers d'&eacute;criture du fl&ocirc;t <parameter>stream</parameter> et force leur stockage. </para> <para> <function>php_stream_flush</function> retourne 0 si les buffers ont &eacute;t&eacute; vid&eacute;s, ou si les buffers n'ont pas besoin d'&ecirc;tre vid&eacute;, mais retourne <constant>EOF</constant> pour indiquer une erreur. </para> </refsect1> </refentry> <refentry id="streams.php-stream-seek"> <refnamediv> <refname>php_stream_seek</refname> <refpurpose>Modifie la position du pointeur de fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_seek</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>off_t</type><parameter>offset</parameter></methodparam> <methodparam><type>int</type><parameter>whence</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_seek</function> modifie la position du pointeur de position du fl&ocirc;t <parameter>stream</parameter>. La nouvelle position est d&eacute;termin&eacute;e en ajoutant <parameter>offset</parameter> &agrave; la position indiqu&eacute;e par <parameter>whence</parameter>. Si <parameter>whence</parameter> vaut <constant>SEEK_SET</constant>, <constant>SEEK_CUR</constant> ou <constant>SEEK_END</constant> l'offset sera relativ au d&eacute;but du fl&ocirc;t, &agrave; la position courante ou &agrave; la fin du fl&ocirc;t, respectivement. </para> <para> <function>php_stream_seek</function> retourne 0 en cas de succ&egrave;s, et -1 en cas d'erreur. </para> <note> <para> Tous les fl&ocirc;ts ne supportent pas la modification de la position du pointeur, m&ecirc;me si l'API va &eacute;muler un tel pointeur si <parameter>whence</parameter> vaut <constant>SEEK_CUR</constant> et <parameter>offset</parameter> est positif, en appelant <function>php_stream_read</function> pour lire (et ignorer) <parameter>offset</parameter> octets. </para> <para> L'&eacute;mulation est uniquement appliqu&eacute;e si l'impl&eacute;mentation du gestionnaire de fl&ocirc;t suporte le pointeur de position. Si le fl&ocirc;t est (par exemple) bas&eacute; sur des fichiers qui travaille avec des fl&ocirc;t de pipes, l'API de fl&ocirc;t ne pourra pas appliquer une telle &eacute;mulation. Le positionnement du pointeur de fl&ocirc;t &eacute;chouera et une erreur sera retourn&eacute;e. </para> </note> </refsect1> </refentry> <refentry id="streams.php-stream-tell"> <refnamediv> <refname>php_stream_tell</refname> <refpurpose>D&eacute;termine la position du pointeur dans un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>off_t</type><methodname>php_stream_tell</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_tell</function> retourne la position du pointeur du fl&ocirc;t <parameter>stream</parameter>, relativement au d&eacute;but du fl&ocirc;t. Si une erreur survient, retourne -1. </para> </refsect1> </refentry> <refentry id="streams.php-stream-copy-to-stream"> <refnamediv> <refname>php_stream_copy_to_stream</refname> <refpurpose>Copie des donn&eacute;es d'un fl&ocirc;t &agrave; l'autre</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>size_t</type><methodname>php_stream_copy_to_stream</methodname> <methodparam><type>php_stream *</type><parameter>src</parameter></methodparam> <methodparam><type>php_stream *</type><parameter>dest</parameter></methodparam> <methodparam><type>size_t</type><parameter>maxlen</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_copy_to_stream</function> essaie de lire un maximum de <parameter>maxlen</parameter> octets dans le fl&ocirc;t <parameter>src</parameter> puis de les &eacute;crire dans le fl&ocirc;t <parameter>dest</parameter>. La fonction retourne le nombre d'octets copi&eacute;s. </para> <para> Si vous souhaitez copier tous les octets restants dans le fl&ocirc;t <parameter>src</parameter>, passez la constante <constant>PHP_STREAM_COPY_ALL</constant> comme valeur de <parameter>maxlen</parameter>. </para> <note> <simpara> Cette fonction va essayer d'effectuer la copie de la mani&egrave;re la plus efficace, en utilise dans buffer m&eacute;moire lorsque c'est possible. </simpara> </note> </refsect1> </refentry> <refentry id="streams.php-stream-copy-to-mem"> <refnamediv> <refname>php_stream_copy_to_mem</refname> <refpurpose>Copie des donn&eacute;es depuis un fl&ocirc;t dans un buffer</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>size_t</type><methodname>php_stream_copy_to_mem</methodname> <methodparam><type>php_stream *</type><parameter>src</parameter></methodparam> <methodparam><type>char **</type><parameter>buf</parameter></methodparam> <methodparam><type>size_t</type><parameter>maxlen</parameter></methodparam> <methodparam><type>int</type><parameter>persistent</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_copy_to_mem</function> alloue un buffer de taille <parameter>maxlen</parameter>+1 en utilisant la fonction <function>pemalloc</function> (en passant <parameter>persistent</parameter>). Puis, elle lit <parameter>maxlen</parameter> octets depuis le fl&ocirc;t from <parameter>src</parameter> and stores them in the allocated buffer. </para> <para> The allocated buffer is returned in <parameter>buf</parameter>, and the number of bytes successfully read. You, the caller, are responsible for freeing the buffer by passing it and <parameter>persistent</parameter> to <function>pefree</function>. </para> <para> If you want to copy all remaining data from the <parameter>src</parameter> stream, pass the constant <constant>PHP_STREAM_COPY_ALL</constant> as the value of <parameter>maxlen</parameter>. </para> <note> <simpara> Cette fonction va essayer d'effectuer la copie de la mani&egrave;re la plus efficace, en utilise dans buffer m&eacute;moire lorsque c'est possible. </simpara> </note> </refsect1> </refentry> <refentry id="streams.php-stream-make-seekable"> <refnamediv> <refname>php_stream_make_seekable</refname> <refpurpose>Convertit un fl&ocirc;t en fl&ocirc;t avec un pointeur de position</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_make_seekable</methodname> <methodparam><type>php_stream *</type><parameter>origstream</parameter></methodparam> <methodparam><type>php_stream **</type><parameter>newstream</parameter></methodparam> <methodparam><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_make_seekable</function> v&eacute;rifie si <parameter>origstream</parameter> dispose d'un pointeur de potision. Si ce n'est pas le cas, il va copier les donn&eacute;es du fl&ocirc;t dans un autre fl&ocirc;t temporaire, et disposant d'un pointeur de position. Si cela fonctionne, <parameter>newstream</parameter> sera un fl&ocirc;t valide m&ecirc;me si le fl&ocirc;t original avait d&eacute;j&agrave; un pointeur de position. </para> <para> <parameter>flags</parameter> vous permet de sp&eacute;cifier votre pr&eacute;f&eacute;rence pour le fl&ocirc;t retourn&eacute; : utilisez la constante <constant>PHP_STREAM_NO_PREFERENCE</constant> pour utiliser le fl&ocirc;t &agrave; pointeur de position par d&eacute;faut (qui utilise la m&eacute;moire, mais passe automatiquement sur un fichier si le fichier devient trop grand), ou bien utilisez <constant>PHP_STREAM_PREFER_STDIO</constant> pour utiliser un fichier temporaire classique. </para> <para> <table> <title>Valeurs retourn&eacute;es par <function>php_stream_make_seekable</function></title> <tgroup cols="2"> <thead> <row> <entry>Valeur</entry> <entry>Signification</entry> </row> </thead> <tbody> <row> <entry>PHP_STREAM_UNCHANGED</entry> <entry>Le fl&ocirc;t original avait d&eacute;j&agrave; son pointeur de position. <parameter>newstream</parameter> vaut <parameter>origstream</parameter>. </entry> </row> <row> <entry>PHP_STREAM_RELEASED</entry> <entry>Le fl&ocirc;t originl n'avait pas pointeur de position, et il a &eacute;t&eacute; d&eacute;truit. Vous n'avez plus acc&egrave;s &agrave; <parameter>origstream</parameter>. </entry> </row> <row> <entry>PHP_STREAM_FAILED</entry> <entry>Une erreur est survenue lors de la conversion. <parameter>newstream</parameter> vaut NULL; <parameter>origstream</parameter> est toujours valide. </entry> </row> <row> <entry>PHP_STREAM_CRITICAL</entry> <entry>Une erreur est survenue lors de la conversion de <parameter>origstream</parameter>, qui est maintenant dans un &eacute;tat ind&eacute;termin&eacute;. <parameter>newstream</parameter> vaut NULL et il est tr&egrave;s recommand&eacute; que vous vous fermiez <parameter>origstream</parameter>. </entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Si vous devez d&eacute;placer le pointeur et &eacute;crire dans le fl&ocirc;t, n'utilisez pas cette fonction, car le fl&ocirc;t retourn&eacute; est un fl&ocirc;t mis en cache. Il n'est pas garantit qu'il soit li&eacute; &agrave; la ressource originale. </simpara> </note> <note> <simpara> Si vous avez uniquement de d&eacute;placer le pointeur de position vers l'avant, il n'y a pas besoin d'appeler cette fonction, car l'API va automatiquement &eacute;muler ce fonctionnement avec le param&egrave;tre whence &agrave; la valeur <constant>SEEK_CUR</constant>. </simpara> </note> <note> <simpara> Si <parameter>origstream</parameter> repose sur le r&eacute;seau, cette fonction va se bloquer jusqu'&agrave; ce que tout le contenu soit t&eacute;l&eacute;charg&eacute;. </simpara> </note> <note> <simpara> NE JAMAIS appeler cette fonction avec un fl&ocirc;t <parameter>origstream</parameter> qui est une r&eacute;f&eacute;rence &agrave; un pointeur de fichier dans un script PHP. Cette fonction pourrait alors fermer le fichier, ce qui conduira &agrave; un crash au prochain acc&egrave;s au pointeur. </simpara> </note> <note> <simpara> Dans de nombreux cas, cette fontion ne peut r&eacute;ussir que si <parameter>origstream</parameter> vient d'&ecirc;tre tout juste ouvert, et qu'aucune donn&eacute;es n'ont &eacute;t&eacute; mises dans les caches de la couche de fl&ocirc;t. Pour cette raison, et parceque cette fonction est compliqu&eacute;e &agrave; utiliser correctement, il est recommand&eacute; que vous utilisiez la fonction <function>php_stream_open_wrapper</function> en lui passant la constante <constant>PHP_STREAM_MUST_SEEK</constant> dans vos options, au lieu d'appeler cette fonction directement. </simpara> </note> </refsect1> </refentry> <refentry id="streams.php-stream-cast"> <refnamediv> <refname>php_stream_cast</refname> <refpurpose>Convertit un fl&ocirc;t en une autre forme, comme un FILE* ou une socket</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_cast</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>int</type><parameter>castas</parameter></methodparam> <methodparam><type>void **</type><parameter>ret</parameter></methodparam> <methodparam><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_cast</function> tente de convertir le fl&ocirc;t <parameter>stream</parameter> en un autre ressource indiqu&eacute; par <parameter>castas</parameter>. Si <parameter>ret</parameter> est NULL, le fl&ocirc;t est interrog&eacute; pour savoir une telle conversoin est posible, sans effectuer r&eacute;ellemnt la conversion (mais certains &eacute;tat interne pourrait &ecirc;tre chang&eacute;s dans ce cas). Si <parameter>flags</parameter> vaut <constant>REPORT_ERRORS</constant>, un message d'erreur appara&icirc;tra si une erreur survient durant la conversion. </para> <note> <para> Cette fonction retourne <constant>SUCCESS</constant> en cas de r&eacute;ussite et <constant>FAILURE</constant> en cas d'&eacute;chec. Soyez pr&eacute;venu que vous devez faire une comparaison explicite avec <constant>SUCCESS</constant> ou <constant>FAILURE</constant> &agrave; cause des valeurs sous jacentes de ces constantes. Une simple comparaison d'expression bool&eacute;enne ne sera pas interpr&eacute;t&eacute;e comme vous le souhaitez. </para> </note> <para> <table> <title>Types de ressources de <parameter>castas</parameter></title> <tgroup cols="2"> <thead> <row> <entry>Valeur</entry> <entry>Signification</entry> </row> </thead> <tbody> <row> <entry>PHP_STREAM_AS_STDIO</entry> <entry>Un pointeur ANSI FILE* qui repr&eacute;sente le fl&ocirc;t</entry> </row> <row> <entry>PHP_STREAM_AS_FD</entry> <entry>Un pointeur de fichier de type POSIX qui repr&eacute;sente le fl&ocirc;t</entry> </row> <row> <entry>PHP_STREAM_AS_SOCKETD</entry> <entry>Un pointeur de socket r&eacute;seau qui repr&eacute;sente le fl&ocirc;t</entry> </row> </tbody> </tgroup> </table> </para> <para> En plus des types de ressources basiques ci-dessus, le processus de conversion peut &ecirc;tre modifi&eacute; en utilisant les param&egrave;tres ci-dessous, ou bien en utilisant l'op&eacute;rateur OR pour combiner le type de ressource avec une ou plusieurs des valeurs suivantes : <table> <title>Types de ressources pour <parameter>castas</parameter></title> <tgroup cols="2"> <thead> <row> <entry>Valeur</entry> <entry>Signification</entry> </row> </thead> <tbody> <row> <entry>PHP_STREAM_CAST_TRY_HARD</entry> <entry>Essaie aussi fort que possible, m&ecirc;me si c'est au prix de quelques ressources suppl&eacute;mentaires, que la conversion r&eacute;ussisse</entry> </row> <row> <entry>PHP_STREAM_CAST_RELEASE</entry> <entry>Informque l'API de fl&ocirc;t que d'autre code (possible une librairie tierce partie) sera responsable de la gestion des ressources de bas niveau. Cela fait que le fl&ocirc;t <parameter>stream</parameter> sera ferm&eacute; de telle fa&ccedil;on &agrave; ce que le gestionnaire soit pr&eacute;serv&eacute; et retourn&eacute; dans le param&egrave;tre <parameter>ret</parameter>. Si la fonction r&eacute;ussit, le param&egrave;tre <parameter>stream</parameter> doit &ecirc;tre consid&eacute;r&eacute; comme ferm&eacute;, et inutilisable en l'&eacute;tat. </entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Si votre syst&egrave;me supporte la fonction <function>fopencookie</function> (les syst&egrave;mes utilisant la librairie glibc 2 ou plus r&eacute;cent), l'API de fl&ocirc;t sera toujours capable de cr&eacute;er des pointeurs de fichiers de type ANSI FILE* pour tous les fl&ocirc;ts. M&ecirc;me si c'est extr&ecirc;mement utile pour passer des fl&ocirc;ts PHP &agrave; des librairie tierce partie, un tel syst&egrave;me n'est pas portable. Il est demand&eacute; que vous consid&eacute;riez la portabilit&eacute; e vos fonctions avant de diffuser votre extension. Si l'utilisation de fopencookie() n'est pas d&eacute;sirable, il est recommand&eacute; d'interroger le fl&ocirc;t pour voir si il supporte naturellement la conversion en FILE* en utilisant la fonction <function>php_stream_is</function> </simpara> </note> <note> <simpara> Si vous demandez une socket r&eacute;seau &agrave; la place d'un FILE*, l'API de fl&ocirc;ts va utiliser la fonction <function>fdopen</function> pour la cr&eacute;er pour vous. Soyez pr&eacute;venu que faire cela risque de perdre les donn&eacute;es qui ont &eacute;t&eacute; mises en buffer dans le fl&ocirc;t, si vous m&eacute;langer des appels de l'API de fl&ocirc;t et les appels standard ANSI. </simpara> </note> <para> Voir aussi <function>php_stream_is</function> et <function>php_stream_can_cast</function>. </para> </refsect1> </refentry> <refentry id="streams.php-stream-can-cast"> <refnamediv> <refname>php_stream_can_cast</refname> <refpurpose>D&eacute;termine si un fl&ocirc;t peut &ecirc;tre converti en une autre forme, comme FILE* ou socket</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_can_cast</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>int</type><parameter>castas</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_can_cast</function> est l'&eacute;quivalent de la fonction <function>php_stream_cast</function> avec le param&egrave;tre <parameter>ret</parameter> mis &agrave; NULL, et le param&egrave;tre <parameter>flags</parameter> mis &agrave; 0. Elle retourne <constant>SUCCESS</constant> si le fl&ocirc;t peut &ecirc;tre converti dans la forme demand&eacute;e, ou bien <constant>FAILURE</constant> si la conversion ne peut se faire. </para> <note> <simpara> Bien que cette fonction n'effectue aucune conversion, il est possible que certains &eacute;tat interne du fl&ocirc;t soient modifi&eacute;s. </simpara> </note> <note> <simpara> Vous devez explicitement comparer la valeur de retour avec une des constantes, comme d&eacute;crit dans <function>php_stream_cast</function>. </simpara> </note> <para> Voir aussi <function>php_stream_cast</function> et <function>php_stream_is</function>. </para> </refsect1> </refentry> <refentry id="streams.php-stream-is-persistent"> <refnamediv> <refname>php_stream_is_persistent</refname> <refpurpose>D&eacute;termine si un fl&ocirc;t est un fl&ocirc;t persistant</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_is_persistent</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_is_persistent</function> retourne 1 si le fl&ocirc;t <parameter>stream</parameter> est un fl&ocirc;t persistant, et 0 sinon. </para> </refsect1> </refentry> <refentry id="streams.php-stream-is"> <refnamediv> <refname>php_stream_is</refname> <refpurpose>D&eacute;termine si un fl&ocirc;t est d'un type particulier</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_is</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> <methodparam><type>int</type><parameter>istype</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_is</function> retourne 1 si <parameter>stream</parameter> est du type sp&eacute;cifi&eacute; par <parameter>istype</parameter>, et 0 sinon. <table> <title>Valeurs possibles pour <parameter>istype</parameter></title> <tgroup cols="2"> <thead> <row> <entry>Valeur</entry> <entry>Signification</entry> </row> </thead> <tbody> <row> <entry>PHP_STREAM_IS_STDIO</entry> <entry>Le fl&ocirc;t est impl&eacute;ment&eacute; en utilisant l'impl&eacute;mentation standard</entry> </row> <row> <entry>PHP_STREAM_IS_SOCKET</entry> <entry>Le fl&ocirc;t est impl&eacute;ment&eacute; en utilisant l'impl&eacute;mentation des sockets r&eacute;seau</entry> </row> <row> <entry>PHP_STREAM_IS_USERSPACE</entry> <entry>Le fl&ocirc;t est impl&eacute;ment&eacute; en utilisant l'impl&eacute;mentation de l'objet utilisateur</entry> </row> <row> <entry>PHP_STREAM_IS_MEMORY</entry> <entry>Le fl&ocirc;t est impl&eacute;ment&eacute; en utilisant l'impl&eacute;mentation m&eacute;moire &agrave; taille automatique</entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Les constantes PHP_STREAM_IS_XXX sont en fait d&eacute;finies comme des pointeurs sur la structure des op&eacute;rations de base. Si vous extension (ou une autre extension d&eacute;finit des fl&ocirc;ts additionnels), il faut qu'elle d&eacute;clare aussi les constantes PHP_STREAM_IS_XXX dans ses ent&ecirc;tes, pour que vous puissiez les utiliser comme base de comparaison. </simpara> </note> <note> <simpara> Cette fonction est impl&eacute;ment&eacute;e comme une comparaison de pointeurs simple (et rapide), et ne modifie pas l'&eacute;tat du fl&ocirc;t. </simpara> </note> <para> Voir aussi <function>php_stream_cast</function> et <function>php_stream_can_cast</function>. </para> </refsect1> </refentry> <refentry id="streams.php-stream-passthru"> <refnamediv> <refname>php_stream_passthru</refname> <refpurpose>Affiche toutes les donn&eacute;es restantes d'un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>size_t</type><methodname>php_stream_passthru</methodname> <methodparam><type>php_stream *</type><parameter>stream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_passthru</function> affiche tous les octets restant dans le fl&ocirc;t <parameter>stream</parameter> vers le buffer de sortie. Les donn&eacute;es sont &eacute;crites directement dans le buffer de sortie, qui sera le navigateur dans le cas de PHP sur un serveur web, ou la sortie standard dans le cas de PHP en mode de ligne de commande. Cette fonction essaie d'utiliser des fichiers en m&eacute;moire pour acc&eacute;l&eacute;rer l'ex&eacute;cution. </para> </refsect1> </refentry> <refentry id="streams.php-register-url-stream-wrapper"> <refnamediv> <refname>php_register_url_stream_wrapper</refname> <refpurpose>Enregistre un gestionnaire pour l'API de fl&ocirc;ts</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_register_url_stream_wrapper</methodname> <methodparam><type>char *</type><parameter>protocol</parameter></methodparam> <methodparam><type>php_stream_wrapper *</type><parameter>wrapper</parameter></methodparam> <methodparam><type>TSRMLS_DC</type><parameter></parameter></methodparam> </methodsynopsis> <para> <function>php_register_url_stream_wrapper</function> enregistre le gestionnaire <parameter>wrapper</parameter> pour le protocole <parameter>protocol</parameter>. </para> <note> <simpara> Si vous appelez cette fonction dans un module dynamiquement charg&eacute;, vous DEVEZ appeler la fonction <function>php_unregister_url_stream_wrapper</function> dans la fonction de terminaison de votre module, sinon PHP va crasher. </simpara> </note> </refsect1> </refentry> <refentry id="streams.php-unregister-url-stream-wrapper"> <refnamediv> <refname>php_unregister_url_stream_wrapper</refname> <refpurpose>D&eacute;senregistre un gestionnaire pour l'API de fl&ocirc;ts</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_unregister_url_stream_wrapper</methodname> <methodparam><type>char *</type><parameter>protocol</parameter></methodparam> <methodparam><type>TSRMLS_DC</type><parameter></parameter></methodparam> </methodsynopsis> <para> <function>php_unregister_url_stream_wrapper</function> d&eacute;senregistre le gestionnaire associ&eacute; avec le protocole <parameter>protocol</parameter>. </para> </refsect1> </refentry> <refentry id="streams.php-stream-open-wrapper-ex"> <refnamediv> <refname>php_stream_open_wrapper_ex</refname> <refpurpose>Ouvre un fl&ocirc;t avec un fichier ou une URL, en sp&eacute;cifiant le contexte</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_open_wrapper_ex</methodname> <methodparam><type>char *</type><parameter>path</parameter></methodparam> <methodparam><type>char *</type><parameter>mode</parameter></methodparam> <methodparam><type>int</type><parameter>options</parameter></methodparam> <methodparam><type>char **</type><parameter>opened</parameter></methodparam> <methodparam><type>php_stream_context *</type><parameter>context</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_open_wrapper_ex</function> est exactement comme <function>php_stream_open_wrapper</function>, mais vous permet de sp&eacute;cifier un objet de type php_stream_context avec le param&egrave;tre <parameter>context</parameter>. Pour en savoir plus sur les contextes, voyez ... une section qui viendra plus tard. </para> </refsect1> </refentry> <refentry id="streams.php-stream-open-wrapper-as-file"> <refnamediv> <refname>php_stream_open_wrapper_as_file</refname> <refpurpose>Ouvre un fl&ocirc;t avec un fichier ou une URL, et le convertit en pointeur FILE*</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>FILE *</type><methodname>php_stream_open_wrapper_as_file</methodname> <methodparam><type>char *</type><parameter>path</parameter></methodparam> <methodparam><type>char *</type><parameter>mode</parameter></methodparam> <methodparam><type>int</type><parameter>options</parameter></methodparam> <methodparam><type>char **</type><parameter>opened</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_open_wrapper_as_file</function> est exactement identique &agrave; la fonction <function>php_stream_open_wrapper</function>, mais convertit le fl&ocirc;t en un pointeur ANSI FILE* puis le retourne &agrave; la place du fl&ocirc;t. C'est un raccourci commode pour les extensions qui passent des pointeurs FILE* aux librairies tierce partie. </para> </refsect1> </refentry> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/streams.constants.xml +++ phpdoc-fr/chapters/streams.constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- 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 required for php-doc restructuring purposes - just drop me a line if you make a change (so I can update my local copy). --> <sect1 id="streams.constants"> <title>Constantes de fl&ocirc;ts</title> <refentry id="streams.options"> <refnamediv> <refname>Options d'ouverture de fl&ocirc;t</refname> <refpurpose>Affectent les fonctions de fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> Plusieurs valeurs peuvent &ecirc;ter combin&eacute;es avec l'op&eacute;rateur OR. <variablelist> <varlistentry> <term> <constant>IGNORE_PATH</constant> </term> <listitem> <simpara> C'est l'option par d&eacute;faut pour les fl&ocirc;ts. Elle indique que l'include_path ne sera pas fouill&eacute; pour trouver le fichier demand&eacute;. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>USE_PATH</constant> </term> <listitem> <simpara> Requiert que l'include_path soit fouill&eacute; &agrave; la recherche du fichier demand&eacute;. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IGNORE_URL</constant> </term> <listitem> <simpara> Requiert que les gestionnaires d'URL soient ignor&eacute;s pour traiter ce fl&ocirc;t. Les gestionnaires qui ne traitent pas d'URL seront utilis&eacute; lors du d&eacute;codate du chemin. Il n'y a pas de contraire &agrave; cette option : l'API des fl&ocirc;ts utilisera tous les gestionnaires par d&eacute;faut. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IGNORE_URL_WIN</constant> </term> <listitem> <simpara> Sous Windows, c'est l'&eacute;quivalent de IGNORE_URL. Sur tous les autres syst&egrave;mes, cette option n'a aucun effet. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ENFORCE_SAFE_MODE</constant> </term> <listitem> <simpara> Requiert que le gestionnaire de fl&ocirc;t effectue les v&eacute;rifications li&eacute;es au safe_mode sur le fichier &agrave; ouvrir avant e le faire. En omettant cette option, le safe_mode sera ignor&eacute; et n'importe quel fichier sera ouvert par PHP, du mometn qu'il a les droits pour le faire. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>REPORT_ERRORS</constant> </term> <listitem> <simpara> Si cette option est utilis&eacute;e, et qu'il y a une erreur durant l'ouverture du fichier ou de l'URL, l'API va appeler automatiquement la fonction php_error pour vous. C'est pratique car le chemin peut contenir des informations le login et mot de passe, que vous souhaitez ou pas afficher (les afficher serait un trou de s&eacute;curit&eacute;). Lorsque les API des fl&ocirc;ts g&eacute;n&egrave;rent une erreur, elles commencent par supprimer les informations de login et mot de passe, afin que l'affichage des donn&eacute;es soit sans souci. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>STREAM_MUST_SEEK</constant> </term> <listitem> <simpara> Cette option est pratique lorsque votre extension doit r&eacute;ellement &ecirc;tre capable d&eacute;placer le pointeur de fichier dans le fl&ocirc;t. Certains flots ne disposent pas d'un tel pointeur. Cette option s'assure que le fl&ocirc;t va supporter ce opinteur. Si il ne le fait pas, le fl&ocirc;t sera copi&eacute; dans un fichier temporaire (qui peut &ecirc;tre un fichier ou un bloc de m&eacute;moire), qui supportera le pointeur. Notez bien que cette option est inutile lorsque vous voulez d&eacute;placer le pointeur de fichier et y &eacute;crire, car le fl&ocirc;t que vous allez utiliser n'est peut &ecirc;tre pas votre ressource initiale, mais un fichier en cache. </simpara> <note> <simpara> Si la ressource demand&eacute;e est sur le r&eacute;seau, cette option va bloquer la fonction d'ouverture jusqu'&agrave; ce que le contenu complet du fichier soit t&eacute;l&eacute;charg&eacute;. </simpara> </note> </listitem> </varlistentry> <varlistentry> <term> <constant>STREAM_WILL_CAST</constant> </term> <listitem> <simpara> Si votre extension utilise une librairie tierce qui s'attend &agrave; recevoir un pointeur FILE* ou un pointeur de fichier, vous pouvez utiliser cette option pour demander &agrave; l'API d'ouvrir la ressource, mas d'&eacute;viter d'utiliser les buffers. Vous pouvez alors utiliser <function>php_stream_cast</function> pour obtenir un FILE* ou un pointeur de fichier, que vous transmettrez &agrave; la librairie. </simpara> <simpara> Ceci est particuli&egrave;rement pratique lorsque vous acc&eacute;dez &agrave; des URL via HTTP, qui vont diffuser des donn&eacute;es, mais dont le corps ne sera accessible qu'apr&egrave;s une quantit&eacute; ind&eacute;termin&eacute;e d'ent&ecirc;tes. </simpara> <simpara> Comme cette option inactive les buffers, vous pouvez rencontrer des performances moins bonnes qu'avec les API habituelles. C'est parfaitement compr&eacute;hensible, car vous avec indiqu&eacute; aux fl&ocirc;ts que vous alliez utiliser les fonctions de bases de l'impl&eacute;mentation. Utilisez donc cette option uniquement si vous en avez besoin. </simpara> </listitem> </varlistentry> </variablelist> </para> </refsect1> </refentry> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/streams.dir.xml +++ phpdoc-fr/chapters/streams.dir.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- 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 required for php-doc restructuring purposes - just drop me a line if you make a change (so I can update my local copy). --> <sect1 id="streams.dir-api"> <title>Streams Dir API Reference</title> <para> Les fonctions ci-dessous fonctionnent sur les dossiers locaux, mais aussi sur les dossier distants (en supposant que le gestionnaire sache le faire!). </para> <refentry id="streams.php-stream-opendir"> <refnamediv> <refname>php_stream_opendir</refname> <refpurpose>Ouvre un dossier pour le lister</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_opendir</methodname> <methodparam><type>char *</type><parameter>path</parameter></methodparam> <methodparam><type>php_stream_context *</type><parameter>context</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_opendir</function> retourne un fl&ocirc;t qui peut &ecirc;tre utilis&eacute; pour lister les fichiers qui sont contenu dans le dossier sp&eacute;cifi&eacute; par <parameter>path</parameter>. Cette fonction est l'&eacute;quivalent de <function>opendir</function> sous POSIX. Bien que cette fonction retourne un objet php_stream, il n'est pas recommand&eacute; d'essayer d'utiliser les fonctions de fichiers sur ce fl&ocirc;t. </para> </refsect1> </refentry> <refentry id="streams.php-stream-readdir"> <refnamediv> <refname>php_stream_readdir</refname> <refpurpose>Lit le fichier suivant dans un dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream_dirent *</type><methodname>php_stream_readdir</methodname> <methodparam><type>php_stream *</type><parameter>dirstream</parameter></methodparam> <methodparam><type>php_stream_dirent *</type><parameter>ent</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_readdir</function> lit le nom du fichier suivant dans le dossier <parameter>dirstream</parameter> et le stocke dans le param&egrave;tre <parameter>ent</parameter>. Si la fonction r&eacute;ussit, la valeur retourn&eacute;e est <parameter>ent</parameter>. Si la fonction &eacute;choue, la valeur retourn&eacute;e est NULL. </para> </refsect1> </refentry> <refentry id="streams.php-stream-rewinddir"> <refnamediv> <refname>php_stream_rewinddir</refname> <refpurpose>Replace le fl&ocirc;t de dossier au d&eacute;but</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_rewinddir</methodname> <methodparam><type>php_stream *</type><parameter>dirstream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_rewinddir</function> replace le pointeur de dossier au d&eacute;but du fl&ocirc;t. Retourne 0 en cas de succes, et -1 en cas d'&eacute;chec. </para> </refsect1> </refentry> <refentry id="streams.php-stream-closedir"> <refnamediv> <refname>php_stream_closedir</refname> <refpurpose>Ferme un fl&ocirc;t de dossier, et lib&egrave;re les ressources</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>php_stream_closedir</methodname> <methodparam><type>php_stream *</type><parameter>dirstream</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_closedir</function> ferme un fl&ocirc;t le dossier <parameter>dirstream</parameter>, et lib&egrave;re les ressources. Retourne 0 en cas de succes, et -1 en cas d'&eacute;chec. </para> </refsect1> </refentry> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/streams.file.xml +++ phpdoc-fr/chapters/streams.file.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- 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 required for php-doc restructuring purposes - just drop me a line if you make a change (so I can update my local copy). --> <sect1 id="streams.file-api"> <title>API des fl&ocirc;ts pour les fichiers</title> <refentry id="streams.php-stream-fopen-from-file"> <refnamediv> <refname>php_stream_fopen_from_file</refname> <refpurpose>Convertit un pointeur ANSI FILE* en un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_fopen_from_file</methodname> <methodparam><type>FILE *</type><parameter>file</parameter></methodparam> <methodparam><type>char *</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_fopen_from_file</function> retourne un fl&ocirc;t bas&eacute; sur le fichier <parameter>file</parameter>. <parameter>mode</parameter> doit &ecirc;tre le m&ecirc;me mode que celui utils&eacute; pour ouvrir <parameter>file</parameter>, sinon d'&eacute;tranges erreurs surviendront lors de l'&eacute;criture lorsque le mode du fl&ocirc;t sera diff&eacute;rent de celui du fichier. </para> </refsect1> </refentry> <refentry id="streams.php-stream-fopen-tmpfile"> <refnamediv> <refname>php_stream_fopen_tmpfile</refname> <refpurpose>Ouvre un pointeur FILE* avec la fonction tmpfile() et la convertit en fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_fopen_tmpfile</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> <para> <function>php_stream_fopen_from_file</function> retourne un fl&ocirc;t bas&eacute; sur un ficheir temporaire, ouvert en mode "w+b". Le fichier temporaire sera supprim&eacute; automatiquement lorsque le fl&ocirc;t sera ferm&eacute; ou que le procesus sera termin&eacute;. </para> </refsect1> </refentry> <refentry id="streams.php-stream-fopen-temporary-file"> <refnamediv> <refname>php_stream_fopen_temporary_file</refname> <refpurpose>G&eacute;n&egrave;re un fichier temporaire et ouvre un fl&ocirc;t avec</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_fopen_temporary_file</methodname> <methodparam><type>const char *</type><parameter>dir</parameter></methodparam> <methodparam><type>const char *</type><parameter>pfx</parameter></methodparam> <methodparam><type>char **</type><parameter>opened</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_fopen_temporary_file</function> g&eacute;n&egrave;re un fichier temporaire dans le dossier <parameter>dir</parameter> avec le pr&eacute;fixe <parameter>pfx</parameter>. Le nom du fichier ainsi g&eacute;n&eacute;r&eacute; est retourn&eacute; dans la variable <parameter>opened</parameter>, dont vous &ecirc;tes responsable de l'effacemetn avec <function>efree</function>. Un fl&ocirc;t est ouvert sur ce fichier g&eacute;n&eacute;r&eacute;, en mode "w+b". Le fichier N'EST PAS automatiquement effac&eacute;. Vous &ecirc;tes responsables de son effacement lorsque vous aurez fini avec. </para> </refsect1> </refentry> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/streams.socket.xml +++ phpdoc-fr/chapters/streams.socket.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- 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 required for php-doc restructuring purposes - just drop me a line if you make a change (so I can update my local copy). --> <sect1 id="streams.socket-api"> <title>Streams Socket API Reference</title> <refentry id="streams.php-stream-sock-open-from-socket"> <refnamediv> <refname>php_stream_sock_open_from_socket</refname> <refpurpose>Convertit un pointeur de socket en fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_sock_open_from_socket</methodname> <methodparam><type>int</type><parameter>socket</parameter></methodparam> <methodparam><type>int</type><parameter>persistent</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_sock_open_from_socket</function> retourne un fl&ocirc;t bas&eacute; sur la socket <parameter>socket</parameter>. <parameter>persistent</parameter> est une option qui contr&ocirc;le si le fl&ocirc;t doit &ecirc;tre ouvert comme un fl&ocirc;t persistant. G&eacute;n&eacute;ralement, ce param&egrave;tre vaudra 0. </para> </refsect1> </refentry> <refentry id="streams.php-stream-sock-open-host"> <refnamediv> <refname>php_stream_sock_open_host</refname> <refpurpose>Ouvre une connexion avec un serveur, et retourne un fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_sock_open_host</methodname> <methodparam><type>const char *</type><parameter>host</parameter></methodparam> <methodparam><type>unsigned short</type><parameter>port</parameter></methodparam> <methodparam><type>int</type><parameter>socktype</parameter></methodparam> <methodparam><type>struct timeval *</type><parameter>timeout</parameter></methodparam> <methodparam><type>int</type><parameter>persistent</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_sock_open_host</function> &eacute;tablit une connexion &agrave; l'h&ocirc;te <parameter>host</parameter> et sur le port <parameter>port</parameter>. <parameter>socktype</parameter> sp&eacute;cifie les options de sockets qui devront &ecirc;tre appliqu&eacute;es. <parameter>socktype</parameter> est d&eacute;pendant du syst&egrave;me, mais incluera notamment <constant>SOCK_STREAM</constant> pour les connexions full-duplex, s&eacute;quentielle et fiables et <constant>SOCK_DGRAM</constant> pour les connexions non fiables, sans connexion, avec une taille maximale fix&eacute;e (UDP). </para> <para> <parameter>persistent</parameter> est une option qui contr&ocirc;le si le fl&ocirc;t doit &ecirc;tre ouvert comme un fl&ocirc;t persistant. G&eacute;n&eacute;ralement, ce param&egrave;tre vaudra 0. </para> <para> Si non-NULL, <parameter>timeout</parameter> sp&eacute;cifie la dur&eacute;e maximale de connexion. SI la connexion prend plus de temps que cette valeur, la tentative de connexion sera abandonn&eacute;e et NULL sera retourn&eacute; pour indiquer que le fl&ocirc;t n'a pu &ecirc;tre ouvert. </para> <note> <simpara> Le param&egrave;tre <parameter>timeout</parameter> n'inclut pas le temps de r&eacute;solution DNS. La raison &agrave; cela est qu'il n'y a pas de m&eacute;thode portable pour effectuer des r&eacute;solutions DNS. </simpara> <simpara> La dur&eacute;e d'expiration s'applique &agrave; la phase de connexion; si vous avez besoin de dur&eacute;es d'expiration pour les op&eacute;rations de lecture et d'&eacute;critures, il faudra utiliser la fonction <function>php_stream_sock_set_timeout</function> pour configurer la dur&eacute;e d'expiration de votre fl&ocirc;t une fois qu'il sera ouvert. </simpara> </note> <para> L'API n'impose aucune restriction sur les valeurs de <parameter>socktype</parameter>, mais il est recommand&eacute; de consid&eacute;rer les probl&egrave;mes de portabilit&eacute; lorsque vous faites ce choix. </para> </refsect1> </refentry> <refentry id="streams.php-stream-sock-open-unix"> <refnamediv> <refname>php_stream_sock_open_unix</refname> <refpurpose>Ouvre une connexion avec une socket UNIX et la convertit en fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>php_stream *</type><methodname>php_stream_sock_open_unix</methodname> <methodparam><type>const char *</type><parameter>path</parameter></methodparam> <methodparam><type>int</type><parameter>pathlen</parameter></methodparam> <methodparam><type>int</type><parameter>persistent</parameter></methodparam> <methodparam><type>struct timeval *</type><parameter>timeout</parameter></methodparam> </methodsynopsis> <para> <function>php_stream_sock_open_unix</function> tente d'ouvrir une connexion avec une socket UNIX, sp&eacute;cifi&eacute;e par <parameter>path</parameter>. <parameter>pathlen</parameter> sp&eacute;cifie la taille de <parameter>path</parameter>. Si non-NULL, <parameter>timeout</parameter> sp&eacute;cifie la dur&eacute;e maximale de connexion. SI la connexion prend plus de temps que cette valeur, la tentative de connexion sera abandonn&eacute;e et NULL sera retourn&eacute; pour indiquer que le fl&ocirc;t n'a pu &ecirc;tre ouvert. <parameter>persistent</parameter> est une option qui contr&ocirc;le si le fl&ocirc;t doit &ecirc;tre ouvert comme un fl&ocirc;t persistant. G&eacute;n&eacute;ralement, ce param&egrave;tre vaudra 0. </para> <note> <simpara> Cette fonction n'est pas utilisable sous Windows, qui n'impl&eacute;mente pas les sockets de domaines. Une exception possible &agrave; cette r&egrave;gle sont les ex&eacute;cutables PHP compil&eacute; avec cygwin. Vous &ecirc;tes encourag&eacute;s &agrave; consid&eacute;rer cet aspect de la portabilit&eacute; de votre extension avant sa publication. </simpara> </note> <note> <simpara> Cette fonction traite <parameter>path</parameter> en tenant compte des donn&eacute;es binaires, ce qui est bon pour les syst&egrave;mes qui utilisent un espace de nom abstrait (comme par exemple Linux), où le premier caract&egrave;re est le caract&egrave;re NUL. </simpara> </note> </refsect1> </refentry> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/streams.structs.xml +++ phpdoc-fr/chapters/streams.structs.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- 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 required for php-doc restructuring purposes - just drop me a line if you make a change (so I can update my local copy). --> <sect1 id="streams.structs"> <title>Streams Structures</title> <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> </refnamediv> <refsect1> <title>Description</title> <synopsis> <structname>php_stream_statbuf</structname> <type>struct stat</type> <structfield>sb</structfield> </synopsis> <para> <structfield>sb</structfield> est une structure standard, d&eacute;finie par le syst&egrave;me de statistiques fichier. </para> </refsect1> </refentry> <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> </refnamediv> <refsect1> <title>Description</title> <synopsis> <structname>php_stream_dirent</structname> <type>char</type> <structfield>d_name[MAXPATHLEN]</structfield> </synopsis> <para> <structfield>d_name</structfield> contient le nom du fichier, relativement au dossier actuellement analys&eacute;. </para> </refsect1> </refentry> <refentry id="streams.struct-php-stream-ops"> <refnamediv> <refname>struct php_stream_ops</refname> <refpurpose>Conserve les fonctions membres d'une impl&eacute;mentation de fl&ocirc;t</refpurpose> </refnamediv> <refsect1> <title>Description</title> <programlisting role="c"> typedef struct _php_stream_ops { /* Tous les fl&ocirc;ts DOIVENT impl&eacute;menter ces op&eacute;rations */ size_t (*write)(php_stream *stream, const char *buf, size_t count TSRMLS_DC); size_t (*read)(php_stream *stream, char *buf, size_t count TSRMLS_DC); int (*close)(php_stream *stream, int close_handle TSRMLS_DC); int (*flush)(php_stream *stream TSRMLS_DC); const char *label; /* name describing this class of stream */ /* Ces op&eacute;rations sont optionnelles, et peuvent prendre la valeur de NULL si le fl&ocirc;t ne supporte pas cette op&eacute;ration */ int (*seek)(php_stream *stream, off_t offset, int whence TSRMLS_DC); char *(*gets)(php_stream *stream, char *buf, size_t size TSRMLS_DC); 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> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/chapters/streams.xml +++ phpdoc-fr/chapters/streams.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- 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 required for php-doc restructuring purposes - just drop me a line if you make a change (so I can update my local copy). --> <chapter id="streams"> <title>API de fl&ocirc;ts les auteurs d'extensions</title> <sect1 id="streams.overview"> <title>Pr&eacute;sentation</title> <para> Les fl&ocirc;ts de PHP proposent une approche unifi&eacute;e &agrave; la gestion des fichiers et sockets, depuis une extension PHP. En utilisant l'API standard, les fl&ocirc;ts vous permettent d'acc&eacute;der &agrave; des fichiers, des sockets, des URL, de la m&eacute;moire ou encore des objets d&eacute;finis dans des scripts. Les fl&ocirc;ts (streams en anglais), sont une API flexible et dynamique, dynamiquement charg&eacute;e dans les modules (et les scripts!). </para> <para> Le but des fl&ocirc;ts est de proposer une API confortables pour les programmeurs, lors des manipulations de fichiers, URL et autres sources de donn&eacute;es lin&eacute;aires. L'API unifi&eacute;e est tr&egrave;s simple &agrave; comprendre : elle est plus ou moins bas&eacute;e sur la famille de fonction classiques C d'entr&eacute;e/sortie (avec les m&ecirc;mes concepts pour la plus part des fonctions) : les programmeurs C ne seront pas d&eacute;pays&eacute;s. </para> <para> L'API des fl&ocirc;ts intervient &agrave; diff&eacute;rents niveaux : &agrave; la base, elle d&eacute;finit un objet php_stream, qui repr&eacute;sente les sources de donn&eacute;es. A un niveau au dessus, l'API d&eacute;fini un objet php_stream_wrapper qui s'interface avec l'API de bas niveau, pour lire et &eacute;crire les donn&eacute;es et m&eacute;ta donn&eacute;es, dans les sources. </para> <para> Les fl&ocirc;ts peuvent &ecirc;tre converti en pilotes pour fichiers, de mani&egrave;re &agrave; &ecirc;tre utilis&eacute; par des librairies tierce-partie avec beaucoup de facilit&eacute;. Cela autorise ces librairies &agrave; acc&eacute;der aux donn&eacute;es directement depuis des sources repr&eacute;sent&eacute;es par des URL. Si votre syst&egrave;me supporte la fonction <function>fopencookie</function>, vous pouvez m&ecirc;me passer n'importe quel fl&ocirc;t PHP &agrave; une autre librairie qui utilise les entr&eacute;e/sortie standard ANSI! </para> </sect1> <sect1 id="streams.basics"> <title>El&eacute;ments de bases</title> <para> Utiliser les fl&ocirc;ts ressemble &eacute;norm&eacute;ment &agrave; l'utilisation des fonctions d'entr&eacute;e/sortie standard ANSI streams. La principale diff&eacute;rence est que vous devez cr&eacute;er le pointeur de fl&ocirc;t d'abord. Dans la plus part des cas, vous utiliserez la fonction <function>php_stream_open_wrapper</function> pour l'obtenir. Cette fonction ressemble &agrave; fopen(), comme le montre l'exemple ci-dessous : </para> <para> <example> <title>Exemple de fl&ocirc;t qui affiche la page de PHP.net</title> <programlisting role="c"> <![CDATA[ php_stream * stream = php_stream_open_wrapper("http://www.php.net", "rb", REPORT_ERRORS, NULL); if (stream) { while(!php_stream_eof(stream)) { char buf[1024]; if (php_stream_gets(stream, buf, sizeof(buf))) { printf(buf); } else { break; } } php_stream_close(stream); } ]]> </programlisting> </example> </para> <para> La table ci-dessous montre les fonctions de fl&ocirc;ts &eacute;quivalentes aux fonctions ANSI. Sauf indication contraire, les fonctionnalit&eacute;s sont les m&ecirc;mes. <table> <title>ANSI stdio equivalent functions in the Streams API</title> <tgroup cols="3"> <thead> <row> <entry>Fonction ANSI</entry> <entry>Fonction Fl&ocirc;t PHP</entry> <entry>Notes</entry> </row> </thead> <tbody> <row> <entry>fopen</entry> <entry>php_stream_open_wrapper</entry> <entry>Les fl&ocirc;ts incluent des param&egrave;tres suppl&eacute;mentaires</entry> </row> <row> <entry>fclose</entry> <entry>php_stream_close</entry> <entry></entry> </row> <row> <entry>fgets</entry> <entry>php_stream_gets</entry> <entry></entry> </row> <row> <entry>fread</entry> <entry>php_stream_read</entry> <entry>Le param&egrave;tre nmemb est suppos avoir la valeur 1 : le prototype ressemble plut&ocirc;t &agrave; read(2)</entry> </row> <row> <entry>fwrite</entry> <entry>php_stream_write</entry> <entry>Le param&egrave;tre nmemb est suppos avoir la valeur 1 : le prototype ressemble plut&ocirc;t &agrave; write(2)</entry> </row> <row> <entry>fseek</entry> <entry>php_stream_seek</entry> <entry></entry> </row> <row> <entry>ftell</entry> <entry>php_stream_tell</entry> <entry></entry> </row> <row> <entry>rewind</entry> <entry>php_stream_rewind</entry> <entry></entry> </row> <row> <entry>feof</entry> <entry>php_stream_eof</entry> <entry></entry> </row> <row> <entry>fgetc</entry> <entry>php_stream_getc</entry> <entry></entry> </row> <row> <entry>fputc</entry> <entry>php_stream_putc</entry> <entry></entry> </row> <row> <entry>fflush</entry> <entry>php_stream_flush</entry> <entry></entry> </row> <row> <entry>puts</entry> <entry>php_stream_puts</entry> <entry>Identique &agrave; puts, et non pas &agrave; fputs</entry> </row> <row> <entry>fstat</entry> <entry>php_stream_stat</entry> <entry>Les informations des fl&ocirc;ts sont plus riches</entry> </row> </tbody> </tgroup> </table> </para> </sect1> <sect1 id="streams.resources"> <title>Les fl&ocirc;ts qui sont des ressources</title> <para> Tous les fl&ocirc;ts sont enregitr&eacute;s comme des ressources lorsqu'il sont cr&eacute;&eacute;s. Cela garantit qu'ils seront convenablement d&eacute;blay&eacute;s de la m&eacute;moire, m&ecirc;me en cas d'erreur fatale. Toutes les fonctions du syt&egrave;me de fichier de &php; op&egrave;re sur des ressources : cela signifie que vos extensions peuvent accepter des pointeurs de fichiers comme param&egrave;tre, et retourner des fl&ocirc;ts. L'API des fl&ocirc;ts rend ce processus tr&egrave;s convivial. </para> <para> <example> <title>Comment accepter un fl&ocirc;t comme param&egrave;tre d'entr&eacute;e</title> <programlisting role="c"> <![CDATA[ PHP_FUNCTION(example_write_hello) { zval *zstream; php_stream *stream; if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zstream)) return; php_stream_from_zval(stream, &zstream); /* Vous pouvez maintenant utiliser votre fl&ocirc;t. Cependant, vous ne "poss&eacute;dez" pas le fl&ocirc;t, mais le script le poss&egrave;de. Cela signifie que vous de DEVEZ PAS fermer le fl&ocirc;t, car sinon, PHP va crasher! */ php_stream_write(stream, "hello\n"); RETURN_TRUE(); } ]]> </programlisting> </example> </para> <para> <example> <title>Comment retourner un fl&ocirc;t depuis une fonction</title> <programlisting role="c"> <![CDATA[ PHP_FUNCTION(example_open_php_home_page) { php_stream *stream; stream = php_stream_open_wrapper("http://www.php.net", "rb", REPORT_ERRORS, NULL); php_stream_to_zval(stream, return_value); /* A partir de ce moment, le fl&ocirc;t appartient au script. Si vous le fermer ici, vous allez faire crasher PHP! */ } ]]> </programlisting> </example> </para> <para> Comme les fl&ocirc;ts sont automatiquement d&eacute;blay&eacute;s de la m&eacute;moire, il est tentant de penser que vous pouvez &ecirc;tre des programmeurs paresseux et ne pas vous pr&eacute;occuper de la fermeture du fl&ocirc;t lorsque vous en avez termin&eacute; avec lui. M&ecirc;me si une telle approche fonctionnera probablement, ce n'est pas une bonne id&eacute;e pour un bon nombre de raisons : les fl&ocirc;ts conservent des verrous sur les ressources syst&egrave;mes durant un temps plus long, ce qui fait que laisser le verrous emp&ecirc;che d'autres processus d'acc&eacute;der &agrave; cette ressource. Si le script g&egrave;re un grand nombre de fichier, l'accumulation de ressources, en terme de m&eacute;moire et de nombre de fichiers ouverts, causer l'&eacute;chec des requ&ecirc;tes du serveur web. Cela n'est plus aussi s&eacute;duisant, n'est-ce pas? L'API de fl&ocirc;t inclut un peu de magie pour que vous puissiez garder votre code propre : si un fl&ocirc;t n'est pas ferm&eacute; par votre code alors qu'il devrait l'&ecirc;tre, vous trouverez des informations de d&eacute;bogage dans le fichier d'historique d'erreur de votre serveur web. </para> <note> <simpara> Utilisez toujours une version de d&eacute;bogagge de &php; lorsque vous d&eacute;veloppez (<option>--enable-debug</option> lors de la configuration de la compilation) car de nombreux efforts ont &eacute;t&eacute; fait pour vous aider &agrave; traquer les fuites de m&eacute;moire. </simpara> </note> <para> Dans certains cas, il est pratique de garder un fl&ocirc;t ouvert pour toute la dur&eacute;e de la requ&ecirc;te, afin de l'utiliser comme fichier d'historique. Ecrire le code n&eacute;cessaire au nettoyage propre d'un tel fichier n'est pas difficile, mais ce sont plusieurs lignes e code qui ne sont pas strictement n&eacute;cessaire. Pour vous &eacute;viter l'&eacute;criture de ce code, vous pouvez marquer le fl&ocirc;t pour qu'il soit automatiquement lib&eacute;r&eacute; lorsque viendra le temps de lib&eacute;rer les ressources. Pour cela, vous pouvez utiliser la fonction <function>php_stream_auto_cleanup</function>. </para> </sect1> &chapters.streams.common; &chapters.streams.dir; &chapters.streams.file; &chapters.streams.socket; &chapters.streams.structs; &chapters.streams.constants; </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.fr (#176) next »