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: | Damien Seguy | 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 à 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 é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é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ème d'exploitation, y compris + Linux et Windows. Sous Linux, vous pouvez aussi trouver + des commandes comme <ulink url="&url.rpmfind;">rpmfind</ulink>, + très pratique pour rechercher les paquets pré compilés. + </para> </sect1> <sect1 id="tutorial.firstpage"> @@ -98,7 +114,8 @@ <ulink url="&url.php.downloads;">téléchargements</ulink>. Vous pouvez développer en PHP, localement, sur tous les systèmes d'exploitation. N'oubliez pas d'installer aussi un serveur - web approprié. + web approprié. Si le problème persiste, n'hésitez pas à + utiliser l'une des options de <ulink url="&url.php.support;">support</ulink>. </para> <para> Le point important de cet exemple é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é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étails pour l'installation de PHP sous Apache sous Unix.</title> <simpara> Il y a deux mé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êter le serveur Apache, et éditer le fichier <filename>srm.conf</filename> ou <filename>httpd.conf</filename>, pour configurer Apache avec PHP. </simpara> <para> Vous pouvez sélectionner des options à ajouter au fichier <command>configure</command> à la ligne 8 depuis la <link linkend="install.configure">liste complè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 étape, vous pouvez aussi copier le binaire httpd et remplacer votre exécutable actuel. Assurez-vous tout de même que le serveur est bien é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 éditer votre fichier php.ini pour modifier certaines options PHP. Si vous préférez placer ce fichier ailleurs, utilisez --with-config-file-path=/path lors de l'é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édure habituelle pour démarrer votre serveur Apache. (vous devez l'éteindre et le redémarrer, pas seulement lui envoyer un signal HUP ou USR1.) </programlisting> </example> <para> Suivant votre installation d'Apache et votre variante d'Unix, il existe de nombreuses façons d'arrêter et redémarrer Apache. Voici une liste des commandes typiques, pour différentes installations. Remplacez <literal>/path/to/</literal> par le chemin d'accès à vos applications sur votre système. <example> <title>Redé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 à 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écutables apachectl et http(s)dctl peuvent être situés dans différents dossiers. Si votre système a <literal>locate</literal> ou <literal>whereis</literal> ou <literal>which</literal>, utilisez-les pour retrouver vos programmes. </para> <para> Diffé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éer une librairie partagée <filename>libphp4.so</filename> qui sera chargée par Apache avec une ligne LoadModule dans le fichier <filename>httpd.conf</filename>. Le support PostgreSQL est aussi inclut dans <filename>libphp4.so</filename>. </para> <para> <example> <title>Compilation sur Apache avec l'extension PostGreSQL (librairie partagée)</title> <programlisting> <![CDATA[ /configure --with-apxs --with-pgsql=shared ]]> </programlisting> </example> </para> <para> Cette commande va créer une librairie partagée <filename>libphp4.so</filename> pour Apache, mais va aussi créer la librairie partagée <filename>pgsql.so</filename> qui sera chargé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éer une autre librairie partagé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ème de compilation d'Apache va cré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écutable <filename>httpd</filename>, ce qui fait que le ré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ée)</title> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql=shared ]]> </programlisting> </example> </para> <para> Identique à la version précédente, mais au lieu d'inclure le support PostgreSQL directement dans l'exécutable final <filename>httpd</filename>, vous allez obtenir une librairie partagée <filename>pgsql.so</filename> que vous pouvez charger dans PHP soit grâce au fichier de configuration &php.ini; ou dynamiquement avec <function>dl</function>. </para> <para> Lorsque vous faites le choix entre les différents modes de compilation de PHP, vous devez prendre en compte leurs avantages et inconvénients respectifs. Les objets partagés permettent de compiler PHP et Apache de manière séparée, et vous n'aurez pas à compiler l'ensemble pour faire évoluer PHP. La compilation statique permet de charger et d'éxé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 à 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 ç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écifiez la version installé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éellement installée sur votre systè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éthodes pour faire fonctionner PHP avec Apache 1.3.x sous Windows. La première est d'utiliser l'exécutable CGI (php.exe), l'autre est d'utiliser les modules Apache DLL. Dans les deux cas, vous devez arrêter le serveur Apache, é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érences de configurations de PHP sous Apache, le processus reste simple et à la portée du néophyte. Reportez-vous aux documentations Apache pour plus de détails sur ces directives. </simpara> <para> Si vous avez dézippé le package dans <filename>C:\PHP\</filename> comme indiqué dans <link linkend="install.windows.manual">Instructions Générales d'installation</link>, vous devez insé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é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 à plusieurs attaques potentielles. Lisez donc la section <link linkend="security.cgi-bin">sécurité des CGI</link> pour savoir comment vous en défendre. </para> </warning> <para> Si vous voulez utiliser PHP comme module Apache, vous devez dé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 é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ès avoir modifié le fichier de configuration, pensez à redé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éthodes pour utiliser la fonctionnalité de coloration syntaxique, elles dépendent de votre installation. Si vous avez configuré 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écutable CGI, vous aurez besoin de la fonction <function>show_source</function>. Pour cela, créez simplement un script PHP et ajoutez-y le code suivant : <literal><?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 être convertis en slash c'est à 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ès recommandé 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é de PHP avec Apache 2.0</title> <para> Les versions de &php; suivantes sont reconnues pour fonctionner avec la plus récente version d'Apache 2.0 : <itemizedlist spacing="compact"> <listitem> <simpara> PHP 4.3.0 ou plus récent, disponible à <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. </simpara> </listitem> <listitem> <simpara> Les dernières versions de développement. Le code source est disponbile à <ulink url="&url.php.snapshots;php4-latest.tar.gz">&url.php.snapshots;php4-latest.tar.gz</ulink>, et les exécutables compilés de Windows à <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élé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écent. </para> <note> <simpara> Le supoprt des SAPI d'Apache 2.0 a commencé 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é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éléchargez la plus récente version de <ulink url="&url.apache;">Apache 2.0</ulink> et une version appropriée de &php;, tel que décrit ci-dessus. Ce guide rapide couvre les manipulations de base, nécessaire à l'installation de Apache 2.0 et &php;. Pour plus d'informations, lisez la <ulink url="&url.apache2.docs;">Documentation Apache</ulink>. Les numéros de version sont omis ici, poru s'assurer que les instructions ne soient pas incorrectes. Il faudra donc remplacer les séquences 'NN' avec les valeurs correctes que vous utilisez. </para> <example> <title>Instruction d'installation (Module partagé 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é dans /usr/local/apache2, configuré avec le support des modules dynamiques, et le préfork standard MPM. Pour tester l'installation, utilisez votre procédure standard de dé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éférez placez ce fichier à un autre endroit, utilisez l'option --with-config-file-path=/path en étape 10. 14. Edites votre fichier httpd.conf et vérifiez la pré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érons. Le chemin sur la driot de la directive LoadModule doit indiquer le chemin du module PHP de votre système. La directive ci-dessus est correcte si vous avez suivi les autres étapes à la lettre. 15. Utilisez votre procédure standard pour redémarrer Apache : /usr/local/apache2/bin/apachectl start ]]> </screen> </example> <para> Suivez les é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étails, utilisez la commande <command>./configure --help</command> dans le dossier de souces approprié. Si vous souhaitez compiler uen version multi-threadé 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 à la ligne de configuration de l'étape 6, l'option <option role="configure">--with-mpm=worker</option> ou <option role="configure">--with-mpm=perchild</option>. Soyez conscient des conséquences, et comprenez bien ce que vous faites. Pour plus de dé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ée d'Apache, votre système doit supporter les threads. Cela implique aussi de compiler &php; avec le module expérimental de Zend Thread Safety (ZTS). Par conséquent, toutes les extensions ne seront pas disponibles. La configuration recommandé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écifiques à Windows</ulink> pour Apache 2.0. </para> <warning> <para> Apache 2.0 est conç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évu pour fonctionner sur ces plate-formes a ce moment. </para> </warning> <para> Téléchargez la plus récente version de <ulink url="&url.apache;">Apache 2.0</ulink> et une version de PHP appropriée, tel que mentionné au début de ce chapiter. Suivez les instructions <link linkend="install.windows.manual">d'installation manuelle</link> puis revenez ici pour réaliser l'intégration de &php; et Apache. </para> <para> Il ya deux méthodes pour que &php; fonctionne avec Apache 2.0 sous Windows. La première est l'interface CGI, et l'autre est le module DLL APache. Dans les deux cas, commencez par stopper le serveur Apache, et éditez le fichier <filename>httpd.conf</filename> pour configurer Apache avec le support &php;. </para> <para> Vous devez insérer les lignes suivantes dans le fichier <filename>httpd.conf</filename> pour réaliser la configuration en mode <emphasis>CGI</emphasis>: <example> <title>Configurer la version de développement de PHP avec Apache 2.0 en CGI</title> <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écutable CGI a changé, 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 écrasant tout autre fichier qui s'y trouverait. Puis vous devrez insérer les deux lignes suivantes dans votre fichier de configuration d'Apache <filename>httpd.conf</filename> 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éel de &php; dans les exemples ci-dessus. Ne mélangez pas votre installation en module (DLL) avec <emphasis>différentes versions de PHP</emphasis>. Vous avez à utiliser uniquement les DLL et extensions qui sont fournies avec la version de PHP que vous télé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 être compilé comme module Pike pour <ulink url="&url.caudium;">le serveur web Caudium</ulink>. Notez que ce mode n'est pas supporté 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é avant de tenter l'installation PHP 4. Pour que PHP 4 fonctionne correctement, vous devez installer Pike 7.0.268 ou plus récent. Pour cet exemple, nous supposerons que vous avez installé Caudium dans le dossier /opt/caudium/server/. 2. Renommez le dossier en php-x.y.z (où x.y.z est le numéro de version). 3. ./configure --with-caudium=/opt/caudium/server 4. make 5. make install 6. Redémarrez Caudium s'il était en fonctionnement 7. Connectez-vous à 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émarré le serveur. Si vous l'avez fait, vérifiez le fichier /opt/caudium/logs/debug/default.1 : il contient peut-être des erreurs liées à PHP4.so. De même, assurez-vous que caudium/server/lib/[pike-version]/PHP4.so est présent. 10. Configurez le module "PHP Script Support" si nécessaire. </programlisting> </example> <para> Vous pouvez bien sûr compiler votre module Caudium avec les diverses extensions disponibles. Voyez la <link linkend="install.configure">liste complète des options de configuration</link> pour une liste exhaustive. </para> <note> <para> Lorsque vous ajoutez le support MySQL à PHP 4, vous devez-vous assurer que le client MySQL normal est utilisé. Sinon, il peut y avoir des conflits avec Pike, qui dispose déjà du support MySQL. Vous pouvez le faire en spécifiant le dossier d'installation de MySQL grâce à 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écution en ligne de commande</title> <para> Par défaut, PHP est compilé comme une CGI. Si PHP peut être incorporé au serveur web que vous utilisez en tant que module, de manière géné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é à la <link linkend="security">sécurité</link> si vous souhaitez utiliser cette solution. </para> <sect2 id="install.commandline.testing"> <title>Tests</title> <simpara> Si vous avez compilé 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ésultat d'une compilation. Cela vous permet de repérer des problè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é PHP comme programme CGI, vous pouvez évaluer les performances de PHP 3 avec la commande <command>make bench</command>. Notez que si le &safemode; est activé (par défaut), vous ne risquez pas de voir l'évaluation s'arrêter une fois les 30 secondes réglementaires écoulées. En effet, la fonction <function>set_time_limit</function> ne peut pas être utilisée si le &safemode; fonctionne. Utilisez l'option <link linkend="ini.max-execution-time">max_execution_time</link> pour contrôler le temps d'éxé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édéfinies</title> <simpara> Certaines variables d'environnements fournies par les serveurs web ne sont pas disponibles dans les spécifications actuelles <ulink url="&url.cgispec;">CGI/1.1 specification</ulink>. Seules, les variables suivantes sont définies, et les autres doivent être considérées comme spé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é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é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é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é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é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éfaut, c'est $EMPRESSPATH. Depuis PHP4, cette option ne supporte que Empress Version 8.60 et plus ré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éfaut, c'est $EMPRESSPATH. Depuis PHP4, cette option ne supporte que Empress Version 8.60 et plus ré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é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éfaut, c'est /usr/local. Assurez vous que la variable CUSTOM_ODBC_LIBS est définie, et que le fichier odbc.h est dans votre chemin d'inclusion, c'est à dire que vous devriez dé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é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é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é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éfaut, c'est /usr/local. C'est le mê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éfaut, c'est le chemin de la derniè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é. Uniquement utilisable si iODBC, Adabas, Solid, Velocis ou une interface ODBC spéciale st activé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éfaut, &php; essaiera de le trouver de lui-même. [expé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érification de sécurité 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ée, l'exécutable PHP peut être placé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ébogage. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-layout"> <term> <parameter>--with-layout=TYPE</parameter> </term> <listitem> <para> Indique comment les fichiers installés doivent être rangés. Les valeurs possibles sont Type (valeur par dé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é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 à PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-rpath"> <term> <parameter>--disable-rpath</parameter> </term> <listitem> <para> Inactive le passage de chemins supplé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ôts de PHP (expé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=<DIR></parameter> </term> <listitem> <para> Dé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é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égulières du système (obsolè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é par défaut). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> <parameter>--enable-shared[=PKGS]</parameter> </term> <listitem> <para> Compile les librairies partagées. Par dé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é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é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é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é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é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è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écessaires. Voir le fichier INSTALL pour plus de dé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ê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é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âce à 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és de débogage à 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è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ègles de compilation (make) et des dé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éside le fichier &php.ini;. Par dé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é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écutables situés dans le dossier DIR lorsque le safe mode est activ. Par dé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><?</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é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é. FILE est un chemin d'accès optionnel vers les outils apxs d'Apache. Par défaut, c'est apxs. Assurez vous de spécifier la version d'apxs qui est réellement installée sur votre systè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é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é Apache 2.0. FILE est un chemin d'accès optionnel vers les outils apxs d'Apache. Par dé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é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é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é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ée comme une librairie partagé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ète des options de configuration</title> <note> <para> Ces options sont utilisées uniquement au moment de la compilation. Si vous voulez modifier le comportement de PHP lors de l'exécution, reportez vous au chapitre <link linkend="configuration">configuration</link>. </para> </note> <para> Ci-dessous, vous trouverez une liste complète des options supportées par le script de configuration de PHP 4, <filename>configure</filename> (depuis PHP 4.1.0), utilisé 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énérales pour le script <command>configure</command>, consultez les pages appropriées du manuel de GNU <command>autoconf</command> ou bien utilisez la commande <command>configure --help</command> pour avoir une liste complète et à jour des options. </para> <itemizedlist> <listitem> <para> <link linkend="install.configure.options.databases">Bases de donné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ées qu'en PHP 4, depuis la version PHP 4.1.0. Certaines sont disponibles dans les anciennes versions PHP 4, certaines mê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épondre "yes" à la question "Build as an fhttpd module ?" (cela correspond à l'option de configuration <link linkend="install.configure.with-fhttpd">--with-fhttpd</link>=<replaceable>DIR</replaceable> et spécifier la racine de la distribution fhttpd. Le répertoire par dé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érieures, plus de contrôle et la possibilité d'exécution à 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érations géné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é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 à interface graphique</simpara></listitem> </itemizedlist> </para> <para> Pour la première tâche, qui est de loin la plus répandue, vous avez besoin de trois choses : PHP lui-même, un serveur web et un navigateur. Vous avez probablement un navigateur, et en fonction de votre systè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 à une société. De cette façon, vous n'aurez pas à mettre en place PHP, mais uniquement à écrire vos scripts, les charger sur le serveur et voir le résultat sur votre navigateur. </para> <para> Si vous installez PHP et le serveur par vous-même, vous avez deux choix. Soit sous la forme d'un module du serveur web (via une interface directe appelé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é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 (écrire des scripts de géné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écutable PHP. Pour plus de détails, lisez la section <link linkend="install.commandline"> é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 écrire des interfaces graphiques clientes, en utilisant l'extension PHP-GTK. C'est une approche complètement différente de l'écriture des pages web, car vous ne générerez pas de fichiers HTML, mais vous aurez à gérer des fenêtres et des objets. Pour plus de dé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écrit l'installation de PHP avec un serveur web sous Unix et Windows, sous forme de module ou d'exécutables CGI. </para> <simpara> Les codes source et les exécutables compilés de certains OS (y compris Windows), sont disponibles à <ulink url="&url.php;">&url.php;</ulink>. Nous recommandons l'utilisation du <ulink url="&url.mirrors;">miroir</ulink> le plus proche pour accélé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és à 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éléchargez la distribution compilée à http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z, puis décompressez la, et utilisez swinstall pour installer. 2. Vous aurez besoin de gcc. Téléchargez une distribution compilée à http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz, puis décompressez la, et utilisez swinstall pour installer. 3. Vous aurez besoin de GNU binutils. Téléchargez une distribution compilée à http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz , puis décompressez la, et utilisez swinstall pour installer. 4. Vous aurez besoin de bison. Téléchargez une distribution compilée à http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz , puis décompressez la, et utilisez swinstall pour installer. 5. Vous aurez besoin de flex. Télé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éléchargez le fichier, décompressez leur, puis utilisez tar -xvf avec. Allez dans le nouveau dossier flex ainsi créé, et exécutez la commande "./configure", puis faites un "make", puis un "make install". Si vous avez des erreurs à cette étape, c'est probablement par ce que gcc et les autres ne sont pas inscrites dans votre PATH. Ajoutez les. Maintenant, la partie délicate. 6. Téléchargez les sources d'Apache et de PHP. 7. Décompressez les avec gunzip puis faites "tar -xvf" avec les deux archives. Nous devons modifier quelques fichiers avant de les compiler. 8. Premièrement, le fichier de configuration doit être modifié car il semble oublier qu'il est sur une machine HP-UX. Il y a des méthodes plus rusées, mais le plus simple et le plus efficace est d'ajouter "lt_target=hpux10.20" à la ligne 47286 du script de configuration. 9. Le fichier d'Apache GuessOS doit être modifié. Sous apache_1.3.9/src/helpers, modifier la ligne 89, en remplaç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és correctement, mais Apache ne démarre pas. Vous devez cré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'éxécuter Apache avec l'utilisateur nobody sous HP-UX. A partir de ce moment là, PHP et Apache doivent fonctionner. J'espè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écent</link> et <link linkend="install.iis.iis4">IIS 4 ou plus récent</link>. </para> <sect2 id="install.iis.iis3"> <title>Windows et PWS/IIS 3</title> <simpara> La méthode recommandée pour configurer ces serveurs est d'utiliser le fichier INF inclus dans la distribution (<filename>php_iis_reg.inf</filename>). Vous pouvez é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èrent la manipulation du fichier de registry de Windows. Une erreur peut laisser votre système dans un état instable. Nous vous recommandons vivement de sauvegarder ce fichier en lieu sûr. L'équipe de développement et les traducteurs de cette documentation ne pourront pas ê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'à : <literal>HKEY_LOCAL_MACHINE /System /CurrentControlSet /Services /W3Svc /Parameters /ScriptMap</literal>. </simpara> </listitem> <listitem> <simpara> Dans le menu "edit", sé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îne, et entrez le chemin jusqu'à <literal>php.exe</literal> dans le champ "value data". ex: <literal>c:\php\php.exe</literal>. </simpara> </listitem> </itemizedlist> </para> <para> Les étapes suivantes n'affectent pas la configuration du serveur web, et ne s'appliquent que si vous voulez que vos scripts PHP soient exécutés lorsqu'il sont exécuté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 étapes si vous préférez que vos scripts PHP s'ouvrent dans éditeur de texte, plutôt que de les voir s'exécuter lorsque vous double-cliquez dessus. </para> <para> <itemizedlist> <listitem> <simpara> Répétez ces instructions pour toutes les extensions que vous voulez associer aux scripts PHP. </simpara> </listitem> <listitem> <simpara> Naviguez jusqu'à : <literal>HKEY_CLASSES_ROOT</literal> </simpara> </listitem> <listitem> <simpara> Dans le menu edit, sélectionnez: <literal>New->Key</literal>. </simpara> </listitem> <listitem> <simpara> Donnez le nom de votre extension à la clé : ex: <literal>.php</literal> </simpara> </listitem> <listitem> <simpara> Sélectionnez le nom de la nouvelle clée dans le panneau de droite, et double cliquez dans "default value", puis entrez <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Répétez ces instructions pour toutes les extensions que vous avez associées aux scripts PHP. </simpara> </listitem> <listitem> <simpara> Créez une autre <literal>New->Key</literal> sous <literal>HKEY_CLASSES_ROOT</literal> et nommez-la <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Sélectionnez la nouvelle clé <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électionnez <literal>New->Key</literal>, appelez-le <literal>Shell</literal>. </simpara> </listitem> <listitem> <simpara> Faites un clic droit dans <literal>Shell</literal> et sélectionnez <literal>New->Key</literal>, appelez-le <literal>open</literal>. </simpara> </listitem> <listitem> <simpara> Faites un clic droit dans <literal>open</literal> et sélectionnez <literal>New->Key</literal>, appelez-le <literal>command</literal>. </simpara> </listitem> <listitem> <simpara> Sélectionnez la nouvelle clé <literal>command</literal> et dans le panneau de droite, faites un double clic dans "default value", puis entrez le chemin jusqu'à <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émarrez pour prendre en compte la nouvelle registry. </simpara> </listitem> </itemizedlist> </para> <simpara> Les utilisateurs de PWS et IIS 3 sont prêts à 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écent</title> <simpara> Pour installer PHP sous Windows avec PWS 4 ou plus ré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 être échappé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é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 être échappé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é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écent</title> <simpara> Pour installer PHP sous Windows NT/2000 serveyr avec IIS 4 ou plus ré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ée soit dans "Windows NT 4.0 Option Pack" ou dans "Control Panel=>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é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électionnez l'onglet "App Mappings". </simpara> </listitem> <listitem> <simpara> Cliquez sur "Add", puis dans la boîte "Executable", tapez : <literal>c:\php\php.exe</literal> (si vous avez installé PHP dans le dossier <literal>c:\php\</literal>.) </simpara> </listitem> <listitem> <simpara> Dans la boî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éférer cocher la boîte 'check that file exists' - pour un coût faible, IIS (ou PWS) s'assirurera que le script existe, et résoudra les problèmes d'autentification avant de démarrer PHP. Cela signifie que vous obtiendrez des messages d'erreur 404 intelligents, plutôt que d'avoir simplement une plainte du serveur comme quoi les CGI n'ont rien retournés. </simpara> <simpara> Répétez les é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épandues.) </simpara> </listitem> <listitem> <simpara> Configurer la sécurité nécessaire (dans "Internet Service Manager"), et si votre serveur NT utilise NTFS, ajoutez les droits adé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 étape. Avec ISAPI Filters, ajoutez un nouveau filtre ISAPI. Utilisez PHP comme nom de filtre, et ajoutez simplement le chemin jusqu'à <filename>php4isapi.dll</filename>. </simpara> </listitem> <listitem> <simpara> Sous "Home Directory", cliquez sur le bouton "Configuration". Ajoutez une nouvelle entrée dans "Application Mappings". Utilisez le chemin jusqu'à <filename>php4isapi.dll</filename> comme "Executable", indiquez ".php" comme extension, laissez "Method exclusions" vide, et cochez "Script engine". </simpara> </listitem> <listitem> <simpara> Arrêtez totalement IIS (NET STOP iisadmin) </simpara> </listitem> <listitem> <simpara> Dé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étails spécifique à 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éfaut est géné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é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 étapes suivantes, assurez-vous que /opt/netscape/suitespot/ correspond bien à 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ès avoir fait l'installation de base et lu les fichiers readme.txt, vous pouvez avoir besoin de faire des configurations supplémentaires. </para> <para> D'abord, vous devez ajouter des chemins dans la variable LD_LIBRARY_PATH pour que PHP trouve toutes les librairies partagées. Le mieux est de le faire dans le script de démarrage de votre serveur Netscape. Les utilisateurs Windows peuvent probablement ignorer cette étape. Le script de démarrage est situé dans : <filename class="directory">/path/to/server/https-servername/start</filename> </para> <para> Vous pouvez aussi avoir besoin d'éditer les fichiers de configuration qui sont situé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épendre de votre OS, pour Unix c'est quelque chose de proche de /opt/netscape/suitespot/bin/libphp4.so. Il est conseillé de placer les lignes suivantes aprè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 être placée aprè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 être utilisé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ès les types MIME, et tout le reste ressemble à 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 être Fastrack), suivez ces instructions : </para> <itemizedlist> <listitem> <simpara> Copiez le fichier <filename>php4ts.dll</filename> dans votre dossier systemroot (le dossier où vous avez installé windows) </simpara> </listitem> <listitem> <para> Faî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éez un dossier shellcgi et supprimez le aussitôt (cette opération créee 5 lignes importantes dans le fichier obj.conf et permet au serveur de gérer les scripts CGI). </simpara> </listitem> <listitem> <simpara> Dans le serveur Netscape Enterprise Administration Server, cré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écuter PHP. </simpara> </listitem> </itemizedlist> <para> Plus de détails sur la configuration de PHP comme CGI sont disponibles à <ulink url="&url.netscape.cgi;">&url.netscape.cgi;</ulink> </para> <para> Pour installer PHP avec l'interface NSAPI (pour Netscape Enterprise Server, iPlanet, peut-être Fastrack), faîtes ceci : </para> <itemizedlist> <listitem> <simpara> Copiez le fichier <filename>php4ts.dll</filename> dans votre dossier systemroot (le dossier où vous avez installé windows) </simpara> </listitem> <listitem> <para> Faî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éeez un nouveau type MIME (Category: type, Content-Type: magnus-internal/shellcgi, File Suffix:php). </simpara> </listitem> <listitem> <para> Stoppez votre serveur web et éditez le fichier <filename>obj.conf</filename>. A la fin de la section Init, placez ces deux lignes (obligatoirement aprè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>< Object name="default" ></literal>, placez cette ligne, obligatoirement aprè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éez un nouvel objet appelé <literal>x-httpd-php</literal>, en insé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é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é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ème d'installation par package, comme le fameux RPM. Ils vous permettent de faire des installations standard, mais si vous avez des configurations spécifiques (comme par exemple un serveur sécurisé, ou un pilote de base de données exotique), vous aurez probablement à compiler vous-même votre PHP et votre serveur web. Si vous n'êtes pas familier avec la compilation de vos propres logiciels, il vaut mieux rechercher le package qui pourra répondre à 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é-packagées et pré-compilée de &php; pour MacOSX. Cela être utile pour mettre en place une configuration standard, mais si vous avez besoin d'accéder a des fonctionnalités spécifiques (comme un serveur sécurisé, ou un pilote de base de données exotique), vous aurez à compiler &php; et/ou votre serveur web vous même. Si vous n'êtes pas familiers avec la compilation et la mise en place d'applications, il est bon de vérifier si personne d'autre n'a réalisé un package. </simpara> </sect2> <sect2 id="install.macosx.compile"> <title>Compilation pour OS X server</title> <simpara> Il existe deux versions légèrement diffé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ées MySQL et PostgreSQL. </simpara> <simpara> NOTE: Attention lors des manipulations ci-dessous : vous pourriez détruire la configuration de votre serveur. </simpara> <para> Faites ceci : <itemizedlist> <listitem> <simpara> 1. Ouvrez une fenê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élé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, à 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èse (<literal>#</literal>), puis sauvez le fichier, et quittez TextEdit. </para> <para> Finalement, tapez "<literal>sudo apachectl graceful</literal>" pour redémarrer le serveur Apache. </para> <para> &php; devrait être fonctionnel. Vous pouvez le tester en créant un fichier dans votre dossier "Sites", appelé "test.php". Dans ce fichier, écrivez la ligne ci-contre : "<literal><?php phpinfo() ?></literal>". </para> <para> Maintenant, ouvrez votre navigateur à 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écent pour Windows</title> <simpara> Vous devez réaliser les étapes suivantes pour configurer PHP sur votre serveur OmniHTTPd. C'est une configuration en exécutable CGI. SAPI est supporté par OmniHTTPd, mais des tests on prouvé 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ème, et sé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épetez les étapes de 2 à 6 pour chaque extension que vous voulez associer à 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écocher le composant PHP. Nous recommandons d'utiliser les dernières versions de PHP. Certains serveurs OmniHTTPd sont livrés avec des versions béta de PHP, et il vaut donc mieux éviter de les installer, et choisir une autre version, stable. Si le serveur est déjà sur votre machine, utilisez le bouton "Replace" (remplacer) dans les é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écifiques à 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éthode est la méthode recommandée pour installer &php; sur OpenBSD. C'est aussi la méthode la plus simple. Le paquet core a été séparé des modules et chacun d'entre eux peut être installé et supprimé indé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é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é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éthode est recommandée aux utilisateurs expérimentés de OpenBSD. Le port PHP4 est scindé en trois sous-dossier : core, extensions et pear. Le dossier extensions génère les sous paquets de tous les modules &php;. Si vous souhaitez ne pas cré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ème des FLAVORS pour compiler statiquement PHP. Comme il est trop difficile de générer des packages binaires avec cette méthode, elle est considérée comme obsolète. Vous pouvez touours utiliser les anciennes versions stables, mais sachez qu'elles ne sont plus supportées par l'é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écifiques à Oreilly Website Pro. </para> <sect2 id="install.oreilly.windows"> <title>Oreilly Website Pro 2.5 et plus récent pour Windows</title> <simpara> Cette liste décrit comment installer PHP comme CGI exécutable ou module ISAPI avec Oreilly Website Pro sous Windows. </simpara> <para> <itemizedlist> <listitem> <para> Editez les "Server Properties" et sélectionnez l'onglet "Mapping". </para> </listitem> <listitem> <para> Dans la "List" sélectionnez "Associations" et entrez le nom de l'extension voulue (".php") et le chemin jusqu'à l'exécutable (ex. c:\php\php.exe) ou la DLL ISAPI (ex. c:\php\sapi\php4isapi.dll). </para> </listitem> <listitem> <para> Sélectionnez "Content Types", ajoutez la mê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 être compilé pour fonctionner avec de nombreux autres serveurs web. Reportez-vous à <link linkend="install.configure.options.servers">Options particulières aux serveurs web</link> pour une liste complète des options de configuration. Les exécutables PHP CGI sont compatibles avec la majorité 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èmes?</title> <sect2> <title>Lisez la FAQ</title> <simpara> Certains problèmes sont récurrents : les plus communs sont listés dans la FAQ PHP, disponible à <link linkend="faq">dans ce manuel</link>. </simpara> </sect2> <sect2 id="install.otherproblems"> <title>Autres problèmes</title> <simpara> Si vous êtes complètement bloqués, quelqu'un sur la liste de diffusion PHP pourra probablement vous aider. Essayez de consulter les archives, au cas où quelqu'un aurait déjà rencontré votre problème. Les archives sont toujours accessibles à : <ulink url="&url.php;">&url.php;</ulink>. Pour souscrire à la liste de diffusion, envoyez un mail vide à <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'être concis et clair, et pensez à donner tous les détails sur votre environnement (OS, version de PHP, serveur web, CGI ou module, &safemode;...), et n'hésitez pas à envoyer 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é un bug dans PHP, n'oubliez pas de le signaler. L'équipe de développement PHP ne le connaît peut être pas, et si vous ne le signaler pas, vos chances de voir le bug corrigé sont nulles. Vous pouvez rapporter des bugs grâce au système de suivi, accessible à <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écrit comment configurer le module ISAPI avec le serveur Sambar sous Windows. </simpara> <para> <itemizedlist> <listitem> <para> Trouvez le fichier appelé <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 été installé dans le dossier <filename>c:\php</filename>.) </para> </listitem> <listitem> <para> Maintenant, redé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écessaires</title> <para> L'installation Solaris oublie généralement les compilateurs C, et leurs utilitaires. Voici la liste des outils nécessaires : <itemizedlist> <listitem> <simpara> gcc (recommandé, 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 être aussi compiler) toutes les librairies né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 étudier les sections spécifiques à votre plate-forme ou à votre serveur web avant de passer à l'installation. </para> <para> Pré-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écessaires aux extensions (librairie <acronym>GD</acronym>, <acronym>PDF</acronym>, etc...) </simpara> </listitem> </itemizedlist> </para> <para> Il y a plusieurs façons d'installer PHP sur une plate-forme UNIX : soit un processus de compilation-configuration, ou bien avec des packages déjà tout prêts. Cette documentation se concentre sur la première solution. </para> <para> La première partie du processus est faite en ligne de commande, grâce aux options du script <filename>configure</filename>. Cette section présente l'utilisation des options les plus courantes, mais il y en a beaucoup d'autres à essayer. Reportez-vous à la <link linkend="install.configure">liste complète des options de configuration </link> pour une liste exhaustive. Voici les différentes mé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écutable CGI</link> </simpara> </listitem> </itemizedlist> </para> <sect2 id="install.unix.apache-module"> <title>Installer PHP comme module Apache</title> <para> PHP peut être compilé de nombreuses manières différentes, mais la plus populaire est le module Apache. La liste suivante est un ré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édure habituelle pour redémarrer le serveur Apache. (vous devez arrêter puis redémarrer le serveur, et pas seulement forcer le serveur à relire la configuration initiale). ]]> </programlisting> </example> </sect2> <sect2 id="install.building"> <title>Compilation</title> <simpara> Lorsque PHP est configuré, vous êtes prêts à compiler l'exécutable CGI. La commande <command>make</command> doit prendre tout en charge. Si ce n'est pas le cas et que vous restez bloqué, reportez-vous aux <link linkend="install.problems">problè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èmes Windows 95/98/Me et Windows NT/2000/XP. (La configuration n'est actuellement pas confirmée sous XP). Ne vous attendez pas à ce que PHP fonctionne sur les plateformes 16 bits, comme Windows 3.1. Parfois, on décrira les plateformes supportées sous le nom de Win32. </para> <para> Il y a deux méthodes principales pour installer PHP sous Windows : soit <link linkend="install.windows.manual">manuellement</link>, soit avec <link linkend="install.windows.installer">InstallShield</link>. </para> <para> Si vous avez Microsoft Visual Studio, vous pouvez aussi <link linkend="install.windows.build">compiler</link> PHP à partir des sources. </para> <para> Une fois que PHP est installé 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éthode simple pour installer PHP, il est limité 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ème et assurez-vous qu'il fonctionne. </simpara> <simpara> Exé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éfaut les plus pratiques, et avancée, qui pose un maximum de questions pour paramé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ée, et vous pouvez sélectionner les dossiers qui utiliseront PHP. </simpara> <simpara> Une fois l'installation terminée, l'installeur vous informera que vous devez redémarrer. Suivez ce conseil, ou commencez à utiliser PHP immédiatement. </simpara> <warning> <para> Gardez bien à l'esprit que cette installation de PHP n'est pas sécurisée. Si vous voulez avoir une installation sécurisée de PHP, vous devriez commencer par lire la documentation, et choisir toutes vos options avec soin. Cet installeur automatique vous permet de réaliser l'installation en un tour de main, mais n'est pas destinée à l'utilisation sur des serveurs de production. </para> </warning> </sect2> <sect2 id="install.windows.manual"> <title>Manual Installation Steps</title> <title>Instructions Générales d'installation</title> <simpara> Ce guide vous permet d'installer et de configurer manuellement PHP sur vos stations Windows 9x/Me/NT/2000. Vous devrez commencer par télécharger la distribution de &php; au format compressé ZIP à <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. La première version de ce guide a été compilée par &link.bob;. La version originale est disponible (en anglais) à <ulink url="&url.win32install;">&url.win32install;</ulink>. </simpara> <para> Ce guide fournit une aide d'installation pour : <itemizedlist> <listitem> <para> Personal Web Server (Version la plus récente recommandée) </para> </listitem> <listitem> <para> Internet Information Server 3 ou 4 </para> </listitem> <listitem> <para> Apache 1.3.x </para> </listitem> <listitem> <para> Omni HTTPd 2.0b1 et plus récent </para> </listitem> <listitem> <para> Oreilly Website Pro </para> </listitem> <listitem> <para> Xitami </para> </listitem> <listitem> <para> Netscape Enterprise Server, iPlanet </para> </listitem> </itemizedlist> </para> <para> PHP 4 pour Windows est décliné en deux versions : un exécutable CGI (<filename>php.exe</filename>), et plusieurs modules SAPI (par exemple php4isapi.dll). Cette dernière forme est nouvelle pour PHP 4 et founit des performances améliorées ainsi que des fonctionnalités supplémentaires. </para> <warning> <simpara> Les modules SAPI ont été significativement amélioré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èmes. </simpara> </warning> <para> Si vous choisissez l'un des modules SAPI et utilisez Windows 95, pensez à télécharger la mise à jour DCOM à <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>. Pour le module ISAPI, comme un serveur web compatible est nécessaire (testé avec IIS 4.0, PWS 4.0 et IIS 5.0). IIS 3.0 <emphasis>n'est pas</emphasis> supporté; vous devez télécharger et installer le Windows NT 4.0 Option Pack avec IIS 4.0 si vous voulez le support natif de PHP. </para> <para> Voici les différentes étapes d'installation avant les étapes spécifiques au serveur. <itemizedlist> <listitem> <para> Extrayez la distribution dans le dossier de votre choix. <filename>"C:\php\"</filename> est une bonne idée. </para> </listitem> <listitem> <para> Vous devez vous assurer que les DLL que PHP utilise sont disponibles. La liste précise des DLL dépend du serveur web que vous utiliser, et de la méthode que vous utiliser pour faire exécuter vos script (CGI ou module). <filename>php4ts.dll</filename> est toujours né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ées. Pour être certains que les DLL sont accessibles, vous pouvez les copier dans le dossier système (i.e. <filename>winnt/system32</filename> ou <filename>windows/system</filename>) ou vous pouvez vous assurer qu'elles sont dans le même dossier que l'exécutable PHP ou les autres DLL de votre serveur web (i.e. php.exe, ou php4apache.dll). </para> <para> L'exécutable binaire PHP, les modules SAPI, et certaines extensions utilisent des DLL externes. Assurez vous que ces DLL sont dans votre distribution, et dans un dossier qui est cité dans le PATH Windows. Le mieux à faire est de copier les fichiers ci-dessous dans votre dossier système, qui est généralement : <simplelist> <member>c:\windows\system pour Windows 9x/Me</member> <member>c:\winnt\system32 pour Windows NT/2000</member> </simplelist> Les fichiers à copier sont : <simplelist> <member> 'php4ts.dll', s'il existe, écrasez le </member> <member> Les fichiers 'dlls' de votre distribution. Si vous les avez déjà installé, ne les remplacez pas, sauf si quelquechose ne fonctionne pas correctement (avant de les écraser, il est recommandé de les sauver de toutes manières, au cas où quelque chose irait de travers). </member> </simplelist> </para> <para> Téléchargez la dernière version de Microsoft Data Access Components (MDAC) pour votre plateforme, spécialement si vous utilisez Microsoft Windows 9x/NT4. MDAC est disponible à <ulink url="&url.mdac;">&url.mdac;</ulink>. </para> </listitem> <listitem> <para> Copiez le fichier '<filename>php.ini-dist</filename>' dans votre dossier '%WINDOWS%' sous Windows 95/98, ou vers votre dossier '%SYSTEMROOT%' sous Windows NT ou Windows 2000 et renommez le en '&php.ini;'. Votre dossier '%WINDOWS%' ou '%SYSTEMROOT%' est généralement : <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é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é d'un point de vue sécurité et vitesse d'exécution. Le mieux est tout de mê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écurité, c'est par ce moyen que vous pourez le faire, même si PHP focntionne parfaitement avec les configurations par défaut. </para> </listitem> <listitem> <para> Editez votre fichier &php.ini; : <itemizedlist> <listitem> <simpara> Vous devez changer votre option 'extension_dir' pour qu'il pointe sur votre dossier d'installation PHP, ou vers l'endroit où vous avez installé vos 'php_*.dll'. ex: c:\php\extensions </simpara> </listitem> <listitem> <simpara> Si vous utilisez Omni Httpd, sautez l'étape suivante. Modifiez 'doc_root' pour qu'il pointe sur votre racine de serveur web. ex: <filename>c:\apache\htdocs</filename> ou <filename>c:\webroot</filename>. </simpara> </listitem> <listitem> <simpara> Choisissez les modules que vous voulez charger lorsque PHP démarre. Voyez la section sur les <link linkend="install.windows.extensions">extensions Windows</link>, pour savoir comment les installer et quelles sont celles qui sont déjà inclues. Notez aussi qu'il est préférable de commencer par faire fonctionner &php; sur une nouvelle installation avant d'activer des extensions supplémentaires avec &php.ini;. </simpara> </listitem> <listitem> <simpara> Sous PWS et IIS, vous pouvez configurer le fichier <filename>browscap.ini</filename> pour qu'il pointe sur <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous Windows 9x/Me, <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sous NT/2000 et <filename>c:\windows\system32\inetsrv\browscap.ini</filename> sous XP. </simpara> </listitem> <listitem> <simpara> Notez que le dossier <filename>mibs</filename> fourni avec la distribution Windows, contient des fichiers de support du protocole SNMP. Ce dpssier doit être déplacé dans le dossier <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> est le périphérique où PHP est installé.) </simpara> </listitem> <listitem> <simpara> Si vous n'utilisez pas NTFS sous Windows NT, 2000 et XP, assurez vous que l'utilisateur qui fait tourner le serveur web a bien les permission pour accéder à votre &php.ini;. </simpara> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> Avec PWS, donnez les droits d'exécution au webmestre : <itemizedlist> <listitem> <simpara> Démarrez le PWS Web Manager </simpara> </listitem> <listitem> <simpara> Editez les Properties du dossier "Home" </simpara> </listitem> <listitem> <simpara> Sélectionnez la coche "execute" </simpara> </listitem> </itemizedlist> </para> </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édiatement à l'esprit : </para> <orderedlist> <listitem> <simpara> Windows ne dispose pas (encore) d'une grande communauté de développeurs qui partagent librement leurs sources. La conséquence directe est que les investissements nécessaires en infrastructure pour supporter ce type de développement n'ont pas été faits. Ce qui fait que le portage des utilitaires Unix a été la solution pour pallier ce manque. Ne soyez donc pas surpris de rencontrer cette parenté de temps en temps. </simpara> </listitem> <listitem> <simpara> La majorité 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écutable &php;, vous avez besoin d'un Microsoft Development Environment. Microsoft Visual C++ 6.0 est recommendé. Pour éxtraire le fichier téléchargé, vous avez besoin d'un outil de décompression (e.g.: Winzip). Si vous n'avez pas encore d'utilitaire de décompression, vous pouvez en télécharger un chez <ulink url="&url.infozip;">InfoZip</ulink>. </para> <para> Avant de commencer, vous devez télé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ésolveur de noms DNS utilisé 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é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êmes!! Les dernières versions sont accessibles sur le serveur CVS <ulink url="&url.php.anoncvs;">anonyme</ulink>. Si vous téléchargez une version <ulink url="&url.php.snapshots;">intermé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ès téléchargement des paquets nécessaires, vous devez les extraire au bon endroit. <itemizedlist> <listitem> <simpara> Créez un dossier où tous les fichiers seront placés après l'extraction, comme par exemple :<filename>c:\work</filename>. </simpara> </listitem> <listitem> <simpara> Créez le dossier <filename>win32build</filename> dans votre dossier de travail (ici <filename>c:\work</filename>) et décompressez <filename>win32build.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> Créez le dossier <filename>bindlib_w32</filename> sous votre dossier de travail (ici <filename>c:\work</filename>) et décompressez <filename>bindlib_w32.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> Décompressez le code source de &php; dans votre dossier de travail (<filename>c:\work</filename>). </simpara> </listitem> </itemizedlist> Après avoir suivi ces instructions, vous devriez obtenir un dossier qui ressemble à ceci : <informalexample> <programlisting> <![CDATA[ +--c:\work | | | +--bindlib_w32 | | | | | +--arpa | | | | | +--conf | | | | | +--... | | | +--php-4.x.x | | | | | +--build | | | | | +--... | | | | | +--win32 | | | | | +--... | | | +--win32build | | | | | +--bin | | | | | +--include | | | | | +--lib ]]> </programlisting> </informalexample> Cré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ère étable. Un environnement Cygwin correctement installé 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 => Options". Dans le dialogue, sélectionnez l'onglet "directories". Modifiez les valeurs pour les items du menu Executables, Includes et Library files. Votre configuration doit alors ressembler à <itemizedlist> <listitem> <simpara> Fichiers éxé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é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électionnez le menu "File => Open Workspace" et "bindlib". Puis sélectionnez "Build=>Set Active Configuration" et sélectionnez la configuration voulue. Enfin, sélectionnez "Build=>Rebuild All". </simpara> </listitem> <listitem> <simpara> Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistré les variables d'environnement C++, ou que vous avez exécuté <command>vcvars.bat</command>. Exé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çant le fichier du même nom. </para> </sect3> <sect3 id="install.windows.build.compile"> <title>Compilation</title> <simpara> La meilleure façon de compiler est de commander par la version CGI/exécutable. </simpara> <itemizedlist> <listitem> <simpara> Pour les utilisateurs GUI, lancez VC++, puis sélectionnez le menu "File => Open Workspace" et sélectionnez "php4ts". Ensuite, sélectionnez le menu "Build=>Set Active Configuration", et sélectionnez la configuration voulue. Finalement, sélectionnez le menu "Build=>Rebuild All". </simpara></listitem> <listitem> <simpara> Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistré les variables d'environnement C++, ou que vous avez exécuté <command>vcvars.bat</command>. Exé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é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ères mineures en éditant le fichier <filename>main/config.win32.h.in</filename>. </simpara> <simpara> Ensuite, vous pouvez compiler la version CLI qui est conçue pour un usage en <link linkend="features.commandline">ligne de commande</link>. Les étapes sont les mêmes que pour la compilation en mode CGI, hormis le fait que vous devez sélectionner <literal>php4ts_cli - Win32 Debug_TS</literal> ou <literal>php4ts_cli - Win32 Release_TS</literal> dans le fichier de proejt. Après une compilation réussie, vous pouvez exé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égrer dans Microsoft IIS, vous devez utiliser la configuration <filename>php4isapi-whatever-config</filename> et compiler la DLL nécessaire. </simpara> </sect3> </sect2> <sect2 id="install.windows.extensions"> <title>Installation des extensions sous Windows</title> <para> Après avoir installé PHP et votre serveur web sous Windows, vous voudrez sûrement ajouter quelques extensions bien pratiques. La table suivante liste une partie des extensions disponibles. Comme indiqué dans le manuel, vous pouvez choisir quelles extensions vous voulez charger en dé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éfixés par 'php_' en PHP 4, et 'php3_' en PHP 3. Cela évite la confusion des extensions PHP et de leurs librairies. </para> <note> <para> En PHP 4.0.6 le support des extensions BCMath, Calendar, COM, FTP, MySQL, ODBC, PCRE, Session, WDDX et XML est activé <emphasis>par défaut</emphasis>. Vous n'avez pas à charger d'extensions particulière pour utiliser ces fonctions. Lisez le fichier <filename>README.txt</filename> inclus dans la distribution, ou bien <filename>install.txt</filename> pour connaitre la liste des modules automatiquement activés. </para> </note> <note> <para> Certaines de ces extensions requièrent des librairies DLL supplémentaires pour fonctionner correctement. Certaines d'entre elles sont disponibles dans la distribution. dans le dossier <filename>dlls</filename> mais 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éjà d'installées sur votre système, ne les écrasez que si PHP ne fonctionne pas correctement (et de toutes manières, faites une sauvegarde de ces DLL, en cas de problème). </para> </note> <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ètes. Utilisez DBA à 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ê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è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è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éné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écifiques à Xitami. </para> <sect2 id="install.xitami.windows"> <title>Xitami pour Windows</title> <simpara> Cette liste décrit comment installer PHP comme CGI exé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éné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écutable PHP (souvent <filename>c:\php\php.exe</filename>). </para> </listitem> <listitem> <para> Cliquez sur le bouton "Save". </para> </listitem> <listitem> <para> Redé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éférence des API communes de flôts</title> <refentry id="streams.php-stream-stat-path"> <refnamediv> <refname>php_stream_stat_path</refname> <refpurpose>Lit l'é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> éxamine le fichier ou l'URL spécifié par <parameter>path</parameter> et retourne des informations telles que la taille, les droits d'accès, la date de création, etc... La valeur retournée est 0 en cas de succès, et -1 en cas d'é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é au flô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ème de stocker du flôt <parameter>stream</parameter>, et retourne des informations telles que la taille de fichier, les droits d'accès, la date de création, etc... La valeur retournée est 0 en cas de succès, et -1 en cas d'échec. Pour plus d'informations sur les informations retourné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ô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éré, spécifiée par <parameter>path</parameter>. Suivant la valeur de <parameter>mode</parameter>, le flôt peut être ouvert en lecture, écriture, ajout ou une combinaison des trois. Voyez la table ci-dessous pour connaîtres les modes utilisées. De plus vous pouvez aussi intégrer le caractère 'b' comme deuxième ou dernière option. Sa présence indiquera que le flôt fonctionnera en mode binaire. </para> <para> L'option 'b' est ignorée sur les systèmes POSIX, qui traitent les fichiers textes et binaires de la même façon. C'est une bonne idée que de spécifier 'b' à chaque fois que votre flôt accède à des données binaires, pour que votre code fonctionne lorsqu'il est compilé sur un système où 'b' serait important. </para> <para> Tous les fichiers locaux créés par l'API des flôts recevront les droits par défaut du système : sous Unix, cela signifie que le masque utilisateur du processus sera utilisé. Sous Windows, le fichier sera donné au propriétaire du processus. Tous les fichiers distants seront créé suivant le protocole utilisé, et les droits utilisé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ôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>r+</constant> </term> <listitem> <simpara> Ouvre le fichier texte en lecture et écriture. Le pointeur du flôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>w</constant> </term> <listitem> <simpara> Tronque le fichier à une taille de 0 ou bien crée le fichier, puis l'ouvre en mode écriture. Le pointeur du flôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>w+</constant> </term> <listitem> <simpara> Tronque le fichier à une taille de 0 ou bien crée le fichier, puis l'ouvre en mode écriture et lecture. Le pointeur du flôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>a</constant> </term> <listitem> <simpara> Ouvre le fichier en mode d'écriture. Le fichier est créé si il n'existe pas. Le pointeur de flôt est positionné à la fin du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>a+</constant> </term> <listitem> <simpara> Ouvre le fichier en mode d'écriture et lecture. Le fichier est créé si il n'existe pas. Le pointeur de flôt est positionné à la fin du fichier. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> <parameter>options</parameter> affecte l'interprétation du path ou de l'URL, les vérifications du safe_mode et les actions à prendre lorsqu'il y a une erreur. Voyez <link linkend="streams.options">Stream open options</link> pour plus de détails sur ces options. </para> <para> Si <parameter>opened</parameter> est non NULL, il sera assigné avec le nom du fichier ou de la ressource qui aura été ré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, êtes responsable de l'appel de <function>efree</function> sur le nom de fichier retourné par ce paramètre. </para> <note> <simpara> Si vous avez spécifié l'option <constant>STREAM_MUST_SEEK</constant> dans <parameter>options</parameter>, le chemin retourné dans <parameter>opened</parameter> peut ne pas être le même que celui qui vous a été réellemetn retourné. Toutes fois, ce sera le nom de la ressource originale à partir de laquelle un flôt à pointeur variable a été créé. </simpara> </note> </refsect1> </refentry> <refentry id="streams.php-stream-read"> <refnamediv> <refname>php_stream_read</refname> <refpurpose>Lit des octets depuis un flô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'à <parameter>count</parameter> octets dans le flô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 é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ôt est avancé d'autant d'octets que le nombre qui en a été lu. Par conséquent, la prochaine lecture reprendra là ou la lecture précédente s'est arrêtée. </para> <para> Si moins de <parameter>count</parameter> octets ont été lus, cet appel bloquera l'application jusqu'à ce que le nombre d'octets nécessaire soit atteint, en fonction de la configuration du flôt (bloquant, non bloquant). Par défaut, un flôt est ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant ne vous gènera pas. Lors que le flôt atteint <constant>EOF</constant> <function>php_stream_read</function> retournera un nombre d'octets lus inférieur à <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ô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> é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 été écrit. Si il y a eu une erreur, le nombre d'octets écrit sera inférieur au paramètre <parameter>count</parameter>. </para> <para> Le pointeur de position dans le flôt est avancé d'autant d'octets que le nombre qui en a été écrit. Par conséquent, la prochaine écriture reprendra là ou la lecture précédente s'est arrété. </para> </refsect1> </refentry> <refentry id="streams.php-stream-eof"> <refnamediv> <refname>php_stream_eof</refname> <refpurpose>Vérifie que le pointeur n'est pas au bout du flô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érifie que le pointeur n'est pas au bout du flôt <parameter>stream</parameter>. </para> <para> <function>php_stream_read</function> retourne 1 pour indiquer la fin du flôt (<constant>EOF</constant>), 0 si il n'y a pas de fin de flô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ô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ôt <parameter>stream</parameter> puis le retourne de type unsigned char transtypé en int, ou <constant>EOF</constant> si la fin du flôt est atteinte, ou bien si une erreur est survenue. </para> <para> <function>php_stream_getc</function> peut bloquer l'application de la même façon que <function>php_stream_read</function> bloque. </para> <para> Le pointeur de position est avancé d'une position si la lecture réussit. </para> </refsect1> </refentry> <refentry id="streams.php-stream-gets"> <refnamediv> <refname>php_stream_gets</refname> <refpurpose>Lit une ligne de données d'un flô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'à <parameter>count</parameter>-1 octets de données dans le flôt <parameter>stream</parameter> puis les copies dans le buffer <parameter>buf</parameter>. La lecture s'arrête après la rencontre de la fin du fichier (<constant>EOF</constant>) ou une nouvelle ligne. Si la nouvelle ligne est lue, elle est stockée dans <parameter>buf</parameter> dans les données retournées. Un caractère NUL de fin de chaîne est stocké comme dernier caractè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é d'une position si la lecture réussit. </para> <para> <function>php_stream_gets</function> peut bloquer l'application de la même faç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ô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ôt <parameter>stream</parameter> et libère les ressources qui lui sont associées. Apràs la fermeture de <parameter>stream</parameter>, il prend une valeur indéfinie, et ne devrait plus être utilisé. </para> <para> <function>php_stream_close</function> retourne 0 si le flôt a été fermé, ou bien <constant>EOF</constant> pour indiquer une erreur. Indépendamment du succès de l'opération, <parameter>stream</parameter> prend une valeur indéfinie, et ne devrait plus être utilisé. </para> </refsect1> </refentry> <refentry id="streams.php-stream-flush"> <refnamediv> <refname>php_stream_flush</refname> <refpurpose>Vide les buffers dans le flô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ées contenues dans les buffers d'écriture du flôt <parameter>stream</parameter> et force leur stockage. </para> <para> <function>php_stream_flush</function> retourne 0 si les buffers ont été vidés, ou si les buffers n'ont pas besoin d'être vidé, 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ô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ôt <parameter>stream</parameter>. La nouvelle position est déterminée en ajoutant <parameter>offset</parameter> à la position indiqué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ébut du flôt, à la position courante ou à la fin du flôt, respectivement. </para> <para> <function>php_stream_seek</function> retourne 0 en cas de succès, et -1 en cas d'erreur. </para> <note> <para> Tous les flôts ne supportent pas la modification de la position du pointeur, même si l'API va é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'émulation est uniquement appliquée si l'implémentation du gestionnaire de flôt suporte le pointeur de position. Si le flôt est (par exemple) basé sur des fichiers qui travaille avec des flôt de pipes, l'API de flôt ne pourra pas appliquer une telle émulation. Le positionnement du pointeur de flôt échouera et une erreur sera retournée. </para> </note> </refsect1> </refentry> <refentry id="streams.php-stream-tell"> <refnamediv> <refname>php_stream_tell</refname> <refpurpose>Détermine la position du pointeur dans un flô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ôt <parameter>stream</parameter>, relativement au début du flô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ées d'un flôt à 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ôt <parameter>src</parameter> puis de les écrire dans le flôt <parameter>dest</parameter>. La fonction retourne le nombre d'octets copiés. </para> <para> Si vous souhaitez copier tous les octets restants dans le flô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ère la plus efficace, en utilise dans buffer mé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ées depuis un flô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ô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ère la plus efficace, en utilise dans buffer mé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ôt en flô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érifie si <parameter>origstream</parameter> dispose d'un pointeur de potision. Si ce n'est pas le cas, il va copier les données du flôt dans un autre flôt temporaire, et disposant d'un pointeur de position. Si cela fonctionne, <parameter>newstream</parameter> sera un flôt valide même si le flôt original avait déjà un pointeur de position. </para> <para> <parameter>flags</parameter> vous permet de spécifier votre préférence pour le flôt retourné : utilisez la constante <constant>PHP_STREAM_NO_PREFERENCE</constant> pour utiliser le flôt à pointeur de position par défaut (qui utilise la mé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é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ôt original avait déjà son pointeur de position. <parameter>newstream</parameter> vaut <parameter>origstream</parameter>. </entry> </row> <row> <entry>PHP_STREAM_RELEASED</entry> <entry>Le flôt originl n'avait pas pointeur de position, et il a été détruit. Vous n'avez plus accès à <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 état indéterminé. <parameter>newstream</parameter> vaut NULL et il est très recommandé que vous vous fermiez <parameter>origstream</parameter>. </entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Si vous devez déplacer le pointeur et écrire dans le flôt, n'utilisez pas cette fonction, car le flôt retourné est un flôt mis en cache. Il n'est pas garantit qu'il soit lié à la ressource originale. </simpara> </note> <note> <simpara> Si vous avez uniquement de déplacer le pointeur de position vers l'avant, il n'y a pas besoin d'appeler cette fonction, car l'API va automatiquement émuler ce fonctionnement avec le paramètre whence à la valeur <constant>SEEK_CUR</constant>. </simpara> </note> <note> <simpara> Si <parameter>origstream</parameter> repose sur le réseau, cette fonction va se bloquer jusqu'à ce que tout le contenu soit téléchargé. </simpara> </note> <note> <simpara> NE JAMAIS appeler cette fonction avec un flôt <parameter>origstream</parameter> qui est une référence à un pointeur de fichier dans un script PHP. Cette fonction pourrait alors fermer le fichier, ce qui conduira à un crash au prochain accès au pointeur. </simpara> </note> <note> <simpara> Dans de nombreux cas, cette fontion ne peut réussir que si <parameter>origstream</parameter> vient d'être tout juste ouvert, et qu'aucune données n'ont été mises dans les caches de la couche de flôt. Pour cette raison, et parceque cette fonction est compliquée à utiliser correctement, il est recommandé 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ô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ôt <parameter>stream</parameter> en un autre ressource indiqué par <parameter>castas</parameter>. Si <parameter>ret</parameter> est NULL, le flôt est interrogé pour savoir une telle conversoin est posible, sans effectuer réellemnt la conversion (mais certains état interne pourrait être changés dans ce cas). Si <parameter>flags</parameter> vaut <constant>REPORT_ERRORS</constant>, un message d'erreur apparaîtra si une erreur survient durant la conversion. </para> <note> <para> Cette fonction retourne <constant>SUCCESS</constant> en cas de réussite et <constant>FAILURE</constant> en cas d'échec. Soyez prévenu que vous devez faire une comparaison explicite avec <constant>SUCCESS</constant> ou <constant>FAILURE</constant> à cause des valeurs sous jacentes de ces constantes. Une simple comparaison d'expression booléenne ne sera pas interprété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ésente le flôt</entry> </row> <row> <entry>PHP_STREAM_AS_FD</entry> <entry>Un pointeur de fichier de type POSIX qui représente le flôt</entry> </row> <row> <entry>PHP_STREAM_AS_SOCKETD</entry> <entry>Un pointeur de socket réseau qui représente le flôt</entry> </row> </tbody> </tgroup> </table> </para> <para> En plus des types de ressources basiques ci-dessus, le processus de conversion peut être modifié en utilisant les paramètres ci-dessous, ou bien en utilisant l'opé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ême si c'est au prix de quelques ressources supplémentaires, que la conversion réussisse</entry> </row> <row> <entry>PHP_STREAM_CAST_RELEASE</entry> <entry>Informque l'API de flô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ôt <parameter>stream</parameter> sera fermé de telle façon à ce que le gestionnaire soit préservé et retourné dans le paramètre <parameter>ret</parameter>. Si la fonction réussit, le paramètre <parameter>stream</parameter> doit être considéré comme fermé, et inutilisable en l'état. </entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Si votre système supporte la fonction <function>fopencookie</function> (les systèmes utilisant la librairie glibc 2 ou plus récent), l'API de flôt sera toujours capable de créer des pointeurs de fichiers de type ANSI FILE* pour tous les flôts. Même si c'est extrêmement utile pour passer des flôts PHP à des librairie tierce partie, un tel système n'est pas portable. Il est demandé que vous considériez la portabilité e vos fonctions avant de diffuser votre extension. Si l'utilisation de fopencookie() n'est pas désirable, il est recommandé d'interroger le flô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éseau à la place d'un FILE*, l'API de flôts va utiliser la fonction <function>fdopen</function> pour la créer pour vous. Soyez prévenu que faire cela risque de perdre les données qui ont été mises en buffer dans le flôt, si vous mélanger des appels de l'API de flô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étermine si un flôt peut ê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'équivalent de la fonction <function>php_stream_cast</function> avec le paramètre <parameter>ret</parameter> mis à NULL, et le paramètre <parameter>flags</parameter> mis à 0. Elle retourne <constant>SUCCESS</constant> si le flôt peut être converti dans la forme demandé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 état interne du flôt soient modifiés. </simpara> </note> <note> <simpara> Vous devez explicitement comparer la valeur de retour avec une des constantes, comme dé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étermine si un flôt est un flô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ôt <parameter>stream</parameter> est un flôt persistant, et 0 sinon. </para> </refsect1> </refentry> <refentry id="streams.php-stream-is"> <refnamediv> <refname>php_stream_is</refname> <refpurpose>Détermine si un flô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écifié 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ôt est implémenté en utilisant l'implémentation standard</entry> </row> <row> <entry>PHP_STREAM_IS_SOCKET</entry> <entry>Le flôt est implémenté en utilisant l'implémentation des sockets réseau</entry> </row> <row> <entry>PHP_STREAM_IS_USERSPACE</entry> <entry>Le flôt est implémenté en utilisant l'implémentation de l'objet utilisateur</entry> </row> <row> <entry>PHP_STREAM_IS_MEMORY</entry> <entry>Le flôt est implémenté en utilisant l'implémentation mémoire à taille automatique</entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Les constantes PHP_STREAM_IS_XXX sont en fait définies comme des pointeurs sur la structure des opérations de base. Si vous extension (ou une autre extension définit des flôts additionnels), il faut qu'elle déclare aussi les constantes PHP_STREAM_IS_XXX dans ses entêtes, pour que vous puissiez les utiliser comme base de comparaison. </simpara> </note> <note> <simpara> Cette fonction est implémentée comme une comparaison de pointeurs simple (et rapide), et ne modifie pas l'état du flô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ées restantes d'un flô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ôt <parameter>stream</parameter> vers le buffer de sortie. Les données sont é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émoire pour accélérer l'exé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ô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é, 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ésenregistre un gestionnaire pour l'API de flô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ésenregistre le gestionnaire associé 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ôt avec un fichier ou une URL, en spé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écifier un objet de type php_stream_context avec le paramè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ô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 à la fonction <function>php_stream_open_wrapper</function>, mais convertit le flôt en un pointeur ANSI FILE* puis le retourne à la place du flô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ôts</title> <refentry id="streams.options"> <refnamediv> <refname>Options d'ouverture de flôt</refname> <refpurpose>Affectent les fonctions de flôt</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> Plusieurs valeurs peuvent êter combinées avec l'opérateur OR. <variablelist> <varlistentry> <term> <constant>IGNORE_PATH</constant> </term> <listitem> <simpara> C'est l'option par défaut pour les flôts. Elle indique que l'include_path ne sera pas fouillé pour trouver le fichier demandé. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>USE_PATH</constant> </term> <listitem> <simpara> Requiert que l'include_path soit fouillé à la recherche du fichier demandé. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IGNORE_URL</constant> </term> <listitem> <simpara> Requiert que les gestionnaires d'URL soient ignorés pour traiter ce flôt. Les gestionnaires qui ne traitent pas d'URL seront utilisé lors du décodate du chemin. Il n'y a pas de contraire à cette option : l'API des flôts utilisera tous les gestionnaires par défaut. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IGNORE_URL_WIN</constant> </term> <listitem> <simpara> Sous Windows, c'est l'équivalent de IGNORE_URL. Sur tous les autres systè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ôt effectue les vérifications liées au safe_mode sur le fichier à ouvrir avant e le faire. En omettant cette option, le safe_mode sera ignoré 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é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écurité). Lorsque les API des flôts génèrent une erreur, elles commencent par supprimer les informations de login et mot de passe, afin que l'affichage des donné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éellement être capable déplacer le pointeur de fichier dans le flôt. Certains flots ne disposent pas d'un tel pointeur. Cette option s'assure que le flôt va supporter ce opinteur. Si il ne le fait pas, le flôt sera copié dans un fichier temporaire (qui peut être un fichier ou un bloc de mémoire), qui supportera le pointeur. Notez bien que cette option est inutile lorsque vous voulez déplacer le pointeur de fichier et y écrire, car le flôt que vous allez utiliser n'est peut être pas votre ressource initiale, mais un fichier en cache. </simpara> <note> <simpara> Si la ressource demandée est sur le réseau, cette option va bloquer la fonction d'ouverture jusqu'à ce que le contenu complet du fichier soit téléchargé. </simpara> </note> </listitem> </varlistentry> <varlistentry> <term> <constant>STREAM_WILL_CAST</constant> </term> <listitem> <simpara> Si votre extension utilise une librairie tierce qui s'attend à recevoir un pointeur FILE* ou un pointeur de fichier, vous pouvez utiliser cette option pour demander à l'API d'ouvrir la ressource, mas d'é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 à la librairie. </simpara> <simpara> Ceci est particulièrement pratique lorsque vous accédez à des URL via HTTP, qui vont diffuser des données, mais dont le corps ne sera accessible qu'après une quantité indéterminée d'entê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éhensible, car vous avec indiqué aux flôts que vous alliez utiliser les fonctions de bases de l'implé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ôt qui peut être utilisé pour lister les fichiers qui sont contenu dans le dossier spécifié par <parameter>path</parameter>. Cette fonction est l'équivalent de <function>opendir</function> sous POSIX. Bien que cette fonction retourne un objet php_stream, il n'est pas recommandé d'essayer d'utiliser les fonctions de fichiers sur ce flô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ètre <parameter>ent</parameter>. Si la fonction réussit, la valeur retournée est <parameter>ent</parameter>. Si la fonction échoue, la valeur retournée est NULL. </para> </refsect1> </refentry> <refentry id="streams.php-stream-rewinddir"> <refnamediv> <refname>php_stream_rewinddir</refname> <refpurpose>Replace le flôt de dossier au dé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ébut du flôt. Retourne 0 en cas de succes, et -1 en cas d'échec. </para> </refsect1> </refentry> <refentry id="streams.php-stream-closedir"> <refnamediv> <refname>php_stream_closedir</refname> <refpurpose>Ferme un flôt de dossier, et libè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ôt le dossier <parameter>dirstream</parameter>, et libère les ressources. Retourne 0 en cas de succes, et -1 en cas d'é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ô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ô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ôt basé sur le fichier <parameter>file</parameter>. <parameter>mode</parameter> doit être le même mode que celui utilsé pour ouvrir <parameter>file</parameter>, sinon d'étranges erreurs surviendront lors de l'écriture lorsque le mode du flôt sera diffé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ô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ôt basé sur un ficheir temporaire, ouvert en mode "w+b". Le fichier temporaire sera supprimé automatiquement lorsque le flôt sera fermé ou que le procesus sera terminé. </para> </refsect1> </refentry> <refentry id="streams.php-stream-fopen-temporary-file"> <refnamediv> <refname>php_stream_fopen_temporary_file</refname> <refpurpose>Génère un fichier temporaire et ouvre un flô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énère un fichier temporaire dans le dossier <parameter>dir</parameter> avec le préfixe <parameter>pfx</parameter>. Le nom du fichier ainsi généré est retourné dans la variable <parameter>opened</parameter>, dont vous êtes responsable de l'effacemetn avec <function>efree</function>. Un flôt est ouvert sur ce fichier généré, en mode "w+b". Le fichier N'EST PAS automatiquement effacé. Vous ê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ô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ôt basé sur la socket <parameter>socket</parameter>. <parameter>persistent</parameter> est une option qui contrôle si le flôt doit être ouvert comme un flôt persistant. Généralement, ce paramè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ô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> établit une connexion à l'hôte <parameter>host</parameter> et sur le port <parameter>port</parameter>. <parameter>socktype</parameter> spécifie les options de sockets qui devront être appliquées. <parameter>socktype</parameter> est dépendant du système, mais incluera notamment <constant>SOCK_STREAM</constant> pour les connexions full-duplex, séquentielle et fiables et <constant>SOCK_DGRAM</constant> pour les connexions non fiables, sans connexion, avec une taille maximale fixée (UDP). </para> <para> <parameter>persistent</parameter> est une option qui contrôle si le flôt doit être ouvert comme un flôt persistant. Généralement, ce paramètre vaudra 0. </para> <para> Si non-NULL, <parameter>timeout</parameter> spécifie la durée maximale de connexion. SI la connexion prend plus de temps que cette valeur, la tentative de connexion sera abandonnée et NULL sera retourné pour indiquer que le flôt n'a pu être ouvert. </para> <note> <simpara> Le paramètre <parameter>timeout</parameter> n'inclut pas le temps de résolution DNS. La raison à cela est qu'il n'y a pas de méthode portable pour effectuer des résolutions DNS. </simpara> <simpara> La durée d'expiration s'applique à la phase de connexion; si vous avez besoin de durées d'expiration pour les opérations de lecture et d'écritures, il faudra utiliser la fonction <function>php_stream_sock_set_timeout</function> pour configurer la durée d'expiration de votre flô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é de considérer les problèmes de portabilité 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ô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écifiée par <parameter>path</parameter>. <parameter>pathlen</parameter> spécifie la taille de <parameter>path</parameter>. Si non-NULL, <parameter>timeout</parameter> spécifie la durée maximale de connexion. SI la connexion prend plus de temps que cette valeur, la tentative de connexion sera abandonnée et NULL sera retourné pour indiquer que le flôt n'a pu être ouvert. <parameter>persistent</parameter> est une option qui contrôle si le flôt doit être ouvert comme un flôt persistant. Généralement, ce paramètre vaudra 0. </para> <note> <simpara> Cette fonction n'est pas utilisable sous Windows, qui n'implémente pas les sockets de domaines. Une exception possible à cette règle sont les exécutables PHP compilé avec cygwin. Vous êtes encouragés à considérer cet aspect de la portabilité de votre extension avant sa publication. </simpara> </note> <note> <simpara> Cette fonction traite <parameter>path</parameter> en tenant compte des données binaires, ce qui est bon pour les systèmes qui utilisent un espace de nom abstrait (comme par exemple Linux), où le premier caractère est le caractè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éfinie par le systè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é. </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émentation de flôt</refpurpose> </refnamediv> <refsect1> <title>Description</title> <programlisting role="c"> typedef struct _php_stream_ops { /* Tous les flôts DOIVENT implémenter ces opé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érations sont optionnelles, et peuvent prendre la valeur de NULL si le flôt ne supporte pas cette opé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ôts les auteurs d'extensions</title> <sect1 id="streams.overview"> <title>Présentation</title> <para> Les flôts de PHP proposent une approche unifiée à la gestion des fichiers et sockets, depuis une extension PHP. En utilisant l'API standard, les flôts vous permettent d'accéder à des fichiers, des sockets, des URL, de la mémoire ou encore des objets définis dans des scripts. Les flôts (streams en anglais), sont une API flexible et dynamique, dynamiquement chargée dans les modules (et les scripts!). </para> <para> Le but des flôts est de proposer une API confortables pour les programmeurs, lors des manipulations de fichiers, URL et autres sources de données linéaires. L'API unifiée est très simple à comprendre : elle est plus ou moins basée sur la famille de fonction classiques C d'entrée/sortie (avec les mêmes concepts pour la plus part des fonctions) : les programmeurs C ne seront pas dépaysés. </para> <para> L'API des flôts intervient à différents niveaux : à la base, elle définit un objet php_stream, qui représente les sources de données. A un niveau au dessus, l'API défini un objet php_stream_wrapper qui s'interface avec l'API de bas niveau, pour lire et écrire les données et méta données, dans les sources. </para> <para> Les flôts peuvent être converti en pilotes pour fichiers, de manière à être utilisé par des librairies tierce-partie avec beaucoup de facilité. Cela autorise ces librairies à accéder aux données directement depuis des sources représentées par des URL. Si votre système supporte la fonction <function>fopencookie</function>, vous pouvez même passer n'importe quel flôt PHP à une autre librairie qui utilise les entrée/sortie standard ANSI! </para> </sect1> <sect1 id="streams.basics"> <title>Eléments de bases</title> <para> Utiliser les flôts ressemble énormément à l'utilisation des fonctions d'entrée/sortie standard ANSI streams. La principale différence est que vous devez créer le pointeur de flô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 à fopen(), comme le montre l'exemple ci-dessous : </para> <para> <example> <title>Exemple de flô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ôts équivalentes aux fonctions ANSI. Sauf indication contraire, les fonctionnalités sont les mêmes. <table> <title>ANSI stdio equivalent functions in the Streams API</title> <tgroup cols="3"> <thead> <row> <entry>Fonction ANSI</entry> <entry>Fonction Flôt PHP</entry> <entry>Notes</entry> </row> </thead> <tbody> <row> <entry>fopen</entry> <entry>php_stream_open_wrapper</entry> <entry>Les flôts incluent des paramètres supplé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ètre nmemb est suppos avoir la valeur 1 : le prototype ressemble plutôt à read(2)</entry> </row> <row> <entry>fwrite</entry> <entry>php_stream_write</entry> <entry>Le paramètre nmemb est suppos avoir la valeur 1 : le prototype ressemble plutôt à 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 à puts, et non pas à fputs</entry> </row> <row> <entry>fstat</entry> <entry>php_stream_stat</entry> <entry>Les informations des flôts sont plus riches</entry> </row> </tbody> </tgroup> </table> </para> </sect1> <sect1 id="streams.resources"> <title>Les flôts qui sont des ressources</title> <para> Tous les flôts sont enregitrés comme des ressources lorsqu'il sont créés. Cela garantit qu'ils seront convenablement déblayés de la mémoire, même en cas d'erreur fatale. Toutes les fonctions du sytème de fichier de &php; opère sur des ressources : cela signifie que vos extensions peuvent accepter des pointeurs de fichiers comme paramètre, et retourner des flôts. L'API des flôts rend ce processus très convivial. </para> <para> <example> <title>Comment accepter un flôt comme paramètre d'entré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ôt. Cependant, vous ne "possédez" pas le flôt, mais le script le possède. Cela signifie que vous de DEVEZ PAS fermer le flôt, car sinon, PHP va crasher! */ php_stream_write(stream, "hello\n"); RETURN_TRUE(); } ]]> </programlisting> </example> </para> <para> <example> <title>Comment retourner un flô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ôt appartient au script. Si vous le fermer ici, vous allez faire crasher PHP! */ } ]]> </programlisting> </example> </para> <para> Comme les flôts sont automatiquement déblayés de la mémoire, il est tentant de penser que vous pouvez être des programmeurs paresseux et ne pas vous préoccuper de la fermeture du flôt lorsque vous en avez terminé avec lui. Même si une telle approche fonctionnera probablement, ce n'est pas une bonne idée pour un bon nombre de raisons : les flôts conservent des verrous sur les ressources systèmes durant un temps plus long, ce qui fait que laisser le verrous empêche d'autres processus d'accéder à cette ressource. Si le script gère un grand nombre de fichier, l'accumulation de ressources, en terme de mémoire et de nombre de fichiers ouverts, causer l'échec des requêtes du serveur web. Cela n'est plus aussi séduisant, n'est-ce pas? L'API de flôt inclut un peu de magie pour que vous puissiez garder votre code propre : si un flôt n'est pas fermé par votre code alors qu'il devrait l'être, vous trouverez des informations de débogage dans le fichier d'historique d'erreur de votre serveur web. </para> <note> <simpara> Utilisez toujours une version de débogagge de &php; lorsque vous développez (<option>--enable-debug</option> lors de la configuration de la compilation) car de nombreux efforts ont été fait pour vous aider à traquer les fuites de mémoire. </simpara> </note> <para> Dans certains cas, il est pratique de garder un flôt ouvert pour toute la durée de la requête, afin de l'utiliser comme fichier d'historique. Ecrire le code né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écessaire. Pour vous éviter l'écriture de ce code, vous pouvez marquer le flôt pour qu'il soit automatiquement libéré lorsque viendra le temps de libé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 -->
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 à 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 é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é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ème d'exploitation, y compris + Linux et Windows. Sous Linux, vous pouvez aussi trouver + des commandes comme <ulink url="&url.rpmfind;">rpmfind</ulink>, + très pratique pour rechercher les paquets pré compilés. + </para> </sect1> <sect1 id="tutorial.firstpage"> @@ -98,7 +114,8 @@ <ulink url="&url.php.downloads;">téléchargements</ulink>. Vous pouvez développer en PHP, localement, sur tous les systèmes d'exploitation. N'oubliez pas d'installer aussi un serveur - web approprié. + web approprié. Si le problème persiste, n'hésitez pas à + utiliser l'une des options de <ulink url="&url.php.support;">support</ulink>. </para> <para> Le point important de cet exemple é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é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étails pour l'installation de PHP sous Apache sous Unix.</title> <simpara> Il y a deux mé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êter le serveur Apache, et éditer le fichier <filename>srm.conf</filename> ou <filename>httpd.conf</filename>, pour configurer Apache avec PHP. </simpara> <para> Vous pouvez sélectionner des options à ajouter au fichier <command>configure</command> à la ligne 8 depuis la <link linkend="install.configure">liste complè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 étape, vous pouvez aussi copier le binaire httpd et remplacer votre exécutable actuel. Assurez-vous tout de même que le serveur est bien é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 éditer votre fichier php.ini pour modifier certaines options PHP. Si vous préférez placer ce fichier ailleurs, utilisez --with-config-file-path=/path lors de l'é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édure habituelle pour démarrer votre serveur Apache. (vous devez l'éteindre et le redémarrer, pas seulement lui envoyer un signal HUP ou USR1.) </programlisting> </example> <para> Suivant votre installation d'Apache et votre variante d'Unix, il existe de nombreuses façons d'arrêter et redémarrer Apache. Voici une liste des commandes typiques, pour différentes installations. Remplacez <literal>/path/to/</literal> par le chemin d'accès à vos applications sur votre système. <example> <title>Redé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 à 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écutables apachectl et http(s)dctl peuvent être situés dans différents dossiers. Si votre système a <literal>locate</literal> ou <literal>whereis</literal> ou <literal>which</literal>, utilisez-les pour retrouver vos programmes. </para> <para> Diffé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éer une librairie partagée <filename>libphp4.so</filename> qui sera chargée par Apache avec une ligne LoadModule dans le fichier <filename>httpd.conf</filename>. Le support PostgreSQL est aussi inclut dans <filename>libphp4.so</filename>. </para> <para> <example> <title>Compilation sur Apache avec l'extension PostGreSQL (librairie partagée)</title> <programlisting> <![CDATA[ /configure --with-apxs --with-pgsql=shared ]]> </programlisting> </example> </para> <para> Cette commande va créer une librairie partagée <filename>libphp4.so</filename> pour Apache, mais va aussi créer la librairie partagée <filename>pgsql.so</filename> qui sera chargé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éer une autre librairie partagé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ème de compilation d'Apache va cré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écutable <filename>httpd</filename>, ce qui fait que le ré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ée)</title> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql=shared ]]> </programlisting> </example> </para> <para> Identique à la version précédente, mais au lieu d'inclure le support PostgreSQL directement dans l'exécutable final <filename>httpd</filename>, vous allez obtenir une librairie partagée <filename>pgsql.so</filename> que vous pouvez charger dans PHP soit grâce au fichier de configuration &php.ini; ou dynamiquement avec <function>dl</function>. </para> <para> Lorsque vous faites le choix entre les différents modes de compilation de PHP, vous devez prendre en compte leurs avantages et inconvénients respectifs. Les objets partagés permettent de compiler PHP et Apache de manière séparée, et vous n'aurez pas à compiler l'ensemble pour faire évoluer PHP. La compilation statique permet de charger et d'éxé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 à 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 ç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écifiez la version installé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éellement installée sur votre systè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éthodes pour faire fonctionner PHP avec Apache 1.3.x sous Windows. La première est d'utiliser l'exécutable CGI (php.exe), l'autre est d'utiliser les modules Apache DLL. Dans les deux cas, vous devez arrêter le serveur Apache, é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érences de configurations de PHP sous Apache, le processus reste simple et à la portée du néophyte. Reportez-vous aux documentations Apache pour plus de détails sur ces directives. </simpara> <para> Si vous avez dézippé le package dans <filename>C:\PHP\</filename> comme indiqué dans <link linkend="install.windows.manual">Instructions Générales d'installation</link>, vous devez insé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é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 à plusieurs attaques potentielles. Lisez donc la section <link linkend="security.cgi-bin">sécurité des CGI</link> pour savoir comment vous en défendre. </para> </warning> <para> Si vous voulez utiliser PHP comme module Apache, vous devez dé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 é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ès avoir modifié le fichier de configuration, pensez à redé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éthodes pour utiliser la fonctionnalité de coloration syntaxique, elles dépendent de votre installation. Si vous avez configuré 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écutable CGI, vous aurez besoin de la fonction <function>show_source</function>. Pour cela, créez simplement un script PHP et ajoutez-y le code suivant : <literal><?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 être convertis en slash c'est à 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ès recommandé 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é de PHP avec Apache 2.0</title> <para> Les versions de &php; suivantes sont reconnues pour fonctionner avec la plus récente version d'Apache 2.0 : <itemizedlist spacing="compact"> <listitem> <simpara> PHP 4.3.0 ou plus récent, disponible à <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. </simpara> </listitem> <listitem> <simpara> Les dernières versions de développement. Le code source est disponbile à <ulink url="&url.php.snapshots;php4-latest.tar.gz">&url.php.snapshots;php4-latest.tar.gz</ulink>, et les exécutables compilés de Windows à <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élé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écent. </para> <note> <simpara> Le supoprt des SAPI d'Apache 2.0 a commencé 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é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éléchargez la plus récente version de <ulink url="&url.apache;">Apache 2.0</ulink> et une version appropriée de &php;, tel que décrit ci-dessus. Ce guide rapide couvre les manipulations de base, nécessaire à l'installation de Apache 2.0 et &php;. Pour plus d'informations, lisez la <ulink url="&url.apache2.docs;">Documentation Apache</ulink>. Les numéros de version sont omis ici, poru s'assurer que les instructions ne soient pas incorrectes. Il faudra donc remplacer les séquences 'NN' avec les valeurs correctes que vous utilisez. </para> <example> <title>Instruction d'installation (Module partagé 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é dans /usr/local/apache2, configuré avec le support des modules dynamiques, et le préfork standard MPM. Pour tester l'installation, utilisez votre procédure standard de dé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éférez placez ce fichier à un autre endroit, utilisez l'option --with-config-file-path=/path en étape 10. 14. Edites votre fichier httpd.conf et vérifiez la pré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érons. Le chemin sur la driot de la directive LoadModule doit indiquer le chemin du module PHP de votre système. La directive ci-dessus est correcte si vous avez suivi les autres étapes à la lettre. 15. Utilisez votre procédure standard pour redémarrer Apache : /usr/local/apache2/bin/apachectl start ]]> </screen> </example> <para> Suivez les é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étails, utilisez la commande <command>./configure --help</command> dans le dossier de souces approprié. Si vous souhaitez compiler uen version multi-threadé 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 à la ligne de configuration de l'étape 6, l'option <option role="configure">--with-mpm=worker</option> ou <option role="configure">--with-mpm=perchild</option>. Soyez conscient des conséquences, et comprenez bien ce que vous faites. Pour plus de dé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ée d'Apache, votre système doit supporter les threads. Cela implique aussi de compiler &php; avec le module expérimental de Zend Thread Safety (ZTS). Par conséquent, toutes les extensions ne seront pas disponibles. La configuration recommandé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écifiques à Windows</ulink> pour Apache 2.0. </para> <warning> <para> Apache 2.0 est conç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évu pour fonctionner sur ces plate-formes a ce moment. </para> </warning> <para> Téléchargez la plus récente version de <ulink url="&url.apache;">Apache 2.0</ulink> et une version de PHP appropriée, tel que mentionné au début de ce chapiter. Suivez les instructions <link linkend="install.windows.manual">d'installation manuelle</link> puis revenez ici pour réaliser l'intégration de &php; et Apache. </para> <para> Il ya deux méthodes pour que &php; fonctionne avec Apache 2.0 sous Windows. La première est l'interface CGI, et l'autre est le module DLL APache. Dans les deux cas, commencez par stopper le serveur Apache, et éditez le fichier <filename>httpd.conf</filename> pour configurer Apache avec le support &php;. </para> <para> Vous devez insérer les lignes suivantes dans le fichier <filename>httpd.conf</filename> pour réaliser la configuration en mode <emphasis>CGI</emphasis>: <example> <title>Configurer la version de développement de PHP avec Apache 2.0 en CGI</title> <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écutable CGI a changé, 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 écrasant tout autre fichier qui s'y trouverait. Puis vous devrez insérer les deux lignes suivantes dans votre fichier de configuration d'Apache <filename>httpd.conf</filename> 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éel de &php; dans les exemples ci-dessus. Ne mélangez pas votre installation en module (DLL) avec <emphasis>différentes versions de PHP</emphasis>. Vous avez à utiliser uniquement les DLL et extensions qui sont fournies avec la version de PHP que vous télé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 être compilé comme module Pike pour <ulink url="&url.caudium;">le serveur web Caudium</ulink>. Notez que ce mode n'est pas supporté 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é avant de tenter l'installation PHP 4. Pour que PHP 4 fonctionne correctement, vous devez installer Pike 7.0.268 ou plus récent. Pour cet exemple, nous supposerons que vous avez installé Caudium dans le dossier /opt/caudium/server/. 2. Renommez le dossier en php-x.y.z (où x.y.z est le numéro de version). 3. ./configure --with-caudium=/opt/caudium/server 4. make 5. make install 6. Redémarrez Caudium s'il était en fonctionnement 7. Connectez-vous à 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émarré le serveur. Si vous l'avez fait, vérifiez le fichier /opt/caudium/logs/debug/default.1 : il contient peut-être des erreurs liées à PHP4.so. De même, assurez-vous que caudium/server/lib/[pike-version]/PHP4.so est présent. 10. Configurez le module "PHP Script Support" si nécessaire. </programlisting> </example> <para> Vous pouvez bien sûr compiler votre module Caudium avec les diverses extensions disponibles. Voyez la <link linkend="install.configure">liste complète des options de configuration</link> pour une liste exhaustive. </para> <note> <para> Lorsque vous ajoutez le support MySQL à PHP 4, vous devez-vous assurer que le client MySQL normal est utilisé. Sinon, il peut y avoir des conflits avec Pike, qui dispose déjà du support MySQL. Vous pouvez le faire en spécifiant le dossier d'installation de MySQL grâce à 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écution en ligne de commande</title> <para> Par défaut, PHP est compilé comme une CGI. Si PHP peut être incorporé au serveur web que vous utilisez en tant que module, de manière géné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é à la <link linkend="security">sécurité</link> si vous souhaitez utiliser cette solution. </para> <sect2 id="install.commandline.testing"> <title>Tests</title> <simpara> Si vous avez compilé 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ésultat d'une compilation. Cela vous permet de repérer des problè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é PHP comme programme CGI, vous pouvez évaluer les performances de PHP 3 avec la commande <command>make bench</command>. Notez que si le &safemode; est activé (par défaut), vous ne risquez pas de voir l'évaluation s'arrêter une fois les 30 secondes réglementaires écoulées. En effet, la fonction <function>set_time_limit</function> ne peut pas être utilisée si le &safemode; fonctionne. Utilisez l'option <link linkend="ini.max-execution-time">max_execution_time</link> pour contrôler le temps d'éxé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édéfinies</title> <simpara> Certaines variables d'environnements fournies par les serveurs web ne sont pas disponibles dans les spécifications actuelles <ulink url="&url.cgispec;">CGI/1.1 specification</ulink>. Seules, les variables suivantes sont définies, et les autres doivent être considérées comme spé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é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é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é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é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é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éfaut, c'est $EMPRESSPATH. Depuis PHP4, cette option ne supporte que Empress Version 8.60 et plus ré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éfaut, c'est $EMPRESSPATH. Depuis PHP4, cette option ne supporte que Empress Version 8.60 et plus ré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é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éfaut, c'est /usr/local. Assurez vous que la variable CUSTOM_ODBC_LIBS est définie, et que le fichier odbc.h est dans votre chemin d'inclusion, c'est à dire que vous devriez dé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é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é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é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éfaut, c'est /usr/local. C'est le mê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éfaut, c'est le chemin de la derniè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é. Uniquement utilisable si iODBC, Adabas, Solid, Velocis ou une interface ODBC spéciale st activé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éfaut, &php; essaiera de le trouver de lui-même. [expé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érification de sécurité 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ée, l'exécutable PHP peut être placé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ébogage. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-layout"> <term> <parameter>--with-layout=TYPE</parameter> </term> <listitem> <para> Indique comment les fichiers installés doivent être rangés. Les valeurs possibles sont Type (valeur par dé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é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 à PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-rpath"> <term> <parameter>--disable-rpath</parameter> </term> <listitem> <para> Inactive le passage de chemins supplé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ôts de PHP (expé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=<DIR></parameter> </term> <listitem> <para> Dé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é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égulières du système (obsolè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é par défaut). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> <parameter>--enable-shared[=PKGS]</parameter> </term> <listitem> <para> Compile les librairies partagées. Par dé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é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é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é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é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é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è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écessaires. Voir le fichier INSTALL pour plus de dé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ê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é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âce à 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és de débogage à 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è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ègles de compilation (make) et des dé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éside le fichier &php.ini;. Par dé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é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écutables situés dans le dossier DIR lorsque le safe mode est activ. Par dé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><?</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é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é. FILE est un chemin d'accès optionnel vers les outils apxs d'Apache. Par défaut, c'est apxs. Assurez vous de spécifier la version d'apxs qui est réellement installée sur votre systè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é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é Apache 2.0. FILE est un chemin d'accès optionnel vers les outils apxs d'Apache. Par dé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é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é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é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ée comme une librairie partagé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ète des options de configuration</title> <note> <para> Ces options sont utilisées uniquement au moment de la compilation. Si vous voulez modifier le comportement de PHP lors de l'exécution, reportez vous au chapitre <link linkend="configuration">configuration</link>. </para> </note> <para> Ci-dessous, vous trouverez une liste complète des options supportées par le script de configuration de PHP 4, <filename>configure</filename> (depuis PHP 4.1.0), utilisé 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énérales pour le script <command>configure</command>, consultez les pages appropriées du manuel de GNU <command>autoconf</command> ou bien utilisez la commande <command>configure --help</command> pour avoir une liste complète et à jour des options. </para> <itemizedlist> <listitem> <para> <link linkend="install.configure.options.databases">Bases de donné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ées qu'en PHP 4, depuis la version PHP 4.1.0. Certaines sont disponibles dans les anciennes versions PHP 4, certaines mê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épondre "yes" à la question "Build as an fhttpd module ?" (cela correspond à l'option de configuration <link linkend="install.configure.with-fhttpd">--with-fhttpd</link>=<replaceable>DIR</replaceable> et spécifier la racine de la distribution fhttpd. Le répertoire par dé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érieures, plus de contrôle et la possibilité d'exécution à 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érations géné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é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 à interface graphique</simpara></listitem> </itemizedlist> </para> <para> Pour la première tâche, qui est de loin la plus répandue, vous avez besoin de trois choses : PHP lui-même, un serveur web et un navigateur. Vous avez probablement un navigateur, et en fonction de votre systè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 à une société. De cette façon, vous n'aurez pas à mettre en place PHP, mais uniquement à écrire vos scripts, les charger sur le serveur et voir le résultat sur votre navigateur. </para> <para> Si vous installez PHP et le serveur par vous-même, vous avez deux choix. Soit sous la forme d'un module du serveur web (via une interface directe appelé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é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 (écrire des scripts de géné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écutable PHP. Pour plus de détails, lisez la section <link linkend="install.commandline"> é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 écrire des interfaces graphiques clientes, en utilisant l'extension PHP-GTK. C'est une approche complètement différente de l'écriture des pages web, car vous ne générerez pas de fichiers HTML, mais vous aurez à gérer des fenêtres et des objets. Pour plus de dé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écrit l'installation de PHP avec un serveur web sous Unix et Windows, sous forme de module ou d'exécutables CGI. </para> <simpara> Les codes source et les exécutables compilés de certains OS (y compris Windows), sont disponibles à <ulink url="&url.php;">&url.php;</ulink>. Nous recommandons l'utilisation du <ulink url="&url.mirrors;">miroir</ulink> le plus proche pour accélé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és à 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éléchargez la distribution compilée à http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z, puis décompressez la, et utilisez swinstall pour installer. 2. Vous aurez besoin de gcc. Téléchargez une distribution compilée à http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz, puis décompressez la, et utilisez swinstall pour installer. 3. Vous aurez besoin de GNU binutils. Téléchargez une distribution compilée à http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz , puis décompressez la, et utilisez swinstall pour installer. 4. Vous aurez besoin de bison. Téléchargez une distribution compilée à http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz , puis décompressez la, et utilisez swinstall pour installer. 5. Vous aurez besoin de flex. Télé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éléchargez le fichier, décompressez leur, puis utilisez tar -xvf avec. Allez dans le nouveau dossier flex ainsi créé, et exécutez la commande "./configure", puis faites un "make", puis un "make install". Si vous avez des erreurs à cette étape, c'est probablement par ce que gcc et les autres ne sont pas inscrites dans votre PATH. Ajoutez les. Maintenant, la partie délicate. 6. Téléchargez les sources d'Apache et de PHP. 7. Décompressez les avec gunzip puis faites "tar -xvf" avec les deux archives. Nous devons modifier quelques fichiers avant de les compiler. 8. Premièrement, le fichier de configuration doit être modifié car il semble oublier qu'il est sur une machine HP-UX. Il y a des méthodes plus rusées, mais le plus simple et le plus efficace est d'ajouter "lt_target=hpux10.20" à la ligne 47286 du script de configuration. 9. Le fichier d'Apache GuessOS doit être modifié. Sous apache_1.3.9/src/helpers, modifier la ligne 89, en remplaç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és correctement, mais Apache ne démarre pas. Vous devez cré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'éxécuter Apache avec l'utilisateur nobody sous HP-UX. A partir de ce moment là, PHP et Apache doivent fonctionner. J'espè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écent</link> et <link linkend="install.iis.iis4">IIS 4 ou plus récent</link>. </para> <sect2 id="install.iis.iis3"> <title>Windows et PWS/IIS 3</title> <simpara> La méthode recommandée pour configurer ces serveurs est d'utiliser le fichier INF inclus dans la distribution (<filename>php_iis_reg.inf</filename>). Vous pouvez é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èrent la manipulation du fichier de registry de Windows. Une erreur peut laisser votre système dans un état instable. Nous vous recommandons vivement de sauvegarder ce fichier en lieu sûr. L'équipe de développement et les traducteurs de cette documentation ne pourront pas ê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'à : <literal>HKEY_LOCAL_MACHINE /System /CurrentControlSet /Services /W3Svc /Parameters /ScriptMap</literal>. </simpara> </listitem> <listitem> <simpara> Dans le menu "edit", sé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îne, et entrez le chemin jusqu'à <literal>php.exe</literal> dans le champ "value data". ex: <literal>c:\php\php.exe</literal>. </simpara> </listitem> </itemizedlist> </para> <para> Les étapes suivantes n'affectent pas la configuration du serveur web, et ne s'appliquent que si vous voulez que vos scripts PHP soient exécutés lorsqu'il sont exécuté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 étapes si vous préférez que vos scripts PHP s'ouvrent dans éditeur de texte, plutôt que de les voir s'exécuter lorsque vous double-cliquez dessus. </para> <para> <itemizedlist> <listitem> <simpara> Répétez ces instructions pour toutes les extensions que vous voulez associer aux scripts PHP. </simpara> </listitem> <listitem> <simpara> Naviguez jusqu'à : <literal>HKEY_CLASSES_ROOT</literal> </simpara> </listitem> <listitem> <simpara> Dans le menu edit, sélectionnez: <literal>New->Key</literal>. </simpara> </listitem> <listitem> <simpara> Donnez le nom de votre extension à la clé : ex: <literal>.php</literal> </simpara> </listitem> <listitem> <simpara> Sélectionnez le nom de la nouvelle clée dans le panneau de droite, et double cliquez dans "default value", puis entrez <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Répétez ces instructions pour toutes les extensions que vous avez associées aux scripts PHP. </simpara> </listitem> <listitem> <simpara> Créez une autre <literal>New->Key</literal> sous <literal>HKEY_CLASSES_ROOT</literal> et nommez-la <literal>phpfile</literal>. </simpara> </listitem> <listitem> <simpara> Sélectionnez la nouvelle clé <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électionnez <literal>New->Key</literal>, appelez-le <literal>Shell</literal>. </simpara> </listitem> <listitem> <simpara> Faites un clic droit dans <literal>Shell</literal> et sélectionnez <literal>New->Key</literal>, appelez-le <literal>open</literal>. </simpara> </listitem> <listitem> <simpara> Faites un clic droit dans <literal>open</literal> et sélectionnez <literal>New->Key</literal>, appelez-le <literal>command</literal>. </simpara> </listitem> <listitem> <simpara> Sélectionnez la nouvelle clé <literal>command</literal> et dans le panneau de droite, faites un double clic dans "default value", puis entrez le chemin jusqu'à <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émarrez pour prendre en compte la nouvelle registry. </simpara> </listitem> </itemizedlist> </para> <simpara> Les utilisateurs de PWS et IIS 3 sont prêts à 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écent</title> <simpara> Pour installer PHP sous Windows avec PWS 4 ou plus ré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 être échappé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é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 être échappé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é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écent</title> <simpara> Pour installer PHP sous Windows NT/2000 serveyr avec IIS 4 ou plus ré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ée soit dans "Windows NT 4.0 Option Pack" ou dans "Control Panel=>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é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électionnez l'onglet "App Mappings". </simpara> </listitem> <listitem> <simpara> Cliquez sur "Add", puis dans la boîte "Executable", tapez : <literal>c:\php\php.exe</literal> (si vous avez installé PHP dans le dossier <literal>c:\php\</literal>.) </simpara> </listitem> <listitem> <simpara> Dans la boî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éférer cocher la boîte 'check that file exists' - pour un coût faible, IIS (ou PWS) s'assirurera que le script existe, et résoudra les problèmes d'autentification avant de démarrer PHP. Cela signifie que vous obtiendrez des messages d'erreur 404 intelligents, plutôt que d'avoir simplement une plainte du serveur comme quoi les CGI n'ont rien retournés. </simpara> <simpara> Répétez les é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épandues.) </simpara> </listitem> <listitem> <simpara> Configurer la sécurité nécessaire (dans "Internet Service Manager"), et si votre serveur NT utilise NTFS, ajoutez les droits adé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 étape. Avec ISAPI Filters, ajoutez un nouveau filtre ISAPI. Utilisez PHP comme nom de filtre, et ajoutez simplement le chemin jusqu'à <filename>php4isapi.dll</filename>. </simpara> </listitem> <listitem> <simpara> Sous "Home Directory", cliquez sur le bouton "Configuration". Ajoutez une nouvelle entrée dans "Application Mappings". Utilisez le chemin jusqu'à <filename>php4isapi.dll</filename> comme "Executable", indiquez ".php" comme extension, laissez "Method exclusions" vide, et cochez "Script engine". </simpara> </listitem> <listitem> <simpara> Arrêtez totalement IIS (NET STOP iisadmin) </simpara> </listitem> <listitem> <simpara> Dé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étails spécifique à 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éfaut est géné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é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 étapes suivantes, assurez-vous que /opt/netscape/suitespot/ correspond bien à 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ès avoir fait l'installation de base et lu les fichiers readme.txt, vous pouvez avoir besoin de faire des configurations supplémentaires. </para> <para> D'abord, vous devez ajouter des chemins dans la variable LD_LIBRARY_PATH pour que PHP trouve toutes les librairies partagées. Le mieux est de le faire dans le script de démarrage de votre serveur Netscape. Les utilisateurs Windows peuvent probablement ignorer cette étape. Le script de démarrage est situé dans : <filename class="directory">/path/to/server/https-servername/start</filename> </para> <para> Vous pouvez aussi avoir besoin d'éditer les fichiers de configuration qui sont situé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épendre de votre OS, pour Unix c'est quelque chose de proche de /opt/netscape/suitespot/bin/libphp4.so. Il est conseillé de placer les lignes suivantes aprè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 être placée aprè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 être utilisé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ès les types MIME, et tout le reste ressemble à 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 être Fastrack), suivez ces instructions : </para> <itemizedlist> <listitem> <simpara> Copiez le fichier <filename>php4ts.dll</filename> dans votre dossier systemroot (le dossier où vous avez installé windows) </simpara> </listitem> <listitem> <para> Faî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éez un dossier shellcgi et supprimez le aussitôt (cette opération créee 5 lignes importantes dans le fichier obj.conf et permet au serveur de gérer les scripts CGI). </simpara> </listitem> <listitem> <simpara> Dans le serveur Netscape Enterprise Administration Server, cré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écuter PHP. </simpara> </listitem> </itemizedlist> <para> Plus de détails sur la configuration de PHP comme CGI sont disponibles à <ulink url="&url.netscape.cgi;">&url.netscape.cgi;</ulink> </para> <para> Pour installer PHP avec l'interface NSAPI (pour Netscape Enterprise Server, iPlanet, peut-être Fastrack), faîtes ceci : </para> <itemizedlist> <listitem> <simpara> Copiez le fichier <filename>php4ts.dll</filename> dans votre dossier systemroot (le dossier où vous avez installé windows) </simpara> </listitem> <listitem> <para> Faî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éeez un nouveau type MIME (Category: type, Content-Type: magnus-internal/shellcgi, File Suffix:php). </simpara> </listitem> <listitem> <para> Stoppez votre serveur web et éditez le fichier <filename>obj.conf</filename>. A la fin de la section Init, placez ces deux lignes (obligatoirement aprè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>< Object name="default" ></literal>, placez cette ligne, obligatoirement aprè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éez un nouvel objet appelé <literal>x-httpd-php</literal>, en insé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é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é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ème d'installation par package, comme le fameux RPM. Ils vous permettent de faire des installations standard, mais si vous avez des configurations spécifiques (comme par exemple un serveur sécurisé, ou un pilote de base de données exotique), vous aurez probablement à compiler vous-même votre PHP et votre serveur web. Si vous n'êtes pas familier avec la compilation de vos propres logiciels, il vaut mieux rechercher le package qui pourra répondre à 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é-packagées et pré-compilée de &php; pour MacOSX. Cela être utile pour mettre en place une configuration standard, mais si vous avez besoin d'accéder a des fonctionnalités spécifiques (comme un serveur sécurisé, ou un pilote de base de données exotique), vous aurez à compiler &php; et/ou votre serveur web vous même. Si vous n'êtes pas familiers avec la compilation et la mise en place d'applications, il est bon de vérifier si personne d'autre n'a réalisé un package. </simpara> </sect2> <sect2 id="install.macosx.compile"> <title>Compilation pour OS X server</title> <simpara> Il existe deux versions légèrement diffé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ées MySQL et PostgreSQL. </simpara> <simpara> NOTE: Attention lors des manipulations ci-dessous : vous pourriez détruire la configuration de votre serveur. </simpara> <para> Faites ceci : <itemizedlist> <listitem> <simpara> 1. Ouvrez une fenê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élé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, à 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èse (<literal>#</literal>), puis sauvez le fichier, et quittez TextEdit. </para> <para> Finalement, tapez "<literal>sudo apachectl graceful</literal>" pour redémarrer le serveur Apache. </para> <para> &php; devrait être fonctionnel. Vous pouvez le tester en créant un fichier dans votre dossier "Sites", appelé "test.php". Dans ce fichier, écrivez la ligne ci-contre : "<literal><?php phpinfo() ?></literal>". </para> <para> Maintenant, ouvrez votre navigateur à 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écent pour Windows</title> <simpara> Vous devez réaliser les étapes suivantes pour configurer PHP sur votre serveur OmniHTTPd. C'est une configuration en exécutable CGI. SAPI est supporté par OmniHTTPd, mais des tests on prouvé 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ème, et sé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épetez les étapes de 2 à 6 pour chaque extension que vous voulez associer à 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écocher le composant PHP. Nous recommandons d'utiliser les dernières versions de PHP. Certains serveurs OmniHTTPd sont livrés avec des versions béta de PHP, et il vaut donc mieux éviter de les installer, et choisir une autre version, stable. Si le serveur est déjà sur votre machine, utilisez le bouton "Replace" (remplacer) dans les é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écifiques à 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éthode est la méthode recommandée pour installer &php; sur OpenBSD. C'est aussi la méthode la plus simple. Le paquet core a été séparé des modules et chacun d'entre eux peut être installé et supprimé indé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é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é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éthode est recommandée aux utilisateurs expérimentés de OpenBSD. Le port PHP4 est scindé en trois sous-dossier : core, extensions et pear. Le dossier extensions génère les sous paquets de tous les modules &php;. Si vous souhaitez ne pas cré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ème des FLAVORS pour compiler statiquement PHP. Comme il est trop difficile de générer des packages binaires avec cette méthode, elle est considérée comme obsolète. Vous pouvez touours utiliser les anciennes versions stables, mais sachez qu'elles ne sont plus supportées par l'é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écifiques à Oreilly Website Pro. </para> <sect2 id="install.oreilly.windows"> <title>Oreilly Website Pro 2.5 et plus récent pour Windows</title> <simpara> Cette liste décrit comment installer PHP comme CGI exécutable ou module ISAPI avec Oreilly Website Pro sous Windows. </simpara> <para> <itemizedlist> <listitem> <para> Editez les "Server Properties" et sélectionnez l'onglet "Mapping". </para> </listitem> <listitem> <para> Dans la "List" sélectionnez "Associations" et entrez le nom de l'extension voulue (".php") et le chemin jusqu'à l'exécutable (ex. c:\php\php.exe) ou la DLL ISAPI (ex. c:\php\sapi\php4isapi.dll). </para> </listitem> <listitem> <para> Sélectionnez "Content Types", ajoutez la mê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 être compilé pour fonctionner avec de nombreux autres serveurs web. Reportez-vous à <link linkend="install.configure.options.servers">Options particulières aux serveurs web</link> pour une liste complète des options de configuration. Les exécutables PHP CGI sont compatibles avec la majorité 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èmes?</title> <sect2> <title>Lisez la FAQ</title> <simpara> Certains problèmes sont récurrents : les plus communs sont listés dans la FAQ PHP, disponible à <link linkend="faq">dans ce manuel</link>. </simpara> </sect2> <sect2 id="install.otherproblems"> <title>Autres problèmes</title> <simpara> Si vous êtes complètement bloqués, quelqu'un sur la liste de diffusion PHP pourra probablement vous aider. Essayez de consulter les archives, au cas où quelqu'un aurait déjà rencontré votre problème. Les archives sont toujours accessibles à : <ulink url="&url.php;">&url.php;</ulink>. Pour souscrire à la liste de diffusion, envoyez un mail vide à <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'être concis et clair, et pensez à donner tous les détails sur votre environnement (OS, version de PHP, serveur web, CGI ou module, &safemode;...), et n'hésitez pas à envoyer 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é un bug dans PHP, n'oubliez pas de le signaler. L'équipe de développement PHP ne le connaît peut être pas, et si vous ne le signaler pas, vos chances de voir le bug corrigé sont nulles. Vous pouvez rapporter des bugs grâce au système de suivi, accessible à <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écrit comment configurer le module ISAPI avec le serveur Sambar sous Windows. </simpara> <para> <itemizedlist> <listitem> <para> Trouvez le fichier appelé <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 été installé dans le dossier <filename>c:\php</filename>.) </para> </listitem> <listitem> <para> Maintenant, redé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écessaires</title> <para> L'installation Solaris oublie généralement les compilateurs C, et leurs utilitaires. Voici la liste des outils nécessaires : <itemizedlist> <listitem> <simpara> gcc (recommandé, 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 être aussi compiler) toutes les librairies né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 étudier les sections spécifiques à votre plate-forme ou à votre serveur web avant de passer à l'installation. </para> <para> Pré-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écessaires aux extensions (librairie <acronym>GD</acronym>, <acronym>PDF</acronym>, etc...) </simpara> </listitem> </itemizedlist> </para> <para> Il y a plusieurs façons d'installer PHP sur une plate-forme UNIX : soit un processus de compilation-configuration, ou bien avec des packages déjà tout prêts. Cette documentation se concentre sur la première solution. </para> <para> La première partie du processus est faite en ligne de commande, grâce aux options du script <filename>configure</filename>. Cette section présente l'utilisation des options les plus courantes, mais il y en a beaucoup d'autres à essayer. Reportez-vous à la <link linkend="install.configure">liste complète des options de configuration </link> pour une liste exhaustive. Voici les différentes mé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écutable CGI</link> </simpara> </listitem> </itemizedlist> </para> <sect2 id="install.unix.apache-module"> <title>Installer PHP comme module Apache</title> <para> PHP peut être compilé de nombreuses manières différentes, mais la plus populaire est le module Apache. La liste suivante est un ré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édure habituelle pour redémarrer le serveur Apache. (vous devez arrêter puis redémarrer le serveur, et pas seulement forcer le serveur à relire la configuration initiale). ]]> </programlisting> </example> </sect2> <sect2 id="install.building"> <title>Compilation</title> <simpara> Lorsque PHP est configuré, vous êtes prêts à compiler l'exécutable CGI. La commande <command>make</command> doit prendre tout en charge. Si ce n'est pas le cas et que vous restez bloqué, reportez-vous aux <link linkend="install.problems">problè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èmes Windows 95/98/Me et Windows NT/2000/XP. (La configuration n'est actuellement pas confirmée sous XP). Ne vous attendez pas à ce que PHP fonctionne sur les plateformes 16 bits, comme Windows 3.1. Parfois, on décrira les plateformes supportées sous le nom de Win32. </para> <para> Il y a deux méthodes principales pour installer PHP sous Windows : soit <link linkend="install.windows.manual">manuellement</link>, soit avec <link linkend="install.windows.installer">InstallShield</link>. </para> <para> Si vous avez Microsoft Visual Studio, vous pouvez aussi <link linkend="install.windows.build">compiler</link> PHP à partir des sources. </para> <para> Une fois que PHP est installé 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éthode simple pour installer PHP, il est limité 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ème et assurez-vous qu'il fonctionne. </simpara> <simpara> Exé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éfaut les plus pratiques, et avancée, qui pose un maximum de questions pour paramé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ée, et vous pouvez sélectionner les dossiers qui utiliseront PHP. </simpara> <simpara> Une fois l'installation terminée, l'installeur vous informera que vous devez redémarrer. Suivez ce conseil, ou commencez à utiliser PHP immédiatement. </simpara> <warning> <para> Gardez bien à l'esprit que cette installation de PHP n'est pas sécurisée. Si vous voulez avoir une installation sécurisée de PHP, vous devriez commencer par lire la documentation, et choisir toutes vos options avec soin. Cet installeur automatique vous permet de réaliser l'installation en un tour de main, mais n'est pas destinée à l'utilisation sur des serveurs de production. </para> </warning> </sect2> <sect2 id="install.windows.manual"> <title>Manual Installation Steps</title> <title>Instructions Générales d'installation</title> <simpara> Ce guide vous permet d'installer et de configurer manuellement PHP sur vos stations Windows 9x/Me/NT/2000. Vous devrez commencer par télécharger la distribution de &php; au format compressé ZIP à <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. La première version de ce guide a été compilée par &link.bob;. La version originale est disponible (en anglais) à <ulink url="&url.win32install;">&url.win32install;</ulink>. </simpara> <para> Ce guide fournit une aide d'installation pour : <itemizedlist> <listitem> <para> Personal Web Server (Version la plus récente recommandée) </para> </listitem> <listitem> <para> Internet Information Server 3 ou 4 </para> </listitem> <listitem> <para> Apache 1.3.x </para> </listitem> <listitem> <para> Omni HTTPd 2.0b1 et plus récent </para> </listitem> <listitem> <para> Oreilly Website Pro </para> </listitem> <listitem> <para> Xitami </para> </listitem> <listitem> <para> Netscape Enterprise Server, iPlanet </para> </listitem> </itemizedlist> </para> <para> PHP 4 pour Windows est décliné en deux versions : un exécutable CGI (<filename>php.exe</filename>), et plusieurs modules SAPI (par exemple php4isapi.dll). Cette dernière forme est nouvelle pour PHP 4 et founit des performances améliorées ainsi que des fonctionnalités supplémentaires. </para> <warning> <simpara> Les modules SAPI ont été significativement amélioré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èmes. </simpara> </warning> <para> Si vous choisissez l'un des modules SAPI et utilisez Windows 95, pensez à télécharger la mise à jour DCOM à <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>. Pour le module ISAPI, comme un serveur web compatible est nécessaire (testé avec IIS 4.0, PWS 4.0 et IIS 5.0). IIS 3.0 <emphasis>n'est pas</emphasis> supporté; vous devez télécharger et installer le Windows NT 4.0 Option Pack avec IIS 4.0 si vous voulez le support natif de PHP. </para> <para> Voici les différentes étapes d'installation avant les étapes spécifiques au serveur. <itemizedlist> <listitem> <para> Extrayez la distribution dans le dossier de votre choix. <filename>"C:\php\"</filename> est une bonne idée. </para> </listitem> <listitem> <para> Vous devez vous assurer que les DLL que PHP utilise sont disponibles. La liste précise des DLL dépend du serveur web que vous utiliser, et de la méthode que vous utiliser pour faire exécuter vos script (CGI ou module). <filename>php4ts.dll</filename> est toujours né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ées. Pour être certains que les DLL sont accessibles, vous pouvez les copier dans le dossier système (i.e. <filename>winnt/system32</filename> ou <filename>windows/system</filename>) ou vous pouvez vous assurer qu'elles sont dans le même dossier que l'exécutable PHP ou les autres DLL de votre serveur web (i.e. php.exe, ou php4apache.dll). </para> <para> L'exécutable binaire PHP, les modules SAPI, et certaines extensions utilisent des DLL externes. Assurez vous que ces DLL sont dans votre distribution, et dans un dossier qui est cité dans le PATH Windows. Le mieux à faire est de copier les fichiers ci-dessous dans votre dossier système, qui est généralement : <simplelist> <member>c:\windows\system pour Windows 9x/Me</member> <member>c:\winnt\system32 pour Windows NT/2000</member> </simplelist> Les fichiers à copier sont : <simplelist> <member> 'php4ts.dll', s'il existe, écrasez le </member> <member> Les fichiers 'dlls' de votre distribution. Si vous les avez déjà installé, ne les remplacez pas, sauf si quelquechose ne fonctionne pas correctement (avant de les écraser, il est recommandé de les sauver de toutes manières, au cas où quelque chose irait de travers). </member> </simplelist> </para> <para> Téléchargez la dernière version de Microsoft Data Access Components (MDAC) pour votre plateforme, spécialement si vous utilisez Microsoft Windows 9x/NT4. MDAC est disponible à <ulink url="&url.mdac;">&url.mdac;</ulink>. </para> </listitem> <listitem> <para> Copiez le fichier '<filename>php.ini-dist</filename>' dans votre dossier '%WINDOWS%' sous Windows 95/98, ou vers votre dossier '%SYSTEMROOT%' sous Windows NT ou Windows 2000 et renommez le en '&php.ini;'. Votre dossier '%WINDOWS%' ou '%SYSTEMROOT%' est généralement : <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é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é d'un point de vue sécurité et vitesse d'exécution. Le mieux est tout de mê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écurité, c'est par ce moyen que vous pourez le faire, même si PHP focntionne parfaitement avec les configurations par défaut. </para> </listitem> <listitem> <para> Editez votre fichier &php.ini; : <itemizedlist> <listitem> <simpara> Vous devez changer votre option 'extension_dir' pour qu'il pointe sur votre dossier d'installation PHP, ou vers l'endroit où vous avez installé vos 'php_*.dll'. ex: c:\php\extensions </simpara> </listitem> <listitem> <simpara> Si vous utilisez Omni Httpd, sautez l'étape suivante. Modifiez 'doc_root' pour qu'il pointe sur votre racine de serveur web. ex: <filename>c:\apache\htdocs</filename> ou <filename>c:\webroot</filename>. </simpara> </listitem> <listitem> <simpara> Choisissez les modules que vous voulez charger lorsque PHP démarre. Voyez la section sur les <link linkend="install.windows.extensions">extensions Windows</link>, pour savoir comment les installer et quelles sont celles qui sont déjà inclues. Notez aussi qu'il est préférable de commencer par faire fonctionner &php; sur une nouvelle installation avant d'activer des extensions supplémentaires avec &php.ini;. </simpara> </listitem> <listitem> <simpara> Sous PWS et IIS, vous pouvez configurer le fichier <filename>browscap.ini</filename> pour qu'il pointe sur <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous Windows 9x/Me, <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sous NT/2000 et <filename>c:\windows\system32\inetsrv\browscap.ini</filename> sous XP. </simpara> </listitem> <listitem> <simpara> Notez que le dossier <filename>mibs</filename> fourni avec la distribution Windows, contient des fichiers de support du protocole SNMP. Ce dpssier doit être déplacé dans le dossier <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> est le périphérique où PHP est installé.) </simpara> </listitem> <listitem> <simpara> Si vous n'utilisez pas NTFS sous Windows NT, 2000 et XP, assurez vous que l'utilisateur qui fait tourner le serveur web a bien les permission pour accéder à votre &php.ini;. </simpara> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> Avec PWS, donnez les droits d'exécution au webmestre : <itemizedlist> <listitem> <simpara> Démarrez le PWS Web Manager </simpara> </listitem> <listitem> <simpara> Editez les Properties du dossier "Home" </simpara> </listitem> <listitem> <simpara> Sélectionnez la coche "execute" </simpara> </listitem> </itemizedlist> </para> </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édiatement à l'esprit : </para> <orderedlist> <listitem> <simpara> Windows ne dispose pas (encore) d'une grande communauté de développeurs qui partagent librement leurs sources. La conséquence directe est que les investissements nécessaires en infrastructure pour supporter ce type de développement n'ont pas été faits. Ce qui fait que le portage des utilitaires Unix a été la solution pour pallier ce manque. Ne soyez donc pas surpris de rencontrer cette parenté de temps en temps. </simpara> </listitem> <listitem> <simpara> La majorité 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écutable &php;, vous avez besoin d'un Microsoft Development Environment. Microsoft Visual C++ 6.0 est recommendé. Pour éxtraire le fichier téléchargé, vous avez besoin d'un outil de décompression (e.g.: Winzip). Si vous n'avez pas encore d'utilitaire de décompression, vous pouvez en télécharger un chez <ulink url="&url.infozip;">InfoZip</ulink>. </para> <para> Avant de commencer, vous devez télé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ésolveur de noms DNS utilisé 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é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êmes!! Les dernières versions sont accessibles sur le serveur CVS <ulink url="&url.php.anoncvs;">anonyme</ulink>. Si vous téléchargez une version <ulink url="&url.php.snapshots;">intermé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ès téléchargement des paquets nécessaires, vous devez les extraire au bon endroit. <itemizedlist> <listitem> <simpara> Créez un dossier où tous les fichiers seront placés après l'extraction, comme par exemple :<filename>c:\work</filename>. </simpara> </listitem> <listitem> <simpara> Créez le dossier <filename>win32build</filename> dans votre dossier de travail (ici <filename>c:\work</filename>) et décompressez <filename>win32build.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> Créez le dossier <filename>bindlib_w32</filename> sous votre dossier de travail (ici <filename>c:\work</filename>) et décompressez <filename>bindlib_w32.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> Décompressez le code source de &php; dans votre dossier de travail (<filename>c:\work</filename>). </simpara> </listitem> </itemizedlist> Après avoir suivi ces instructions, vous devriez obtenir un dossier qui ressemble à ceci : <informalexample> <programlisting> <![CDATA[ +--c:\work | | | +--bindlib_w32 | | | | | +--arpa | | | | | +--conf | | | | | +--... | | | +--php-4.x.x | | | | | +--build | | | | | +--... | | | | | +--win32 | | | | | +--... | | | +--win32build | | | | | +--bin | | | | | +--include | | | | | +--lib ]]> </programlisting> </informalexample> Cré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ère étable. Un environnement Cygwin correctement installé 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 => Options". Dans le dialogue, sélectionnez l'onglet "directories". Modifiez les valeurs pour les items du menu Executables, Includes et Library files. Votre configuration doit alors ressembler à <itemizedlist> <listitem> <simpara> Fichiers éxé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é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électionnez le menu "File => Open Workspace" et "bindlib". Puis sélectionnez "Build=>Set Active Configuration" et sélectionnez la configuration voulue. Enfin, sélectionnez "Build=>Rebuild All". </simpara> </listitem> <listitem> <simpara> Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistré les variables d'environnement C++, ou que vous avez exécuté <command>vcvars.bat</command>. Exé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çant le fichier du même nom. </para> </sect3> <sect3 id="install.windows.build.compile"> <title>Compilation</title> <simpara> La meilleure façon de compiler est de commander par la version CGI/exécutable. </simpara> <itemizedlist> <listitem> <simpara> Pour les utilisateurs GUI, lancez VC++, puis sélectionnez le menu "File => Open Workspace" et sélectionnez "php4ts". Ensuite, sélectionnez le menu "Build=>Set Active Configuration", et sélectionnez la configuration voulue. Finalement, sélectionnez le menu "Build=>Rebuild All". </simpara></listitem> <listitem> <simpara> Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistré les variables d'environnement C++, ou que vous avez exécuté <command>vcvars.bat</command>. Exé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é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ères mineures en éditant le fichier <filename>main/config.win32.h.in</filename>. </simpara> <simpara> Ensuite, vous pouvez compiler la version CLI qui est conçue pour un usage en <link linkend="features.commandline">ligne de commande</link>. Les étapes sont les mêmes que pour la compilation en mode CGI, hormis le fait que vous devez sélectionner <literal>php4ts_cli - Win32 Debug_TS</literal> ou <literal>php4ts_cli - Win32 Release_TS</literal> dans le fichier de proejt. Après une compilation réussie, vous pouvez exé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égrer dans Microsoft IIS, vous devez utiliser la configuration <filename>php4isapi-whatever-config</filename> et compiler la DLL nécessaire. </simpara> </sect3> </sect2> <sect2 id="install.windows.extensions"> <title>Installation des extensions sous Windows</title> <para> Après avoir installé PHP et votre serveur web sous Windows, vous voudrez sûrement ajouter quelques extensions bien pratiques. La table suivante liste une partie des extensions disponibles. Comme indiqué dans le manuel, vous pouvez choisir quelles extensions vous voulez charger en dé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éfixés par 'php_' en PHP 4, et 'php3_' en PHP 3. Cela évite la confusion des extensions PHP et de leurs librairies. </para> <note> <para> En PHP 4.0.6 le support des extensions BCMath, Calendar, COM, FTP, MySQL, ODBC, PCRE, Session, WDDX et XML est activé <emphasis>par défaut</emphasis>. Vous n'avez pas à charger d'extensions particulière pour utiliser ces fonctions. Lisez le fichier <filename>README.txt</filename> inclus dans la distribution, ou bien <filename>install.txt</filename> pour connaitre la liste des modules automatiquement activés. </para> </note> <note> <para> Certaines de ces extensions requièrent des librairies DLL supplémentaires pour fonctionner correctement. Certaines d'entre elles sont disponibles dans la distribution. dans le dossier <filename>dlls</filename> mais 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éjà d'installées sur votre système, ne les écrasez que si PHP ne fonctionne pas correctement (et de toutes manières, faites une sauvegarde de ces DLL, en cas de problème). </para> </note> <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ètes. Utilisez DBA à 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ê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è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è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éné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écifiques à Xitami. </para> <sect2 id="install.xitami.windows"> <title>Xitami pour Windows</title> <simpara> Cette liste décrit comment installer PHP comme CGI exé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éné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écutable PHP (souvent <filename>c:\php\php.exe</filename>). </para> </listitem> <listitem> <para> Cliquez sur le bouton "Save". </para> </listitem> <listitem> <para> Redé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éférence des API communes de flôts</title> <refentry id="streams.php-stream-stat-path"> <refnamediv> <refname>php_stream_stat_path</refname> <refpurpose>Lit l'é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> éxamine le fichier ou l'URL spécifié par <parameter>path</parameter> et retourne des informations telles que la taille, les droits d'accès, la date de création, etc... La valeur retournée est 0 en cas de succès, et -1 en cas d'é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é au flô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ème de stocker du flôt <parameter>stream</parameter>, et retourne des informations telles que la taille de fichier, les droits d'accès, la date de création, etc... La valeur retournée est 0 en cas de succès, et -1 en cas d'échec. Pour plus d'informations sur les informations retourné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ô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éré, spécifiée par <parameter>path</parameter>. Suivant la valeur de <parameter>mode</parameter>, le flôt peut être ouvert en lecture, écriture, ajout ou une combinaison des trois. Voyez la table ci-dessous pour connaîtres les modes utilisées. De plus vous pouvez aussi intégrer le caractère 'b' comme deuxième ou dernière option. Sa présence indiquera que le flôt fonctionnera en mode binaire. </para> <para> L'option 'b' est ignorée sur les systèmes POSIX, qui traitent les fichiers textes et binaires de la même façon. C'est une bonne idée que de spécifier 'b' à chaque fois que votre flôt accède à des données binaires, pour que votre code fonctionne lorsqu'il est compilé sur un système où 'b' serait important. </para> <para> Tous les fichiers locaux créés par l'API des flôts recevront les droits par défaut du système : sous Unix, cela signifie que le masque utilisateur du processus sera utilisé. Sous Windows, le fichier sera donné au propriétaire du processus. Tous les fichiers distants seront créé suivant le protocole utilisé, et les droits utilisé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ôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>r+</constant> </term> <listitem> <simpara> Ouvre le fichier texte en lecture et écriture. Le pointeur du flôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>w</constant> </term> <listitem> <simpara> Tronque le fichier à une taille de 0 ou bien crée le fichier, puis l'ouvre en mode écriture. Le pointeur du flôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>w+</constant> </term> <listitem> <simpara> Tronque le fichier à une taille de 0 ou bien crée le fichier, puis l'ouvre en mode écriture et lecture. Le pointeur du flôt est placé au début du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>a</constant> </term> <listitem> <simpara> Ouvre le fichier en mode d'écriture. Le fichier est créé si il n'existe pas. Le pointeur de flôt est positionné à la fin du fichier. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>a+</constant> </term> <listitem> <simpara> Ouvre le fichier en mode d'écriture et lecture. Le fichier est créé si il n'existe pas. Le pointeur de flôt est positionné à la fin du fichier. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> <parameter>options</parameter> affecte l'interprétation du path ou de l'URL, les vérifications du safe_mode et les actions à prendre lorsqu'il y a une erreur. Voyez <link linkend="streams.options">Stream open options</link> pour plus de détails sur ces options. </para> <para> Si <parameter>opened</parameter> est non NULL, il sera assigné avec le nom du fichier ou de la ressource qui aura été ré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, êtes responsable de l'appel de <function>efree</function> sur le nom de fichier retourné par ce paramètre. </para> <note> <simpara> Si vous avez spécifié l'option <constant>STREAM_MUST_SEEK</constant> dans <parameter>options</parameter>, le chemin retourné dans <parameter>opened</parameter> peut ne pas être le même que celui qui vous a été réellemetn retourné. Toutes fois, ce sera le nom de la ressource originale à partir de laquelle un flôt à pointeur variable a été créé. </simpara> </note> </refsect1> </refentry> <refentry id="streams.php-stream-read"> <refnamediv> <refname>php_stream_read</refname> <refpurpose>Lit des octets depuis un flô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'à <parameter>count</parameter> octets dans le flô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 é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ôt est avancé d'autant d'octets que le nombre qui en a été lu. Par conséquent, la prochaine lecture reprendra là ou la lecture précédente s'est arrêtée. </para> <para> Si moins de <parameter>count</parameter> octets ont été lus, cet appel bloquera l'application jusqu'à ce que le nombre d'octets nécessaire soit atteint, en fonction de la configuration du flôt (bloquant, non bloquant). Par défaut, un flôt est ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant ne vous gènera pas. Lors que le flôt atteint <constant>EOF</constant> <function>php_stream_read</function> retournera un nombre d'octets lus inférieur à <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ô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> é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 été écrit. Si il y a eu une erreur, le nombre d'octets écrit sera inférieur au paramètre <parameter>count</parameter>. </para> <para> Le pointeur de position dans le flôt est avancé d'autant d'octets que le nombre qui en a été écrit. Par conséquent, la prochaine écriture reprendra là ou la lecture précédente s'est arrété. </para> </refsect1> </refentry> <refentry id="streams.php-stream-eof"> <refnamediv> <refname>php_stream_eof</refname> <refpurpose>Vérifie que le pointeur n'est pas au bout du flô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érifie que le pointeur n'est pas au bout du flôt <parameter>stream</parameter>. </para> <para> <function>php_stream_read</function> retourne 1 pour indiquer la fin du flôt (<constant>EOF</constant>), 0 si il n'y a pas de fin de flô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ô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ôt <parameter>stream</parameter> puis le retourne de type unsigned char transtypé en int, ou <constant>EOF</constant> si la fin du flôt est atteinte, ou bien si une erreur est survenue. </para> <para> <function>php_stream_getc</function> peut bloquer l'application de la même façon que <function>php_stream_read</function> bloque. </para> <para> Le pointeur de position est avancé d'une position si la lecture réussit. </para> </refsect1> </refentry> <refentry id="streams.php-stream-gets"> <refnamediv> <refname>php_stream_gets</refname> <refpurpose>Lit une ligne de données d'un flô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'à <parameter>count</parameter>-1 octets de données dans le flôt <parameter>stream</parameter> puis les copies dans le buffer <parameter>buf</parameter>. La lecture s'arrête après la rencontre de la fin du fichier (<constant>EOF</constant>) ou une nouvelle ligne. Si la nouvelle ligne est lue, elle est stockée dans <parameter>buf</parameter> dans les données retournées. Un caractère NUL de fin de chaîne est stocké comme dernier caractè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é d'une position si la lecture réussit. </para> <para> <function>php_stream_gets</function> peut bloquer l'application de la même faç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ô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ôt <parameter>stream</parameter> et libère les ressources qui lui sont associées. Apràs la fermeture de <parameter>stream</parameter>, il prend une valeur indéfinie, et ne devrait plus être utilisé. </para> <para> <function>php_stream_close</function> retourne 0 si le flôt a été fermé, ou bien <constant>EOF</constant> pour indiquer une erreur. Indépendamment du succès de l'opération, <parameter>stream</parameter> prend une valeur indéfinie, et ne devrait plus être utilisé. </para> </refsect1> </refentry> <refentry id="streams.php-stream-flush"> <refnamediv> <refname>php_stream_flush</refname> <refpurpose>Vide les buffers dans le flô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ées contenues dans les buffers d'écriture du flôt <parameter>stream</parameter> et force leur stockage. </para> <para> <function>php_stream_flush</function> retourne 0 si les buffers ont été vidés, ou si les buffers n'ont pas besoin d'être vidé, 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ô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ôt <parameter>stream</parameter>. La nouvelle position est déterminée en ajoutant <parameter>offset</parameter> à la position indiqué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ébut du flôt, à la position courante ou à la fin du flôt, respectivement. </para> <para> <function>php_stream_seek</function> retourne 0 en cas de succès, et -1 en cas d'erreur. </para> <note> <para> Tous les flôts ne supportent pas la modification de la position du pointeur, même si l'API va é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'émulation est uniquement appliquée si l'implémentation du gestionnaire de flôt suporte le pointeur de position. Si le flôt est (par exemple) basé sur des fichiers qui travaille avec des flôt de pipes, l'API de flôt ne pourra pas appliquer une telle émulation. Le positionnement du pointeur de flôt échouera et une erreur sera retournée. </para> </note> </refsect1> </refentry> <refentry id="streams.php-stream-tell"> <refnamediv> <refname>php_stream_tell</refname> <refpurpose>Détermine la position du pointeur dans un flô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ôt <parameter>stream</parameter>, relativement au début du flô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ées d'un flôt à 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ôt <parameter>src</parameter> puis de les écrire dans le flôt <parameter>dest</parameter>. La fonction retourne le nombre d'octets copiés. </para> <para> Si vous souhaitez copier tous les octets restants dans le flô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ère la plus efficace, en utilise dans buffer mé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ées depuis un flô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ô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ère la plus efficace, en utilise dans buffer mé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ôt en flô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érifie si <parameter>origstream</parameter> dispose d'un pointeur de potision. Si ce n'est pas le cas, il va copier les données du flôt dans un autre flôt temporaire, et disposant d'un pointeur de position. Si cela fonctionne, <parameter>newstream</parameter> sera un flôt valide même si le flôt original avait déjà un pointeur de position. </para> <para> <parameter>flags</parameter> vous permet de spécifier votre préférence pour le flôt retourné : utilisez la constante <constant>PHP_STREAM_NO_PREFERENCE</constant> pour utiliser le flôt à pointeur de position par défaut (qui utilise la mé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é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ôt original avait déjà son pointeur de position. <parameter>newstream</parameter> vaut <parameter>origstream</parameter>. </entry> </row> <row> <entry>PHP_STREAM_RELEASED</entry> <entry>Le flôt originl n'avait pas pointeur de position, et il a été détruit. Vous n'avez plus accès à <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 état indéterminé. <parameter>newstream</parameter> vaut NULL et il est très recommandé que vous vous fermiez <parameter>origstream</parameter>. </entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Si vous devez déplacer le pointeur et écrire dans le flôt, n'utilisez pas cette fonction, car le flôt retourné est un flôt mis en cache. Il n'est pas garantit qu'il soit lié à la ressource originale. </simpara> </note> <note> <simpara> Si vous avez uniquement de déplacer le pointeur de position vers l'avant, il n'y a pas besoin d'appeler cette fonction, car l'API va automatiquement émuler ce fonctionnement avec le paramètre whence à la valeur <constant>SEEK_CUR</constant>. </simpara> </note> <note> <simpara> Si <parameter>origstream</parameter> repose sur le réseau, cette fonction va se bloquer jusqu'à ce que tout le contenu soit téléchargé. </simpara> </note> <note> <simpara> NE JAMAIS appeler cette fonction avec un flôt <parameter>origstream</parameter> qui est une référence à un pointeur de fichier dans un script PHP. Cette fonction pourrait alors fermer le fichier, ce qui conduira à un crash au prochain accès au pointeur. </simpara> </note> <note> <simpara> Dans de nombreux cas, cette fontion ne peut réussir que si <parameter>origstream</parameter> vient d'être tout juste ouvert, et qu'aucune données n'ont été mises dans les caches de la couche de flôt. Pour cette raison, et parceque cette fonction est compliquée à utiliser correctement, il est recommandé 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ô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ôt <parameter>stream</parameter> en un autre ressource indiqué par <parameter>castas</parameter>. Si <parameter>ret</parameter> est NULL, le flôt est interrogé pour savoir une telle conversoin est posible, sans effectuer réellemnt la conversion (mais certains état interne pourrait être changés dans ce cas). Si <parameter>flags</parameter> vaut <constant>REPORT_ERRORS</constant>, un message d'erreur apparaîtra si une erreur survient durant la conversion. </para> <note> <para> Cette fonction retourne <constant>SUCCESS</constant> en cas de réussite et <constant>FAILURE</constant> en cas d'échec. Soyez prévenu que vous devez faire une comparaison explicite avec <constant>SUCCESS</constant> ou <constant>FAILURE</constant> à cause des valeurs sous jacentes de ces constantes. Une simple comparaison d'expression booléenne ne sera pas interprété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ésente le flôt</entry> </row> <row> <entry>PHP_STREAM_AS_FD</entry> <entry>Un pointeur de fichier de type POSIX qui représente le flôt</entry> </row> <row> <entry>PHP_STREAM_AS_SOCKETD</entry> <entry>Un pointeur de socket réseau qui représente le flôt</entry> </row> </tbody> </tgroup> </table> </para> <para> En plus des types de ressources basiques ci-dessus, le processus de conversion peut être modifié en utilisant les paramètres ci-dessous, ou bien en utilisant l'opé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ême si c'est au prix de quelques ressources supplémentaires, que la conversion réussisse</entry> </row> <row> <entry>PHP_STREAM_CAST_RELEASE</entry> <entry>Informque l'API de flô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ôt <parameter>stream</parameter> sera fermé de telle façon à ce que le gestionnaire soit préservé et retourné dans le paramètre <parameter>ret</parameter>. Si la fonction réussit, le paramètre <parameter>stream</parameter> doit être considéré comme fermé, et inutilisable en l'état. </entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Si votre système supporte la fonction <function>fopencookie</function> (les systèmes utilisant la librairie glibc 2 ou plus récent), l'API de flôt sera toujours capable de créer des pointeurs de fichiers de type ANSI FILE* pour tous les flôts. Même si c'est extrêmement utile pour passer des flôts PHP à des librairie tierce partie, un tel système n'est pas portable. Il est demandé que vous considériez la portabilité e vos fonctions avant de diffuser votre extension. Si l'utilisation de fopencookie() n'est pas désirable, il est recommandé d'interroger le flô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éseau à la place d'un FILE*, l'API de flôts va utiliser la fonction <function>fdopen</function> pour la créer pour vous. Soyez prévenu que faire cela risque de perdre les données qui ont été mises en buffer dans le flôt, si vous mélanger des appels de l'API de flô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étermine si un flôt peut ê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'équivalent de la fonction <function>php_stream_cast</function> avec le paramètre <parameter>ret</parameter> mis à NULL, et le paramètre <parameter>flags</parameter> mis à 0. Elle retourne <constant>SUCCESS</constant> si le flôt peut être converti dans la forme demandé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 état interne du flôt soient modifiés. </simpara> </note> <note> <simpara> Vous devez explicitement comparer la valeur de retour avec une des constantes, comme dé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étermine si un flôt est un flô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ôt <parameter>stream</parameter> est un flôt persistant, et 0 sinon. </para> </refsect1> </refentry> <refentry id="streams.php-stream-is"> <refnamediv> <refname>php_stream_is</refname> <refpurpose>Détermine si un flô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écifié 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ôt est implémenté en utilisant l'implémentation standard</entry> </row> <row> <entry>PHP_STREAM_IS_SOCKET</entry> <entry>Le flôt est implémenté en utilisant l'implémentation des sockets réseau</entry> </row> <row> <entry>PHP_STREAM_IS_USERSPACE</entry> <entry>Le flôt est implémenté en utilisant l'implémentation de l'objet utilisateur</entry> </row> <row> <entry>PHP_STREAM_IS_MEMORY</entry> <entry>Le flôt est implémenté en utilisant l'implémentation mémoire à taille automatique</entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Les constantes PHP_STREAM_IS_XXX sont en fait définies comme des pointeurs sur la structure des opérations de base. Si vous extension (ou une autre extension définit des flôts additionnels), il faut qu'elle déclare aussi les constantes PHP_STREAM_IS_XXX dans ses entêtes, pour que vous puissiez les utiliser comme base de comparaison. </simpara> </note> <note> <simpara> Cette fonction est implémentée comme une comparaison de pointeurs simple (et rapide), et ne modifie pas l'état du flô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ées restantes d'un flô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ôt <parameter>stream</parameter> vers le buffer de sortie. Les données sont é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émoire pour accélérer l'exé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ô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é, 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ésenregistre un gestionnaire pour l'API de flô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ésenregistre le gestionnaire associé 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ôt avec un fichier ou une URL, en spé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écifier un objet de type php_stream_context avec le paramè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ô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 à la fonction <function>php_stream_open_wrapper</function>, mais convertit le flôt en un pointeur ANSI FILE* puis le retourne à la place du flô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ôts</title> <refentry id="streams.options"> <refnamediv> <refname>Options d'ouverture de flôt</refname> <refpurpose>Affectent les fonctions de flôt</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> Plusieurs valeurs peuvent êter combinées avec l'opérateur OR. <variablelist> <varlistentry> <term> <constant>IGNORE_PATH</constant> </term> <listitem> <simpara> C'est l'option par défaut pour les flôts. Elle indique que l'include_path ne sera pas fouillé pour trouver le fichier demandé. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>USE_PATH</constant> </term> <listitem> <simpara> Requiert que l'include_path soit fouillé à la recherche du fichier demandé. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IGNORE_URL</constant> </term> <listitem> <simpara> Requiert que les gestionnaires d'URL soient ignorés pour traiter ce flôt. Les gestionnaires qui ne traitent pas d'URL seront utilisé lors du décodate du chemin. Il n'y a pas de contraire à cette option : l'API des flôts utilisera tous les gestionnaires par défaut. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IGNORE_URL_WIN</constant> </term> <listitem> <simpara> Sous Windows, c'est l'équivalent de IGNORE_URL. Sur tous les autres systè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ôt effectue les vérifications liées au safe_mode sur le fichier à ouvrir avant e le faire. En omettant cette option, le safe_mode sera ignoré 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é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écurité). Lorsque les API des flôts génèrent une erreur, elles commencent par supprimer les informations de login et mot de passe, afin que l'affichage des donné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éellement être capable déplacer le pointeur de fichier dans le flôt. Certains flots ne disposent pas d'un tel pointeur. Cette option s'assure que le flôt va supporter ce opinteur. Si il ne le fait pas, le flôt sera copié dans un fichier temporaire (qui peut être un fichier ou un bloc de mémoire), qui supportera le pointeur. Notez bien que cette option est inutile lorsque vous voulez déplacer le pointeur de fichier et y écrire, car le flôt que vous allez utiliser n'est peut être pas votre ressource initiale, mais un fichier en cache. </simpara> <note> <simpara> Si la ressource demandée est sur le réseau, cette option va bloquer la fonction d'ouverture jusqu'à ce que le contenu complet du fichier soit téléchargé. </simpara> </note> </listitem> </varlistentry> <varlistentry> <term> <constant>STREAM_WILL_CAST</constant> </term> <listitem> <simpara> Si votre extension utilise une librairie tierce qui s'attend à recevoir un pointeur FILE* ou un pointeur de fichier, vous pouvez utiliser cette option pour demander à l'API d'ouvrir la ressource, mas d'é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 à la librairie. </simpara> <simpara> Ceci est particulièrement pratique lorsque vous accédez à des URL via HTTP, qui vont diffuser des données, mais dont le corps ne sera accessible qu'après une quantité indéterminée d'entê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éhensible, car vous avec indiqué aux flôts que vous alliez utiliser les fonctions de bases de l'implé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ôt qui peut être utilisé pour lister les fichiers qui sont contenu dans le dossier spécifié par <parameter>path</parameter>. Cette fonction est l'équivalent de <function>opendir</function> sous POSIX. Bien que cette fonction retourne un objet php_stream, il n'est pas recommandé d'essayer d'utiliser les fonctions de fichiers sur ce flô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ètre <parameter>ent</parameter>. Si la fonction réussit, la valeur retournée est <parameter>ent</parameter>. Si la fonction échoue, la valeur retournée est NULL. </para> </refsect1> </refentry> <refentry id="streams.php-stream-rewinddir"> <refnamediv> <refname>php_stream_rewinddir</refname> <refpurpose>Replace le flôt de dossier au dé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ébut du flôt. Retourne 0 en cas de succes, et -1 en cas d'échec. </para> </refsect1> </refentry> <refentry id="streams.php-stream-closedir"> <refnamediv> <refname>php_stream_closedir</refname> <refpurpose>Ferme un flôt de dossier, et libè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ôt le dossier <parameter>dirstream</parameter>, et libère les ressources. Retourne 0 en cas de succes, et -1 en cas d'é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ô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ô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ôt basé sur le fichier <parameter>file</parameter>. <parameter>mode</parameter> doit être le même mode que celui utilsé pour ouvrir <parameter>file</parameter>, sinon d'étranges erreurs surviendront lors de l'écriture lorsque le mode du flôt sera diffé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ô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ôt basé sur un ficheir temporaire, ouvert en mode "w+b". Le fichier temporaire sera supprimé automatiquement lorsque le flôt sera fermé ou que le procesus sera terminé. </para> </refsect1> </refentry> <refentry id="streams.php-stream-fopen-temporary-file"> <refnamediv> <refname>php_stream_fopen_temporary_file</refname> <refpurpose>Génère un fichier temporaire et ouvre un flô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énère un fichier temporaire dans le dossier <parameter>dir</parameter> avec le préfixe <parameter>pfx</parameter>. Le nom du fichier ainsi généré est retourné dans la variable <parameter>opened</parameter>, dont vous êtes responsable de l'effacemetn avec <function>efree</function>. Un flôt est ouvert sur ce fichier généré, en mode "w+b". Le fichier N'EST PAS automatiquement effacé. Vous ê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ô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ôt basé sur la socket <parameter>socket</parameter>. <parameter>persistent</parameter> est une option qui contrôle si le flôt doit être ouvert comme un flôt persistant. Généralement, ce paramè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ô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> établit une connexion à l'hôte <parameter>host</parameter> et sur le port <parameter>port</parameter>. <parameter>socktype</parameter> spécifie les options de sockets qui devront être appliquées. <parameter>socktype</parameter> est dépendant du système, mais incluera notamment <constant>SOCK_STREAM</constant> pour les connexions full-duplex, séquentielle et fiables et <constant>SOCK_DGRAM</constant> pour les connexions non fiables, sans connexion, avec une taille maximale fixée (UDP). </para> <para> <parameter>persistent</parameter> est une option qui contrôle si le flôt doit être ouvert comme un flôt persistant. Généralement, ce paramètre vaudra 0. </para> <para> Si non-NULL, <parameter>timeout</parameter> spécifie la durée maximale de connexion. SI la connexion prend plus de temps que cette valeur, la tentative de connexion sera abandonnée et NULL sera retourné pour indiquer que le flôt n'a pu être ouvert. </para> <note> <simpara> Le paramètre <parameter>timeout</parameter> n'inclut pas le temps de résolution DNS. La raison à cela est qu'il n'y a pas de méthode portable pour effectuer des résolutions DNS. </simpara> <simpara> La durée d'expiration s'applique à la phase de connexion; si vous avez besoin de durées d'expiration pour les opérations de lecture et d'écritures, il faudra utiliser la fonction <function>php_stream_sock_set_timeout</function> pour configurer la durée d'expiration de votre flô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é de considérer les problèmes de portabilité 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ô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écifiée par <parameter>path</parameter>. <parameter>pathlen</parameter> spécifie la taille de <parameter>path</parameter>. Si non-NULL, <parameter>timeout</parameter> spécifie la durée maximale de connexion. SI la connexion prend plus de temps que cette valeur, la tentative de connexion sera abandonnée et NULL sera retourné pour indiquer que le flôt n'a pu être ouvert. <parameter>persistent</parameter> est une option qui contrôle si le flôt doit être ouvert comme un flôt persistant. Généralement, ce paramètre vaudra 0. </para> <note> <simpara> Cette fonction n'est pas utilisable sous Windows, qui n'implémente pas les sockets de domaines. Une exception possible à cette règle sont les exécutables PHP compilé avec cygwin. Vous êtes encouragés à considérer cet aspect de la portabilité de votre extension avant sa publication. </simpara> </note> <note> <simpara> Cette fonction traite <parameter>path</parameter> en tenant compte des données binaires, ce qui est bon pour les systèmes qui utilisent un espace de nom abstrait (comme par exemple Linux), où le premier caractère est le caractè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éfinie par le systè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é. </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émentation de flôt</refpurpose> </refnamediv> <refsect1> <title>Description</title> <programlisting role="c"> typedef struct _php_stream_ops { /* Tous les flôts DOIVENT implémenter ces opé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érations sont optionnelles, et peuvent prendre la valeur de NULL si le flôt ne supporte pas cette opé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ôts les auteurs d'extensions</title> <sect1 id="streams.overview"> <title>Présentation</title> <para> Les flôts de PHP proposent une approche unifiée à la gestion des fichiers et sockets, depuis une extension PHP. En utilisant l'API standard, les flôts vous permettent d'accéder à des fichiers, des sockets, des URL, de la mémoire ou encore des objets définis dans des scripts. Les flôts (streams en anglais), sont une API flexible et dynamique, dynamiquement chargée dans les modules (et les scripts!). </para> <para> Le but des flôts est de proposer une API confortables pour les programmeurs, lors des manipulations de fichiers, URL et autres sources de données linéaires. L'API unifiée est très simple à comprendre : elle est plus ou moins basée sur la famille de fonction classiques C d'entrée/sortie (avec les mêmes concepts pour la plus part des fonctions) : les programmeurs C ne seront pas dépaysés. </para> <para> L'API des flôts intervient à différents niveaux : à la base, elle définit un objet php_stream, qui représente les sources de données. A un niveau au dessus, l'API défini un objet php_stream_wrapper qui s'interface avec l'API de bas niveau, pour lire et écrire les données et méta données, dans les sources. </para> <para> Les flôts peuvent être converti en pilotes pour fichiers, de manière à être utilisé par des librairies tierce-partie avec beaucoup de facilité. Cela autorise ces librairies à accéder aux données directement depuis des sources représentées par des URL. Si votre système supporte la fonction <function>fopencookie</function>, vous pouvez même passer n'importe quel flôt PHP à une autre librairie qui utilise les entrée/sortie standard ANSI! </para> </sect1> <sect1 id="streams.basics"> <title>Eléments de bases</title> <para> Utiliser les flôts ressemble énormément à l'utilisation des fonctions d'entrée/sortie standard ANSI streams. La principale différence est que vous devez créer le pointeur de flô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 à fopen(), comme le montre l'exemple ci-dessous : </para> <para> <example> <title>Exemple de flô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ôts équivalentes aux fonctions ANSI. Sauf indication contraire, les fonctionnalités sont les mêmes. <table> <title>ANSI stdio equivalent functions in the Streams API</title> <tgroup cols="3"> <thead> <row> <entry>Fonction ANSI</entry> <entry>Fonction Flôt PHP</entry> <entry>Notes</entry> </row> </thead> <tbody> <row> <entry>fopen</entry> <entry>php_stream_open_wrapper</entry> <entry>Les flôts incluent des paramètres supplé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ètre nmemb est suppos avoir la valeur 1 : le prototype ressemble plutôt à read(2)</entry> </row> <row> <entry>fwrite</entry> <entry>php_stream_write</entry> <entry>Le paramètre nmemb est suppos avoir la valeur 1 : le prototype ressemble plutôt à 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 à puts, et non pas à fputs</entry> </row> <row> <entry>fstat</entry> <entry>php_stream_stat</entry> <entry>Les informations des flôts sont plus riches</entry> </row> </tbody> </tgroup> </table> </para> </sect1> <sect1 id="streams.resources"> <title>Les flôts qui sont des ressources</title> <para> Tous les flôts sont enregitrés comme des ressources lorsqu'il sont créés. Cela garantit qu'ils seront convenablement déblayés de la mémoire, même en cas d'erreur fatale. Toutes les fonctions du sytème de fichier de &php; opère sur des ressources : cela signifie que vos extensions peuvent accepter des pointeurs de fichiers comme paramètre, et retourner des flôts. L'API des flôts rend ce processus très convivial. </para> <para> <example> <title>Comment accepter un flôt comme paramètre d'entré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ôt. Cependant, vous ne "possédez" pas le flôt, mais le script le possède. Cela signifie que vous de DEVEZ PAS fermer le flôt, car sinon, PHP va crasher! */ php_stream_write(stream, "hello\n"); RETURN_TRUE(); } ]]> </programlisting> </example> </para> <para> <example> <title>Comment retourner un flô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ôt appartient au script. Si vous le fermer ici, vous allez faire crasher PHP! */ } ]]> </programlisting> </example> </para> <para> Comme les flôts sont automatiquement déblayés de la mémoire, il est tentant de penser que vous pouvez être des programmeurs paresseux et ne pas vous préoccuper de la fermeture du flôt lorsque vous en avez terminé avec lui. Même si une telle approche fonctionnera probablement, ce n'est pas une bonne idée pour un bon nombre de raisons : les flôts conservent des verrous sur les ressources systèmes durant un temps plus long, ce qui fait que laisser le verrous empêche d'autres processus d'accéder à cette ressource. Si le script gère un grand nombre de fichier, l'accumulation de ressources, en terme de mémoire et de nombre de fichiers ouverts, causer l'échec des requêtes du serveur web. Cela n'est plus aussi séduisant, n'est-ce pas? L'API de flôt inclut un peu de magie pour que vous puissiez garder votre code propre : si un flôt n'est pas fermé par votre code alors qu'il devrait l'être, vous trouverez des informations de débogage dans le fichier d'historique d'erreur de votre serveur web. </para> <note> <simpara> Utilisez toujours une version de débogagge de &php; lorsque vous développez (<option>--enable-debug</option> lors de la configuration de la compilation) car de nombreux efforts ont été fait pour vous aider à traquer les fuites de mémoire. </simpara> </note> <para> Dans certains cas, il est pratique de garder un flôt ouvert pour toute la durée de la requête, afin de l'utiliser comme fichier d'historique. Ecrire le code né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écessaire. Pour vous éviter l'écriture de ce code, vous pouvez marquer le flôt pour qu'il soit automatiquement libéré lorsque viendra le temps de libé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 -->