cvs: phpdoc /fr/chapters config.xml install.xml security.xml
| From: | Damien Seguy | Date: | Mon, 12 Nov 2001 05:03:39 +0000 |
| Subject: | cvs: phpdoc /fr/chapters config.xml install.xml security.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338747@lists.php.net to get a copy of this message | ||
dams Mon Nov 12 00:03:39 2001 EDT
Modified files:
/phpdoc/fr/chapters install.xml security.xml config.xml
Log:
Commiting latest changes since July 1rst.
Minor addings, typos corrections.
Uptodate with en.
Index: phpdoc/fr/chapters/install.xml diff -u phpdoc/fr/chapters/install.xml:1.31 phpdoc/fr/chapters/install.xml:1.32 --- phpdoc/fr/chapters/install.xml:1.31 Thu Oct 4 17:05:52 2001 +++ phpdoc/fr/chapters/install.xml Mon Nov 12 00:03:37 2001 @@ -1,4573 +1 @@ -<!-- $Revision: 1.31 $ --> -<chapter id="installation"> - <title>Installation</title> - <sect1 id="install.downloading"> - <title>Télécharger la dernière version</title> - <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> - <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 les codes sources) - </simpara> - </listitem> - <listitem> - <simpara> - bison (pour les codes sources) - </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>Référence 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> - Instructions d'installation PHP 4 (Version Module Apache) - </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. ./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> - <sect1 id="install.linux"> - <title>Installation sous Linux</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> - <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> - <programlisting> -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. - </programlisting> - </example> - </sect1> - <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> - <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</ulink>. - </para> - <sect2 id="install.openbsd.ports"> - <title>Utilisation des ports</title> - <simpara> - Ceci est la méthode recommandée d'installation de PHP sous - OpenBSD, car elle prend en compte les dernières modifications et - mises à jour de sécurité. Pour utiliser cette méthode, assurez - vous que vous avez bien - <ulink url="&url.openbsd.ports;">ports tree</ulink> récent. Choisissez - alors simplement la version que vous souhaitez installer, et utilisez - la commande <command>make install</command>. Ci-dessous, voici un - exemple. - </simpara> - <example id="install.openbsd.ports.example"> - <title>Exemple d'installation de PHP sous OpenBSD avec Ports</title> - <programlisting> -$ cd /usr/ports/www/php4 -$ make show VARNAME=FLAVORS - (choisissez les versions que vous souhaitez sur votre liste). -$ env FLAVOR="imap gettext ldap mysql gd" make install -$ /usr/local/sbin/php4-enable - </programlisting> - </example> - </sect2> - <sect2 id="install.openbsd.packages"> - <title>Utilisation des Packages</title> - <simpara> - Il existe des packages pré-compilés disponibles en - téléchargement à <ulink url="&url.openbsd;">OpenBSD</ulink>. - Ils s'intègrent automatiquement avec la version d'Apache - installée sur votre OS. Cependant, comme il y a un - grand nombre d'options (appelées <emphasis>flavors</emphasis>) - disponibles, vous trouverez peut-être plus facile de - le compiler à partir de l'arbre de ports. - Lisez le manuel <ulink url="&url.openbsd.packages;">packages(7)</ulink> - pour plus de détails sur les packages disponibles (en anglais). - </simpara> - </sect2> - </sect1> - <sect1 id="install.macosx"> - <title>Installation sous Mac OS X</title> - <para> - Cette section contient les notes et conseils d'installation de PHP - sur les distributions Mac OS X. - </para> - <sect2 id="install.macosx.packages"> - <title>Utilisation des packages</title> - <simpara> - Il existe quelques versions pré-packagée et - pré-compilées de PHP pour Mac OS X. Ils permettent de - réaliser rapidement des installations standard, mais si vous - avez des configurations personnelles, (comme un serveur sécurisé - SSL ou un pilote de base de données exotique), vous devrez compiler - PHP et/ou votre serveur web vous-même. 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> - <sect2 id="install.macosx.compile"> - <title>Compilation pour serveur OS X</title> - <simpara> - Il existe deux versions légèrement différentes de Mac OS X, - client et serveur. Cette installation est faite pour le OS X Serveur. - </simpara> - <example id="install.macosx.compile.example"> - <title>Installation sous Mac OS X serveur</title> - <programlisting> -1. Téléchargez la dernière version de Apache et PHP -2. Décompressez puis désarchivez la, puis configurez Apache comme ceci : - ./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. Vous aurez peut être besoin d'ajouter ces lignes ci, pour optimiser la -compilation : - setenv OPTIM=-O2 -5. Puis, allez dans le dossier source de PHP 4, et configurez le : - ./configure --prefix=/usr \ - --sysconfdir=/etc \ - --localstatedir=/var \ - --mandir=/usr/share/man \ - --with-xml \ - --with-apache=/src/apache_1.3.12 - Si vous avez d'autres composants (MySQL, GD, etc.), n'oubliez pas de les - ajouter à ce moment la. Pour l'option --with-apache, ajoutez le chemin - jusqu'au dossier source d'Apache, par exemple "/src/apache_1.3.12". -6. Exécutez un "make" -7. Exécutez un "make install" - Cette commande ajoutera un dossier dans le dossier Apache : - src/modules/php4. -8. Maintenant, reconfigurez Apache pour compiler 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 - Vous pouvez rencontrer un message qui vous dira que libmodphp4.a est - obsolète. Si c'est le cas, allez dans le dossier - src/modules/php4 de votre dossier Apache et exécutez la commande suivante : - ranlib libmodphp4.a - Puis, revenez à la racine de la distribution Apache, et recommencez la - configuration. Cela aura mis à jour la table de liens. -9. Exécutez un "make" -10. Exécutez un "make install" -11. Copiez et renommez le fichier php.ini-dist de votre distribution PHP 4 - dans votre dossier "bin": - cp php.ini-dist /usr/local/bin/php.ini - ou (si vous n'avez pas de dossier local) - cp php.ini-dist /usr/bin/php.ini - </programlisting> - </example> - <simpara> - D'autres exemples pour - <ulink url="&url.stepwise.macosx-client;">Mac OS X client</ulink> - et - <ulink url="&url.stepwise.macosx-client;">Mac OS X server</ulink> - sont disponibles à <ulink url="&url.stepwise;">Stepwise</ulink>. - </simpara> - </sect2> - <sect2 id="install.macosx.client"> - <title>Compilation pour MacOS X client</title> - <simpara> - Ces conseils sont gracieusement fourni par <ulink url="&url.macosx;">Marc Liyanage</ulink>. - </simpara> - <simpara> - Le module PHP pour Apache est inclus dans Mac OS X. - Cette version inclus le support des bases de données MySQL et PostgreSQL. - </simpara> - <simpara> - NOTE: Soyez prudent avec cette manipulation, vous risquez de mettre - votre serveur Apache à terre! - </simpara> - <para> - Insctructions : - <itemizedlist> - <listitem> - <simpara> - 1. Ouvrez un terminal - </simpara> - </listitem> - <listitem> - <simpara> - 2. Tapez "wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz", - attendez la fin du 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 ouvrira le fichier de configuration. Recherchez ces deux lignes, vers la - fin du fichier (Utilisez la commande Find) - <programlisting> - * #AddType application/x-httpd-php .php - * #AddType application/x-httpd-php-source .phps - </programlisting> - Supprimez les deux marques de commentaires (<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 fonctionner. Vous pouvez le tester en placant un script dans le dossier - "Sites". Par exemple, le fichier "test.php", qui contient la simple ligne : - "<literal><?php phpinfo() ?></literal>". - </para> - <para> - Ouvrez l'URL <literal>127.0.0.1/~your_username/test.php</literal> dans votre - navigateur. Vous obtiendrez le tableau de bord de PHP. - </para> - </sect2> - </sect1> - <sect1 id="install.configure"> - <title>Liste complète des options de configuration</title> - <para> - Cette section rassemble la liste complète des options de configuration - supportées par PHP 3 et PHP 4, à utiliser avec le fichier - <filename>configure</filename>, lors de la configuration sous Unix. - Certaines options sont disponibles sous PHP 3, d'autres sous - PHP 4 et certains sous PHP 3 et PHP 4, comme inidiqué. Il y a de - nombreuses options dont le nom a changé entre PHP 3 et PHP 4. Ces - options ont des liens entre elles : si vous vous souvenez d'un - nom d'option en PHP 3, regardez si le nom a changé. - </para> - <itemizedlist> - <listitem> - <para> - <link linkend="install.configure.databases">Base de données</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.ecommerce">E-commerce</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.graphics">Images</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.misc">Divers</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.networking">Réseau</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.php">Comportement PHP</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.servers">Serveur</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.text">Texte et langue</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.xml">XML</link> - </para> - </listitem> - </itemizedlist> - <sect2 id="install.configure.databases"> - <title>Base de données</title> - <variablelist> - <varlistentry id="install.configure.with-adabas"> - <term> - <parameter>--with-adabas[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Adabas D. DIR est le dossier - d'installation de Adabas (par défaut, <literal>/usr/local</literal>). - </para> - <para> - <ulink url="&url.adabas;">Adabas home page</ulink> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dba"> - <term> - <parameter>--enable-dba=shared</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile DBA comme module partagé - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dbx"> - <term> - <parameter>--enable-dbx</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support DBX. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dbase"> - <term> - <parameter>--enable-dbase</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-dbase">--with-dbase</link> - instead. - </para> - <para> - PHP 4: Active la librairie dbase livrée avec PHP. Aucune librairie - supplémentaire n'est nécessaire. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-dbase"> - <term> - <parameter>--with-dbase</parameter> - </term> - <listitem> - <para> - PHP 3: Active la librairie dbase livrée avec PHP. Aucune librairie - supplémentaire n'est nécessaire. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-dbase">--enable-dbase</link> - instead. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-db2"> - <term> - <parameter>--with-db2[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support Berkeley DB2. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-db3"> - <term> - <parameter>--with-db3[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Berkeley DB3. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-dbm"> - <term> - <parameter>--with-dbm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support DBM. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-dbmaker"> - <term> - <parameter>--with-dbmaker[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3. - </para> - <para> - PHP 4: Inclut le support DBMaker. DIR est le dossier d'installation - DBMaker (par défaut, c'est le dossier de la dernière installation - DBMaker, comme <literal>/home/dbmaker/3.6</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-empress"> - <term> - <parameter>--with-empress[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Empress. DIR est le dossier - d'installation Empress (par défaut, <literal>$EMPRESSPATH</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-filepro"> - <term> - <parameter>--enable-filepro</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-filepro">--with-filepro</link> - instead. - </para> - <para> - PHP 4: Active la librairie filePro (lecture seule) livrée avec PHP. - Aucune librairie supplémentaire n'est nécessaire. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-fbsql"> - <term> - <parameter>--with-fbsql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible. - </para> - <para> - PHP 4: Inclut le support de FrontBase SQL. DIR est le chemin - jusqu'à l'installation de FrontBase base. Par défaut, c'est le dossier - standard d'installation Frontbase. L'installation dépend de votre - OS : Solaris: <literal>/opt/FrontBase</literal>, - WinNT: <literal>\usr\FrontBase</literal>, - Linux: <literal>/usr/frontbase</literal>, - Mac OSX: <literal>/Library/FrontBase</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-filepro"> - <term> - <parameter>--with-filepro</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support IBM DB2. - Aucune librairie supplémentaire n'est nécessaire. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-filepro">--enable-filepro</link>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gdbm"> - <term> - <parameter>--with-gdbm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support GDBM. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-hyperwave"> - <term> - <parameter>--with-hyperwave</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support Hyperwave. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ibm-db2"> - <term> - <parameter>--with-ibm-db2[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support IBM DB2. DIR est le dossier - d'installation de DB2 (par défaut, - <filename>/home/db2inst1/sqllib</filename>). - </para> - <para> - <ulink url="&url.ibmdb2;">IBM DB2</ulink> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-informix"> - <term> - <parameter>--with-informix[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Informix. DIR est le dossier - d'installation d'Informix (par défaut, aucune valeur). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ingres"> - <term> - <parameter>--with-ingres[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Ingres II. DIR est le dossier - d'installation d'Ingres (par défaut, <literal>/II/ingres</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-interbase"> - <term> - <parameter>--with-interbase[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support InterBase. DIR est le dossier - d'installation d'InterBase (par défaut, - <filename>/usr/interbase</filename>). - </para> - <simpara> - <link linkend="ref.ibase">Fonctions Interbase</link> - </simpara> - <simpara> - <ulink url="&url.ibase;">Interbase</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ldap"> - <term> - <parameter>--with-ldap[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support LDAP. DIR est le dossier - d'installation de LDAP (par défaut <filename>/usr</filename> et - <filename>/usr/local</filename>). - </para> - <para> - PHP 4: Inclut le support LDAP. DIR est le dossier - d'installation de LDAP. (par défaut; - <filename class="directory">/usr/local/ldap</filename>). - </para> - <simpara> - Plus de détails sur LDAP sont disponibles à - <ulink url="&url.rfc;rfc1777.html">RFC1777</ulink> et - <ulink url="&url.rfc;rfc1778.html">RFC1778</ulink>. - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-msql"> - <term> - <parameter>--with-msql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support mSQL. DIR est le dossier - d'installation de mSQL (par défaut <filename>/usr</filename> et - <filename>/usr/local/Hughes</filename>, pour la version 2.0). - <command>configure</command> détecte automatiquement la version - de mSQL qui fonctionne. PHP supporte les versions 1.0 et 2.0, - mais si vous compilez PHP avec mSQL 1.0, vous ne pourrez accéder qu'à - des bases mSQL 1.0, et vice-versa. - </para> - <simpara> - Voir aussi - <link linkend="ini.sect.msql">Configuration mSQL</link> dans le - fichier de <link linkend="configuration.file">configuration</link>. - </simpara> - <simpara> - <ulink url="&url.msql;">mSQL</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mysql"> - <term> - <parameter>--with-mysql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support MySQL. DIR est le dossier - d'installation de MySQL (par défaut, il cherche dans différents - dossiers où MySQL a coutume d'être installé). - </para> - <para> - PHP 4: Inclut le support MySQL. DIR est le dossier de l'installation - MySQL. S'il est omis, la librairie MySQL livrée en standard avec - PHP sera utilisée par défaut. - </para> - <para> - Voir aussi - <link linkend="ini.sect.mysql">Configuration MySQL</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </para> - <para> - <ulink url="&url.mysql;">MySQL</ulink> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ndbm"> - <term> - <parameter>--with-ndbm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support NDBM. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ovrimos"> - <term> - <parameter>--with-ovrimos</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Ovrimos. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-oci8"> - <term> - <parameter>--with-oci8[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Oracle-oci8. DIR est le dossier - d'installation de Oracle-oci8 (par défaut, - <filename>ORACLE_HOME</filename>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-oracle"> - <term> - <parameter>--with-oracle[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support Oracle database. DIR est le dossier - d'installation de Oracle (par défaut, - <filename>$ORACLE_HOME</filename>). - </para> - <para> - PHP 4: Inclut le support Oracle-oci7. DIR est le dossier - d'installation de Oracle-oci7 (par défaut, - <filename>ORACLE_HOME</filename>). - </para> - <simpara> - Inclut le support Oracle. Ce support a été testé et permet de travailler - avec les versions d'Oracle de 7.0 à 7.3. Le paramètre - est le dossier <envar>ORACLE_HOME</envar>. Vous n'avez pas à - spécifier ce paramètre si votre environnement Oracle a été - configuré. - </simpara> - <simpara> - <ulink url="&url.oracle;">Oracle</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pgsql"> - <term> - <parameter>--with-pgsql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support PostgresSQL. DIR est le dossier - d'installation de PostgresSQL (par défaut, - <filename>/usr/local/pgsql</filename>). - </para> - <para> - PHP 4: Inclut le support PostgreSQL. DIR est le dossier - d'installation de PostgreSQL (par défaut, - <filename>/usr/local/pgsql</filename>). Pour compiler en "dl", - utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", - mais spécifier DIR malgré tout. - </para> - <simpara> - Voir aussi <link linkend="ini.sect.pgsql">Postgres</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - <simpara> - <ulink url="&url.pgsql;">PostgreSQL</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-solid"> - <term> - <parameter>--with-solid[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Solid. DIR est le dossier - d'installation de Solid (par défaut, - <literal>/usr/local/solid</literal>). - </para> - <simpara> - <ulink url="&url.solid;">Solid</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-sybase-ct"> - <term> - <parameter>--with-sybase-ct[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Sybase-CT. DIR est le dossier - d'installation de Sybase (par défaut, - <literal>/home/sybase</literal>). - </para> - <simpara> - Voir aussi <link linkend="ini.sect.sybct">Sybase-CT</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-sybase"> - <term> - <parameter>--with-sybase[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Sybase-DB. DIR est le dossier - d'installation de Sybase (par défaut, <filename>/home/sybase</filename>). - </para> - <simpara> - Voir aussi <link linkend="ini.sect.sybase">Sybase</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - <simpara> - <ulink url="&url.sybase;">Sybase</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-openlink"> - <term> - <parameter>--with-openlink[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support OpenLink ODBC. DIR est le dossier - d'installation d'OpenLink (par défaut - <literal>/usr/local/openlink</literal>). - A partir de PHP 4.0.6, cette option n'est plus valable. - Utilisez plutôt <link linkend="install.configure.with-iodbc"><option> - --with-iodbc</option></link> si vous voulez - utiliser l'ODBC de OpenLink Software. - </para> - <simpara> - <ulink url="&url.openlink;">OpenLink Software</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-iodbc"> - <term> - <parameter>--with-iodbc[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support iODBC. DIR est le dossier - d'installation d'iODBC (par défaut, <filename>/usr/local</filename>). - </para> - <para> - Cette fonctionnalité a d'abord été - développée avec le gestionnaire - iODBC Driver Manager, un pilote ODBC librement distribuable, qui - fonctionne sous divers UNIX. - </para> - <simpara> - <ulink url="&url.freeodbc;">FreeODBC</ulink> - ou <ulink url="&url.iodbc;">iODBC</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-custom-odbc"> - <term> - <parameter>--with-custom-odbc[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support ODBC, avec une librairie tierce. - Le paramètre DIR est le nom du dossier d'installation de cette - librairie. Par défaut, il vaut - <filename class="directory">/usr/local</filename>. - </para> - <simpara> - Cette option implique qus vous avez défini CUSTOM_ODBC_LIBS - lorsque vous éxécutez le script de configuration. - Vous devez aussi avoir une en-tête <filename>odbc.h</filename> valide dans vos - dossiers d'Inclution. Si vous n'en avez pas, créez le, et - ajoutez-y vos en-têtes spécifiques. Votre en-tête peut - aussi réclamer d'autres définitions, surtout si elle - est multi-plate-forme. Définissez les dans CFLAGS. - </simpara> - <simpara> - Par exemple, vous pouvez utilisez Sybase SQL Anywhere sous QNX comme - ceci : - <literal> - CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib - -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50 - </literal> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-unified-odbc"> - <term> - <parameter>--disable-unified-odbc</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive le support unified ODBC. Uniquement valable si - iODBC, Adabas, Solid, Velocis ou une interface spéciale ODBC - a été activée. - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - <simpara> - Le module Unified ODBC est commun à toutes les bases de données - ODBC, comme par exemple Solid, IBM DB2 et Adabas D. Il fonctionne - aussi avec les librairies ODBC normales. Des tests ont été menés - avec iODBC, Solid, Adabas D, IBM DB2 et Sybase SQL Anywhere. - Il requiert une (et une seule) de ces extensions, ou l'extension - Velocis, ou une librairie ODBC spéciale. Cette option n'est - possible qu'avec l'utilisation de l'une des options suivantes : - <link linkend="install.configure.with-iodbc">--with-iodbc</link>, - <link linkend="install.configure.with-solid">--with-solid</link>, - <link linkend="install.configure.with-ibm-db2">--with-ibm-db2</link>, - <link linkend="install.configure.with-adabas">--with-adabas</link>, - <link linkend="install.configure.with-velocis">--with-velocis</link>, - ou - <link linkend="install.configure.with-custom-odbc">--with-custom-odbc</link>. - </simpara> - <simpara> - Voir aussi <link linkend="ini.sect.uodbc">Unified ODBC</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-unixODBC"> - <term> - <parameter>--with-unixODBC[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support unixODBC. DIR est le dossier - d'installation d'unixODBC (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-velocis"> - <term> - <parameter>--with-velocis[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclus le support Velocis. DIR est le dossier - d'installation de Velocis (par défaut, - <literal>/usr/local/velocis</literal>). - </para> - <simpara> - <ulink url="&url.velocis;">Velocis</ulink> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.ecommerce"> - <title>E-commerce</title> - <variablelist> - <varlistentry id="install.configure.with-ccvs"> - <term> - <parameter>--with-ccvs[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Ajoute le support CCVS. DIR est le dossier d'installation - de CCVS. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cybermut"> - <term> - <parameter>--with-cybermut[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support de Cybermut pour PHP 4. DIR est le dossier - du SDK Cybermut, qui contient les deux fichiers <filename>libcm-mac.a</filename> - et <filename>cm-mac.h</filename>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mck"> - <term> - <parameter>--with-mck[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support Cybercash MCK. DIR est le dossier - d'installation de cybercash mck (par défaut, - <filename>/usr/src/mck-3.2.0.3-linux</filename>). Plus d'aide dans - le dossier <filename>extra/cyberlib</filename>. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-cybercash">--with-cybercash</link> - instead. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cybercash"> - <term> - <parameter>--with-cybercash[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-mck">--with-mck</link> - instead. - </para> - <para> - PHP 4: Inclut le support CyberCash. DIR est le dossier - d'installation de CyberCash MCK. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pfpro"> - <term> - <parameter>--with-pfpro[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Verisign Payflow Pro. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.graphics"> - <title>Images</title> - <variablelist> - <varlistentry id="install.configure.enable-freetype-4bit-antialias-hack"> - <term> - <parameter>--enable-freetype-4bit-antialias-hack</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support de FreeType2 (expérimental). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gd"> - <term> - <parameter>--with-gd[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support GD. DIR est le dossier - d'installation de GD. - </para> - <para> - PHP 4: Inclut le support GD. DIR est le dossier - d'installation de GD. Pour compiler en "dl", - utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", - mais spécifier DIR malgré tout. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.without-gd"> - <term> - <parameter>--without-gd</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inactive le support GD . - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-imagick"> - <term> - <parameter>--with-imagick[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support ImageMagick. DIR est le dossier - d'installation de ImageMagick. S'il est omis, PHP essaiera de - le trouver de lui-même (expérimental). - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-jpeg-dir"> - <term> - <parameter>--with-jpeg-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: dossier JPEG pour pdflib 2.0 - </para> - <para> - PHP 4: dossier JPEG pour pdflib 3.x et 4.x - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-png-dir"> - <term> - <parameter>--with-png-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: dossier PNG pour pdflib 3.x et 4.x - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-t1lib"> - <term> - <parameter>--enable-t1lib</parameter> - </term> - <listitem> - <para> - PHP 3: Active le support t1lib. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-t1lib">--with-t1lib</link> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-t1lib"> - <term> - <parameter>--with-t1lib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-t1lib">--enable-t1lib</link>. - </para> - <para> - PHP 4: Inclut le support T1lib. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-tiff-dir"> - <term> - <parameter>--with-tiff-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: dossier TIFF pour pdflib 2.0 - </para> - <para> - PHP 4: dossier TIFF pour pdflib 3.x et 4.x - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ttf"> - <term> - <parameter>--with-ttf[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support FreeType. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-xpm-dir"> - <term> - <parameter>--with-xpm-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: dossier XPM pour GD-1.8+ - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.misc"> - <title>Divers</title> - <para> - Ces options seront classées ultérieurement, lorsqu'une catégorie - adéquate apparaîtra. - </para> - <variablelist> - <varlistentry id="install.configure.disable-bcmath"> - <term> - <parameter>--disable-bcmath</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive la librairie BCmath. - </para> - <para> - PHP 4: Option non disponible en PHP 4. La librairie BCmath n'est pas - compilée par défaut. Utilisez - <link linkend="install.configure.enable-bcmath">--enable-bcmath</link> - pour l'inclure. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.gmp"> - <term> - <parameter>--with-gmp</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4 : Inclut le support GMP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-display-source"> - <term> - <parameter>--disable-display-source</parameter> - </term> - <listitem> - <para> - PHP 3: Compile sans afficher le support des sources - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-libtool-lock"> - <term> - <parameter>--disable-libtool-lock</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Empêche le verrouillage (risque d'empêcher certaines - compilations paralléles). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-pear"> - <term> - <parameter>--disable-pear</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: N'installe pas PEAR - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-pic"> - <term> - <parameter>--disable-pic</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inactive PIC pour les shared objects - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-posix"> - <term> - <parameter>--disable-posix</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3; Utilisez plutôt <link - linkend="install.configure.without-posix">--without-posix</link> - </para> - <para> - PHP 4: Inactive les fonctions POSIX. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-rpath"> - <term> - <parameter>--disable-rpath</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inactive le passage de chemins supplémentaires - pour la recherche de librairie lors de l'exécution. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-session"> - <term> - <parameter>--disable-session</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inactive le support session. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-bcmath"> - <term> - <parameter>--enable-bcmath</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3; bcmath est compilée par - défaut. Utilisez plutôt - <link linkend="install.configure.disable-bcmath">--disable-bcmath</link>, - pour l'inactiver. - </para> - <para> - PHP 4: Active le support de l'extension bc maths. - Voir aussi <link linkend="ref.bc">les fonctions BCMath</link>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-c9x-inline"> - <term> - <parameter>--enable-c9x-inline</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active les sémantiques C9x-inline - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-calendar"> - <term> - <parameter>--enable-calendar</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support des conversions calendaires - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-debug"> - <term> - <parameter>--enable-debug</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile sans les symboles de débuggages - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-debugger"> - <term> - <parameter>--enable-debugger</parameter> - </term> - <listitem> - <para> - PHP 3: Compile avec les fonctions de débuggage à distance - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-discard-path"> - <term> - <parameter>--enable-discard-path</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Si cette option est activée, le CGI PHP peut être - placé hors de l'arborescence web, pour que personne ne puisse l'atteindre, - même en contournant les .htaccess. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dmalloc"> - <term> - <parameter>--enable-dmalloc</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active dmalloc - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-exif"> - <term> - <parameter>--enable-exif</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support exif. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-experimental-zts"> - <term> - <parameter>--enable-experimental-zts</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Cela risque fortement de ne plus compiler du tout! - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-fast-install"> - <term> - <parameter>--enable-fast-install[=PKGS]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Optimise pour les installations rapides for fast installation - (par défaut, <literal>no</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-force-cgi-redirect"> - <term> - <parameter>--enable-force-cgi-redirect</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active la vérification interne des redirections serveurs. - Il est recommandé d'utiliser cette option si vous avez compilé - PHP en CGI. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-inline-optimization"> - <term> - <parameter>--enable-inline-optimization</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Si vous avez beaucoup de mémoire disponible et que vous - utilisez gcc, essayez donc ça. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-libgcc"> - <term> - <parameter>--enable-libgcc</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active explicitement les liens avec libgcc - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-maintainer-mode"> - <term> - <parameter>--enable-maintainer-mode</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active des règles de make et de dépendances qui - sont parfois absconses et ne servent pas aux utilisateurs - habituels (Bref, ne l'utilisez pas). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-memory-limit"> - <term> - <parameter>--enable-memory-limit</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile avec le support de la limitation de mémoire - (par défaut, <literal>no</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-safe-mode"> - <term> - <parameter>--enable-safe-mode</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le SAFE_MODE (par défaut, <literal>yes</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-satellite"> - <term> - <parameter>--enable-satellite</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support CORBA via Satellite (Requiert ORBit) - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-shared"> - <term> - <parameter>--enable-shared[=PKGS]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile les librairies partagées - (par défaut, <literal>yes</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sigchild"> - <term> - <parameter>--enable-sigchild</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le gestionnaire SIGCHLD propre à PHP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-static"> - <term> - <parameter>--enable-static[=PKGS]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile les librairies en statique - (par défaut, <literal>yes</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sysvsem"> - <term> - <parameter>--enable-sysvsem</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support des sémaphores System V. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sysvshm"> - <term> - <parameter>--enable-sysvshm</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support de partage de mémoire System V. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-trans-sid"> - <term> - <parameter>--enable-trans-sid</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active la propagation transparente des identifiants de session. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cdb"> - <term> - <parameter>--with-cdb[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support CDB. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-config-file-path"> - <term> - <parameter>--with-config-file-path=PATH</parameter> - </term> - <listitem> - <para> - PHP 3: Indique le chemin dans lequel aller lire le fichier - <filename>php3.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. - </para> - <para> - PHP 4: Indique le chemin dans lequel allet lire le fichier - <filename>php.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cpdflib"> - <term> - <parameter>--with-cpdflib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support ClibPDF. DIR est le dossier - d'installation de ClibPDF (par défaut, <literal>/usr/local</literal>). - </para> - <para> - PHP 4: Inclut le support ClibPDF.(requires cpdflib >= 2). - DIR est le dossier d'installation de cpdfllib (par défaut, - <literal>/usr</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-esoob"> - <term> - <parameter>--with-esoob[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Easysoft OOB. DIR est le dossier - d'installation de OOB (par défaut, - <literal>/usr/local/easysoft/oob/client</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-exec-dir"> - <term> - <parameter>--with-exec-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: N'autorise que les exécutables placés dans le dossier - DIR, lorsque le SAFE MODE est activé (par défaut, c'est - <literal>/usr/local/php/bin</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-fdftk"> - <term> - <parameter>--with-fdftk[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support fdftk. DIR est le dossier - d'installation de fdftk (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gnu-ld"> - <term> - <parameter>--with-gnu-ld</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Suppose que le compilateur C utilise GNU ld - (par défaut, <literal>no</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-icap"> - <term> - <parameter>--with-icap[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support ICAP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-imap"> - <term> - <parameter>--with-imap[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support IMAP. DIR est le dossier - d'include d'IMAP (et aussi c-client.a). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-imsp"> - <term> - <parameter>--with-imsp[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support IMSP.(DIR est le dossier d'installation - IMSP, là où il y a les dossiers d'include et libimsp.a). - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-java"> - <term> - <parameter>--with-java[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Java. DIR est le dossier - d'installation du JDK). Cette extension peut uniquement être - compilée comme "dl". - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-kerberos"> - <term> - <parameter>--with-kerberos[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Kerberos dans IMAP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mcal"> - <term> - <parameter>--with-mcal[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support MCAL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mcrypt"> - <term> - <parameter>--with-mcrypt[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support mcrypt. DIR est le dossier - d'installation de mcrypt. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mhash"> - <term> - <parameter>--with-mhash[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support mhash. DIR est le dossier - d'installation de mhash. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mm"> - <term> - <parameter>--with-mm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support mm pour le stockage de session. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mod_charset"> - <term> - <parameter>--with-mod_charset</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le transfert des tables depuis le module Apache - mod_charset (Rus Apache). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pdflib"> - <term> - <parameter>--with-pdflib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support pdflib (testé avec 0.6 et 2.0). DIR est - le dossier d'installation de pdflib (par défaut, c'est - <filename>/usr/local</filename>). - </para> - <para> - PHP 4: Inclut le support pdflib 3.x/4.x. DIR est le dossier - d'installation de pdflib. Par défaut, c'est <filename>/usr/local</filename>. - </para> - <para> - PHP 4 et PDFlib 3.x/4.x requiert les librairies JPEG et TIFF. - Lors de la compilation du support PDFlib utilise les options - <link linkend="install.configure.with-jpeg-dir">--with-jpeg-dir</link> et - <link linkend="install.configure.with-tiff-dir">--with-tiff-dir</link>. - Vous pouvez aussi utiliser - <link linkend="install.configure.with-png-dir">--with-png-dir</link> et - <link linkend="install.configure.with-zlib-dir">--with-zlib-dir</link>, - pour compiler le support PNG et Zlib avec PDFlib. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-shared-pdflib"> - <term> - <parameter>--enable-shared-pdflib</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut pdflib comme shared librairy. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-readline"> - <term> - <parameter>--with-readline[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support readline. DIR est le dossier - d'installation de readline. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-regex"> - <term> - <parameter>--with-regex=TYPE</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Type de librairie d'expressions régulières : - système, apache, php - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-servlet"> - <term> - <parameter>--with-servlet[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support servlet. DIR est le dossier - d'installation de JSDK. Ce SAPI demande que l'extension - Java soit compilée comme shared dl. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ming"> - <term> - <parameter>--with-ming</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Flash 4 avec Ming. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-swf"> - <term> - <parameter>--with-swf[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support SWF. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-system-regex"> - <term> - <parameter>--with-system-regex</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive la librairie d'expressions régulières - livrée avec PHP. - </para> - <para> - PHP 4: (Obsolète) Utilise la librairie d'expressions - régulières système. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-tsrm-pth"> - <term> - <parameter>--with-tsrm-pth[=pth-config]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Utilise GNU Pth. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-tsrm-pthreads"> - <term> - <parameter>--with-tsrm-pthreads</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Utilise les threads POSIX (par défaut). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-x"> - <term> - <parameter>--with-x</parameter> - </term> - <listitem> - <para> - PHP 3: Utilise X Window System - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-bzip2-dir"> - <term> - <parameter>--with-bz2[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 4: Ajoute le support bzip2. DIR - est le dossier d'installation de bzip2. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zlib-dir"> - <term> - <parameter>--with-zlib-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Dossier zlib pour pdflib 2.0 ou active le support zlib. - </para> - <para> - PHP 4: Dossier zlib pour pdflib 3.x/4.x ou active le support zlib. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zlib"> - <term> - <parameter>--with-zlib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support zlib. (requiert zlib >= 1.0.9). DIR - est le dossier d'installation de zlib (par défaut, <literal>/usr</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zziplib"> - <term> - <parameter>--with-zziplib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 4: Inclut le support ZZIPlib (requiert ZZIPlib >= 0.10.6). DIR - est le dossier d'installation de ZZIPliby (par défaut, - <literal>/usr/local</literal>). - </para> - <para> - La dernière version de ZZIPlib est disponible à - <ulink url="&url.zziplib;">&url.zziplib;</ulink>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.without-pcre-regex"> - <term> - <parameter>--without-pcre-regex</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive le support des expressions régulières Perl. - </para> - <para> - PHP 4: Inactive le support des expressions régulières Perl. Utilisez - --with-pcre-regex=DIR pour spécifier le dossier d'installation de - PCRE, si vous n'utilisez pas la librairie livrée en standard. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.without-posix"> - <term> - <parameter>--without-posix</parameter> - </term> - <listitem> - <para> - PHP 3: N'Inclut pas lrs fonctions POSIX. - </para> - <para> - PHP 4: Option non disponible en PHP 4; utilisez plutôt - <link linkend="install.configure.disable-posix">--disable-posix</link>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.networking"> - <title>Réseau</title> - <variablelist> - <varlistentry id="install.configure.with-curl"> - <term> - <parameter>--with-curl[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support CURL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-ftp"> - <term> - <parameter>--enable-ftp</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-ftp">--with-ftp</link> - </para> - <para> - PHP 4: Active le support FTP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ftp"> - <term> - <parameter>--with-ftp</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support FTP. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-ftp">--enable-ftp</link> - instead - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-url-fopen-wrapper"> - <term> - <parameter>--disable-url-fopen-wrapper</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inactive le support des URL avec <function>fopen</function>. - </para> - <warning> - <para> - Cette option n'est disponible que jusqu'à la version 4.0.3. Les - versions plus récentes fournissent un paramètre dans le - fichier <filename>php.ini</filename> appelé <parameter>allow_url_fopen</parameter>, - afin de vous éviter de faire ce choix au moment de la - compilation. - </para> - </warning> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mod-dav"> - <term> - <parameter>--with-mod-dav=DIR</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support DAV, grâce au module Apache mod_dav. - DIR est le dossier d'installation de mod_dav (valable uniquement pour les serveurs - Apache). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-openssl"> - <term> - <parameter>--with-openssl[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support OpenSSL avec SNMP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-snmp"> - <term> - <parameter>--with-snmp[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support SNMP. DIR est le dossier - d'installation de SNMP (par défaut, il scanne un nombre de - dossiers habituels de l'installation SNMP). Utilisez la valeur de - "shared" pour compiler sous forme de "dl", ou "shared,DIR" - pour compiler sous forme de "dl" tout en spécifiant un dossier. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-ucd-snmp-hack"> - <term> - <parameter>--enable-ucd-snmp-hack</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le hack UCD SNMP - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sockets"> - <term> - <parameter>--enable-sockets</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support des sockets. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-yaz"> - <term> - <parameter>--with-yaz[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support YAZ.(ANSI/NISO Z39.50). DIR est le dossier - d'installation de YAZ (dossier bin). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-yp"> - <term> - <parameter>--enable-yp</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-yp">--with-yp</link> - </para> - <para> - PHP 4: Active le support YellowPages (YP). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-yp"> - <term> - <parameter>--with-yp</parameter> - </term> - <listitem> - <para> - PHP 3: Active le support YellowPages (YP). - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-yp">--enable-yp</link> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mnogosearch"> - <term> - <parameter>--with-mnogosearch</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support mnoGoSearch. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.php"> - <title>Comportement PHP</title> - <variablelist> - <varlistentry id="install.configure.enable-magic-quotes"> - <term> - <parameter>--enable-magic-quotes</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active les magic quotes par défaut. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-short-tags"> - <term> - <parameter>--disable-short-tags</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Désactive la forme courte des balises PHP (<? ?>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-track-vars"> - <term> - <parameter>--enable-track-vars</parameter> - </term> - <listitem> - <para> - PHP 3: Active le suivi des variables GET/POST/Cookie par défaut. - </para> - <para> - PHP 4: Option non disponible en PHP 4; à partir de - PHP 4.0.2, cette option est toujours activée. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.servers"> - <title>Serveur</title> - <variablelist> - <varlistentry id="install.configure.with-aolserver-src"> - <term> - <parameter>--with-aolserver-src=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Indique le chemin jusqu'à la distribution source - de AOLserver - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-aolserver"> - <term> - <parameter>--with-aolserver=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Indique le chemin jusqu'à la distribution installée - de AOLserver. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-apache"> - <term> - <parameter>--with-apache[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile PHP en module Apache. DIR est le dossier - d'installation supérieur d'Apache (par défaut, - <literal>/usr/local/etc/httpd</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-apxs"> - <term> - <parameter>--with-apxs[=FILE]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile PHP comme module partagé d'Apache module. FILE - est le chemin optionnel jusqu'à Apache apxs tool; par défaut, - c'est apxs). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-versioning"> - <term> - <parameter>--enable-versioning</parameter> - </term> - <listitem> - <para> - PHP 3: Tire profit du système de versionnage et de scoping fourni - par Solaris 2.x et Linux - </para> - <para> - PHP 4: Exporte uniquement les symboles nécessaires. Voyez l'installation - pour plus de détails. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-caudium"> - <term> - <parameter>--with-caudium[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP sous forme de module Pike pour être utilisé avec le - serveur web Caudium. DIR est le dossier - d'installation de Caudium (par défaut, - <literal>$prefix/caudium/server</literal>. Le préfixe est paramétré - par l'option --prefix (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-fhttpd"> - <term> - <parameter>--with-fhttpd[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile PHP comme module fhttpd. DIR est le dossier - d'installation de fhttpd (par défaut, - <literal>/usr/local/src/fhttpd</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-nsapi"> - <term> - <parameter>--with-nsapi=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Indique le chemin jusqu'au serveur Netscape - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-phttpd"> - <term> - <parameter>--with-phttpd=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pi3web"> - <term> - <parameter>--with-pi3web=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP comme module pour Pi3Web. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-roxen"> - <term> - <parameter>--with-roxen=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP comme module pour Pi3Web Pike. DIR est le dossier - d'installation de Roxen (par défaut, - <literal>/usr/local/roxen/server</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-roxen-zts"> - <term> - <parameter>--enable-roxen-zts</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile le module Roxen en utilisant - Zend Thread Safety. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-thttpd"> - <term> - <parameter>--with-thttpd=SRCDIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zeus"> - <term> - <parameter>--with-zeus=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP comme module ISAPI pour Zeus. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.text"> - <title>Texte et langue</title> - <variablelist> - <varlistentry id="install.configure.with-aspell"> - <term> - <parameter>--with-aspell[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support ASPELL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gettext"> - <term> - <parameter>--with-gettext[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support GNU gettext. DIR est le dossier - d'installation de gettext (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-iconv"> - <term> - <parameter>--with-iconv[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support iconv. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pspell"> - <term> - <parameter>--with-pspell[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support PSPELL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-recode"> - <term> - <parameter>--with-recode[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support GNU recode. - </para> - <para> - PHP 4: Inclut le support recode. DIR est le dossier - d'installation de recode. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-shmop"> - <term> - <parameter>--enable-shmop</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4 : Inclut le support shmop. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.xml"> - <title>XML</title> - <variablelist> - <varlistentry id="install.configure.with-dom"> - <term> - <parameter>--with-dom[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support DOM. (requiert libxml >= 2.0). - DIR est le dossier d'installation de libxml (par défaut, - <filename>/usr</filename>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sablot-errors-descriptive"> - <term> - <parameter>--enable-sablot-errors-descriptive</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active les erreurs descriptives. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-sablot"> - <term> - <parameter>--with-sablot[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Sablotron. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-wddx"> - <term> - <parameter>--enable-wddx</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support WDDX. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-xml"> - <term> - <parameter>--disable-xml</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3; Les fonctions XML - ne sont pas construites par défaut. Utilisez plutôt - <link linkend="install.configure.with-xml">--with-xml</link> - pour les activer. - </para> - <para> - PHP 4: Inactive le support XML, qui utilise la librairie expat, - livrée avec PHP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-xml"> - <term> - <parameter>--with-xml</parameter> - </term> - <listitem> - <para> - PHP 3: Active le support XML. - </para> - <para> - PHP 4: Option non disponible en PHP 4; Le support XML est - activé par défaut. Utilisez plutôt - <link linkend="install.configure.disable-xml">--disable-xml</link> pour - l'inactiver. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - </sect1> - <sect1 id="install.windows"> - <title>Installation sous Windows 9x/ME/NT/2000</title> - <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;">téléchargement</ulink>, installe la version - CGI de PHP, et configure les serveurs web IIS, PWS, et Xitami. - </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 <filename>php.ini</filename> 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> - </sect2> - <sect2 id="install.windows.manual"> - <title>Instructions Générales d'installation</title> - <simpara> - Ce guide vous permet d'installer et de configurer manuellement - PHP sur vos stations Windows 9x/Me/NT/2000. 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> - </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. Notez cependant que les - modules SAPI <emphasis>ne sont pas</emphasis> considéré comme ayant - atteint une qualité de production. La raison à cela est que - les modules SAPI utilisent le système de thread sécurisé de - PHP, ce qui est nouveau en PHP 4, et qui n'a pas été testé et - torturé suffisamment pour être considérés comme stable. - Il y a encore - quelques bugs qui trainent. D'un autre côté, certains d'entre - vous ont rapporté des résultats significativement meilleurs avec - les modules SAPI, même si nous ne connaissons actuellement personne - qui le fasse fonctionner en production. En clair, faites votre choix : - soit vous avez absolument besoin de stabilité, et il vaut mieux - laisser les performances SAPI de côté; soit vous avez besoin de - performances, et alors c'est l'occasion de tester en production - et de nous rapporter vos résultats. - </para> - <para> - Si vous choisissez l'un des modules SAPI et utilisez Windows 95, - pensez à télécharger la mise à jour DCOM à - <ulink url="http://download.microsoft.com/msdownload/dcom/95/x86/en/dcom95.exe">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> - 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 95/98</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). - </member> - </simplelist> - </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 '<filename>php.ini</filename>'. Votre dossier - '%WINDOWS%' ou '%SYSTEMROOT%' est généralement : - <simplelist> - <member>c:\windows pour Windows 95/98</member> - <member>c:\winnt ou c:\winnt40 pour les serveurs NT/2000</member> - </simplelist> - </para> - </listitem> - <listitem> - <para> - Editez votre fichier <filename>php.ini</filename> : - <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 - </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. Vous pouvez décommenter les lignes - 'extension=php_*.dll' pour charger ces modules. - Certains modules requièrent que des librairies - supplémentaires soient installées sur votre - système. La <ulink url="&url.php.faq;">FAQ</ulink> - PHP a plus d'informations sur ces librairies. Vous pouvez - aussi charger dynamiquement ces librairies avec - <command>dl("php_*.dll");</command>. Voyez la - section sur les - <link linkend="install.windows.extensions">extensions Windows</link>. - </simpara> - </listitem> - <listitem> - <simpara> - Sous PWS et IIS, vous pouvez modifier le fichier - <filename>browscap.ini</filename> pour qu'il pointe sur : - <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous - Windows 95/98 et <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> - sous NT. - </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.prepare"> - <title>Préparation</title> - <para> - Avant de commencer, il faut télécharger un maximum de fichiers! - </para> - <itemizedlist> - <listitem> - <simpara> - Pour commencer, téléchargez le Cygwin depuis le miroir <ulink - url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink> - le plus proche. Cela vous donnera les utilitaires GNU les plus - populaires, utilisés durant le processus de compilation. - </simpara> - </listitem> - <listitem> - <simpara> - Téléchargez le reste des utilitaires de compilation dont vous aurez besoin - depuis le site PHP à <ulink url="http://www.php.net/extra/win32build.zip"> - http://www.php.net/extra/win32build.zip</ulink>. - </simpara> - </listitem> - <listitem> - <simpara> - Téléchargez le code source du DNS utilisé par PHP - à <ulink url="http://www.php.net/extra/bindlib_w32.zip"> - http://www.php.net/extra/bindlib_w32.zip</ulink>. Il - remplacera le fichier <filename>resolv.lib</filename> - inclut dans <filename>win32build.zip</filename>. - </simpara> - </listitem> - <listitem> - <simpara> - Si vous n'avez pas d'utilitaire de dézippage, vous devez en - télécharger un. Une version libre est disponible à <ulink - url="http://www.cdrom.com/pub/infozip/UnZip.html">InfoZip</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="http://www.php.net/anoncvs.php">anonyme</ulink>. Si vous - téléchargez une version - <ulink url="http://snaps.php.net/">intermédiaire</ulink> - ou la <ulink url="http://www.php.net/downloads.php">source</ulink>, vous - devez non seulement extraire les fichiers, mais aussi convertir les - nouvelles lignes en leur équivalent windows (crlf) dans les fichiers - <filename>*.dsp</filename> et <filename>*.dsw</filename> avant que - Microsoft Visual C++ ne soit capable de les comprendre. - </simpara> - <note> - <simpara> - Placez les dossiers <filename>Zend</filename> et - <filename>TSRM</filename> dans le dossier - <filename>php4</filename> pour que les projets puissent les - trouver durant la compilation. - </simpara> - </note> - </sect3> - <sect3 id="install.windows.build.install"> - <title>Mettre tout ensemble</title> - <itemizedlist> - <listitem> - <simpara> - Suivez les instructions pour installer l'utilitaire d'unzip de - votre choix. - </simpara> - </listitem> - <listitem> - <simpara> - Exécutez <filename>setup.exe</filename> et suivez les instructions - d'installation. Si vous décidez d'installer dans un autre - dossier que <filename>c:\cygnus</filename>, indiquez le au processus de - compilation en modifiant la variable d'environnement - Cygwin. Sous Windows 95/98, modifier une variable - d'environnement se fait en ajoutant une ligne dans le - fichier <filename>autoexec.bat</filename>. Sous Windows NT, allez - dans le menu "Démarrer => Paramètres => Panneau de contrôle => Système " - ("My Computer => Control Panel => System ") et - sélectionnez l'onglet "environnement" ("environment"). - </simpara> - <warning> - <simpara> - Créez un dossier temporaire pour Cygwin, sinon de nombreuses - commandes (comme bison) échoueront. Sous Windows 95/98, - <userinput>mkdir C:\TMP</userinput>. Sous Windows NT, - <userinput>mkdir %SystemDrive%\tmp</userinput>. - </simpara> - </warning> - </listitem> - <listitem> - <simpara> - Créez un dossier et dézippez <filename>win32build.zip</filename> dedans. - </simpara> - </listitem> - <listitem> - <simpara> - Lancez Microsoft Visual C++, et allez dans le menu - "select Tools => Options". Dans le dialogue, sélectionnez - l'onglet "directories". Assurez-vous que <filename>cygwin\bin</filename>, - <filename>win32build\include</filename>, et - <filename>win32build\lib</filename> sont bien - dans les menus déroulants "Executables", "Include", et "Library". - (Pour ajouter une entrée, sélectionnez une ligne - blanche, et tapez). Une entrée typique ressemble à ceci : - </simpara> - <itemizedlist> - <listitem> - <simpara> - <filename>c:\cygnus\bin</filename> - </simpara> - </listitem> - <listitem> - <simpara> - <filename>c:\php-win32build\include</filename> - </simpara> - </listitem> - <listitem> - <simpara> - <filename>c:\php-win32build\lib</filename> - </simpara> - </listitem> - </itemizedlist> - <simpara> - Pressez "OK", et sortez de Visual C++. - </simpara> - </listitem> - <listitem> - <simpara> - Créez un autre dossier et dézippez <filename>bindlib_w32.zip</filename> - dedans. Décidez si vous avez besoin des symboles de débuggage - (bindlib - Win32 Debug) ou non (bindlib - Win32 Release). - Compilez la configuration adéquate : - </simpara> - <itemizedlist> - <listitem> - <simpara> - Pour les utilisateurs de GUI, 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> - <listitem> - <simpara> - 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. - </simpara> - </listitem> - </itemizedlist> - </listitem> - </itemizedlist> - </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 une librairie <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> - Répétez les instructions ci-dessus avec <filename>php4isapi.dsp</filename> - (qui est dans <filename>sapi\isapi</filename>) pour compiler le - code nécessaire pour intégrer PHP avec Microsoft IIS. - </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 <filename>php.ini</filename>. - 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.4pl1, les extensions BCMath, BCMath,Calendar, COM, - FTP, MySQL, ODBC, PCRE, Sessions, WDDX et XML sont activées - <emphasis>par défaut</emphasis>. Vous n'avez rien à - faire pour qu'elles soient inclues. Lisez le fichier - <filename>README.txt</filename> ou <filename>install.txt</filename> - dans votre distribution pour connaître la liste des modules par - défaut. - </para> - </note> - <para> - <table> - <title>Extensions PHP</title> - <tgroup cols="2"> - <tbody> - <row> - <entry>php_bz2.dll</entry> - <entry>Fonctions de compression Bzip2</entry> - </row> - <row> - <entry>php_calendar.dll</entry> - <entry>Fonctions de conversions calendaires (Depuis PHP 4.03, elles sont - activées par défaut)</entry> - </row> - <row> - <entry>php_cpdf.dll</entry> - <entry>Fonctions ClibPDF</entry> - </row> <row> - <entry>php_crypt.dll</entry> - <entry>Fonctions de cryptage</entry> - </row> - <row> - <entry>php_ctype.dll</entry> - <entry>Fonctions ctype</entry> - </row> - <row> - <entry>php_curl.dll</entry> - <entry>Fonctions CURL</entry> - </row> - <row> - <entry>php_cybercash.dll</entry> - <entry>Fonctions de paiement Cybercash</entry> - </row> - <row> - <entry>php_db.dll</entry> - <entry>Fonctions DBM</entry> - </row> - <row> - <entry>php_dba.dll</entry> - <entry>Fonctions dbm-style</entry> - </row> - <row> - <entry>php_dbase.dll</entry> - <entry>Fonctions DBase</entry> - </row> - <row> - <entry>php3_dbm.dll</entry> - <entry>Librairie d'émulation GDBM via Berkely DB2</entry> - </row> - <row> - <entry>php_domxml.dll</entry> - <entry>Fonctions DOM XML</entry> - </row> - <row> - <entry>php_dotnet.dll</entry> - <entry>Fonctions .NET</entry> - </row> - <row> - <entry>php_exif.dll</entry> - <entry>Entêtes EXIF des images JPEG</entry> - </row> - <row> - <entry>php_fbsql.dll</entry> - <entry>Fonctions FrontBase</entry> - </row> - <row> - <entry>php_fdf.dll</entry> - <entry>Fonction FDF (Forms Data Format)</entry> - </row> - <row> - <entry>php_filepro.dll</entry> - <entry>Lecture des bases filepro</entry> - </row> - <row> - <entry>php_ftp.dll</entry> - <entry>Fonctions FTP(Depuis PHP 4.0.3, elles sont activées par défaut)</entry> - </row> - <row> - <entry>php_gd.dll</entry> - <entry>Bibliothèque GD (pour les manipulations d'images)</entry> - </row> - <row> - <entry>php_gettext.dll</entry> - <entry>Fonctions GNU Gettext</entry> - </row> - <row> - <entry>php_hyperwave.dll</entry> - <entry>Fonctions HyperWave</entry> - </row> - <row> - <entry>php_iconv.dll</entry> - <entry>Fonctions de conversions ICONV</entry> - </row> - <row> - <entry>php_ifx.dll</entry> - <entry>Fonctions Informix</entry> - </row> - <row> - <entry>php_iisfunc.dll</entry> - <entry>Fonctions IIS</entry> - </row> - <row> - <entry>php_imap.dll</entry> - <entry>Fonctions IMAP 4(en PHP 3: php3_imap4r1.dll)</entry> - </row> - <row> - <entry>php_ingres.dll</entry> - <entry>Fonctions Ingres II</entry> - </row> - <row> - <entry>php_interbase.dll</entry> - <entry>Fonctoins InterBase</entry> - </row> - <row> - <entry>php_java.dll</entry> - <entry>Extension Java</entry> - </row> - <row> - <entry>php_ldap.dll</entry> - <entry>Fonctions LDAP</entry> - </row> - <row> - <entry>php_mhash.dll</entry> - <entry>Fonctions Mhash</entry> - </row> - <row> - <entry>php_ming.dll</entry> - <entry>Fonctions Ming pour Flash</entry> - </row> - <row> - <entry>php_msql.dll</entry> - <entry>Fonctions mSQL</entry> - </row> - <row> - <entry>php3_msql1.dll</entry> - <entry>Fonctions mSQL 1</entry> - </row> - <row> - <entry>php3_msql2.dll</entry> - <entry>Fonctions mSQL 2</entry> - </row> - <row> - <entry>php_mssql.dll</entry> - <entry>Fonctions MSSQL (anciennement php_mssql70.dll, - requiert MSSQL DB-Libraries)</entry> - </row> - <row> - <entry>php3_mysql.dll</entry> - <entry>Fonctions MySQL (Activées par défaut en PHP 4)</entry> - </row> - <row> - <entry>php_nsmail.dll</entry> - <entry>Fonctions Netscape mail</entry> - </row> - <row> - <entry>php3_oci73.dll</entry> - <entry>Fonctions Oracle</entry> - </row> - <row> - <entry>php_oci8.dll</entry> - <entry>Fonctions Oracle 8</entry> - </row> - <row> - <entry>php_openssl.dll</entry> - <entry>Fonctions OpenSSL</entry> - </row> - <row> - <entry>php_oracle.dll</entry> - <entry>Fonctions Oracle</entry> - </row> - <row> - <entry>php_pdf.dll</entry> - <entry>Fonctions PDF</entry> - </row> - <row> - <entry>php_pgsql.dll</entry> - <entry>Fonctions PostgreSQL</entry> - </row> - <row> - <entry>php_printer.dll</entry> - <entry>Fonctions d'impression</entry> - </row> - <row> - <entry>php_sablot.dll</entry> - <entry>Focntions XSLT</entry> - </row> - <row> - <entry>php_snmp.dll</entry> - <entry>Fonctions <acronym>SNMP</acronym> get et walk (NT uniquement!)</entry> - </row> - <row> - <entry>php_sybase_ct.dll</entry> - <entry>Fonctions Sybase</entry> - </row> - <row> - <entry>php_yaz.dll</entry> - <entry>Fonctions YAZ</entry> - </row> - <row> - <entry>php_zlib.dll</entry> - <entry>Fonctions ZLib</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </sect2> - </sect1> - <sect1 id="install.apache"> - <title>Installation du 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> - <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 (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. - <informalexample> - <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> - </informalexample> - 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 : - <informalexample> - <programlisting> -./configure --with-apxs --with-pgsql - </programlisting> - </informalexample> - </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> - <informalexample> - <programlisting> -./configure --with-apxs --with-pgsql=shared - </programlisting> - </informalexample> - </para> - <para> - Cette commande va créer une autre librairie partagée - <filename>libphp4.so</filename>, mais va aussi créer une - librairie partagée <filename>pgsql.so</filename> qui sera chargée - dans PHP avec les options de configurations du fichier - <filename>php.ini</filename> ou par chargement dynamique - avec <function>dl</function>. - </para> - <para> - <informalexample> - <programlisting> -./configure --with-apache=/path/to/apache_source --with-pgsql - </programlisting> - </informalexample> - </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 inclus Apache et PHP. - </para> - <para> - <informalexample> - <programlisting> -./configure --with-apache=/path/to/apache_source --with-pgsql=shared - </programlisting> - </informalexample> - </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 - <filename>php.ini</filename> 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 - <ulink url="&url.apachedso;">webpage on DSO support</ulink>. - </para> - </sect2> - <sect2 id="install.apache.windows"> - <title>Détails sur l'installation de 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> - <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> - Pour utiliser les fonctionnalités de mise en évidence du code - source, créez simplement un script PHP et ajoutez le code suivant : - <literal><?php show_source("original_php_script.php"); ?></literal>. - Remplacez le fichier <literal>original_php_script.php</literal> par le fichier - que vous voulez afficher : c'est la seule manière de le faire. - </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. - </simpara> - </note> - </sect2> - </sect1> - <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 vous voulez - que votre serveur web supporte le PHP, compiler le PHP comme un CGI - permet d'obtenir de meilleures 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 - <link linkend="ini.safe-mode">safe mode</link> 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 <link linkend="ini.safe-mode">safe mode</link> 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> - </sect1> - <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 - <option role="configure"><link linkend="install.configure.with-fhttpd">--with-fhttpd</link>=<replaceable>DIR</replaceable></option> - 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> - <sect1 id="install.caudium"> - <title>Installation sur serveur Caudium</title> - <para> - PHP 4 peut être compilé comme module Pike pour le serveur web Caudium. - 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 à <filename>PHP4.so</filename>. De même, assurez-vous - que <filename>caudium/server/lib/[pike-version]/PHP4.so</filename> - 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 <link linkend="install.configure.with-mysql">--with-mysql</link>. - </para> - </note> - </sect1> - <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. - ex: <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 %s %s</literal>. Les '%s %s' sont TRES - importants, PHP ne fonctionnera pas sans. - </simpara> - </listitem> - <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 %s %s</literal> (en supposant - que vous avez dézippé PHP dans <filename>c:\php\</filename>). - Vous DEVEZ ajouter <literal>%s %s</literal> à la fin : PHP ne - fonctionnera pas correctement sans. - </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". - 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épandus.) - </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 - </simpara> - </listitem> - <listitem> - <simpara> - Démarrez IIS - </simpara> - </listitem> - </itemizedlist> - </para> - </sect2> - </sect1> - <sect1 id="install.netscape-enterprise"> - <title>Installation sous Netscape et iPlanet Enterprise Serveur</title> - <para> - Pour compiler PHP avec NES ou iPlanet web, ajoutez le dossier - d'installation dans l'option de configuration - <option role="configure"><link linkend="install.configure.with-nsapi">--with-nsapi</link> = <replaceable>DIR</replaceable></option> . - Par défaut, le dossier est - <filename class="directory">/opt/netscape/suitespot/</filename>. - Lisez aussi le fichier <filename>/php-xxx-version/sapi/nsapi/nsapi-readme.txt</filename> - pour plus de détails. - </para> - <para> - <example id="install.netscape-enterprise.solaris"> - <title> - Installation de Netscape Enterprise sous Solaris - </title> - <programlisting> -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 - </programlisting> - </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> - <programlisting> -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> - </programlisting> - </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> - 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> - </sect1> - <sect1 id="install.omnihttpd"> - <title>Installation OmniHTTPd</title> - <para> - Cette section contient des notes et conseils spécifiques à OmniHTTPd. - </para> - <sect2 id="install.omnihttpd.windows"> - <title>OmniHTTPd 2.0b1 et plus récent pour Windows</title> - <simpara> - La méthode la plus simple pour configurer le serveur est : - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - Step 1: Installez Omni server. - </para> - </listitem> - <listitem> - <para> - Step 2: Faites un clic-droit sur l'icone bleue d'OmniHTTPd, sur le - bureau, 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". - </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". - </para> - </listitem> - <listitem> - <para> - Step 6: Cliquez sur <literal>OK</literal>. - </para> - </listitem> - </itemizedlist> - </para> - <simpara> - Réptez les étapes 2 à 6 pour chaque extension que - vous voulez associer à PHP. - </simpara> - <note> - <para> - Certains package OmniHTTPd sont livrés avec le support - PHP déjà intégré. Vous pouvez choisir au moment de la - configuration de faire un paramétrage poussé et de décocher - le support PHP. Nous vous conseillons d'utiliser les - dernières versions de PHP. Certains serveurs OmniHTTPd sont - encore livrés avec des versions beta de PHP : il - est recommandé de ne pas les installer, mais d'installer - votre propre version. Si le serveur est déjà sur votre - machine, vous pouvez utiliser le bouton "Replace" dans les - étapes 4 et 5 pour en choisir un nouveau et à jour. - </para> - </note> - </sect2> - </sect1> - <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 ".php" - 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> - <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 http://127.0.0.1/admin), 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> - </itemizedlist> - </para> - </sect2> - </sect1> - <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.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> - <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 à - <ulink url="&url.php.faq;">&url.php.faq;</ulink>. - </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.bugdosdonts;">Bugs-Dos-And-Donts</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> - <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, - <link linkend="ini.safe-mode">safe mode</link>...), et - n'hésitez pas à envoyer suffisamment de code pour que nous - puissions reproduire l'erreur. - </simpara> - </sect2> - </sect1> -</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 -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.32 $ --><chapter id="installation"> <title>Installation</title> <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. Vous pouvez trouver une liste de ces compagnies à <ulink url="&url.php.hosts;">&url.php.hosts;</ulink>. </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="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> <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 les codes sources) </simpara> </listitem> <listitem> <simpara> bison (pour les codes sources) </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>Référence 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> Instructions d'installation PHP 4 (Version Module Apache) </title> <programlisting>1. gunzip apache_1.3.x.tar.gz2. tar xvf apache_1.3.x.tar3. gunzip php-x.x.x.tar.gz4. tar xvf php-x.x.x.tar5. cd apache_1.3.x6. ./configure --prefix=/www7. cd ../php-x.x.x8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars9. make10. make install11. cd ../apache_1.3.x12. ./configure --activate-module=src/modules/php4/libphp4.a13. make14. make install15. cd ../php-x.x.x16. cp php.ini-dist /usr/local/lib/php.ini17. "Editez votre fichier httpd.conf ou srm.conf et ajoutez : " AddType application/x-httpd-php .php18. "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> <sect1 id="install.linux"> <title>Installation sous Linux</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> <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> <programlisting>From: paul_mckay@clearwater-it.co.uk04-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'undes 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 etles 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 ilsemble oublier qu'il est sur une machine HP-UX. Il y a des méthodes plusrusé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é. Sousapache_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 sousHP-UX, ce qui fait que vous devez le compiler en statique. Suivezsimplement 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 nogrouppar vos valeurs, par exemple : User www Group sysIl n'est pas possible d'éxécuter Apache avec l'utilisateur nobody sousHP-UX. A partir de ce moment là, PHP et Apache doivent fonctionner.J'espère que cela aidera quelqu'un.Paul Mckay. </programlisting> </example> </sect1> <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> <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</ulink>. </para> <sect2 id="install.openbsd.ports"> <title>Utilisation des ports</title> <simpara> Ceci est la méthode recommandée d'installation de PHP sous OpenBSD, car elle prend en compte les dernières modifications et mises à jour de sécurité. Pour utiliser cette méthode, assurez vous que vous avez bien <ulink url="&url.openbsd.ports;">ports tree</ulink> récent. Choisissez alors simplement la version que vous souhaitez installer, et utilisez la commande <command>make install</command>. Ci-dessous, voici un exemple. </simpara> <example id="install.openbsd.ports.example"> <title>Exemple d'installation de PHP sous OpenBSD avec Ports</title> <programlisting>$ cd /usr/ports/www/php4$ make show VARNAME=FLAVORS (choisissez les versions que vous souhaitez sur votre liste).$ env FLAVOR="imap gettext ldap mysql gd" make install$ /usr/local/sbin/php4-enable </programlisting> </example> </sect2> <sect2 id="install.openbsd.packages"> <title>Utilisation des Packages</title> <simpara> Il existe des packages pré-compilés disponibles en téléchargement à <ulink url="&url.openbsd;">OpenBSD</ulink>. Ils s'intègrent automatiquement avec la version d'Apache installée sur votre OS. Cependant, comme il y a un grand nombre d'options (appelées <emphasis>flavors</emphasis>) disponibles, vous trouverez peut-être plus facile de le compiler à partir de l'arbre de ports. Lisez le manuel <ulink url="&url.openbsd.packages;">packages(7)</ulink> pour plus de détails sur les packages disponibles (en anglais). </simpara> </sect2> </sect1> <sect1 id="install.macosx"> <title>Installation sous Mac OS X</title> <para> Cette section contient les notes et conseils d'installation de PHP sur les distributions Mac OS X. </para> <sect2 id="install.macosx.packages"> <title>Utilisation des packages</title> <simpara> Il existe quelques versions pré-packagée et pré-compilées de PHP pour Mac OS X. Ils permettent de réaliser rapidement des installations standard, mais si vous avez des configurations personnelles, (comme un serveur sécurisé SSL ou un pilote de base de données exotique), vous devrez compiler PHP et/ou votre serveur web vous-même. 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> <sect2 id="install.macosx.compile"> <title>Compilation pour serveur OS X</title> <simpara> Il existe deux versions légèrement différentes de Mac OS X, client et serveur. Cette installation est faite pour le OS X Serveur. </simpara> <example id="install.macosx.compile.example"> <title>Installation sous Mac OS X serveur</title> <programlisting>1. Téléchargez la dernière version de Apache et PHP2. Décompressez puis désarchivez la, puis configurez Apache comme ceci : ./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=apache4. Vous aurez peut être besoin d'ajouter ces lignes ci, pour optimiser lacompilation : setenv OPTIM=-O25. Puis, allez dans le dossier source de PHP 4, et configurez le : ./configure --prefix=/usr \ --sysconfdir=/etc \ --localstatedir=/var \ --mandir=/usr/share/man \ --with-xml \ --with-apache=/src/apache_1.3.12 Si vous avez d'autres composants (MySQL, GD, etc.), n'oubliez pas de les ajouter à ce moment la. Pour l'option --with-apache, ajoutez le chemin jusqu'au dossier source d'Apache, par exemple "/src/apache_1.3.12".6. Exécutez un "make"7. Exécutez un "make install" Cette commande ajoutera un dossier dans le dossier Apache : src/modules/php4.8. Maintenant, reconfigurez Apache pour compiler 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 Vous pouvez rencontrer un message qui vous dira que libmodphp4.a est obsolète. Si c'est le cas, allez dans le dossier src/modules/php4 de votre dossier Apache et exécutez la commande suivante : ranlib libmodphp4.a Puis, revenez à la racine de la distribution Apache, et recommencez la configuration. Cela aura mis à jour la table de liens.9. Exécutez un "make"10. Exécutez un "make install"11. Copiez et renommez le fichier php.ini-dist de votre distribution PHP 4 dans votre dossier "bin": cp php.ini-dist /usr/local/bin/php.ini ou (si vous n'avez pas de dossier local) cp php.ini-dist /usr/bin/php.ini </programlisting> </example> <simpara> D'autres exemples pour <ulink url="&url.stepwise.macosx-client;">Mac OS X client</ulink> et <ulink url="&url.stepwise.macosx-client;">Mac OS X server</ulink> sont disponibles à <ulink url="&url.stepwise;">Stepwise</ulink>. </simpara> </sect2> <sect2 id="install.macosx.client"> <title>Compilation pour MacOS X client</title> <simpara> Ces conseils sont gracieusement fourni par <ulink url="&url.macosx;">Marc Liyanage</ulink>. </simpara> <simpara> Le module PHP pour Apache est inclus dans Mac OS X. Cette version inclus le support des bases de données MySQL et PostgreSQL. </simpara> <simpara> NOTE: Soyez prudent avec cette manipulation, vous risquez de mettre votre serveur Apache à terre! </simpara> <para> Insctructions : <itemizedlist> <listitem> <simpara> 1. Ouvrez un terminal </simpara> </listitem> <listitem> <simpara> 2. Tapez "wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz", attendez la fin du 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 ouvrira le fichier de configuration. Recherchez ces deux lignes, vers la fin du fichier (Utilisez la commande Find) <programlisting> * #AddType application/x-httpd-php .php * #AddType application/x-httpd-php-source .phps </programlisting> Supprimez les deux marques de commentaires (<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 fonctionner. Vous pouvez le tester en placant un script dans le dossier "Sites". Par exemple, le fichier "test.php", qui contient la simple ligne : "<literal><?php phpinfo() ?></literal>". </para> <para> Ouvrez l'URL <literal>127.0.0.1/~your_username/test.php</literal> dans votre navigateur. Vous obtiendrez le tableau de bord de PHP. </para> </sect2> </sect1> <sect1 id="install.configure"> <title>Liste complète des options de configuration</title> <para> Cette section rassemble la liste complète des options de configuration supportées par PHP 3 et PHP 4, à utiliser avec le fichier <filename>configure</filename>, lors de la configuration sous Unix. Certaines options sont disponibles sous PHP 3, d'autres sous PHP 4 et certains sous PHP 3 et PHP 4, comme inidiqué. Il y a de nombreuses options dont le nom a changé entre PHP 3 et PHP 4. Ces options ont des liens entre elles : si vous vous souvenez d'un nom d'option en PHP 3, regardez si le nom a changé. </para> <itemizedlist> <listitem> <para> <link linkend="install.configure.databases">Base de données</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.ecommerce">E-commerce</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.graphics">Images</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.misc">Divers</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.networking">Réseau</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.php">Comportement PHP</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.servers">Serveur</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.text">Texte et langue</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.xml">XML</link> </para> </listitem> </itemizedlist> <sect2 id="install.configure.databases"> <title>Base de données</title> <variablelist> <varlistentry id="install.configure.with-adabas"> <term> <parameter>--with-adabas[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Adabas D. DIR est le dossier d'installation de Adabas (par défaut, <literal>/usr/local</literal>). </para> <para> <ulink url="&url.adabas;">Adabas home page</ulink> </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dba"> <term> <parameter>--enable-dba=shared</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile DBA comme module partagé </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dbx"> <term> <parameter>--enable-dbx</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support DBX. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dbase"> <term> <parameter>--enable-dbase</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-dbase">--with-dbase</link> instead. </para> <para> PHP 4: Active la librairie dbase livrée avec PHP. Aucune librairie supplémentaire n'est nécessaire. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-dbase"> <term> <parameter>--with-dbase</parameter> </term> <listitem> <para> PHP 3: Active la librairie dbase livrée avec PHP. Aucune librairie supplémentaire n'est nécessaire. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-dbase">--enable-dbase</link> instead. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-db2"> <term> <parameter>--with-db2[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support Berkeley DB2. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-db3"> <term> <parameter>--with-db3[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Berkeley DB3. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-dbm"> <term> <parameter>--with-dbm[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support DBM. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-dbmaker"> <term> <parameter>--with-dbmaker[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3. </para> <para> PHP 4: Inclut le support DBMaker. DIR est le dossier d'installation DBMaker (par défaut, c'est le dossier de la dernière installation DBMaker, comme <literal>/home/dbmaker/3.6</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-empress"> <term> <parameter>--with-empress[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Empress. DIR est le dossier d'installation Empress (par défaut, <literal>$EMPRESSPATH</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-filepro"> <term> <parameter>--enable-filepro</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-filepro">--with-filepro</link> instead. </para> <para> PHP 4: Active la librairie filePro (lecture seule) livrée avec PHP. Aucune librairie supplémentaire n'est nécessaire. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fbsql"> <term> <parameter>--with-fbsql[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible. </para> <para> PHP 4: Inclut le support de FrontBase SQL. DIR est le chemin jusqu'à l'installation de FrontBase base. Par défaut, c'est le dossier standard d'installation Frontbase. L'installation dépend de votre OS : Solaris: <literal>/opt/FrontBase</literal>, WinNT: <literal>\usr\FrontBase</literal>, Linux: <literal>/usr/frontbase</literal>, Mac OSX: <literal>/Library/FrontBase</literal>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-filepro"> <term> <parameter>--with-filepro</parameter> </term> <listitem> <para> PHP 3: Inclut le support IBM DB2. Aucune librairie supplémentaire n'est nécessaire. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-filepro">--enable-filepro</link>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gdbm"> <term> <parameter>--with-gdbm[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support GDBM. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-hyperwave"> <term> <parameter>--with-hyperwave</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support Hyperwave. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ibm-db2"> <term> <parameter>--with-ibm-db2[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support IBM DB2. DIR est le dossier d'installation de DB2 (par défaut, <filename>/home/db2inst1/sqllib</filename>). </para> <para> <ulink url="&url.ibmdb2;">IBM DB2</ulink> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-informix"> <term> <parameter>--with-informix[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Informix. DIR est le dossier d'installation d'Informix (par défaut, aucune valeur). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ingres"> <term> <parameter>--with-ingres[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Ingres II. DIR est le dossier d'installation d'Ingres (par défaut, <literal>/II/ingres</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-interbase"> <term> <parameter>--with-interbase[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support InterBase. DIR est le dossier d'installation d'InterBase (par défaut, <filename>/usr/interbase</filename>). </para> <simpara> <link linkend="ref.ibase">Fonctions Interbase</link> </simpara> <simpara> <ulink url="&url.ibase;">Interbase</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-ldap"> <term> <parameter>--with-ldap[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support LDAP. DIR est le dossier d'installation de LDAP (par défaut <filename>/usr</filename> et <filename>/usr/local</filename>). </para> <para> PHP 4: Inclut le support LDAP. DIR est le dossier d'installation de LDAP. (par défaut; <filename class="directory">/usr/local/ldap</filename>). </para> <simpara> Plus de détails sur LDAP sont disponibles à <ulink url="&url.rfc;rfc1777.html">RFC1777</ulink> et <ulink url="&url.rfc;rfc1778.html">RFC1778</ulink>. </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-msql"> <term> <parameter>--with-msql[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support mSQL. DIR est le dossier d'installation de mSQL (par défaut <filename>/usr</filename> et <filename>/usr/local/Hughes</filename>, pour la version 2.0). <command>configure</command> détecte automatiquement la version de mSQL qui fonctionne. PHP supporte les versions 1.0 et 2.0, mais si vous compilez PHP avec mSQL 1.0, vous ne pourrez accéder qu'à des bases mSQL 1.0, et vice-versa. </para> <simpara> Voir aussi <link linkend="ini.sect.msql">Configuration mSQL</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> <simpara> <ulink url="&url.msql;">mSQL</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-mysql"> <term> <parameter>--with-mysql[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support MySQL. DIR est le dossier d'installation de MySQL (par défaut, il cherche dans différents dossiers où MySQL a coutume d'être installé). </para> <para> PHP 4: Inclut le support MySQL. DIR est le dossier de l'installation MySQL. S'il est omis, la librairie MySQL livrée en standard avec PHP sera utilisée par défaut. </para> <para> Voir aussi <link linkend="ini.sect.mysql">Configuration MySQL</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </para> <para> <ulink url="&url.mysql;">MySQL</ulink> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ndbm"> <term> <parameter>--with-ndbm[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support NDBM. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ovrimos"> <term> <parameter>--with-ovrimos</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Ovrimos. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-oci8"> <term> <parameter>--with-oci8[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Oracle-oci8. DIR est le dossier d'installation de Oracle-oci8 (par défaut, <filename>ORACLE_HOME</filename>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-oracle"> <term> <parameter>--with-oracle[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support Oracle database. DIR est le dossier d'installation de Oracle (par défaut, <filename>$ORACLE_HOME</filename>). </para> <para> PHP 4: Inclut le support Oracle-oci7. DIR est le dossier d'installation de Oracle-oci7 (par défaut, <filename>ORACLE_HOME</filename>). </para> <simpara> Inclut le support Oracle. Ce support a été testé et permet de travailler avec les versions d'Oracle de 7.0 à 7.3. Le paramètre est le dossier <envar>ORACLE_HOME</envar>. Vous n'avez pas à spécifier ce paramètre si votre environnement Oracle a été configuré. </simpara> <simpara> <ulink url="&url.oracle;">Oracle</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-pgsql"> <term> <parameter>--with-pgsql[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support PostgresSQL. DIR est le dossier d'installation de PostgresSQL (par défaut, <filename>/usr/local/pgsql</filename>). </para> <para> PHP 4: Inclut le support PostgreSQL. DIR est le dossier d'installation de PostgreSQL (par défaut, <filename>/usr/local/pgsql</filename>). Pour compiler en "dl", utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", mais spécifier DIR malgré tout. </para> <simpara> Voir aussi <link linkend="ini.sect.pgsql">Postgres</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> <simpara> <ulink url="&url.pgsql;">PostgreSQL</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-solid"> <term> <parameter>--with-solid[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Solid. DIR est le dossier d'installation de Solid (par défaut, <literal>/usr/local/solid</literal>). </para> <simpara> <ulink url="&url.solid;">Solid</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-sybase-ct"> <term> <parameter>--with-sybase-ct[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Sybase-CT. DIR est le dossier d'installation de Sybase (par défaut, <literal>/home/sybase</literal>). </para> <simpara> Voir aussi <link linkend="ini.sect.sybct">Sybase-CT</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-sybase"> <term> <parameter>--with-sybase[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Sybase-DB. DIR est le dossier d'installation de Sybase (par défaut, <filename>/home/sybase</filename>). </para> <simpara> Voir aussi <link linkend="ini.sect.sybase">Sybase</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> <simpara> <ulink url="&url.sybase;">Sybase</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-openlink"> <term> <parameter>--with-openlink[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support OpenLink ODBC. DIR est le dossier d'installation d'OpenLink (par défaut <literal>/usr/local/openlink</literal>). A partir de PHP 4.0.6, cette option n'est plus valable. Utilisez plutôt <link linkend="install.configure.with-iodbc"><option> --with-iodbc</option></link> si vous voulez utiliser l'ODBC de OpenLink Software. </para> <simpara> <ulink url="&url.openlink;">OpenLink Software</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-iodbc"> <term> <parameter>--with-iodbc[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support iODBC. DIR est le dossier d'installation d'iODBC (par défaut, <filename>/usr/local</filename>). </para> <para> Cette fonctionnalité a d'abord été développée avec le gestionnaire iODBC Driver Manager, un pilote ODBC librement distribuable, qui fonctionne sous divers UNIX. </para> <simpara> <ulink url="&url.freeodbc;">FreeODBC</ulink> ou <ulink url="&url.iodbc;">iODBC</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-custom-odbc"> <term> <parameter>--with-custom-odbc[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support ODBC, avec une librairie tierce. Le paramètre DIR est le nom du dossier d'installation de cette librairie. Par défaut, il vaut <filename class="directory">/usr/local</filename>. </para> <simpara> Cette option implique qus vous avez défini CUSTOM_ODBC_LIBS lorsque vous éxécutez le script de configuration. Vous devez aussi avoir une en-tête <filename>odbc.h</filename> valide dans vos dossiers d'Inclution. Si vous n'en avez pas, créez le, et ajoutez-y vos en-têtes spécifiques. Votre en-tête peut aussi réclamer d'autres définitions, surtout si elle est multi-plate-forme. Définissez les dans CFLAGS. </simpara> <simpara> Par exemple, vous pouvez utilisez Sybase SQL Anywhere sous QNX comme ceci : <literal> CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50 </literal> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.disable-unified-odbc"> <term> <parameter>--disable-unified-odbc</parameter> </term> <listitem> <para> PHP 3: Inactive le support unified ODBC. Uniquement valable si iODBC, Adabas, Solid, Velocis ou une interface spéciale ODBC a été activée. </para> <para> PHP 4: Option non disponible en PHP 4 </para> <simpara> Le module Unified ODBC est commun à toutes les bases de données ODBC, comme par exemple Solid, IBM DB2 et Adabas D. Il fonctionne aussi avec les librairies ODBC normales. Des tests ont été menés avec iODBC, Solid, Adabas D, IBM DB2 et Sybase SQL Anywhere. Il requiert une (et une seule) de ces extensions, ou l'extension Velocis, ou une librairie ODBC spéciale. Cette option n'est possible qu'avec l'utilisation de l'une des options suivantes : <link linkend="install.configure.with-iodbc">--with-iodbc</link>, <link linkend="install.configure.with-solid">--with-solid</link>, <link linkend="install.configure.with-ibm-db2">--with-ibm-db2</link>, <link linkend="install.configure.with-adabas">--with-adabas</link>, <link linkend="install.configure.with-velocis">--with-velocis</link>, ou <link linkend="install.configure.with-custom-odbc">--with-custom-odbc</link>. </simpara> <simpara> Voir aussi <link linkend="ini.sect.uodbc">Unified ODBC</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-unixODBC"> <term> <parameter>--with-unixODBC[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support unixODBC. DIR est le dossier d'installation d'unixODBC (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-velocis"> <term> <parameter>--with-velocis[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclus le support Velocis. DIR est le dossier d'installation de Velocis (par défaut, <literal>/usr/local/velocis</literal>). </para> <simpara> <ulink url="&url.velocis;">Velocis</ulink> </simpara> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.ecommerce"> <title>E-commerce</title> <variablelist> <varlistentry id="install.configure.with-ccvs"> <term> <parameter>--with-ccvs[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Ajoute le support CCVS. DIR est le dossier d'installation de CCVS. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cybermut"> <term> <parameter>--with-cybermut[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support de Cybermut pour PHP 4. DIR est le dossier du SDK Cybermut, qui contient les deux fichiers <filename>libcm-mac.a</filename> et <filename>cm-mac.h</filename>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mck"> <term> <parameter>--with-mck[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support Cybercash MCK. DIR est le dossier d'installation de cybercash mck (par défaut, <filename>/usr/src/mck-3.2.0.3-linux</filename>). Plus d'aide dans le dossier <filename>extra/cyberlib</filename>. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.with-cybercash">--with-cybercash</link> instead. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cybercash"> <term> <parameter>--with-cybercash[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-mck">--with-mck</link> instead. </para> <para> PHP 4: Inclut le support CyberCash. DIR est le dossier d'installation de CyberCash MCK. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pfpro"> <term> <parameter>--with-pfpro[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Verisign Payflow Pro. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.graphics"> <title>Images</title> <variablelist> <varlistentry id="install.configure.enable-freetype-4bit-antialias-hack"> <term> <parameter>--enable-freetype-4bit-antialias-hack</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support de FreeType2 (expérimental). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gd"> <term> <parameter>--with-gd[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support GD. DIR est le dossier d'installation de GD. </para> <para> PHP 4: Inclut le support GD. DIR est le dossier d'installation de GD. Pour compiler en "dl", utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", mais spécifier DIR malgré tout. </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-gd"> <term> <parameter>--without-gd</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inactive le support GD . </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-imagick"> <term> <parameter>--with-imagick[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support ImageMagick. DIR est le dossier d'installation de ImageMagick. S'il est omis, PHP essaiera de le trouver de lui-même (expérimental). </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-jpeg-dir"> <term> <parameter>--with-jpeg-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: dossier JPEG pour pdflib 2.0 </para> <para> PHP 4: dossier JPEG pour pdflib 3.x et 4.x </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-png-dir"> <term> <parameter>--with-png-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: dossier PNG pour pdflib 3.x et 4.x </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-t1lib"> <term> <parameter>--enable-t1lib</parameter> </term> <listitem> <para> PHP 3: Active le support t1lib. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.with-t1lib">--with-t1lib</link> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-t1lib"> <term> <parameter>--with-t1lib[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-t1lib">--enable-t1lib</link>. </para> <para> PHP 4: Inclut le support T1lib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tiff-dir"> <term> <parameter>--with-tiff-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: dossier TIFF pour pdflib 2.0 </para> <para> PHP 4: dossier TIFF pour pdflib 3.x et 4.x </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ttf"> <term> <parameter>--with-ttf[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support FreeType. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-xpm-dir"> <term> <parameter>--with-xpm-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: dossier XPM pour GD-1.8+ </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.misc"> <title>Divers</title> <para> Ces options seront classées ultérieurement, lorsqu'une catégorie adéquate apparaîtra. </para> <variablelist> <varlistentry id="install.configure.disable-bcmath"> <term> <parameter>--disable-bcmath</parameter> </term> <listitem> <para> PHP 3: Inactive la librairie BCmath. </para> <para> PHP 4: Option non disponible en PHP 4. La librairie BCmath n'est pas compilée par défaut. Utilisez <link linkend="install.configure.enable-bcmath">--enable-bcmath</link> pour l'inclure. </para> </listitem> </varlistentry> <varlistentry id="install.configure.gmp"> <term> <parameter>--with-gmp</parameter> </term> <listitem> <para> PHP 3, PHP 4 : Inclut le support GMP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-display-source"> <term> <parameter>--disable-display-source</parameter> </term> <listitem> <para> PHP 3: Compile sans afficher le support des sources </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-libtool-lock"> <term> <parameter>--disable-libtool-lock</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Empêche le verrouillage (risque d'empêcher certaines compilations paralléles). </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-pear"> <term> <parameter>--disable-pear</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: N'installe pas PEAR </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-pic"> <term> <parameter>--disable-pic</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inactive PIC pour les shared objects </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-posix"> <term> <parameter>--disable-posix</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3; Utilisez plutôt <link linkend="install.configure.without-posix">--without-posix</link> </para> <para> PHP 4: Inactive les fonctions POSIX. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-rpath"> <term> <parameter>--disable-rpath</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inactive le passage de chemins supplémentaires pour la recherche de librairie lors de l'exécution. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-session"> <term> <parameter>--disable-session</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inactive le support session. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-bcmath"> <term> <parameter>--enable-bcmath</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3; bcmath est compilée par défaut. Utilisez plutôt <link linkend="install.configure.disable-bcmath">--disable-bcmath</link>, pour l'inactiver. </para> <para> PHP 4: Active le support de l'extension bc maths. Voir aussi <link linkend="ref.bc">les fonctions BCMath</link>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-c9x-inline"> <term> <parameter>--enable-c9x-inline</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active les sémantiques C9x-inline </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-calendar"> <term> <parameter>--enable-calendar</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support des conversions calendaires </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debug"> <term> <parameter>--enable-debug</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile sans les symboles de débuggages </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debugger"> <term> <parameter>--enable-debugger</parameter> </term> <listitem> <para> PHP 3: Compile avec les fonctions de débuggage à distance </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-discard-path"> <term> <parameter>--enable-discard-path</parameter> </term> <listitem> <para> PHP 3, PHP 4: Si cette option est activée, le CGI PHP peut être placé hors de l'arborescence web, pour que personne ne puisse l'atteindre, même en contournant les .htaccess. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dmalloc"> <term> <parameter>--enable-dmalloc</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active dmalloc </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-exif"> <term> <parameter>--enable-exif</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support exif. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-experimental-zts"> <term> <parameter>--enable-experimental-zts</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Cela risque fortement de ne plus compiler du tout! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-fast-install"> <term> <parameter>--enable-fast-install[=PKGS]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Optimise pour les installations rapides for fast installation (par défaut, <literal>no</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-force-cgi-redirect"> <term> <parameter>--enable-force-cgi-redirect</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active la vérification interne des redirections serveurs. Il est recommandé d'utiliser cette option si vous avez compilé PHP en CGI. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-inline-optimization"> <term> <parameter>--enable-inline-optimization</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Si vous avez beaucoup de mémoire disponible et que vous utilisez gcc, essayez donc ça. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-libgcc"> <term> <parameter>--enable-libgcc</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active explicitement les liens avec libgcc </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-maintainer-mode"> <term> <parameter>--enable-maintainer-mode</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active des règles de make et de dépendances qui sont parfois absconses et ne servent pas aux utilisateurs habituels (Bref, ne l'utilisez pas). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-memory-limit"> <term> <parameter>--enable-memory-limit</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile avec le support de la limitation de mémoire (par défaut, <literal>no</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-safe-mode"> <term> <parameter>--enable-safe-mode</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le SAFE_MODE (par défaut, <literal>yes</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-satellite"> <term> <parameter>--enable-satellite</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support CORBA via Satellite (Requiert ORBit) </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> <parameter>--enable-shared[=PKGS]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile les librairies partagées (par défaut, <literal>yes</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sigchild"> <term> <parameter>--enable-sigchild</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le gestionnaire SIGCHLD propre à PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-static"> <term> <parameter>--enable-static[=PKGS]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile les librairies en statique (par défaut, <literal>yes</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sysvsem"> <term> <parameter>--enable-sysvsem</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support des sémaphores System V. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sysvshm"> <term> <parameter>--enable-sysvshm</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support de partage de mémoire System V. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-trans-sid"> <term> <parameter>--enable-trans-sid</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active la propagation transparente des identifiants de session. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cdb"> <term> <parameter>--with-cdb[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support CDB. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-config-file-path"> <term> <parameter>--with-config-file-path=PATH</parameter> </term> <listitem> <para> PHP 3: Indique le chemin dans lequel aller lire le fichier <filename>php3.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. </para> <para> PHP 4: Indique le chemin dans lequel allet lire le fichier <filename>php.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cpdflib"> <term> <parameter>--with-cpdflib[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support ClibPDF. DIR est le dossier d'installation de ClibPDF (par défaut, <literal>/usr/local</literal>). </para> <para> PHP 4: Inclut le support ClibPDF.(requires cpdflib >= 2). DIR est le dossier d'installation de cpdfllib (par défaut, <literal>/usr</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-esoob"> <term> <parameter>--with-esoob[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Easysoft OOB. DIR est le dossier d'installation de OOB (par défaut, <literal>/usr/local/easysoft/oob/client</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-exec-dir"> <term> <parameter>--with-exec-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: N'autorise que les exécutables placés dans le dossier DIR, lorsque le SAFE MODE est activé (par défaut, c'est <literal>/usr/local/php/bin</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fdftk"> <term> <parameter>--with-fdftk[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support fdftk. DIR est le dossier d'installation de fdftk (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gnu-ld"> <term> <parameter>--with-gnu-ld</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Suppose que le compilateur C utilise GNU ld (par défaut, <literal>no</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-icap"> <term> <parameter>--with-icap[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support ICAP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-imap"> <term> <parameter>--with-imap[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support IMAP. DIR est le dossier d'include d'IMAP (et aussi c-client.a). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-imsp"> <term> <parameter>--with-imsp[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support IMSP.(DIR est le dossier d'installation IMSP, là où il y a les dossiers d'include et libimsp.a). </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-java"> <term> <parameter>--with-java[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Java. DIR est le dossier d'installation du JDK). Cette extension peut uniquement être compilée comme "dl". </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-kerberos"> <term> <parameter>--with-kerberos[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Kerberos dans IMAP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mcal"> <term> <parameter>--with-mcal[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support MCAL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mcrypt"> <term> <parameter>--with-mcrypt[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support mcrypt. DIR est le dossier d'installation de mcrypt. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mhash"> <term> <parameter>--with-mhash[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support mhash. DIR est le dossier d'installation de mhash. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mm"> <term> <parameter>--with-mm[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support mm pour le stockage de session. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod_charset"> <term> <parameter>--with-mod_charset</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le transfert des tables depuis le module Apache mod_charset (Rus Apache). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pdflib"> <term> <parameter>--with-pdflib[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support pdflib (testé avec 0.6 et 2.0). DIR est le dossier d'installation de pdflib (par défaut, c'est <filename>/usr/local</filename>). </para> <para> PHP 4: Inclut le support pdflib 3.x/4.x. DIR est le dossier d'installation de pdflib. Par défaut, c'est <filename>/usr/local</filename>. </para> <para> PHP 4 et PDFlib 3.x/4.x requiert les librairies JPEG et TIFF. Lors de la compilation du support PDFlib utilise les options <link linkend="install.configure.with-jpeg-dir">--with-jpeg-dir</link> et <link linkend="install.configure.with-tiff-dir">--with-tiff-dir</link>. Vous pouvez aussi utiliser <link linkend="install.configure.with-png-dir">--with-png-dir</link> et <link linkend="install.configure.with-zlib-dir">--with-zlib-dir</link>, pour compiler le support PNG et Zlib avec PDFlib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared-pdflib"> <term> <parameter>--enable-shared-pdflib</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut pdflib comme shared librairy. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-readline"> <term> <parameter>--with-readline[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support readline. DIR est le dossier d'installation de readline. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-regex"> <term> <parameter>--with-regex=TYPE</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Type de librairie d'expressions régulières : système, apache, php </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-servlet"> <term> <parameter>--with-servlet[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support servlet. DIR est le dossier d'installation de JSDK. Ce SAPI demande que l'extension Java soit compilée comme shared dl. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ming"> <term> <parameter>--with-ming</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Flash 4 avec Ming. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-swf"> <term> <parameter>--with-swf[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support SWF. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-system-regex"> <term> <parameter>--with-system-regex</parameter> </term> <listitem> <para> PHP 3: Inactive la librairie d'expressions régulières livrée avec PHP. </para> <para> PHP 4: (Obsolète) Utilise la librairie d'expressions régulières système. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tsrm-pth"> <term> <parameter>--with-tsrm-pth[=pth-config]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Utilise GNU Pth. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tsrm-pthreads"> <term> <parameter>--with-tsrm-pthreads</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Utilise les threads POSIX (par défaut). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-x"> <term> <parameter>--with-x</parameter> </term> <listitem> <para> PHP 3: Utilise X Window System </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-bzip2-dir"> <term> <parameter>--with-bz2[=DIR]</parameter> </term> <listitem> <para> PHP 4: Ajoute le support bzip2. DIR est le dossier d'installation de bzip2. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zlib-dir"> <term> <parameter>--with-zlib-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: Dossier zlib pour pdflib 2.0 ou active le support zlib. </para> <para> PHP 4: Dossier zlib pour pdflib 3.x/4.x ou active le support zlib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zlib"> <term> <parameter>--with-zlib[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support zlib. (requiert zlib >= 1.0.9). DIR est le dossier d'installation de zlib (par défaut, <literal>/usr</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zziplib"> <term> <parameter>--with-zziplib[=DIR]</parameter> </term> <listitem> <para> PHP 4: Inclut le support ZZIPlib (requiert ZZIPlib >= 0.10.6). DIR est le dossier d'installation de ZZIPliby (par défaut, <literal>/usr/local</literal>). </para> <para> La dernière version de ZZIPlib est disponible à <ulink url="&url.zziplib;">&url.zziplib;</ulink>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-pcre-regex"> <term> <parameter>--without-pcre-regex</parameter> </term> <listitem> <para> PHP 3: Inactive le support des expressions régulières Perl. </para> <para> PHP 4: Inactive le support des expressions régulières Perl. Utilisez --with-pcre-regex=DIR pour spécifier le dossier d'installation de PCRE, si vous n'utilisez pas la librairie livrée en standard. </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-posix"> <term> <parameter>--without-posix</parameter> </term> <listitem> <para> PHP 3: N'Inclut pas lrs fonctions POSIX. </para> <para> PHP 4: Option non disponible en PHP 4; utilisez plutôt <link linkend="install.configure.disable-posix">--disable-posix</link>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.networking"> <title>Réseau</title> <variablelist> <varlistentry id="install.configure.with-curl"> <term> <parameter>--with-curl[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support CURL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-ftp"> <term> <parameter>--enable-ftp</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-ftp">--with-ftp</link> </para> <para> PHP 4: Active le support FTP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ftp"> <term> <parameter>--with-ftp</parameter> </term> <listitem> <para> PHP 3: Inclut le support FTP. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-ftp">--enable-ftp</link> instead </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-url-fopen-wrapper"> <term> <parameter>--disable-url-fopen-wrapper</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inactive le support des URL avec <function>fopen</function>. </para> <warning> <para> Cette option n'est disponible que jusqu'à la version 4.0.3. Les versions plus récentes fournissent un paramètre dans le fichier <filename>php.ini</filename> appelé <parameter>allow_url_fopen</parameter>, afin de vous éviter de faire ce choix au moment de la compilation. </para> </warning> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod-dav"> <term> <parameter>--with-mod-dav=DIR</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support DAV, grâce au module Apache mod_dav. DIR est le dossier d'installation de mod_dav (valable uniquement pour les serveurs Apache). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-openssl"> <term> <parameter>--with-openssl[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support OpenSSL avec SNMP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-snmp"> <term> <parameter>--with-snmp[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support SNMP. DIR est le dossier d'installation de SNMP (par défaut, il scanne un nombre de dossiers habituels de l'installation SNMP). Utilisez la valeur de "shared" pour compiler sous forme de "dl", ou "shared,DIR" pour compiler sous forme de "dl" tout en spécifiant un dossier. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-ucd-snmp-hack"> <term> <parameter>--enable-ucd-snmp-hack</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le hack UCD SNMP </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sockets"> <term> <parameter>--enable-sockets</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support des sockets. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-yaz"> <term> <parameter>--with-yaz[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support YAZ.(ANSI/NISO Z39.50). DIR est le dossier d'installation de YAZ (dossier bin). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-yp"> <term> <parameter>--enable-yp</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-yp">--with-yp</link> </para> <para> PHP 4: Active le support YellowPages (YP). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-yp"> <term> <parameter>--with-yp</parameter> </term> <listitem> <para> PHP 3: Active le support YellowPages (YP). </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-yp">--enable-yp</link> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mnogosearch"> <term> <parameter>--with-mnogosearch</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support mnoGoSearch. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.php"> <title>Comportement PHP</title> <variablelist> <varlistentry id="install.configure.enable-magic-quotes"> <term> <parameter>--enable-magic-quotes</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active les magic quotes par défaut. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-short-tags"> <term> <parameter>--disable-short-tags</parameter> </term> <listitem> <para> PHP 3, PHP 4: Désactive la forme courte des balises PHP (<? ?>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-track-vars"> <term> <parameter>--enable-track-vars</parameter> </term> <listitem> <para> PHP 3: Active le suivi des variables GET/POST/Cookie par défaut. </para> <para> PHP 4: Option non disponible en PHP 4; à partir de PHP 4.0.2, cette option est toujours activée. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.servers"> <title>Serveur</title> <variablelist> <varlistentry id="install.configure.with-aolserver-src"> <term> <parameter>--with-aolserver-src=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Indique le chemin jusqu'à la distribution source de AOLserver </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-aolserver"> <term> <parameter>--with-aolserver=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Indique le chemin jusqu'à la distribution installée de AOLserver. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-apache"> <term> <parameter>--with-apache[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile PHP en module Apache. DIR est le dossier d'installation supérieur d'Apache (par défaut, <literal>/usr/local/etc/httpd</literal>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-apxs"> <term> <parameter>--with-apxs[=FILE]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile PHP comme module partagé d'Apache module. FILE est le chemin optionnel jusqu'à Apache apxs tool; par défaut, c'est apxs). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> PHP 3: Tire profit du système de versionnage et de scoping fourni par Solaris 2.x et Linux </para> <para> PHP 4: Exporte uniquement les symboles nécessaires. Voyez l'installation pour plus de détails. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-caudium"> <term> <parameter>--with-caudium[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP sous forme de module Pike pour être utilisé avec le serveur web Caudium. DIR est le dossier d'installation de Caudium (par défaut, <literal>$prefix/caudium/server</literal>. Le préfixe est paramétré par l'option --prefix (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fhttpd"> <term> <parameter>--with-fhttpd[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile PHP comme module fhttpd. DIR est le dossier d'installation de fhttpd (par défaut, <literal>/usr/local/src/fhttpd</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-nsapi"> <term> <parameter>--with-nsapi=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Indique le chemin jusqu'au serveur Netscape </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-phttpd"> <term> <parameter>--with-phttpd=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pi3web"> <term> <parameter>--with-pi3web=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP comme module pour Pi3Web. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-roxen"> <term> <parameter>--with-roxen=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP comme module pour Pi3Web Pike. DIR est le dossier d'installation de Roxen (par défaut, <literal>/usr/local/roxen/server</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-roxen-zts"> <term> <parameter>--enable-roxen-zts</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile le module Roxen en utilisant Zend Thread Safety. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-thttpd"> <term> <parameter>--with-thttpd=SRCDIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zeus"> <term> <parameter>--with-zeus=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP comme module ISAPI pour Zeus. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.text"> <title>Texte et langue</title> <variablelist> <varlistentry id="install.configure.with-aspell"> <term> <parameter>--with-aspell[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support ASPELL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gettext"> <term> <parameter>--with-gettext[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support GNU gettext. DIR est le dossier d'installation de gettext (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-iconv"> <term> <parameter>--with-iconv[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support iconv. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pspell"> <term> <parameter>--with-pspell[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support PSPELL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-recode"> <term> <parameter>--with-recode[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support GNU recode. </para> <para> PHP 4: Inclut le support recode. DIR est le dossier d'installation de recode. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shmop"> <term> <parameter>--enable-shmop</parameter> </term> <listitem> <para> PHP 3, PHP 4 : Inclut le support shmop. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.xml"> <title>XML</title> <variablelist> <varlistentry id="install.configure.with-dom"> <term> <parameter>--with-dom[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support DOM. (requiert libxml >= 2.0). DIR est le dossier d'installation de libxml (par défaut, <filename>/usr</filename>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sablot-errors-descriptive"> <term> <parameter>--enable-sablot-errors-descriptive</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active les erreurs descriptives. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-sablot"> <term> <parameter>--with-sablot[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Sablotron. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-wddx"> <term> <parameter>--enable-wddx</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support WDDX. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-xml"> <term> <parameter>--disable-xml</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3; Les fonctions XML ne sont pas construites par défaut. Utilisez plutôt <link linkend="install.configure.with-xml">--with-xml</link> pour les activer. </para> <para> PHP 4: Inactive le support XML, qui utilise la librairie expat, livrée avec PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-xml"> <term> <parameter>--with-xml</parameter> </term> <listitem> <para> PHP 3: Active le support XML. </para> <para> PHP 4: Option non disponible en PHP 4; Le support XML est activé par défaut. Utilisez plutôt <link linkend="install.configure.disable-xml">--disable-xml</link> pour l'inactiver. </para> </listitem> </varlistentry> </variablelist> </sect2> </sect1> <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;">téléchargement</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 <filename>php.ini</filename> 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>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. 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> <para> Notez cependant que les modules SAPI <emphasis>ne sont pas</emphasis> considéré comme ayant atteint une qualité de production. La raison à cela est que les modules SAPI utilisent le système de thread sécurisé de PHP, ce qui est nouveau en PHP 4, et qui n'a pas été testé et torturé suffisamment pour être considérés comme stable. </para> <para> Il y a encore quelques bugs qui trainent. D'un autre côté, certains d'entre vous ont rapporté des résultats significativement meilleurs avec les modules SAPI, même si nous ne connaissons actuellement personne qui le fasse fonctionner en production. En clair, faites votre choix : soit vous avez absolument besoin de stabilité, et il vaut mieux laisser les performances SAPI de côté; soit vous avez besoin de performances, et alors c'est l'occasion de tester en production et de nous rapporter vos résultats. </para> <para> Si vous choisissez l'un des modules SAPI et utilisez Windows 95, pensez à télécharger la mise à jour DCOM à <ulink url="http://download.microsoft.com/msdownload/dcom/95/x86/en/dcom95.exe">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 '<filename>php.ini</filename>'. 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 <filename>php.ini</filename> : <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. Vous pouvez décommenter les lignes 'extension=php_*.dll' pour charger ces modules. Certains modules requièrent que des librairies supplémentaires soient installées sur votre système. La <ulink url="&url.php.faq;">FAQ</ulink> PHP a plus d'informations sur ces librairies. Vous pouvez aussi charger dynamiquement ces librairies avec <command>dl("php_*.dll");</command>. Voyez la section sur les <link linkend="install.windows.extensions">extensions Windows</link>. </simpara> </listitem> <listitem> <simpara> Sous PWS et IIS, vous pouvez modifier le fichier <filename>browscap.ini</filename> pour qu'il pointe sur : <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous Windows 9x/Me et <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sous NT/2000. </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> </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.prepare"> <title>Préparation</title> <para> Avant de commencer, il faut télécharger un maximum de fichiers! </para> <itemizedlist> <listitem> <simpara> Pour commencer, téléchargez le Cygwin depuis le miroir <ulink url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink> le plus proche. Cela vous donnera les utilitaires GNU les plus populaires, utilisés durant le processus de compilation. </simpara> </listitem> <listitem> <simpara> Téléchargez le reste des utilitaires de compilation dont vous aurez besoin depuis le site PHP à <ulink url="http://www.php.net/extra/win32build.zip"> http://www.php.net/extra/win32build.zip</ulink>. </simpara> </listitem> <listitem> <simpara> Téléchargez le code source du DNS utilisé par PHP à <ulink url="http://www.php.net/extra/bindlib_w32.zip"> http://www.php.net/extra/bindlib_w32.zip</ulink>. Il remplacera le fichier <filename>resolv.lib</filename> inclut dans <filename>win32build.zip</filename>. </simpara> </listitem> <listitem> <simpara> Si vous n'avez pas d'utilitaire de dézippage, vous devez en télécharger un. Une version libre est disponible à <ulink url="http://www.cdrom.com/pub/infozip/UnZip.html">InfoZip</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="http://www.php.net/anoncvs.php">anonyme</ulink>. Si vous téléchargez une version <ulink url="http://snaps.php.net/">intermédiaire</ulink> ou la <ulink url="http://www.php.net/downloads.php">source</ulink>, vous devez non seulement extraire les fichiers, mais aussi convertir les nouvelles lignes en leur équivalent windows (crlf) dans les fichiers <filename>*.dsp</filename> et <filename>*.dsw</filename> avant que Microsoft Visual C++ ne soit capable de les comprendre. </simpara> <note> <simpara> Placez les dossiers <filename>Zend</filename> et <filename>TSRM</filename> dans le dossier <filename>php4</filename> pour que les projets puissent les trouver durant la compilation. </simpara> </note> </sect3> <sect3 id="install.windows.build.install"> <title>Mettre tout ensemble</title> <itemizedlist> <listitem> <simpara> Suivez les instructions pour installer l'utilitaire d'unzip de votre choix. </simpara> </listitem> <listitem> <simpara> Exécutez <filename>setup.exe</filename> et suivez les instructions d'installation. Si vous décidez d'installer dans un autre dossier que <filename>c:\cygnus</filename>, indiquez le au processus de compilation en modifiant la variable d'environnement Cygwin. Sous Windows 9x/Me, modifier une variable d'environnement se fait en ajoutant une ligne dans le fichier <filename>autoexec.bat</filename>. Sous Windows NT, allez dans le menu "Démarrer => Paramètres => Panneau de contrôle => Système " ("My Computer => Control Panel => System ") et sélectionnez l'onglet "environnement" ("environment"). </simpara> <warning> <simpara> Créez un dossier temporaire pour Cygwin, sinon de nombreuses commandes (comme bison) échoueront. Sous Windows 9x/Me, <userinput>mkdir C:\TMP</userinput>. Sous Windows NT, <userinput>mkdir %SystemDrive%\tmp</userinput>. </simpara> </warning> </listitem> <listitem> <simpara> Créez un dossier et dézippez <filename>win32build.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> Lancez Microsoft Visual C++, et allez dans le menu "select Tools => Options". Dans le dialogue, sélectionnez l'onglet "directories". Assurez-vous que <filename>cygwin\bin</filename>, <filename>win32build\include</filename>, et <filename>win32build\lib</filename> sont bien dans les menus déroulants "Executables", "Include", et "Library". (Pour ajouter une entrée, sélectionnez une ligne blanche, et tapez). Une entrée typique ressemble à ceci : </simpara> <itemizedlist> <listitem> <simpara> <filename>c:\cygnus\bin</filename> </simpara> </listitem> <listitem> <simpara> <filename>c:\php-win32build\include</filename> </simpara> </listitem> <listitem> <simpara> <filename>c:\php-win32build\lib</filename> </simpara> </listitem> </itemizedlist> <simpara> Pressez "OK", et sortez de Visual C++. </simpara> </listitem> <listitem> <simpara> Créez un autre dossier et dézippez <filename>bindlib_w32.zip</filename> dedans. Décidez si vous avez besoin des symboles de débuggage (bindlib - Win32 Debug) ou non (bindlib - Win32 Release). Compilez la configuration adéquate : </simpara> <itemizedlist> <listitem> <simpara> Pour les utilisateurs de GUI, 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> <listitem> <simpara> 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. </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> </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 une librairie <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> Répétez les instructions ci-dessus avec <filename>php4isapi.dsp</filename> (qui est dans <filename>sapi\isapi</filename>) pour compiler le code nécessaire pour intégrer PHP avec Microsoft IIS. </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 <filename>php.ini</filename>. 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.4pl1, les extensions BCMath, BCMath,Calendar, COM, FTP, MySQL, ODBC, PCRE, Sessions, WDDX et XML sont activées <emphasis>par défaut</emphasis>. Vous n'avez rien à faire pour qu'elles soient inclues. Lisez le fichier <filename>README.txt</filename> ou <filename>install.txt</filename> dans votre distribution pour connaître la liste des modules par défaut. </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> </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>Extensions PHP</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 Bzip2</entry> <entry>Aucune</entry> </row> <row> <entry>php_calendar.dll</entry> <entry>Fonctions de conversions calendaires (Depuis PHP 4.03, elles sont activées par défaut)</entry> <entry>Activée automatiquement depuis PHP 4.0.3</entry> </row> <row> <entry>php_cpdf.dll</entry> <entry>Fonctions ClibPDF</entry> </row> <row> <entry>php_crypt.dll</entry> <entry>Fonctions de cryptage</entry> <entry>Aucune</entry> </row> <row> <entry>php_ctype.dll</entry> <entry>Fonctions ctype</entry> <entry>Aucune</entry> </row> <row> <entry>php_curl.dll</entry> <entry>Fonctions CURL</entry> <entry>Requiert : libeay32.dll, ssleay32.dll (fournies)</entry> </row> <row> <entry>php_cybercash.dll</entry> <entry>Fonctions de paiement Cybercash</entry> <entry>Aucune</entry> </row> <row> <entry>php_db.dll</entry> <entry>Fonctions DBM</entry> <entry>Obsolète. Utilisez DBA à la place (php_dba.dll)</entry> </row> <row> <entry>php_dba.dll</entry> <entry>Fonctions dbm-style</entry> <entry>Aucune</entry> </row> <row> <entry>php_dbase.dll</entry> <entry>Fonctions DBase</entry> <entry>Aucune</entry> </row> <row> <entry>php3_dbm.dll</entry> <entry>Librairie d'émulation GDBM via Berkely DB2</entry> <entry>Aucune</entry> </row> <row> <entry>php_domxml.dll</entry> <entry>Fonctions DOM XML</entry> <entry>Requiert : libxml2.dll (fournie)</entry> </row> <row> <entry>php_dotnet.dll</entry> <entry>Fonctions .NET</entry> <entry>Aucune</entry> </row> <row> <entry>php_exif.dll</entry> <entry>Entêtes EXIF des images JPEG</entry> <entry>Aucune</entry> </row> <row> <entry>php_fbsql.dll</entry> <entry>Fonctions FrontBase</entry> <entry>Aucune</entry> </row> <row> <entry>php_fdf.dll</entry> <entry>Fonction FDF (Forms Data Format)</entry> <entry>Requiert: fdftk.dll (fournie)</entry> </row> <row> <entry>php_filepro.dll</entry> <entry>Lecture des bases filepro</entry> <entry>Accès en lecture seule</entry> </row> <row> <entry>php_ftp.dll</entry> <entry><link linkend="ref.ftp">Fonctions FTP</link></entry> <entry>Activée par défaut depuis PHP 4.0.3</entry> </row> <row> <entry>php_gd.dll</entry> <entry>Bibliothèque GD (pour les manipulations d'images)</entry> <entry>Aucune</entry> </row> <row> <entry>php_gettext.dll</entry> <entry>Fonctions GNU Gettext</entry> <entry>Requiert : gnu_gettext.dll (fournie)</entry> </row> <row> <entry>php_hyperwave.dll</entry> <entry>Fonctions HyperWave</entry> <entry>Aucune</entry> </row> <row> <entry>php_iconv.dll</entry> <entry>Fonctions de conversions ICONV</entry> <entry>Requiert : iconv-1.3.dll (fournie)</entry> </row> <row> <entry>php_ifx.dll</entry> <entry>Fonctions Informix</entry> <entry>Requiert: librairies Informix</entry> </row> <row> <entry>php_iisfunc.dll</entry> <entry>Fonctions IIS</entry> <entry>Aucune</entry> </row> <row> <entry>php_imap.dll</entry> <entry>Fonctions IMAP 4(en PHP 3: php3_imap4r1.dll)</entry> <entry>PHP 3: php3_imap4r1.dll</entry> </row> <row> <entry>php_ingres.dll</entry> <entry>Fonctions Ingres II</entry> <entry>Requiert: librairies Ingres II</entry> </row> <row> <entry>php_interbase.dll</entry> <entry>Fonctions InterBase</entry> <entry>Requiert: gds32.dll (fournie)</entry> </row> <row> <entry>php_java.dll</entry> <entry>Extension Java</entry> <entry>Requiert: jvm.dll (fournie)</entry> </row> <row> <entry>php_ldap.dll</entry> <entry>Fonctions LDAP</entry> <entry>Requiert: libsasl.dll (fournie)</entry> </row> <row> <entry>php_mhash.dll</entry> <entry>Fonctions Mhash</entry> <entry>Aucune</entry> </row> <row> <entry>php_ming.dll</entry> <entry>Fonctions Ming pour Flash</entry> <entry>Aucune</entry> </row> <row> <entry>php_msql.dll</entry> <entry>Fonctions mSQL</entry> <entry>Requiert: msql.dll (fournie)</entry> </row> <row> <entry>php3_msql1.dll</entry> <entry>Fonctions mSQL 1</entry> <entry>Aucune</entry> </row> <row> <entry>php3_msql2.dll</entry> <entry>Fonctions mSQL 2</entry> <entry>Aucune</entry> </row> <row> <entry>php_mssql.dll</entry> <entry>Fonctions MSSQL (anciennement php_mssql70.dll, requiert MSSQL DB-Libraries)</entry> <entry>Requiert: ntwdblib.dll (fournie)</entry> </row> <row> <entry>php3_mysql.dll</entry> <entry>Fonctions MySQL (Activées par défaut en PHP 4)</entry> <entry>Aucune</entry> </row> <row> <entry>php_nsmail.dll</entry> <entry>Fonctions Netscape mail</entry> <entry>Aucune</entry> </row> <row> <entry>php3_oci73.dll</entry> <entry>Fonctions Oracle</entry> <entry>Aucune</entry> </row> <row> <entry>php_oci8.dll</entry> <entry>Fonctions Oracle 8</entry> <entry>Requiert: librairies clientes Oracle 8</entry> </row> <row> <entry>php_openssl.dll</entry> <entry>Fonctions OpenSSL</entry> <entry>Requiert: libeay32.dll (fournie)</entry> </row> <row> <entry>php_oracle.dll</entry> <entry>Fonctions Oracle</entry> <entry>Requiert: librairies clientes Oracle 7</entry> </row> <row> <entry>php_pdf.dll</entry> <entry>Fonctions PDF</entry> <entry>Aucune</entry> </row> <row> <entry>php_pgsql.dll</entry> <entry>Fonctions PostgreSQL</entry> <entry>Aucune</entry> </row> <row> <entry>php_printer.dll</entry> <entry>Fonctions d'impression</entry> <entry>Aucune</entry> </row> <row> <entry>php_sablot.dll</entry> <entry>Focntions XSLT</entry> <entry>Requiert: sablot.dll (fournie)</entry> </row> <row> <entry>php_snmp.dll</entry> <entry>Fonctions <acronym>SNMP</acronym> get et walk</entry> <entry>NT uniquement!</entry> </row> <row> <entry>php_sybase_ct.dll</entry> <entry>Fonctions Sybase</entry> <entry>Requiert: librairies clientes Sybase</entry> </row> <row> <entry>php_yaz.dll</entry> <entry>Fonctions YAZ</entry> <entry>Aucune</entry> </row> <row> <entry>php_zlib.dll</entry> <entry>Fonctions ZLib</entry> <entry>Aucune</entry> </row> </tbody> </tgroup> </table> </para> </sect2> </sect1> <sect1 id="install.apache"> <title>Installation du 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 (version module) </title> <programlisting>1. gunzip apache_1.3.x.tar.gz2. tar xvf apache_1.3.x.tar3. gunzip php-x.x.x.tar.gz4. tar xvf php-x.x.x.tar5. cd apache_1.3.x6. ./configure --prefix=/www7. cd ../php-x.x.x8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars9. make10. make install11. cd ../apache_1.3.x12. for PHP 3: ./configure --activate-module=src/modules/php3/libphp3.a for PHP 4: ./configure --activate-module=src/modules/php4/libphp4.a13. make14. 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.x16. 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 envoyerun 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. <informalexample> <programlisting>1. Nombreuses variantes Linux SysV :/etc/rc.d/init.d/httpd restart2. Avec les scripts apachectl :/path/to/apachectl stop/path/to/apachectl start3. httpdctl et httpsdctl (utilisant OpenSSL), similaire à apachectl:/path/to/httpsdctl stop/path/to/httpsdctl start4. En utilisant mod_ssl, ou un autre seveur SSL, manuellement :/path/to/apachectl stop/path/to/apachectl startssl </programlisting> </informalexample> 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 : <informalexample> <programlisting>./configure --with-apxs --with-pgsql </programlisting> </informalexample> </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> <informalexample> <programlisting>./configure --with-apxs --with-pgsql=shared </programlisting> </informalexample> </para> <para> Cette commande va créer une autre librairie partagée <filename>libphp4.so</filename>, mais va aussi créer une librairie partagée <filename>pgsql.so</filename> qui sera chargée dans PHP avec les options de configurations du fichier <filename>php.ini</filename> ou par chargement dynamique avec <function>dl</function>. </para> <para> <informalexample> <programlisting>./configure --with-apache=/path/to/apache_source --with-pgsql </programlisting> </informalexample> </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 inclus Apache et PHP. </para> <para> <informalexample> <programlisting>./configure --with-apache=/path/to/apache_source --with-pgsql=shared </programlisting> </informalexample> </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 <filename>php.ini</filename> 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 <ulink url="&url.apachedso;">webpage on DSO support</ulink>. </para> </sect2> <sect2 id="install.apache.windows"> <title>Détails sur l'installation de 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> <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> <note> <simpara> Avec Apache 1.3.22 pour Windows, le fichier de configuration par défaut (<filename>httpd.conf-dist-win</filename>) a une directive <literal>ClearModuleList</literal> incluse par défaut. Si cette directive est utilisé, il est nécessaire de mettre une ligne <literal>AddModule mod_php4.c</literal> à la liste <literal>AddModule</literal>, sinon PHP ne sera pas enregistré comme Module Apache. </simpara> </note> <simpara> Pour utiliser les fonctionnalités de mise en évidence du code source, créez simplement un script PHP et ajoutez le code suivant : <literal><?php show_source("original_php_script.php"); ?></literal>. Remplacez le fichier <literal>original_php_script.php</literal> par le fichier que vous voulez afficher : c'est la seule manière de le faire, car il n'y a pas de fonctionnalités phps sous Windows. </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> <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 vous voulez que votre serveur web supporte le PHP, compiler le PHP comme un CGI permet d'obtenir de meilleures 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 <link linkend="ini.safe-mode">safe mode</link> 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 <link linkend="ini.safe-mode">safe mode</link> 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> </sect1> <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 <option role="configure"><link linkend="install.configure.with-fhttpd">--with-fhttpd</link>=<replaceable>DIR</replaceable></option> 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> <sect1 id="install.caudium"> <title>Installation sur serveur Caudium</title> <para> PHP 4 peut être compilé comme module Pike pour le serveur web Caudium. 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/server4. make5. make install6. Redémarrez Caudium s'il était en fonctionnement7. 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 à <filename>PHP4.so</filename>. De même, assurez-vous que <filename>caudium/server/lib/[pike-version]/PHP4.so</filename> 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 <link linkend="install.configure.with-mysql">--with-mysql</link>. </para> </note> </sect1> <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> <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 <option><link linkend="install.configure.with-nsapi">--with-nsapi</link> = <replaceable>DIR</replaceable></option> 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> <programlisting>Instructions pour Sun Solaris 2.6 avec Netscape Enterprise Server 3.6From: bhager@invacare.com1. Installez les packages suivants depuis le serveur www.sunfreeware.comou 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 PATH3. 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.tar5. cd ../php-x.x.x6. Pour les étapes suivantes, assurez-vous que /opt/netscape/suitespot/ correspondbien à votre installation du serveur netscape. Sinon, indiquez le chemincorrect : /configure --with-mysql=/usr/local/mysql --with-nsapi=/opt/netscape/suitespot/ --enable-track-vars --enable-libgcc7. make8. make install </programlisting> </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> <programlisting>Instructions de configuration for Netscape Enterprise ServerFrom: bhager@invacare.com1. Ajoutez les lignes suivantes dans mime.types: type=magnus-internal/x-httpd-php exts=php2. Ajoutez les lignes suivantes dans obj.conf. shlib peut dépendre devotre 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> </programlisting> </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> 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>assoc .php=PHPScriptftype 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>assoc .php=PHPScriptftype 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>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>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>+<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> <sect1 id="install.omnihttpd"> <title>Installation OmniHTTPd</title> <para> Cette section contient des notes et conseils spécifiques à OmniHTTPd. </para> <sect2 id="install.omnihttpd.windows"> <title>OmniHTTPd 2.0b1 et plus récent pour Windows</title> <simpara> Vous devez compléter les étapes suivantes pour configurer PHP avec OmniHTTPd. Ceci est une installation sous forme de CGI. SAPI est supporté par OmniHTTPd, mais des tests ont montrés que ce n'est pas stable d'utiliser PHP en module ISAPI avec OmniHTTPd. </simpara> <para> <itemizedlist> <listitem> <para> Step 1: Installez Omni server. </para> </listitem> <listitem> <para> Step 2: Faites un clic-droit sur l'icone bleue d'OmniHTTPd, sur le bureau, 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". </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". </para> </listitem> <listitem> <para> Step 6: Cliquez sur <literal>OK</literal>. </para> </listitem> </itemizedlist> </para> <simpara> Réptez les étapes 2 à 6 pour chaque extension que vous voulez associer à PHP. </simpara> <note> <para> Certains packages OmniHTTPd sont livrés avec le support PHP déjà intégré. Vous pouvez choisir au moment de la configuration de faire un paramétrage poussé et de décocher le support PHP. Nous vous conseillons d'utiliser les dernières versions de PHP. Certains serveurs OmniHTTPd sont encore livrés avec des versions beta de PHP : il est recommandé de ne pas les installer, mais d'installer votre propre version. Si le serveur est déjà sur votre machine, vous pouvez utiliser le bouton "Replace" dans les étapes 4 et 5 pour en choisir un nouveau et à jour. </para> </note> </sect2> </sect1> <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> <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> </itemizedlist> </para> </sect2> </sect1> <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.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> <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 à <ulink url="&url.php.faq;">&url.php.faq;</ulink>. N'envoyez pas de rapport de bug ou de courriers personnels sur la liste de diffusion. Le système de bug est aussi capable de traiter les suggestions. </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> <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, <link linkend="ini.safe-mode">safe mode</link>...), et n'hésitez pas à envoyer suffisamment de code pour que nous puissions reproduire l'erreur. </simpara> </sect2> </sect1></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:tsgml-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/security.xml diff -u phpdoc/fr/chapters/security.xml:1.16 phpdoc/fr/chapters/security.xml:1.17 --- phpdoc/fr/chapters/security.xml:1.16 Wed Jul 25 15:13:42 2001 +++ phpdoc/fr/chapters/security.xml Mon Nov 12 00:03:38 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.17 $ --> <chapter id="security"> <title>Sécurité</title> <simpara> @@ -39,6 +41,57 @@ toute sécurité. Puis, viennent les considérations de niveaux de sécurité, et les conseils généraux. </simpara> + <sect1 id="security.general"> + <title>Considérations générales</title> + <simpara> + Un système complètement sûr est une impossiblité virtuelle. + L'approche souvent utilisée par les professionnels de la + sécurité est d'équilibrer les risques et l'ergonomie. + Si chaque variable fournie par l'utilisateur demandaient deux + formes de validation biométrique (un scan de la rétine et + une empreinte digitale), on obtiendrait un système avec + un niveau de sécurité d'un bon niveau. Il faudrait aussi une + bonne heure pour remplir un formulaire simple, ce qui encouragerait + les utilisateurs à trouver un moyen de contourner cette sécurité. + </simpara> + <simpara> + La meilleure sécurité est suffisamment discrète pour assurer + un maximum de sécurité sans ajouter de contraintes insurmontables + pour l'utilisateur ou de systèmes complexes de programmation. + Souvent, les attaques sur un script sont des exploitations + des sysèmes de sécurité trop complexes, qui s'érodent au cour + du temps. + </simpara> + <simpara> + Un principe qu'il est bon de retenir : Un système est aussi sur + que son maillon le plus faible. Si toutes les transactions sont + bien notées dans une base, avec confirmation mais que l'utilisateur + n'est authentifiée que par un cookie, la robustesse de votre + système est sévèrement réduite. + </simpara> + <simpara> + Lorsque vous testez votre site, gardez en tête que vous ne pourrez + jamais tester toutes les situations, même pour les pages les plus + simples. Les valeurs que vous attendez seront toujours complétement + différentes des valeurs qu'un employé négligent, un hacker qui a toute + la nuit devant lui ou encore le chat de la maison qui marche sur le clavier. + C'est pourquoi il est préférable de regarder le code d'un point de vue + logique, pour repérer les points d'entrée des données inattendues, + puis de voir comment elles pourront être modifiées, + amplifiées ou réduites. + </simpara> + <simpara> + L'Internet est rempli d'individu qui tentent de se faire une renommée + en piratant vos programmes, en bloquant votre site, en envoyant des contenus + inappropriés, qui rendent vos journées si "spéciales". + Peut importe que vous ayez un grand portail ou un petit web, vous pouvez + être la cible pour tout quidam avec une connexion. Vous êtes une + cible potentielle dès que vous êtes connecté vous-même. + Certains programmes de piratage ne font pas dans la demi-mesure, et + testent systématiquement des millions d'IP, à la recherche + de victimes : ne soyez pas la prochaine. + </simpara> + </sect1> <sect1 id="security.cgi"> <title>Binaires CGI</title> <sect2 id="security.cgi.attacks"> @@ -304,6 +357,13 @@ Pour les professionnels de la sécurité, une telle utilisation est à exclure d'office. </simpara> + <simpara> + Il existe des solutions plus simples. En utilisant + <function>open_basedir</function> vous pouvez contrôler et restraindre + l'accès à certains dossiers qui pourront être utilisés par PHP. Vous pouvez + aussi des aires de restrictions Apache, pour restraindre les activités + anonymes liées aux internautes. + </simpara> </sect1> <sect1 id="security.filesystem"> <title>Sécurité des fichiers</title> @@ -337,7 +397,7 @@ <programlisting role="php"> <?php // efface un fichier dans un dossier racine -$username = $user_submitted_name; +$username = $HTTP_POST_VARS['user_submitted_name']; $homedir = "/home/$username"; $file_to_delete = "$userfile"; unlink ($homedir/$userfile); @@ -362,7 +422,7 @@ $homedir = "/home/../etc/"; $file_to_delete = "passwd"; unlink ("/home/../etc/passwd"); -echo "/home/../etc/passwd" has been deleted!"; +echo "/home/../etc/passwd a été effacé!"; ?> </programlisting> </example> @@ -381,39 +441,46 @@ </simpara> </listitem> </itemizedlist> - Voici le script renforcé : + Voici un script renforcé : <example> <title>Une vérification renforcée</title> <programlisting role="php"> <?php // Efface un fichier sur le disque où l'utilisateur à le droit d'aller -$username = get_env("REMOTE_USER"); + $username = $HTTP_SERVER_VARS['REMOTE_USER']; // utilise un mécanisme d'authentification -$homedir = "/home/$username"; -$file_to_delete = basename("$userfile"); + $homedir = "/home/$username"; + $file_to_delete = basename("$userfile"); // supprime le chemin excédentaire -unlink ($homedir/$file_to_delete); -$fp = fopen("/home/logging/filedelete.log","+a"); //note l'effacement -$logstring = "$HTTP_REMOTE_USER $homedir $file_to_delete"; -fputs ($fp, $logstring); -fclose($fp); -echo "$file_to_delete a été éffacé!"; + unlink ($homedir/$file_to_delete); + $fp = fopen("/home/logging/filedelete.log","+a"); //note l'effacement + $logstring = "$username $homedir $file_to_delete"; + fputs ($fp, $logstring); + fclose($fp); + echo "$file_to_delete a été éffacé!"; ?> </programlisting> </example> - Vous pouvez-vous protéger avec une vérification telle que : + Cependant, même cette technique n'est pas sans faille. + Si votre système d'identification permet aux utilisateurs + de créer leur propre login, et qu'un utilisateur choisi + le login "../etc/", le système est de nouveau exposé. Pour cette + raison, vous pouvez essayez d'écrire un script renforcé : <example> <title>Vérification de noms de fichier sécurisée</title> <programlisting role="php"> <?php -$username = $HTTP_REMOTE_USER; -$homedir = "/home/$username"; -if (!ereg('^[^./][^/]*$', $userfile)) - die('Erreur de nom de fichier'); //meurt, ne pas traiter! + $username = $HTTP_SERVER_VARS['REMOTE_USER'];; + $homedir = "/home/$username"; + if (!ereg('^[^./][^/]*$', $username)) + die('Erreur de nom de fichier'); + //meurt, ne SURTOUT pas traiter! //etc... ?> </programlisting> </example> + </para> + <para> Suivant votre système d'exploitation, vous devrez protéger un grand nombre de fichiers, notamment les entrées de périphériques, (/dev/ ou COM1), les fichiers de configuration (fichiers /etc/ et .ini), @@ -424,13 +491,30 @@ </sect1> <sect1 id="security.errors"> <title>Rapport d'erreur</title> - <simpara> + <para> + En terme de sécurité, il y a deux conséquence au rapport d'erreur. + D'un coté, cela améliore la sécurité, + mais d'un autre, cela la réduit aussi. + </para> + <para> Une tactique d'attaque standard consiste à faire faire des erreurs au système, et lire les variables d'environnement et de contexte qui sont retournées. Cela permet au pirate de lire de nombreuses informations sur le serveur, et de détecter des faiblesses du serveur. - </simpara> - <simpara> + Par exemple, si un intrus a glané des informations sur votre page, avec + une première utilisation de votre site, il peut essayer de remplacer les + variables par ses propres valeurs : + <example> + <title>Attacque de site avec une page HTML personnalisée</title> + <programlisting role="php"> +<form method="post" action="http://www.site.cible.com/?username=badfoo&password=badfoo"> +<input type="hidden" name="username" value="badfoo"> +<input type="hidden" name="password" value="badfoo"> +</form> + </programlisting> + </example> + </para> + <para> Les erreurs PHP qui sont normalement retournées peuvent être très pratiques pour un développeur qui essaie de débugger un script, car elles donnent de précieux renseignements tels que @@ -439,17 +523,35 @@ ces informations sont exploitables. Il est commun aux développeurs PHP d'utiliser les fonctions <function>show_source</function>, <function>highlight_string</function>, ou <function>highlight_file</function> - comme outils de débuggage, mais sur un site en production, cela expose + comme outils de débuggage, mais sur un site en production, cela expose des variables cachées, des syntaxes non vérifiées - ou d'autres informations dangereuses. - </simpara> - <simpara> - Par exemple, le style d'erreur indique sur quel système PHP fonctionne. + ou d'autres informations critiques. Il est particulièrement dangeureux + d'exécuter du code de sources connues, avec les gestionnaires de + débuggage. Si l'intrus peut comprendre votre technique habituelle + d'utilisation, il peut tenter une attaque frontale sur une page, en + envoyant des chaînes de débuggage : + <example> + <title>Exploiter des variables classiques de débuggage</title> + <programlisting role="php"> +<form method="post" action="http://www.site.cible.com/?errors=Y&showerrors=1"&debug=1"> +<input type="hidden" name="errors" value="Y"> +<input type="hidden" name="showerrors" value="1"> +<input type="hidden" name="debug" value="1"> +</form> + </programlisting> + </example> + </para> + <para> + Indépendamment de la gestion des erreurs, la possibilité de tester + la gestion des erreurs d'un système conduit à un trou de sécurité, + et la diffusion de plus d'informations sur votre système. + </para> + <para> Si un pirate affiche une page <acronym>html</acronym>, et essaye de la tester (pour rechercher des faiblesses du système), il peut déterminer sur quel système PHP a été compilé. - </simpara> - <simpara> + </para> + <para> Une erreur de fonction indique si un système supporte une base de données spécifique, ou bien indique comment la page a été générée. Cela peut orienter l'intrus @@ -458,23 +560,123 @@ erronées, par exemple, un pirate peut déterminer l'ordre d'authentification dans un script (à partir des lignes d'erreurs), et d'essayer de les exploiter ailleurs, dans le script. - </simpara> - <simpara> + </para> + <para> Une erreur de fichier, ou une erreur générale PHP peut indiquer quelles sont les permissions du serveur web, ainsi que la structure et l'organisation des fichiers. Les gestionnaires d'erreurs utilisateurs peuvent aussi aggraver ce problème, en permettant l'exploitation facile d'informations préalablement cachées. - </simpara> - <simpara> - Il y a trois solutions majeures à ces problèmes : la première est - de scruter toutes les fonctions, et essayer de traiter toutes les + </para> + <para> + Il y a trois solutions majeures à ces problèmes : la première + est de scruter toutes les fonctions, et d'essayer de traiter toutes les erreurs. La deuxième est d'inactiver le rapport d'erreur, dès que le script est en production. La troisième est d'utiliser les fonctions de gestions des erreurs. Suivant votre politique de sécurité, vous pouvez utiliser un panachage savant des trois méthodes. - </simpara> + </para> + <para> + Une méthode pour gagner du temps est d'utiliser la fonction + <function>error_reporting</function>, pour vous aider à + sécuriser le code, et détecter les utilisations dangeureuses de variables. + Vous testez votre code en béta-test avec la valeur <constant>E_ALL</constant>, + et vous pouvez rapidement repérer les variables qui ne sont pas + protégées. Une fois que le code est prêt à être déployé, + utilisez la constante <constant>E_NONE</constant>, pour isoler + votre code. + <example> + <title>Détecter des variables non protégées avec E_ALL</title> + <programlisting role="php"> +<?php + if ($username) { +// Non initialisée, ou vérifée avant utilisation + $good_login = 1; + } + if ($good_login == 1) { +// Si le test ci-dessus échoue, les valeurs n'ont pas été testées + fpassthru ("/données/très/très/sensibles/index.html"); + } +?> + </programlisting> + </example> + </para> + </sect1> + <sect1 id="security.registerglobals"> + <title>Utilisation des variables HTTP</title> + <para> + Une fonctionnalité de PHP qui peut être utilisée pour + améliorer la sécurité est de configurer PHP en inactivant l'option + <link linkend="ini.register-globals">register_globals</link>. + En supprimant la possibilité que les variables envoyées + par les internautes soient injectées automatiquement dans + le script PHP, vous pouvez restreindre la quantité de + variables non-protégées. Les intrus devront prendre beaucoup plus + de temps pour corrompre les mécanismes d'envoi de données, + et vos variables internes seront nettement mieux protégées. + </para> + <para> + Bien que cela augmente d'autant les efforts à fournir pour + écrire un script PHP, les bénéfices peuvent en être + nettement plus interessants. + <example> + <title>Travailler avec register_globals actif</title> + <programlisting role="php"> +<?php + if ($username) { +// attention, cette valeur peut être parasitée via GET/POST/COOKIES + $good_login = 1; + } +if ($good_login == 1) { +// attention, cette valeur peut être parasitée via GET/POST/COOKIES + fpassthru ("/données/très/très/sensibles/index.html"); +} +?> + </programlisting> + </example> + <example> + <title>Travailler avec register_globals actif</title> + <programlisting role="php"> +<?php + if($HTTP_COOKIE_VARS["username"]){ +// ne peut provenir que d'un cookie, corrompu ou pas + $good_login = 1; +// Impossible à parasiter + fpassthru ("/données/très/très/sensibles/index.html"); + } +?> + </programlisting> + </example> + En utilisant intelligemment ceci, il est même possible + de détecter les tentatives de corruption. Si vous savez à l'avance + d'où la variable doit venir (GET ou POST ou COOKIE), vous pouvez + tester les données. Même si cela ne vous garantit pas contre + la corruption de ces données, cela impose aux pirates de bien + savoir comment corrompre les données. + <example> + <title>Détection de corruption de variables</title> + <programlisting role="php"> +<?php + if ($HTTP_COOKIE_VARS['username'] && + !$HTTP_POST_VARS['username'] && + !$HTTP_GET_VARS['username'] ) { + // D'autres vérifications pour vérifier l'origine du nom d'utilisateur fourni + $good_login = 1; + fpassthru ("/données/très/très/sensibles/index.html"); + } else { + mail("admin@example.com", "Tentative de piratage", $HTTP_SERVER_VARS['REMOTE_ADDR']); + echo "Problème de sécurité, l'administrateur est alerté."; + exit; + } +?> + </programlisting> + </example> + Bien entendu, inactiver l'option register_globals ne signifie pas + que votre code devient ouvert à tous. Mais il faut aussi + vérifier toutes les données qui vous sont fournies par les + utilisateurs, et plutôt deux fois qu'une. + </para> </sect1> <sect1 id="security.variables"> <title>Données transmises par les internautes</title> @@ -491,12 +693,12 @@ <?php // efface un fichier à la racine d'un utilisateur... ou peut être // de quelqu'un d'autre? -unlink ($evil_var); + unlink($evil_var); // Note l'accès de ce fichier ... ou pas? -fputs ($fp, $evil_var); -// Exécute une commande triviale... ou pas? -system ($evil_var); -exec ($evil_var); + fputs($fp, $evil_var); +// Exécute une commande triviale... ou ajoute une entrée dans /etc/password ? + system($evil_var); + exec($evil_var); ?> </programlisting> </example> @@ -549,61 +751,51 @@ à la source). </para> </sect1> - <sect1 id="security.general"> - <title>Considérations générales</title> - <simpara> - Un système complètement sécurisé est - virtuellement impossible. De ce fait, une approche qui - équilibre les risques et l'ergonomie est souvent retenue. - Si toutes les variables envoyées par l'utilisateur - nécessitaient deux formes d'identification biométriques - (comme par exemple un scanner de la rétine, et une - empreinte digitale), vous pourriez avoir un niveau de - sécurité élevé. Cela prendrait aussi - une demi-heure pour remplir les conditions de sécurité, - ce qui pousserait les utilisateurs à éviter d'utiliser - votre système. - </simpara> - <simpara> - La meilleure sécurité est celle qui protège - votre système, sans empêcher les utilisateurs de faire - leur travail. En général, les attaques exploitent - des trous de sécurité entre diverses couches d'identification : cet - empilement devient trop complexe, et finalement, peu fiable. - </simpara> - <simpara> - Une phrase qui vaut la peine d'être retenue : un système est - aussi fiable que son maillon le plus faible. Si toutes les - transactions sont exhaustivement notées (heure, lieu, type, etc...) - mais que l'utilisateur n'est authentifié que par un cookie, - la validité de votre système de surveillance est intimement - liée à la validité du cookie (et donc, - sévèrement réduite). - </simpara> - <simpara> - Lors de vos tests, gardez à l'esprit que vous ne pourrez pas - tester toutes les configurations, mais probablement les plus - simples. Les données en entrées auxquelles vous pouvez vous - attendre ne seront rien comparées aux données - incohérentes d'un employé négligent, un - pirate disposant d'autant de temps qu'il veut, ou du chat de la - maison marchant sur le clavier. Il est donc bon de regarder le - code logiquement, de chercher où des données incohérentes - peuvent être introduites, modifiées, réduites ou - amplifiées. - </simpara> - <simpara> - L'Internet est rempli de personnes qui tentent de se faire une renommée - en piratant vos programmes, en bloquant votre site, en envoyant des contenus - inappropriés, qui rendent vos journées si "spéciales". - Peut importe que vous ayez un grand portail ou un petit web, vous pouvez - être la cible pour tout quidam avec une connexion. Vous êtes une - cible potentielle dès que vous êtes connecté vous-même. - Certains programmes de piratage ne font pas dans la demi-mesure, et - testent systématiquement des millions d'IP, à la recherche - de victimes : ne soyez pas la prochaine. - </simpara> - </sect1> + <sect1 id="security.hiding"> + <title>Masquer PHP</title> + <para> + Quelques astuces permettent de masquer PHP, et cela entrave les + pirates qui recherchent des faiblesses dans votre système. En + inactivant l'option expose_php dans votre fichier <filename>php.ini</filename>, + vous pouvez réduire la quantité d'informations disponible. + </para> + <para> + Une autre astuce est de configurer le serveur web, comme Apache, + pour qu'il utilise plusieurs types de fichiers différents avec PHP, + soit localement avec le fichier <filename>.htaccess</filename>, soit + dans le fichier de configuration lui-même. Vous pouvez utiliser des + informations déroutantes comme ceci : + <example> + <title>Masquer PHP avec un autre langage</title> + <programlisting role="php"> +// Faire que le code PHP ressemble à un autre type +AddType application/x-httpd-php .asp .py .pl + </programlisting> + </example> + Ou masquez le complètement : + <example> + <title>Masquer PHP avec des types inconnus</title> + <programlisting role="php"> +// Faire que le code PHP ressemble à un autre langage qui n'existe pas +AddType application/x-httpd-php .bop .foo .133t + </programlisting> + </example> + Ou encore, cachez le sous forme de html. Cela a un légèr impact négatif + sur les performances générales, car tous les fichiers HTML seront aussi + analysés et traités par le moteur PHP : + <example> + <title>Utiliser le type html pour les extensions PHP</title> + <programlisting role="php"> +// Faire que le code PHP ressemble à du html +AddType application/x-httpd-php .htm .html + </programlisting> + </example> + Pour que cela fonctionne efficacement, pensez à renommer tous vos + fichiers avec les extensions ci-dessus. Même si c'est une forme + de sécurité du non-dit, c'est une mesure de prévention mineure, + avec peu d'inconvénients. + </para> + </sect1> <sect1 id="security.current"> <title>Etre à jour</title> <simpara> Index: phpdoc/fr/chapters/config.xml diff -u phpdoc/fr/chapters/config.xml:1.12 phpdoc/fr/chapters/config.xml:1.13 --- phpdoc/fr/chapters/config.xml:1.12 Sat Jul 7 18:21:57 2001 +++ phpdoc/fr/chapters/config.xml Mon Nov 12 00:03:38 2001 @@ -1,1422 +1 @@ - <chapter id="configuration"> - <title>Configuration</title> - <sect1 id="configuration.file"> - <title>Le fichier de configuration</title> - <simpara> - Le fichier de configuration (appelé <filename>php3.ini</filename> - dans la version 3.0 du PHP, et simplement <filename>php.ini</filename> - dans la version 4.0) est lu par le PHP au démarrage. Si vous - avez compilé PHP en module, le fichier n'est lu qu'une seule - fois, au lancement du démon <acronym>HTTP</acronym>. Pour la version - <acronym>CGI</acronym> le fichier est lu à chaque invocation. - </simpara> - <simpara> - Lorsque vous utilisez le module Apache vous pouvez aussi changer - les paramètres de configurations en utilisant les directives - dans les fichiers de configuration d'Apache et dans les fichiers - <filename>.htaccess</filename>. - </simpara> - <simpara> - Dans la version 3.0, à chaque directive de configuration - présente dans le fichier de configuration d'Apache correspond - une directive de configuration dans le fichier - <filename>php3.ini</filename> à l'exception des directives - préfixées par "php3_". - </simpara> - <simpara> - Dans la version 4.0, il n'y a seulement que quelques directives - dans le fichier de configuration d'Apache qui vous permettent de - modifier la configuration de PHP. - </simpara> - <variablelist> - <varlistentry> - <term> - <systemitem role="directive">php_value</systemitem> - <parameter>name</parameter> - <parameter>value</parameter> - </term> - <listitem> - <para> - Cette directive affecte une valeur à la variable - spécifiée. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <systemitem role="directive">php_flag</systemitem> - <parameter>name</parameter> - <parameter>on|off</parameter> - </term> - <listitem> - <para> - Cette directive est utilisée pour activer ou - désactiver une option. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <systemitem role="directive">php_admin_value</systemitem> - <parameter>name</parameter> - <parameter>value</parameter> - </term> - <listitem> - <para> - Cette directive affecte une valeur à la variable - spécifiée. La directive "Admin" ne peut être - utilisée que dans le fichier de configuration d'Apache, et - non dans un fichier <filename>.htaccess</filename>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <systemitem role="directive">php_admin_flag</systemitem> - <parameter>name</parameter> - <parameter>on|off</parameter> - </term> - <listitem> - <para> - Cette directive est utilisée pour activer ou désactiver l'option - précédente. - </para> - </listitem> - </varlistentry> - </variablelist> - <simpara> - Vous pouvez voir l'état de votre configuration en utilisant - la fonction <function>phpinfo</function>. Vous pouvez aussi - accéder aux valeurs de votre configuration de manière - individuelle en utilisant la fonction <function>get_cfg_var</function>. - </simpara> - <sect2 id="ini.sect.general"> - <title>Directives de configuration générale</title> - <variablelist> - <varlistentry id="ini.allow-url-fopen"> - <term> - <parameter>allow_url_fopen</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Cette option autorise les accès au réseau des fonctions - <function>fopen</function>. Par défaut, l'accès est - autorisé aux procédures - d'<link linkend="features.remote-files">accès distants</link>, - avec les protocoles <acronym>FTP</acronym>, <acronym>NNTP</acronym>, - et certaines extensions telles ques zlib. - </para> - <note> - <para> - Cette option a été introduite immédiatement - après la version 4.0.3. Pour les versions jusqu'à - la 4.0.3 inclus, vous pouvez désactiver cette - fonctionnalité au moment de la compilation en utilisant - la configuration - <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. - </para> - </note> - </listitem> - </varlistentry> - <varlistentry id="ini.asp-tags"> - <term> - <parameter>asp_tags</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active l'utilisation des balises de type ASP <% %>, en plus des - traditionnelles balises <?php ?> . Cela inclus l'utilisation du raccourcis - <%= $value %>. Pour plus d'informations, reportez vous à - <link linkend="language.basic-syntax.phpmode">inclusion dans le HTML</link>. - </para> - <note> - <para>Le support des balises ASP a été ajouté dans la version 3.0.4. - </para> - </note> - </listitem> - </varlistentry> - <varlistentry id="ini.auto-append-file"> - <term> - <parameter>auto_append_file</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Spécifie le nom d'un fichier qui sera automatiquement ajouté - après le fichier principal. Le fichier est inclus comme si il avait - été appelé avec la fonction <function>include</function>, - donc <link linkend="ini.include-path">include_path</link> est utilisé. - </para> - <para> - Le mot réservé <systemitem class="constant">NONE</systemitem> - désactive l'auto-appending. - </para> - <note> - <para> - Si le script s'arrête par la fonction <function>exit</function>, - auto-append <emphasis>ne fonctionnera pas</emphasis>. - </para> - </note> - </listitem> - </varlistentry> - <varlistentry id="ini.auto-prepend-file"> - <term> - <parameter>auto_prepend_file</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Spécifie le nom d'un fichier qui sera automatiquement ajouté - avant le fichier principal. Le fichier est inclus comme si il avait - été appelé avec la fonction <function>include</function>, - donc <link linkend="ini.include-path">include_path</link> est utilisé. - </para> - <para> - Le mot réservé <systemitem class="constant">NONE</systemitem> - désactive l'auto-appending. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.cgi-ext"> - <term> - <parameter>cgi_ext</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - (NDT : aucune documentation n'est fournie). - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.display-errors"> - <term> - <parameter>display_errors</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette directive détermine si les erreurs doivent être - affichées à l'écran au format HTML ou non. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.doc-root"> - <term> - <parameter>doc_root</parameter> - <type>string</type> - </term> - <listitem> - <para> - Le dossier racine de PHP. Utilisée uniquement si elle est définie. - Si PHP est configuré en <link linkend="ini.safe-mode">safe mode</link>, - aucun fichier en dehors de ce dossier ne sera accessible. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.engine"> - <term> - <parameter>engine</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Cette directive ne sert vraiment que si PHP est un module Apache. - Elle sert aux sites qui veulent activer ou désactiver l'analyse des fichiers - par PHP, dossier par dossier. En mettant <userinput>php3_engine off</userinput> - au bon endroit, dans le fichier <filename>httpd.conf</filename>, PHP peut être - activé ou desactivé. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.error-log"> - <term> - <parameter>error_log</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom du fichier oú les erreurs seront enregistrées. Si la valeur spéciale - <literal>syslog</literal> est utilisée, les erreurs sont envoyées au système - standard d'historique. Sous UNIX, c'est syslog(3) et sous Windows NT c'est - l'historique d'événements. L'historique système n'est pas supporté sous - Windows 95.</para> - </listitem> - </varlistentry> - <varlistentry id="ini.error-reporting"> - <term> - <parameter>error_reporting</parameter> - <type>integer</type> - </term> - <listitem> - <para> - Fixe le niveau d'erreur. Ce paramètre est un entier, représentant un - champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau - que vous désirez : - <table> - <title>Niveau de rapport d'erreur</title> - <tgroup cols="2"> - <thead> - <row> - <entry>valeur du bit</entry> - <entry>niveau choisi</entry> - </row> - </thead> - <tbody> - <row> - <entry>1</entry> - <entry>erreurs normales</entry> - </row> - <row> - <entry>2</entry> - <entry>alertes normales</entry> - </row> - <row> - <entry>4</entry> - <entry>erreurs d'analyseur (parser errors)</entry> - </row> - <row> - <entry>8</entry> - <entry>alertes non critiques</entry> - </row> - </tbody> - </tgroup> - </table> - Par défaut, la valeur est de 7 (erreurs normales, alertes normales - et erreurs d'analyseur sont affichées). - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.open-basedir"> - <term> - <parameter>open_basedir</parameter> - <type>string</type> - </term> - <listitem> - <para> - Limite l'espace oú PHP peut ouvrir des fichiers. - </para> - <para> - Lorsqu'un script essaie d'ouvrir un fichier avec les fonctions - fopen ou gzopen (par exemple), la localisation du fichier est vérifiée. - Si ce fichier est hors du dossier cité dans cette directive, PHP refusera - de l'ouvrir. Tous les liens symboliques sont résolus, et subissent aussi - la restriction. - </para> - <para> - La valeurs spéciale <systemitem class="constant">.</systemitem> - indique que le dossier courant du script est utilisé comme open_basedir. - </para> - <para> - Sous Windows, séparez les noms de dossiers par un point virgule (;). - Sur les autres systèmes, séparez les noms de dossiers par des deux points (:). - Lorsque PHP est un module Apache, la valeur de la directive open_basedir - des dossiers parents sont automatiquement hérités par les fils. - </para> - <note> - <para>Le support pour les dossiers multiples a été ajouté dans 3.0.7.</para> - </note> - <para> - La valeur par défaut est : libre accès à tous les fichiers. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.gpc-order"> - <term> - <parameter>gpc_order</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Etablit l'ordre de préséance des méthodes GET/POST/COOKIE. - Par défaut, cette directive est établie à "GPC". En affectant "GP" à - cette directive, PHP ignorera les cookies, et écrasera toute méthode - GET utilisée par une méthode POST avec des variables du même nom. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ignore-user-abort"> - <term> - <parameter>ignore_user_abort</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Désactivée par défaut. Si cette directive est activée, alors tous les scripts - lancés iront jusqu'à leur terme, même si le client se déconnecte en plein - milieu. Voir aussi la fonction <function>ignore_user_abort</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.include-path"> - <term> - <parameter>include_path</parameter> - <type>string</type> - </term> - <listitem> - <para> - Spécifie une liste de dossier oú les fonctions <function>require</function>, - <function>include</function> et fopen_with_path (NDtraducteur : cette fonction - semble avoir disparue) iront chercher les fichiers. Le format est le même - que celui de la variable d'environnement <envar>PATH</envar> : une liste de dossiers, - séparés par des deux points (:) sous UNIX, et des points virgules (;), - sous Windows. - <example> - <title>UNIX include_path</title> - <programlisting role="php3.ini"> -include_path=.:/home/httpd/php-lib - </programlisting> - </example> - <example> - <title>Windows include_path</title> - <programlisting role="php3.ini"> -include_path=".;c:\www\phplib" - </programlisting> - </example> - La valeur par défaut pour cette directive est <literal>.</literal>, - c'est à dire le dossier courant.</para> - </listitem> - </varlistentry> - <varlistentry id="ini.isapi-ext"> - <term> - <parameter>isapi_ext</parameter> - <type>string</type> - </term> - <listitem> - <para> - (Aucune documentation n'est fournie) - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.log-errors"> - <term> - <parameter>log_errors</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Indique oú les messages d'erreur générés doivent - être écrits. Cette fonction est spécifique aux serveurs. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.magic-quotes-gpc"> - <term> - <parameter>magic_quotes_gpc</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Fixe le mode magic_quotes pour les opérations GPC (Get/Post/Cookie). - Lorsque magic_quotes est activé, tous les caractères ' - (guillemets simples), " (guillemets doubles), \ (antislash) et NUL - sont échappés avec un antislash. Si magic_quotes_sybase - fonctionne aussi, les guillemets simples seront échappés - avec un autre guillemet simple, plutôt qu'un antislash. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.magic-quotes-runtime"> - <term> - <parameter>magic_quotes_runtime</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Si <parameter>magic_quotes_runtime</parameter> est activé, toutes les fonctions - qui retournent des données d'une source externe, y compris les bases de - données et les fichiers texte, verront leur guillemets échappés avec un - antislash. Si <parameter>magic_quotes_sybase</parameter> est aussi activé, - les guillemets simples seront échappés avec un autre guillemet simple, - plutôt qu'un antislash. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.magic-quotes-sybase"> - <term> - <parameter>magic_quotes_sybase</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Si <parameter>magic_quotes_sybase</parameter> est activé, les guillemets - simples seront échappés avec un autre guillemet simple, plutôt - qu'un antislash, si <parameter>magic_quotes_gpc</parameter> ou - <parameter>magic_quotes_runtime</parameter> est activé. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.max-execution-time"> - <term> - <parameter>max_execution_time</parameter> - <type>integer</type> - </term> - <listitem> - <para> - Fixe le temps maximal d'éxécution d'un script, en secondes. Cela permet - d'éviter que des scripts en boucles infinies ne saturent le serveur. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.memory-limit"> - <term> - <parameter>memory_limit</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Grâce à cette option, vous pouvez donner la quantité maximale - de mémoire qu'un script peut allouer. Cela permet de reserver toute la - mémoire d'un serveur à un seul script. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.nsapi-ext"> - <term> - <parameter>nsapi_ext</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Aucune documentation n'est fournie. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.register-globals"> - <term> - <parameter>register_globals</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Cette option active l'enregistrement des variables EGPCS - (Environement, GET, POST, Cookie, Serveur), en tant que - variables globales. Vous pouvez désactiver cette fonction - si vous ne voulez pas truffer vos scripts avec des - valeurs utilisateurs. Cette option est surtout utile lorsqu'elle - est utilisée conjointement avec <link - linkend="ini.track-vars">track_vars</link> - dans ce cas, - vous pouvez accéder à toutes les variables EGPCS grâce aux tableaux - <varname>$HTTP_ENV_VARS</varname>, - <varname>$HTTP_GET_VARS</varname>, - <varname>$HTTP_POST_VARS</varname>, - <varname>$HTTP_COOKIE_VARS</varname>, et - <varname>$HTTP_SERVER_VARS</varname>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.short-open-tag"> - <term> - <parameter>short_open_tag</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive l'utilisation des balises courtes, - (<userinput><? ?></userinput>). Si vous voulez utiliser PHP et XML en même - temps, vous devez désactiver cette option. Si cette option est - désactivée, vous devez utiliser la forme longue des tags, - (<userinput><?php ?></userinput>).</para> - </listitem> - </varlistentry> - <varlistentry id="ini.sql.safe-mode"> - <term> - <parameter>sql.safe_mode</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Aucune documentation n'est fournie. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.track-errors"> - <term> - <parameter>track_errors</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Si cette option est activée, le dernier message d'erreur sera placé dans la - variable globale <symbol>$php_errormsg</symbol>.</para> - </listitem> - </varlistentry> - <varlistentry id="ini.track-vars"> - <term> - <parameter>track_vars</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Si cette option est activée, lors de l'appel des méthodes GET, POST et - l'utilisation des cookies, les variables sont disponibles dans des tableaux - associatifs globaux appelés respectivement <symbol>$HTTP_GET_VARS</symbol>, - <symbol>$HTTP_POST_VARS</symbol> et <symbol>$HTTP_COOKIE_VARS</symbol>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.upload-tmp-dir"> - <term> - <parameter>upload_tmp_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Indique le répertoire utilisé lors du chargement d'un fichier sur un - serveur. Ce répertoire doit être accessible en lecture pour - l'utilisateur qui lance le script PHP. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.user-dir"> - <term> - <parameter>user_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Répertoire oú sont stockés les fichiers PHP dans le - répertoire d'un utilisateur. Par exemple, <literal>public_html</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.warn-plus-overloading"> - <term> - <parameter>warn_plus_overloading</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Si cette option est activée, PHP émet un warning lorsque - l'opérateur plus (<literal>+</literal>) est utilisé sur une - chaîne de caractères. Cela permet de réperer plus - facilement les scripts qui doivent être réécrits en - utilisant l'opérateur de concaténation (<literal>.</literal>) - plutôt que l'opérateur plus. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.mail"> - <title>Configuration des directives concernant le mail</title> - <variablelist> - <varlistentry id="ini.smtp"> - <term> - <parameter>SMTP</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Sous Windows, adresse IP ou nom que PHP doit utiliser pour envoyer - du mail avec la fonction <function>mail</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sendmail-from"> - <term> - <parameter>sendmail_from</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Sous Windows, valeur du champs "From:" qui doit être utilisée lors - de l'envoie de mail. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sendmail-path"> - <term> - <parameter>sendmail_path</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Localisation du programme de <command>sendmail</command>, habituellement - <filename>/usr/sbin/sendmail</filename> ou <filename>/usr/lib/sendmail</filename>. - <command>configure</command> essaye de repérer la présence de sendmail - par lui même, et affecte ce résultat par défaut. En cas de - problème de localisation, vous pouvez établir une nouvelle valeur - par défaut ici. - </para> - <para> - Tout système n'utilisant pas <command>sendmail</command> doit établir cette - directive à la valeur chemin du programme de substitution qui remplace le - serveur de mail, si celui-ci existe, par exemple, - <ulink url="http://www.qmail.org/">Qmail</ulink>. - Dans ce cas la, vous devez mettre: <filename>/var/qmail/bin/sendmail</filename>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.safe-mode"> - <title>Directives de configuration du "Safe Mode"</title> - <variablelist> - <varlistentry id="ini.safe-mode"> - <term> - <parameter>safe_mode</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette directive active ou désactive l'option "safe mode". - Lisez le chapitre <link linkend="security">sécurité </link> pour plus - d'informations. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.safe-mode-exec-dir"> - <term> - <parameter>safe_mode_exec_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Si l'option "SAFE MODE" est activée, <function>system</function> et les - autres fonctions exécutant des programmes systèmes refusent de se lancer - si ces programmes ne sont pas placés dans ce répertoire. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.debugger"> - <title>Directives de configuration de débbugage.</title> - <variablelist> - <varlistentry id="ini.debugger.host"> - <term> - <parameter>debugger.host</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Adresse IP ou nom de l'hôte utilisé pour le déboggage. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.debugger.port"> - <term> - <parameter>debugger.port</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Numéro du port utilisé pour le déboggage. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.debugger.enabled"> - <term> - <parameter>debugger.enabled</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Activation ou désactivation du debugger.</para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.extension"> - <title>Directives de chargement des extensions</title> - <variablelist> - <varlistentry id="ini.enable-dl"> - <term> - <parameter>enable_dl</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette directive n'est réellement utile que dans le cas d'une compilation - comme module Apache. Vous pouvez activer le chargement dynamique des - extensions avec la fonction <function>dl</function>, et cela de manière - locale à chaque serveur virtuel ou à chaque répertoire. - </para> - <para> - La principale raison qui pousse à désactiver le chargement - dynamique est un problème de sécurité. Lorsque le - chargement dynamique est activé, il est possible d'ignorer les - directives <link linkend="ini.safe-mode">safe mode</link> - ou "open_basedir". - </para> - <para> - Par défaut, il est possible d'utiliser le chargement dynamique, sauf - lorsque la directive <link linkend="ini.safe-mode">safe mode</link> est - activée. En effet, il est alors impossible d'utiliser la fonction - <function>dl</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.extension-dir"> - <term> - <parameter>extension_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Définit le répertoire dans lequel le PHP doit chercher les extensions lors - du chargement dynamique. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.extension"> - <term> - <parameter>extension</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Définit les extensions qui doivent être chargées lors du - démarrage du PHP. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.mysql"> - <title>MySQL Configuration Directives</title> - <variablelist> - <varlistentry id="ini.mysql.allow-persistent"> - <term> - <parameter>mysql.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistentes à la base de - données MySQL. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.default-host"> - <term> - <parameter>mysql.default_host</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Adresse par défaut du serveur, à utiliser lors de la connexion à - un serveur MySQL, si aucun hôte n'est spécifié. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.default-user"> - <term> - <parameter>mysql.default_user</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Utilisateur par défaut, à utiliser lors de la connexion à un serveur - MySQL, si aucun utilisateur n'est spécifié. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.default-password"> - <term> - <parameter>mysql.default_password</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Mot de passe par défaut, à utiliser lors de la connexion à un serveur - MySQL, si aucun mot de passe n'est spécifié. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.max-persistent"> - <term> - <parameter>mysql.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de donnée MySQL, - par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.max-links"> - <term> - <parameter>mysql.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre de connexion maximum à une base de donnée MySQL, - par processus, incluant les connexions persistantes - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.msql"> - <title>Directives de configuration mSQL</title> - <variablelist> - <varlistentry id="ini.msql.allow-persistent"> - <term> - <parameter>msql.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistentes à la base de données mSQL. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.msql.max-persistent"> - <term> - <parameter>msql.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de donnée mSQL, - par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.msql.max-links"> - <term> - <parameter>msql.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de donnée mSQL, - par processus, incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.pgsql"> - <title>Directives de configuration Postgres</title> - <variablelist> - <varlistentry id="ini.pgsql.allow-persistent"> - <term> - <parameter>pgsql.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistantes à la base de - données Postgres. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.pgsql.max-persistent"> - <term> - <parameter>pgsql.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données - Postgres, par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.pgsql.max-links"> - <term> - <parameter>pgsql.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximal de connexions à une base de donnée Postgres, - par processus, incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.sesam"> - <title>Directives de configuration SESAM</title> - <variablelist> - <varlistentry id="ini.sesam-oml"> - <term> - <parameter>sesam_oml</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom de la librairieBS2000 PLAM contenant les pilotes de connexion SESAM. - Obligatoire pour les fonctions SESAM. La librairie BS2000 PLAM - doit être configurée avec ACCESS=READ,SHARE=YES - car elle doit être accessible à l'utilisateur Apache. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sesam-configfile"> - <term> - <parameter>sesam_configfile</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom du fichier de configuration de l'application SESAM. - Obligatoire pour les fonctions SESAM. Le fichier - BS2000 doit être accessible être accessible à l'utilisateur Apache. - </para> - <para> - Le fichier de configuration de l'application va contenir la configuration - sur le schéma suivant (voir le manuel SESAM) : - <informalexample> - <programlisting role="bs2000"> -CNF=B -NAM=K -NOTYPE</programlisting> - </informalexample> - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sesam-messagecatalog"> - <term> - <parameter>sesam_messagecatalog</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom du catalogue de messages SESAM. Dans la plus part des - cas, cette directive n'est pas nécessaire. Seulement, si - le fichier de messages SESAM n'est pas installé dans la - table de messages BS2000, il faut indiquer sa localisation avec - cette directive. - </para> - <para> - Le catalogue de messages doit être paramétré avec - ACCESS=READ,SHARE=YES car elle doit être accessible à l'utilisateur Apache. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.sybase"> - <title>Directives de configuration Sybase</title> - <variablelist> - <varlistentry id="ini.sybase.allow-persistent"> - <term> - <parameter>sybase.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistentes à la base de données Sybase. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybase.max-persistent"> - <term> - <parameter>sybase.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données Sybase par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybase.max-links"> - <term> - <parameter>sybase.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de données Sybase, par processus, - incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.sybct"> - <title>Sybase-CT Configuration Directives</title> - <variablelist> - <varlistentry id="ini.sybct.allow-persistent"> - <term> - <parameter>sybct.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistantes à la base de données - Sybase-CT. Par défaut, cette option est activée. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.max-persistent"> - <term> - <parameter>sybct.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données Sybase-CT par - processus. Par défaut, cette option est à -1, ce qui signifie que le nombre de - connexion est illimité. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.max-links"> - <term> - <parameter>sybct.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de données Sybase-CT, par processus, - incluant les connexions persistantes. Par défaut, cette option est à -1, - ce qui signifie que le nombre de connexions est illimitée. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.min-server-severity"> - <term> - <parameter>sybct.min_server_severity</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Les messages en provenance du serveur d'un niveau d'erreur égal à - sybct.min_server_severity seront considérés comme des alertes (warnings). - Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction - sybase_min_server_severity (NDtraducteur : cette fonction semble ne pas exister). - Par défaut, cette valeur vaut 10. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.min-client-severity"> - <term> - <parameter>sybct.min_client_severity</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Les messages en provenance de la librairie client avec un niveau d'erreur égal - ou supérieur à sybct.min_client_severity seront considérés comme des alertes. - Cette valeur peut être modifiée à l'intérieur du script en appelant la - fonction sybase_min_client_severity (NDtraducteur : cette fonction semble ne pas exister). - Par défaut, cette valeur vaut 10, ce qui annule tout rapport d'erreur. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.login-timeout"> - <term> - <parameter>sybct.login_timeout</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Délai de validité d'une tentative de connexion. Il est à - noter que si max_execution_time est dépassé avant que la connexion - n'éxpire, le script sera terminé avant le message d'erreur. - Par défaut, cette valeur vaut 1 minute. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.timeout"> - <term> - <parameter>sybct.timeout</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Temps maximum en secondes avant qu'une tentative de requête "select_db" ou - "query" non aboutie renvoie une erreur. Il est à noter que si - max_execution_time est dépassé avant que la requête - n'éxpire, votre script sera terminé avant le message d'erreur. - Par défaut, il n'y a pas de limite. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.hostname"> - <term> - <parameter>sybct.hostname</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Nom de l'hôte à partir duquel vous vous connectez, afin d'être affiché par - la fonction sp_who (NDtraducteur : cette fonction semble ne pas exister). - Par défaut, cette valeur égale à 0. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.informix"> - <title>Directives de configuration Informix</title> - <variablelist> - <varlistentry id="ini.ifx.allow-persistent"> - <term> - <parameter>ifx.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active les connexions persistantes à une base de données Informix. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.max-persistent"> - <term> - <parameter>ifx.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données Informix, - par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.max-links"> - <term> - <parameter>ifx.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de données Informix par processus, - en incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.default-host"> - <term> - <parameter>ifx.default_host</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Hôte par défaut oú se connecter si aucun hôte n'est spécifié par les - fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.default-user"> - <term> - <parameter>ifx.default_user</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Utilisateur par défaut si aucun utilisateur n'est spécifié par les fonctions - <function>ifx_connect</function> ou <function>ifx_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.default-password"> - <term> - <parameter>ifx.default_password</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Mot de passe par défaut si aucun mot de passe n'est spécifié par les fonctions - <function>ifx_connect</function> ou <function>ifx_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.blobinfile"> - <term> - <parameter>ifx.blobinfile</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de type "blob" seront retournées - dans un fichier. Par défaut, elles seront retournées en mémoire. Il est possible - de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_blobinfile_mode</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.textasvarchar"> - <term> - <parameter>ifx.textasvarchar</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de type "TEXT" seront retournées - dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible - de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_textasvarchar</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.byteasvarchar"> - <term> - <parameter>ifx.byteasvarchar</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de type "BYTE" seront retournées - dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. - Il est possible de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_textasvarchar</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.charasvarchar"> - <term> - <parameter>ifx.charasvarchar</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les espaces en fin de chaîne de caractères - seront conservés lors d'une commande FETCH. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.nullformat"> - <term> - <parameter>ifx.nullformat</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de valeur &null; seront retournées - comme des chaînes de caractères vides. - Il est possible de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_nullformat</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.bcmath"> - <title>Directives de configuration pour les calculs mathématiques.</title> - <variablelist> - <varlistentry id="ini.bcmath.scale"> - <term> - <parameter>bcmath.scale</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre de chiffres après la virgule pour toutes les fonctions de - précision mathématique arbitraire. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.browscap"> - <title>Directives de configuration du navigateur.</title> - <variablelist> - <varlistentry id="ini.browscap"> - <term> - <parameter>browscap</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Nom du fichier de descriptif des clients HTML. - Voir aussi <function>get_browser</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.uodbc"> - <title>Directives de configuration du driver ODBC unifié</title> - <variablelist> - <varlistentry id="ini.uodbc.default-db"> - <term> - <parameter>uodbc.default_db</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Source de données ODBC à utiliser par défaut avec les fonctions - <function>odbc_connect</function> ou <function>odbc_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.default-user"> - <term> - <parameter>uodbc.default_user</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Nom d'utilisateur défaut avec les fonctions <function>odbc_connect</function> ou - <function>odbc_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.default-pw"> - <term> - <parameter>uodbc.default_pw</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Mot de passe par défaut dans les fonctions <function>odbc_connect</function> ou - <function>odbc_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.allow-persistent"> - <term> - <parameter>uodbc.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette option active ou désactive les connexions persistantes à la base de - données, via le canal ODBC. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.max-persistent"> - <term> - <parameter>uodbc.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes autorisées à la base de données. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.max-links"> - <term> - <parameter>uodbc.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions (persistantes ou non), par processus, - à la base de données. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - </sect1> - </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 -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.13 $ --> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> <title>Le fichier de configuration</title> <simpara> Le fichier de configuration (appelé <filename>php3.ini</filename> dans la version 3.0 du PHP, et simplement <filename>php.ini</filename> dans la version 4.0) est lu par le PHP au démarrage. Si vous avez compilé PHP en module, le fichier n'est lu qu'une seule fois, au lancement du démon <acronym>HTTP</acronym>. Pour la version <acronym>CGI</acronym> le fichier est lu à chaque invocation. </simpara> <para> <example> <title>Extrait du php.ini</title> <programlisting role="ini">; tout texte sur une ligne, situé après un point-virgule ";" est ignoré[php] ; les marqueur de section (texte entre crochets) sont aussi ignorés; Les valeurs booléenne peuvent être spécifiées comme ceci :; true, on, yes; ou false, off, no, noneregister_globals = offmagic_quotes_gpc = yes; vous pouvez placer les chaînes de caractères entre guillemetsinclude_path = ".:/usr/local/lib/php"; Les anti-slash sont traités comme n'importe quel caractèreinclude_path = ".;c:\php\lib"</programlisting><!-- TODO: add more details about values and expressions --> </example> </para> <simpara> Lorsque vous utilisez le module Apache, vous pouvez aussi changer les paramètres de configurations en utilisant les directives dans les fichiers de configuration d'Apache et dans les fichiers <filename>.htaccess</filename>. </simpara> <simpara> Dans la version 3.0, à chaque directive de configuration présente dans le fichier de configuration d'Apache correspond une directive de configuration dans le fichier <filename>php3.ini</filename>, à l'exception des directives préfixées par "php3_". </simpara> <simpara> Dans la version 4.0, il n'y a que quelques directives dans le fichier de configuration d'Apache qui vous permettent de modifier la configuration de PHP. </simpara> <variablelist> <varlistentry> <term> <systemitem role="directive">php_value</systemitem> <parameter>name</parameter> <parameter>value</parameter> </term> <listitem> <para> Cette directive affecte une valeur à la variable spécifiée. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_flag</systemitem> <parameter>name</parameter> <parameter>on|off</parameter> </term> <listitem> <para> Cette directive est utilisée pour activer ou désactiver une option. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_admin_value</systemitem> <parameter>name</parameter> <parameter>value</parameter> </term> <listitem> <para> Cette directive affecte une valeur à la variable spécifiée. La directive "Admin" ne peut être utilisée que dans le fichier de configuration d'Apache, et non dans un fichier <filename>.htaccess</filename>. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_admin_flag</systemitem> <parameter>name</parameter> <parameter>on|off</parameter> </term> <listitem> <para> Cette directive est utilisée pour activer ou désactiver l'option précédente. </para> </listitem> </varlistentry> </variablelist> <para> <example> <title>Exemple de configuration Apache</title> <programlisting role="ini"><IfModule mod_php4.c> php_value include_path ".:/usr/local/lib/php" php_flag safe_mode on</IfModule><IfModule mod_php3.c> php3_include_path ".:/usr/local/lib/php" php3_safe_mode on</IfModule></programlisting> </example> </para> <simpara> Vous pouvez voir l'état de votre configuration en utilisant la fonction <function>phpinfo</function>. Vous pouvez aussi accéder aux valeurs de votre configuration de manière individuelle en utilisant la fonction <function>get_cfg_var</function>. </simpara> <sect2 id="ini.sect.general"> <title>Directives de configuration générale</title> <variablelist> <varlistentry id="ini.allow-url-fopen"> <term> <parameter>allow_url_fopen</parameter> <type>boolean</type> </term> <listitem> <para> Cette option autorise les accès au réseau des fonctions <function>fopen</function>. Par défaut, l'accès est autorisé aux procédures d'<link linkend="features.remote-files">accès distants</link>, avec les protocoles <acronym>FTP</acronym>, <acronym>NNTP</acronym>, et certaines extensions telles ques zlib. </para> <note> <para> Cette option a été introduite immédiatement après la version 4.0.3. Pour les versions jusqu'à 4.0.3 incluse, vous pouvez désactiver cette fonctionnalité au moment de la compilation en utilisant la configuration <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.asp-tags"> <term> <parameter>asp_tags</parameter> <type>booléen</type> </term> <listitem> <para> Active l'utilisation des balises de type ASP <% %>, en plus des traditionnelles balises <?php ?> . Cela inclut l'utilisation du raccourcid <%= $value %>. Pour plus d'informations, reportez-vous à <link linkend="language.basic-syntax.phpmode">inclusion dans le HTML</link>. </para> <note> <para> Le support des balises ASP a été ajouté dans la version 3.0.4. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.auto-append-file"> <term> <parameter>auto_append_file</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Spécifie le nom d'un fichier qui sera automatiquement ajouté après le fichier principal. Le fichier est inclus comme s'il avait été appelé avec la fonction <function>include</function>, donc <link linkend="ini.include-path">include_path</link> est utilisé. </para> <para> Le mot réservé <systemitem class="constant">NONE</systemitem> désactive l'auto-appending. </para> <note> <para> Si le script s'arrête par la fonction <function>exit</function>, auto-append <emphasis>ne fonctionnera pas</emphasis>. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.auto-prepend-file"> <term> <parameter>auto_prepend_file</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Spécifie le nom d'un fichier qui sera automatiquement ajouté avant le fichier principal. Le fichier est inclus comme s'il avait été appelé avec la fonction <function>include</function>, donc <link linkend="ini.include-path">include_path</link> est utilisé. </para> <para> Le mot réservé <systemitem class="constant">NONE</systemitem> désactive l'auto-appending. </para> </listitem> </varlistentry> <varlistentry id="ini.cgi-ext"> <term> <parameter>cgi_ext</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> (NDT : aucune documentation n'est fournie). </para> </listitem> </varlistentry> <varlistentry id="ini.display-errors"> <term> <parameter>display_errors</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive détermine si les erreurs doivent être affichées à l'écran au format HTML ou non. </para> </listitem> </varlistentry> <varlistentry id="ini.doc-root"> <term> <parameter>doc_root</parameter> <type>string</type> </term> <listitem> <para> Le dossier racine de PHP. Cette directive n'est utilisée que si elle est définie. Si PHP est configuré en <link linkend="ini.safe-mode">safe mode</link>, aucun fichier en dehors de ce dossier ne sera accessible. </para> </listitem> </varlistentry> <varlistentry id="ini.engine"> <term> <parameter>engine</parameter> <type>boolean</type> </term> <listitem> <para> Cette directive ne sert vraiment que si PHP est un module Apache. Elle sert aux sites qui veulent activer ou désactiver l'analyse des fichiers par PHP, dossier par dossier. En mettant <userinput>php3_engine off</userinput> au bon endroit, dans le fichier <filename>httpd.conf</filename>, PHP peut être activé ou désactivé. </para> </listitem> </varlistentry> <varlistentry id="ini.error-log"> <term> <parameter>error_log</parameter> <type>string</type> </term> <listitem> <para> Nom du fichier où les erreurs seront enregistrées. Si la valeur spéciale <literal>syslog</literal> est utilisée, les erreurs sont envoyées au système standard d'historique. Sous UNIX, c'est <literal>syslog(3)</literal> et sous Windows NT, c'est l'historique d'événements. L'historique système n'est pas supporté sous Windows 95. </para> </listitem> </varlistentry> <varlistentry id="ini.error-reporting"> <term> <parameter>error_reporting</parameter> <type>integer</type> </term> <listitem> <para> Fixe le niveau d'erreur. Ce paramètre est un entier, représentant un champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau que vous désirez : <table> <title>Niveau de rapport d'erreur</title> <tgroup cols="2"> <thead> <row> <entry>valeur du bit</entry> <entry>niveau choisi</entry> </row> </thead> <tbody> <row> <entry>1</entry> <entry>erreurs normales</entry> </row> <row> <entry>2</entry> <entry>alertes normales</entry> </row> <row> <entry>4</entry> <entry>erreurs d'analyseur (parser errors)</entry> </row> <row> <entry>8</entry> <entry>alertes non critiques</entry> </row> </tbody> </tgroup> </table> Par défaut, la valeur est de 7 (erreurs normales, alertes normales et erreurs d'analyseur sont affichées). </para> </listitem> </varlistentry> <varlistentry id="ini.open-basedir"> <term> <parameter>open_basedir</parameter> <type>string</type> </term> <listitem> <para> Limite l'espace où PHP peut ouvrir des fichiers. </para> <para> Lorsqu'un script essaie d'ouvrir un fichier avec les fonctions fopen ou gzopen (par exemple), la localisation du fichier est vérifiée. Si ce fichier est hors du dossier cité dans cette directive, PHP refusera de l'ouvrir. Tous les liens symboliques sont résolus, et subissent aussi la restriction. </para> <para> La valeur spéciale <systemitem class="constant">.</systemitem> indique que le dossier courant du script est utilisé comme open_basedir. </para> <para> Sous Windows, séparez les noms de dossiers par un point virgule (;). Sur les autres systèmes, séparez les noms de dossiers par des deux points (:). Lorsque PHP est un module Apache, la valeur de la directive <literal>open_basedir</literal> des dossiers parents est automatiquement héritée par les fils. </para> <note> <para> Le support pour les dossiers multiples a été ajouté dans 3.0.7. </para> </note> <para> La valeur par défaut est : libre accès à tous les fichiers. </para> </listitem> </varlistentry> <varlistentry id="ini.gpc-order"> <term> <parameter>gpc_order</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Etablit l'ordre de préséance des méthodes GET/POST/COOKIE. Par défaut, cette directive est établie à "GPC". En affectant "GP" à cette directive, PHP ignorera les cookies, et écrasera toute méthode GET utilisée par une méthode POST avec des variables du même nom. </para> </listitem> </varlistentry> <varlistentry id="ini.ignore-user-abort"> <term> <parameter>ignore_user_abort</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Désactivée par défaut. Si cette directive est activée, alors tous les scripts lancés iront jusqu'à leur terme, même si le client se déconnecte en plein milieu. Voir aussi la fonction <function>ignore_user_abort</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.include-path"> <term> <parameter>include_path</parameter> <type>string</type> </term> <listitem> <para> Spécifie une liste de dossiers, où les fonctions <function>require</function>, <function>include</function> et fopen_with_path() (NDtraducteur : cette fonction semble avoir disparu) iront chercher les fichiers. Le format est le même que celui de la variable d'environnement <envar>PATH</envar> : une liste de dossiers, séparés par des deux points (:) sous UNIX, et par des points virgules (;) sous Windows. <example> <title>UNIX include_path</title> <programlisting role="php3.ini">include_path=.:/home/httpd/php-lib </programlisting> </example> <example> <title>Windows include_path</title> <programlisting role="php3.ini">include_path=".;c:\www\phplib" </programlisting> </example> La valeur par défaut pour cette directive est <literal>.</literal>, c'est-à-dire le dossier courant.</para> </listitem> </varlistentry> <varlistentry id="ini.isapi-ext"> <term> <parameter>isapi_ext</parameter> <type>string</type> </term> <listitem> <para> (Aucune documentation n'est fournie) </para> </listitem> </varlistentry> <varlistentry id="ini.log-errors"> <term> <parameter>log_errors</parameter> <type>boolean</type> </term> <listitem> <para> Indique où les messages d'erreur générés doivent être écrits. Cette fonction est spécifique aux serveurs. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-gpc"> <term> <parameter>magic_quotes_gpc</parameter> <type>boolean</type> </term> <listitem> <para> Fixe le mode magic_quotes pour les opérations GPC (Get/Post/Cookie). Lorsque magic_quotes est activé, tous les caractères ' (guillemets simples), " (guillemets doubles), \ (antislash) et NUL sont échappés avec un antislash. Si magic_quotes_sybase fonctionne aussi, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-runtime"> <term> <parameter>magic_quotes_runtime</parameter> <type>boolean</type> </term> <listitem> <para> Si <parameter>magic_quotes_runtime</parameter> est activé, toutes les fonctions qui obtiennent des données auprès d'une source externe, y compris les bases de données et les fichiers texte, verront leur guillemets échappés avec un antislash. Si <parameter>magic_quotes_sybase</parameter> est aussi activé, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-sybase"> <term> <parameter>magic_quotes_sybase</parameter> <type>boolean</type> </term> <listitem> <para> Si <parameter>magic_quotes_sybase</parameter> est activé, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash, si <parameter>magic_quotes_gpc</parameter> ou <parameter>magic_quotes_runtime</parameter> est activé. </para> </listitem> </varlistentry> <varlistentry id="ini.max-execution-time"> <term> <parameter>max_execution_time</parameter> <type>integer</type> </term> <listitem> <para> Fixe le temps maximal d'éxécution d'un script, en secondes. Cela permet d'éviter que des scripts en boucles infinies saturent le serveur. </para> </listitem> </varlistentry> <varlistentry id="ini.memory-limit"> <term> <parameter>memory_limit</parameter> <type>entier</type> </term> <listitem> <para> Grâce à cette option, vous pouvez donner la quantité maximale de mémoire qu'un script peut allouer. Cela permet de réserver toute la mémoire d'un serveur à un seul script. </para> </listitem> </varlistentry> <varlistentry id="ini.nsapi-ext"> <term> <parameter>nsapi_ext</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Aucune documentation n'est fournie. </para> </listitem> </varlistentry> <varlistentry id="ini.register-globals"> <term> <parameter>register_globals</parameter> <type>boolean</type> </term> <listitem> <para> Cette option active l'enregistrement des variables EGPCS (Environnement, GET, POST, Cookie, Serveur), en tant que variables globales. Vous pouvez désactiver cette fonction si vous ne voulez pas truffer vos scripts avec des valeurs utilisateurs. Cette option est surtout utile lorsqu'elle est utilisée conjointement avec <link linkend="ini.track-vars">track_vars</link> - dans ce cas, vous pouvez accéder à toutes les variables EGPCS grâce aux tableaux <varname>$HTTP_ENV_VARS</varname>, <varname>$HTTP_GET_VARS</varname>, <varname>$HTTP_POST_VARS</varname>, <varname>$HTTP_COOKIE_VARS</varname>, et <varname>$HTTP_SERVER_VARS</varname>. </para> </listitem> </varlistentry> <varlistentry id="ini.short-open-tag"> <term> <parameter>short_open_tag</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive l'utilisation des balises courtes, (<userinput><? ?></userinput>). Si vous voulez utiliser PHP et XML en même temps, vous devez désactiver cette option. Si cette option est désactivée, vous devez utiliser la forme longue des tags, (<userinput><?php ?></userinput>).</para> </listitem> </varlistentry> <varlistentry id="ini.sql.safe-mode"> <term> <parameter>sql.safe_mode</parameter> <type>booléen</type> </term> <listitem> <para> Aucune documentation n'est fournie. </para> </listitem> </varlistentry> <varlistentry id="ini.track-errors"> <term> <parameter>track_errors</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, le dernier message d'erreur sera placé dans la variable globale <symbol>$php_errormsg</symbol>.</para> </listitem> </varlistentry> <varlistentry id="ini.track-vars"> <term> <parameter>track_vars</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, lors de l'appel des méthodes GET, POST et l'utilisation des cookies, les variables sont disponibles dans des tableaux associatifs globaux appelés respectivement <symbol>$HTTP_GET_VARS</symbol>, <symbol>$HTTP_POST_VARS</symbol> et <symbol>$HTTP_COOKIE_VARS</symbol>. </para> </listitem> </varlistentry> <varlistentry id="ini.upload-tmp-dir"> <term> <parameter>upload_tmp_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Indique le répertoire utilisé lors du chargement d'un fichier sur un serveur. Ce répertoire doit être accessible en lecture pour l'utilisateur qui lance le script PHP. </para> </listitem> </varlistentry> <varlistentry id="ini.upload-max-filesize"> <term> <parameter>upload_max_filesize</parameter> <type>entier</type> </term> <listitem> <para> La taille maximale d'un fichier téléchargé sur le serveur. La valeur doit être en octets. Par défaut, elle est de 2 méga-octets. in bytes. </para> </listitem> </varlistentry> <varlistentry id="ini.user-dir"> <term> <parameter>user_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Répertoire où sont stockés les fichiers PHP dans le répertoire d'un utilisateur. Par exemple, <literal>public_html</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.warn-plus-overloading"> <term> <parameter>warn_plus_overloading</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, PHP émet une alerte lorsque l'opérateur plus (<literal>+</literal>) est utilisé sur une chaîne de caractères. Cela permet de réperer plus facilement les scripts qui doivent être réécrits en utilisant l'opérateur de concaténation (<literal>.</literal>) plutôt que l'opérateur plus. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mail"> <title>Directives de configuration concernant le mail</title> <variablelist> <varlistentry id="ini.smtp"> <term> <parameter>SMTP</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Sous Windows, adresse IP ou nom que PHP doit utiliser pour envoyer du mail avec la fonction <function>mail</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.sendmail-from"> <term> <parameter>sendmail_from</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Sous Windows, valeur du champs "From:" qui doit être utilisée lors de l'envoi de mail. </para> </listitem> </varlistentry> <varlistentry id="ini.sendmail-path"> <term> <parameter>sendmail_path</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Localisation du programme de <command>sendmail</command> : habituellement <filename>/usr/sbin/sendmail</filename> ou <filename>/usr/lib/sendmail</filename>. <command>configure</command> essaye de repérer la présence de sendmail par lui-même, et affecte ce résultat par défaut. En cas de problème de localisation, vous pouvez établir une nouvelle valeur par défaut ici. </para> <para> Tout système n'utilisant pas <command>sendmail</command> doit établir cette directive à la valeur chemin du programme de substitution qui remplace le serveur de mail, si celui-ci existe, par exemple, <ulink url="&url.qmail;">Qmail</ulink>. Dans ce cas là, vous devez mettre: <filename>/var/qmail/bin/sendmail</filename>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.safe-mode"> <title>Directives de configuration du "Safe Mode"</title> <variablelist> <varlistentry id="ini.safe-mode"> <term> <parameter>safe_mode</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive active ou désactive l'option "safe mode". Lisez le chapitre <link linkend="security">sécurité </link> pour plus d'informations. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-exec-dir"> <term> <parameter>safe_mode_exec_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Si l'option "SAFE MODE" est activée, <function>system</function> et les autres fonctions exécutant des programmes systèmes refusent de se lancer si ces programmes ne sont pas placés dans ce répertoire. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.debugger"> <title>Directives de configuration de débugage.</title> <variablelist> <varlistentry id="ini.debugger.host"> <term> <parameter>debugger.host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Adresse IP ou nom de l'hôte utilisé pour le débugage. </para> </listitem> </varlistentry> <varlistentry id="ini.debugger.port"> <term> <parameter>debugger.port</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Numéro du port utilisé pour le débugage. </para> </listitem> </varlistentry> <varlistentry id="ini.debugger.enabled"> <term> <parameter>debugger.enabled</parameter> <type>booléen</type> </term> <listitem> <para> Activation ou désactivation du débugueur.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.extension"> <title>Directives de chargement des extensions</title> <variablelist> <varlistentry id="ini.enable-dl"> <term> <parameter>enable_dl</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive n'est réellement utile que dans le cas d'une compilation comme module Apache. Vous pouvez activer le chargement dynamique des extensions avec la fonction <function>dl</function>, et cela de manière locale à chaque serveur virtuel ou à chaque répertoire. </para> <para> La principale raison qui pousse à désactiver le chargement dynamique est un problème de sécurité. Lorsque le chargement dynamique est activé, il est possible d'ignorer les directives <link linkend="ini.safe-mode">safe mode</link> ou "open_basedir". </para> <para> Par défaut, il est possible d'utiliser le chargement dynamique, sauf lorsque la directive <link linkend="ini.safe-mode">safe mode</link> est activée. En effet, il est alors impossible d'utiliser la fonction <function>dl</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.extension-dir"> <term> <parameter>extension_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Définit le répertoire dans lequel le PHP doit chercher les extensions lors du chargement dynamique. </para> </listitem> </varlistentry> <varlistentry id="ini.extension"> <term> <parameter>extension</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Définit les extensions qui doivent être chargées lors du démarrage du PHP. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mysql"> <title>Directives de configuration MySQL</title> <variablelist> <varlistentry id="ini.mysql.allow-persistent"> <term> <parameter>mysql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données MySQL. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-host"> <term> <parameter>mysql.default_host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Adresse par défaut du serveur, à utiliser lors de la connexion à un serveur MySQL, si aucun hôte n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-user"> <term> <parameter>mysql.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Utilisateur par défaut, à utiliser lors de la connexion à un serveur MySQL, si aucun utilisateur n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-password"> <term> <parameter>mysql.default_password</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut, à utiliser lors de la connexion à un serveur MySQL, si aucun mot de passe n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-port"> <term> <parameter>mysql.default_port</parameter> <type>string</type> </term> <listitem> <para> Le numéro de port TCP par défaut, utilisé pour se connecter à la base de données, lorsqu'aucun port n'est spécifié. Si aucun port par défaut est spécifié, le port sera alors obtenu en lisant la variable d'environnement <literal>MYSQL_TCP_PORT</literal>, l'entrée <literal>mysql-tcp</literal> dans le fichier <filename>/etc/services</filename> ou encore la constante de compilation <literal>MYSQL_PORT</literal>, dans cet order. Win32 n'utilisera aussi que la constante <literal>MYSQL_PORT</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-socket"> <term> <parameter>mysql.default_socket</parameter> <type>string</type> </term> <listitem> <para> Le nom par défaut de la socket lorsque l'on se conecte au serveur local, si aucune autre socket n'est spécifiée. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.max-persistent"> <term> <parameter>mysql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données MySQL, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.max-links"> <term> <parameter>mysql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre de connexions maximum à une base de données MySQL, par processus, incluant les connexions persistantes </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.msql"> <title>Directives de configuration mSQL</title> <variablelist> <varlistentry id="ini.msql.allow-persistent"> <term> <parameter>msql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données mSQL. </para> </listitem> </varlistentry> <varlistentry id="ini.msql.max-persistent"> <term> <parameter>msql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données mSQL, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.msql.max-links"> <term> <parameter>msql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données mSQL, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.pgsql"> <title>Directives de configuration Postgres</title> <variablelist> <varlistentry id="ini.pgsql.allow-persistent"> <term> <parameter>pgsql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Postgres. </para> </listitem> </varlistentry> <varlistentry id="ini.pgsql.max-persistent"> <term> <parameter>pgsql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Postgres, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.pgsql.max-links"> <term> <parameter>pgsql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximal de connexions à une base de données Postgres, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sesam"> <title>Directives de configuration SESAM</title> <variablelist> <varlistentry id="ini.sesam-oml"> <term> <parameter>sesam_oml</parameter> <type>string</type> </term> <listitem> <para> Nom de la librairieBS2000 PLAM contenant les pilotes de connexion SESAM. Obligatoire pour les fonctions SESAM. La librairie BS2000 PLAM doit être configurée avec <literal>ACCESS=READ,SHARE=YES</literal>, car elle doit être accessible à l'utilisateur Apache. </para> </listitem> </varlistentry> <varlistentry id="ini.sesam-configfile"> <term> <parameter>sesam_configfile</parameter> <type>string</type> </term> <listitem> <para> Nom du fichier de configuration de l'application SESAM. Obligatoire pour les fonctions SESAM. Le fichier BS2000 doit être accessible être accessible à l'utilisateur Apache. </para> <para> Le fichier de configuration de l'application va contenir la configuration sur le schéma suivant (voir le manuel SESAM) : <informalexample> <programlisting role="bs2000">CNF=BNAM=KNOTYPE</programlisting> </informalexample> </para> </listitem> </varlistentry> <varlistentry id="ini.sesam-messagecatalog"> <term> <parameter>sesam_messagecatalog</parameter> <type>string</type> </term> <listitem> <para> Nom du catalogue de messages SESAM. Dans la plupart des cas, cette directive n'est pas nécessaire. Seulement, si le fichier de messages SESAM n'est pas installé dans la table de messages BS2000, il faut indiquer sa localisation avec cette directive. </para> <para> Le catalogue de messages doit être paramétré avec <literal>ACCESS=READ,SHARE=YES</literal>, car il doit être accessible à l'utilisateur Apache. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sybase"> <title>Directives de configuration Sybase</title> <variablelist> <varlistentry id="ini.sybase.allow-persistent"> <term> <parameter>sybase.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Sybase. </para> </listitem> </varlistentry> <varlistentry id="ini.sybase.max-persistent"> <term> <parameter>sybase.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Sybase par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.sybase.max-links"> <term> <parameter>sybase.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Sybase, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sybct"> <title>Directives de configuration Sybase-CT</title> <variablelist> <varlistentry id="ini.sybct.allow-persistent"> <term> <parameter>sybct.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Sybase-CT. Par défaut, cette option est activée. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.max-persistent"> <term> <parameter>sybct.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Sybase-CT par processus. Par défaut, cette option est à -1, ce qui signifie que le nombre de connexion est illimité. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.max-links"> <term> <parameter>sybct.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Sybase-CT, par processus, incluant les connexions persistantes. Par défaut, cette option est à -1, ce qui signifie que le nombre de connexions est illimité. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.min-server-severity"> <term> <parameter>sybct.min_server_severity</parameter> <type>entier</type> </term> <listitem> <para> Les messages en provenance du serveur d'un niveau d'erreur égal à sybct.min_server_severity seront considérés comme des alertes (warnings). Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction sybase_min_server_severity (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur vaut 10. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.min-client-severity"> <term> <parameter>sybct.min_client_severity</parameter> <type>entier</type> </term> <listitem> <para> Les messages en provenance de la librairie client avec un niveau d'erreur égal ou supérieur à sybct.min_client_severity seront considérés comme des alertes. Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction sybase_min_client_severity (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur vaut 10, ce qui annule tout rapport d'erreur. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.login-timeout"> <term> <parameter>sybct.login_timeout</parameter> <type>entier</type> </term> <listitem> <para> Délai de validité d'une tentative de connexion. Il est à noter que si max_execution_time est dépassé avant que la connexion n'expire, le script sera terminé avant le message d'erreur. Par défaut, cette valeur vaut 1 minute. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.timeout"> <term> <parameter>sybct.timeout</parameter> <type>entier</type> </term> <listitem> <para> Temps maximum en secondes avant qu'une tentative de requête "select_db" ou "query" non aboutie renvoie une erreur. Il est à noter que si max_execution_time est dépassé avant que la requête n'expire, votre script sera terminé avant le message d'erreur. Par défaut, il n'y a pas de limite. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.hostname"> <term> <parameter>sybct.hostname</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom de l'hôte à partir duquel vous vous connectez, afin d'être affiché par la fonction sp_who (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur égale à 0. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.informix"> <title>Directives de configuration Informix</title> <variablelist> <varlistentry id="ini.ifx.allow-persistent"> <term> <parameter>ifx.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active les connexions persistantes à une base de données Informix. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.max-persistent"> <term> <parameter>ifx.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Informix, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.max-links"> <term> <parameter>ifx.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Informix par processus, en incluant les connexions persistantes. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-host"> <term> <parameter>ifx.default_host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Hôte par défaut où se connecter si aucun hôte n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-user"> <term> <parameter>ifx.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Utilisateur par défaut si aucun utilisateur n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-password"> <term> <parameter>ifx.default_password</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut si aucun mot de passe n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.blobinfile"> <term> <parameter>ifx.blobinfile</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "blob" seront retournées dans un fichier. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_blobinfile_mode</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.textasvarchar"> <term> <parameter>ifx.textasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "TEXT" seront retournées dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_textasvarchar</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.byteasvarchar"> <term> <parameter>ifx.byteasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "BYTE" seront retournées dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_textasvarchar</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.charasvarchar"> <term> <parameter>ifx.charasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les espaces en fin de chaîne de caractères seront conservés lors d'une commande FETCH. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.nullformat"> <term> <parameter>ifx.nullformat</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de valeur &null; seront retournées comme des chaînes de caractères vides. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_nullformat</function>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.bcmath"> <title> Directives de configuration pour les calculs mathématiques. </title> <variablelist> <varlistentry id="ini.bcmath.scale"> <term> <parameter>bcmath.scale</parameter> <type>entier</type> </term> <listitem> <para> Nombre de chiffres après la virgule pour toutes les fonctions de précision mathématique arbitraire. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.browscap"> <title>Directives de configuration du navigateur.</title> <variablelist> <varlistentry id="ini.browscap"> <term> <parameter>browscap</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom du fichier de descriptif des clients HTML. Voir aussi <function>get_browser</function>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.uodbc"> <title>Directives de configuration du pilote ODBC unifié</title> <variablelist> <varlistentry id="ini.uodbc.default-db"> <term> <parameter>uodbc.default_db</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Source de données ODBC à utiliser par défaut avec les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.default-user"> <term> <parameter>uodbc.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom d'utilisateur défaut avec les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.default-pw"> <term> <parameter>uodbc.default_pw</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut dans les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.allow-persistent"> <term> <parameter>uodbc.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Cette option active ou désactive les connexions persistantes à la base de données, via le canal ODBC. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.max-persistent"> <term> <parameter>uodbc.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes autorisées à la base de données. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.max-links"> <term> <parameter>uodbc.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions (persistantes ou non), par processus, à la base de données. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mbstring"> <title>Directives de configuration des chaînes mulit-octets</title> <variablelist> <varlistentry id="ini.mbstring.internal-encoding"> <term> <parameter>mbstring.internal_encoding</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.internal_encoding</literal> définit l'encodage interne par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.http-input"> <term> <parameter>mbstring.http_input</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.http_input</literal> définit l'encodage de reception HTTP par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.http-output"> <term> <parameter>mbstring.http_output</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.http_output</literal> définit l'encodage d'affichage HTTP par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.detect-order"> <term> <parameter>mbstring.detect_order</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.detect_order</literal> définit l'ordre de détection des encodages par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.substitute-character"> <term> <parameter>mbstring.substitute_character</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.substitute_character</literal> définit l'encodage de substitution par défaut : il est utilisé pour les caractères invalides. </para> </listitem> </varlistentry> </variablelist> </sect2> </sect1> </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:tsgml-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/install.xml diff -u phpdoc/fr/chapters/install.xml:1.31 phpdoc/fr/chapters/install.xml:1.32 --- phpdoc/fr/chapters/install.xml:1.31 Thu Oct 4 17:05:52 2001 +++ phpdoc/fr/chapters/install.xml Mon Nov 12 00:03:37 2001 @@ -1,4573 +1 @@ -<!-- $Revision: 1.31 $ --> -<chapter id="installation"> - <title>Installation</title> - <sect1 id="install.downloading"> - <title>Télécharger la dernière version</title> - <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> - <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 les codes sources) - </simpara> - </listitem> - <listitem> - <simpara> - bison (pour les codes sources) - </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>Référence 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> - Instructions d'installation PHP 4 (Version Module Apache) - </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. ./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> - <sect1 id="install.linux"> - <title>Installation sous Linux</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> - <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> - <programlisting> -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. - </programlisting> - </example> - </sect1> - <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> - <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</ulink>. - </para> - <sect2 id="install.openbsd.ports"> - <title>Utilisation des ports</title> - <simpara> - Ceci est la méthode recommandée d'installation de PHP sous - OpenBSD, car elle prend en compte les dernières modifications et - mises à jour de sécurité. Pour utiliser cette méthode, assurez - vous que vous avez bien - <ulink url="&url.openbsd.ports;">ports tree</ulink> récent. Choisissez - alors simplement la version que vous souhaitez installer, et utilisez - la commande <command>make install</command>. Ci-dessous, voici un - exemple. - </simpara> - <example id="install.openbsd.ports.example"> - <title>Exemple d'installation de PHP sous OpenBSD avec Ports</title> - <programlisting> -$ cd /usr/ports/www/php4 -$ make show VARNAME=FLAVORS - (choisissez les versions que vous souhaitez sur votre liste). -$ env FLAVOR="imap gettext ldap mysql gd" make install -$ /usr/local/sbin/php4-enable - </programlisting> - </example> - </sect2> - <sect2 id="install.openbsd.packages"> - <title>Utilisation des Packages</title> - <simpara> - Il existe des packages pré-compilés disponibles en - téléchargement à <ulink url="&url.openbsd;">OpenBSD</ulink>. - Ils s'intègrent automatiquement avec la version d'Apache - installée sur votre OS. Cependant, comme il y a un - grand nombre d'options (appelées <emphasis>flavors</emphasis>) - disponibles, vous trouverez peut-être plus facile de - le compiler à partir de l'arbre de ports. - Lisez le manuel <ulink url="&url.openbsd.packages;">packages(7)</ulink> - pour plus de détails sur les packages disponibles (en anglais). - </simpara> - </sect2> - </sect1> - <sect1 id="install.macosx"> - <title>Installation sous Mac OS X</title> - <para> - Cette section contient les notes et conseils d'installation de PHP - sur les distributions Mac OS X. - </para> - <sect2 id="install.macosx.packages"> - <title>Utilisation des packages</title> - <simpara> - Il existe quelques versions pré-packagée et - pré-compilées de PHP pour Mac OS X. Ils permettent de - réaliser rapidement des installations standard, mais si vous - avez des configurations personnelles, (comme un serveur sécurisé - SSL ou un pilote de base de données exotique), vous devrez compiler - PHP et/ou votre serveur web vous-même. 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> - <sect2 id="install.macosx.compile"> - <title>Compilation pour serveur OS X</title> - <simpara> - Il existe deux versions légèrement différentes de Mac OS X, - client et serveur. Cette installation est faite pour le OS X Serveur. - </simpara> - <example id="install.macosx.compile.example"> - <title>Installation sous Mac OS X serveur</title> - <programlisting> -1. Téléchargez la dernière version de Apache et PHP -2. Décompressez puis désarchivez la, puis configurez Apache comme ceci : - ./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. Vous aurez peut être besoin d'ajouter ces lignes ci, pour optimiser la -compilation : - setenv OPTIM=-O2 -5. Puis, allez dans le dossier source de PHP 4, et configurez le : - ./configure --prefix=/usr \ - --sysconfdir=/etc \ - --localstatedir=/var \ - --mandir=/usr/share/man \ - --with-xml \ - --with-apache=/src/apache_1.3.12 - Si vous avez d'autres composants (MySQL, GD, etc.), n'oubliez pas de les - ajouter à ce moment la. Pour l'option --with-apache, ajoutez le chemin - jusqu'au dossier source d'Apache, par exemple "/src/apache_1.3.12". -6. Exécutez un "make" -7. Exécutez un "make install" - Cette commande ajoutera un dossier dans le dossier Apache : - src/modules/php4. -8. Maintenant, reconfigurez Apache pour compiler 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 - Vous pouvez rencontrer un message qui vous dira que libmodphp4.a est - obsolète. Si c'est le cas, allez dans le dossier - src/modules/php4 de votre dossier Apache et exécutez la commande suivante : - ranlib libmodphp4.a - Puis, revenez à la racine de la distribution Apache, et recommencez la - configuration. Cela aura mis à jour la table de liens. -9. Exécutez un "make" -10. Exécutez un "make install" -11. Copiez et renommez le fichier php.ini-dist de votre distribution PHP 4 - dans votre dossier "bin": - cp php.ini-dist /usr/local/bin/php.ini - ou (si vous n'avez pas de dossier local) - cp php.ini-dist /usr/bin/php.ini - </programlisting> - </example> - <simpara> - D'autres exemples pour - <ulink url="&url.stepwise.macosx-client;">Mac OS X client</ulink> - et - <ulink url="&url.stepwise.macosx-client;">Mac OS X server</ulink> - sont disponibles à <ulink url="&url.stepwise;">Stepwise</ulink>. - </simpara> - </sect2> - <sect2 id="install.macosx.client"> - <title>Compilation pour MacOS X client</title> - <simpara> - Ces conseils sont gracieusement fourni par <ulink url="&url.macosx;">Marc Liyanage</ulink>. - </simpara> - <simpara> - Le module PHP pour Apache est inclus dans Mac OS X. - Cette version inclus le support des bases de données MySQL et PostgreSQL. - </simpara> - <simpara> - NOTE: Soyez prudent avec cette manipulation, vous risquez de mettre - votre serveur Apache à terre! - </simpara> - <para> - Insctructions : - <itemizedlist> - <listitem> - <simpara> - 1. Ouvrez un terminal - </simpara> - </listitem> - <listitem> - <simpara> - 2. Tapez "wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz", - attendez la fin du 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 ouvrira le fichier de configuration. Recherchez ces deux lignes, vers la - fin du fichier (Utilisez la commande Find) - <programlisting> - * #AddType application/x-httpd-php .php - * #AddType application/x-httpd-php-source .phps - </programlisting> - Supprimez les deux marques de commentaires (<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 fonctionner. Vous pouvez le tester en placant un script dans le dossier - "Sites". Par exemple, le fichier "test.php", qui contient la simple ligne : - "<literal><?php phpinfo() ?></literal>". - </para> - <para> - Ouvrez l'URL <literal>127.0.0.1/~your_username/test.php</literal> dans votre - navigateur. Vous obtiendrez le tableau de bord de PHP. - </para> - </sect2> - </sect1> - <sect1 id="install.configure"> - <title>Liste complète des options de configuration</title> - <para> - Cette section rassemble la liste complète des options de configuration - supportées par PHP 3 et PHP 4, à utiliser avec le fichier - <filename>configure</filename>, lors de la configuration sous Unix. - Certaines options sont disponibles sous PHP 3, d'autres sous - PHP 4 et certains sous PHP 3 et PHP 4, comme inidiqué. Il y a de - nombreuses options dont le nom a changé entre PHP 3 et PHP 4. Ces - options ont des liens entre elles : si vous vous souvenez d'un - nom d'option en PHP 3, regardez si le nom a changé. - </para> - <itemizedlist> - <listitem> - <para> - <link linkend="install.configure.databases">Base de données</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.ecommerce">E-commerce</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.graphics">Images</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.misc">Divers</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.networking">Réseau</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.php">Comportement PHP</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.servers">Serveur</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.text">Texte et langue</link> - </para> - </listitem> - <listitem> - <para> - <link linkend="install.configure.xml">XML</link> - </para> - </listitem> - </itemizedlist> - <sect2 id="install.configure.databases"> - <title>Base de données</title> - <variablelist> - <varlistentry id="install.configure.with-adabas"> - <term> - <parameter>--with-adabas[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Adabas D. DIR est le dossier - d'installation de Adabas (par défaut, <literal>/usr/local</literal>). - </para> - <para> - <ulink url="&url.adabas;">Adabas home page</ulink> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dba"> - <term> - <parameter>--enable-dba=shared</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile DBA comme module partagé - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dbx"> - <term> - <parameter>--enable-dbx</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support DBX. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dbase"> - <term> - <parameter>--enable-dbase</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-dbase">--with-dbase</link> - instead. - </para> - <para> - PHP 4: Active la librairie dbase livrée avec PHP. Aucune librairie - supplémentaire n'est nécessaire. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-dbase"> - <term> - <parameter>--with-dbase</parameter> - </term> - <listitem> - <para> - PHP 3: Active la librairie dbase livrée avec PHP. Aucune librairie - supplémentaire n'est nécessaire. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-dbase">--enable-dbase</link> - instead. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-db2"> - <term> - <parameter>--with-db2[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support Berkeley DB2. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-db3"> - <term> - <parameter>--with-db3[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Berkeley DB3. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-dbm"> - <term> - <parameter>--with-dbm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support DBM. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-dbmaker"> - <term> - <parameter>--with-dbmaker[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3. - </para> - <para> - PHP 4: Inclut le support DBMaker. DIR est le dossier d'installation - DBMaker (par défaut, c'est le dossier de la dernière installation - DBMaker, comme <literal>/home/dbmaker/3.6</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-empress"> - <term> - <parameter>--with-empress[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Empress. DIR est le dossier - d'installation Empress (par défaut, <literal>$EMPRESSPATH</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-filepro"> - <term> - <parameter>--enable-filepro</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-filepro">--with-filepro</link> - instead. - </para> - <para> - PHP 4: Active la librairie filePro (lecture seule) livrée avec PHP. - Aucune librairie supplémentaire n'est nécessaire. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-fbsql"> - <term> - <parameter>--with-fbsql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible. - </para> - <para> - PHP 4: Inclut le support de FrontBase SQL. DIR est le chemin - jusqu'à l'installation de FrontBase base. Par défaut, c'est le dossier - standard d'installation Frontbase. L'installation dépend de votre - OS : Solaris: <literal>/opt/FrontBase</literal>, - WinNT: <literal>\usr\FrontBase</literal>, - Linux: <literal>/usr/frontbase</literal>, - Mac OSX: <literal>/Library/FrontBase</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-filepro"> - <term> - <parameter>--with-filepro</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support IBM DB2. - Aucune librairie supplémentaire n'est nécessaire. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-filepro">--enable-filepro</link>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gdbm"> - <term> - <parameter>--with-gdbm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support GDBM. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-hyperwave"> - <term> - <parameter>--with-hyperwave</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support Hyperwave. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ibm-db2"> - <term> - <parameter>--with-ibm-db2[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support IBM DB2. DIR est le dossier - d'installation de DB2 (par défaut, - <filename>/home/db2inst1/sqllib</filename>). - </para> - <para> - <ulink url="&url.ibmdb2;">IBM DB2</ulink> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-informix"> - <term> - <parameter>--with-informix[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Informix. DIR est le dossier - d'installation d'Informix (par défaut, aucune valeur). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ingres"> - <term> - <parameter>--with-ingres[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Ingres II. DIR est le dossier - d'installation d'Ingres (par défaut, <literal>/II/ingres</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-interbase"> - <term> - <parameter>--with-interbase[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support InterBase. DIR est le dossier - d'installation d'InterBase (par défaut, - <filename>/usr/interbase</filename>). - </para> - <simpara> - <link linkend="ref.ibase">Fonctions Interbase</link> - </simpara> - <simpara> - <ulink url="&url.ibase;">Interbase</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ldap"> - <term> - <parameter>--with-ldap[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support LDAP. DIR est le dossier - d'installation de LDAP (par défaut <filename>/usr</filename> et - <filename>/usr/local</filename>). - </para> - <para> - PHP 4: Inclut le support LDAP. DIR est le dossier - d'installation de LDAP. (par défaut; - <filename class="directory">/usr/local/ldap</filename>). - </para> - <simpara> - Plus de détails sur LDAP sont disponibles à - <ulink url="&url.rfc;rfc1777.html">RFC1777</ulink> et - <ulink url="&url.rfc;rfc1778.html">RFC1778</ulink>. - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-msql"> - <term> - <parameter>--with-msql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support mSQL. DIR est le dossier - d'installation de mSQL (par défaut <filename>/usr</filename> et - <filename>/usr/local/Hughes</filename>, pour la version 2.0). - <command>configure</command> détecte automatiquement la version - de mSQL qui fonctionne. PHP supporte les versions 1.0 et 2.0, - mais si vous compilez PHP avec mSQL 1.0, vous ne pourrez accéder qu'à - des bases mSQL 1.0, et vice-versa. - </para> - <simpara> - Voir aussi - <link linkend="ini.sect.msql">Configuration mSQL</link> dans le - fichier de <link linkend="configuration.file">configuration</link>. - </simpara> - <simpara> - <ulink url="&url.msql;">mSQL</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mysql"> - <term> - <parameter>--with-mysql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support MySQL. DIR est le dossier - d'installation de MySQL (par défaut, il cherche dans différents - dossiers où MySQL a coutume d'être installé). - </para> - <para> - PHP 4: Inclut le support MySQL. DIR est le dossier de l'installation - MySQL. S'il est omis, la librairie MySQL livrée en standard avec - PHP sera utilisée par défaut. - </para> - <para> - Voir aussi - <link linkend="ini.sect.mysql">Configuration MySQL</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </para> - <para> - <ulink url="&url.mysql;">MySQL</ulink> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ndbm"> - <term> - <parameter>--with-ndbm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support NDBM. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ovrimos"> - <term> - <parameter>--with-ovrimos</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Ovrimos. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-oci8"> - <term> - <parameter>--with-oci8[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Oracle-oci8. DIR est le dossier - d'installation de Oracle-oci8 (par défaut, - <filename>ORACLE_HOME</filename>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-oracle"> - <term> - <parameter>--with-oracle[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support Oracle database. DIR est le dossier - d'installation de Oracle (par défaut, - <filename>$ORACLE_HOME</filename>). - </para> - <para> - PHP 4: Inclut le support Oracle-oci7. DIR est le dossier - d'installation de Oracle-oci7 (par défaut, - <filename>ORACLE_HOME</filename>). - </para> - <simpara> - Inclut le support Oracle. Ce support a été testé et permet de travailler - avec les versions d'Oracle de 7.0 à 7.3. Le paramètre - est le dossier <envar>ORACLE_HOME</envar>. Vous n'avez pas à - spécifier ce paramètre si votre environnement Oracle a été - configuré. - </simpara> - <simpara> - <ulink url="&url.oracle;">Oracle</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pgsql"> - <term> - <parameter>--with-pgsql[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support PostgresSQL. DIR est le dossier - d'installation de PostgresSQL (par défaut, - <filename>/usr/local/pgsql</filename>). - </para> - <para> - PHP 4: Inclut le support PostgreSQL. DIR est le dossier - d'installation de PostgreSQL (par défaut, - <filename>/usr/local/pgsql</filename>). Pour compiler en "dl", - utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", - mais spécifier DIR malgré tout. - </para> - <simpara> - Voir aussi <link linkend="ini.sect.pgsql">Postgres</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - <simpara> - <ulink url="&url.pgsql;">PostgreSQL</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-solid"> - <term> - <parameter>--with-solid[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Solid. DIR est le dossier - d'installation de Solid (par défaut, - <literal>/usr/local/solid</literal>). - </para> - <simpara> - <ulink url="&url.solid;">Solid</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-sybase-ct"> - <term> - <parameter>--with-sybase-ct[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Sybase-CT. DIR est le dossier - d'installation de Sybase (par défaut, - <literal>/home/sybase</literal>). - </para> - <simpara> - Voir aussi <link linkend="ini.sect.sybct">Sybase-CT</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-sybase"> - <term> - <parameter>--with-sybase[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support Sybase-DB. DIR est le dossier - d'installation de Sybase (par défaut, <filename>/home/sybase</filename>). - </para> - <simpara> - Voir aussi <link linkend="ini.sect.sybase">Sybase</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - <simpara> - <ulink url="&url.sybase;">Sybase</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-openlink"> - <term> - <parameter>--with-openlink[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support OpenLink ODBC. DIR est le dossier - d'installation d'OpenLink (par défaut - <literal>/usr/local/openlink</literal>). - A partir de PHP 4.0.6, cette option n'est plus valable. - Utilisez plutôt <link linkend="install.configure.with-iodbc"><option> - --with-iodbc</option></link> si vous voulez - utiliser l'ODBC de OpenLink Software. - </para> - <simpara> - <ulink url="&url.openlink;">OpenLink Software</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-iodbc"> - <term> - <parameter>--with-iodbc[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support iODBC. DIR est le dossier - d'installation d'iODBC (par défaut, <filename>/usr/local</filename>). - </para> - <para> - Cette fonctionnalité a d'abord été - développée avec le gestionnaire - iODBC Driver Manager, un pilote ODBC librement distribuable, qui - fonctionne sous divers UNIX. - </para> - <simpara> - <ulink url="&url.freeodbc;">FreeODBC</ulink> - ou <ulink url="&url.iodbc;">iODBC</ulink> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-custom-odbc"> - <term> - <parameter>--with-custom-odbc[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support ODBC, avec une librairie tierce. - Le paramètre DIR est le nom du dossier d'installation de cette - librairie. Par défaut, il vaut - <filename class="directory">/usr/local</filename>. - </para> - <simpara> - Cette option implique qus vous avez défini CUSTOM_ODBC_LIBS - lorsque vous éxécutez le script de configuration. - Vous devez aussi avoir une en-tête <filename>odbc.h</filename> valide dans vos - dossiers d'Inclution. Si vous n'en avez pas, créez le, et - ajoutez-y vos en-têtes spécifiques. Votre en-tête peut - aussi réclamer d'autres définitions, surtout si elle - est multi-plate-forme. Définissez les dans CFLAGS. - </simpara> - <simpara> - Par exemple, vous pouvez utilisez Sybase SQL Anywhere sous QNX comme - ceci : - <literal> - CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib - -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50 - </literal> - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-unified-odbc"> - <term> - <parameter>--disable-unified-odbc</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive le support unified ODBC. Uniquement valable si - iODBC, Adabas, Solid, Velocis ou une interface spéciale ODBC - a été activée. - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - <simpara> - Le module Unified ODBC est commun à toutes les bases de données - ODBC, comme par exemple Solid, IBM DB2 et Adabas D. Il fonctionne - aussi avec les librairies ODBC normales. Des tests ont été menés - avec iODBC, Solid, Adabas D, IBM DB2 et Sybase SQL Anywhere. - Il requiert une (et une seule) de ces extensions, ou l'extension - Velocis, ou une librairie ODBC spéciale. Cette option n'est - possible qu'avec l'utilisation de l'une des options suivantes : - <link linkend="install.configure.with-iodbc">--with-iodbc</link>, - <link linkend="install.configure.with-solid">--with-solid</link>, - <link linkend="install.configure.with-ibm-db2">--with-ibm-db2</link>, - <link linkend="install.configure.with-adabas">--with-adabas</link>, - <link linkend="install.configure.with-velocis">--with-velocis</link>, - ou - <link linkend="install.configure.with-custom-odbc">--with-custom-odbc</link>. - </simpara> - <simpara> - Voir aussi <link linkend="ini.sect.uodbc">Unified ODBC</link> - dans le fichier de - <link linkend="configuration.file">configuration</link>. - </simpara> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-unixODBC"> - <term> - <parameter>--with-unixODBC[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support unixODBC. DIR est le dossier - d'installation d'unixODBC (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-velocis"> - <term> - <parameter>--with-velocis[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclus le support Velocis. DIR est le dossier - d'installation de Velocis (par défaut, - <literal>/usr/local/velocis</literal>). - </para> - <simpara> - <ulink url="&url.velocis;">Velocis</ulink> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.ecommerce"> - <title>E-commerce</title> - <variablelist> - <varlistentry id="install.configure.with-ccvs"> - <term> - <parameter>--with-ccvs[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Ajoute le support CCVS. DIR est le dossier d'installation - de CCVS. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cybermut"> - <term> - <parameter>--with-cybermut[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support de Cybermut pour PHP 4. DIR est le dossier - du SDK Cybermut, qui contient les deux fichiers <filename>libcm-mac.a</filename> - et <filename>cm-mac.h</filename>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mck"> - <term> - <parameter>--with-mck[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support Cybercash MCK. DIR est le dossier - d'installation de cybercash mck (par défaut, - <filename>/usr/src/mck-3.2.0.3-linux</filename>). Plus d'aide dans - le dossier <filename>extra/cyberlib</filename>. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-cybercash">--with-cybercash</link> - instead. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cybercash"> - <term> - <parameter>--with-cybercash[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-mck">--with-mck</link> - instead. - </para> - <para> - PHP 4: Inclut le support CyberCash. DIR est le dossier - d'installation de CyberCash MCK. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pfpro"> - <term> - <parameter>--with-pfpro[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Verisign Payflow Pro. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.graphics"> - <title>Images</title> - <variablelist> - <varlistentry id="install.configure.enable-freetype-4bit-antialias-hack"> - <term> - <parameter>--enable-freetype-4bit-antialias-hack</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support de FreeType2 (expérimental). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gd"> - <term> - <parameter>--with-gd[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support GD. DIR est le dossier - d'installation de GD. - </para> - <para> - PHP 4: Inclut le support GD. DIR est le dossier - d'installation de GD. Pour compiler en "dl", - utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", - mais spécifier DIR malgré tout. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.without-gd"> - <term> - <parameter>--without-gd</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inactive le support GD . - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-imagick"> - <term> - <parameter>--with-imagick[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support ImageMagick. DIR est le dossier - d'installation de ImageMagick. S'il est omis, PHP essaiera de - le trouver de lui-même (expérimental). - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-jpeg-dir"> - <term> - <parameter>--with-jpeg-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: dossier JPEG pour pdflib 2.0 - </para> - <para> - PHP 4: dossier JPEG pour pdflib 3.x et 4.x - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-png-dir"> - <term> - <parameter>--with-png-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: dossier PNG pour pdflib 3.x et 4.x - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-t1lib"> - <term> - <parameter>--enable-t1lib</parameter> - </term> - <listitem> - <para> - PHP 3: Active le support t1lib. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-t1lib">--with-t1lib</link> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-t1lib"> - <term> - <parameter>--with-t1lib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-t1lib">--enable-t1lib</link>. - </para> - <para> - PHP 4: Inclut le support T1lib. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-tiff-dir"> - <term> - <parameter>--with-tiff-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: dossier TIFF pour pdflib 2.0 - </para> - <para> - PHP 4: dossier TIFF pour pdflib 3.x et 4.x - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ttf"> - <term> - <parameter>--with-ttf[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support FreeType. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-xpm-dir"> - <term> - <parameter>--with-xpm-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: dossier XPM pour GD-1.8+ - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.misc"> - <title>Divers</title> - <para> - Ces options seront classées ultérieurement, lorsqu'une catégorie - adéquate apparaîtra. - </para> - <variablelist> - <varlistentry id="install.configure.disable-bcmath"> - <term> - <parameter>--disable-bcmath</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive la librairie BCmath. - </para> - <para> - PHP 4: Option non disponible en PHP 4. La librairie BCmath n'est pas - compilée par défaut. Utilisez - <link linkend="install.configure.enable-bcmath">--enable-bcmath</link> - pour l'inclure. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.gmp"> - <term> - <parameter>--with-gmp</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4 : Inclut le support GMP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-display-source"> - <term> - <parameter>--disable-display-source</parameter> - </term> - <listitem> - <para> - PHP 3: Compile sans afficher le support des sources - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-libtool-lock"> - <term> - <parameter>--disable-libtool-lock</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Empêche le verrouillage (risque d'empêcher certaines - compilations paralléles). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-pear"> - <term> - <parameter>--disable-pear</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: N'installe pas PEAR - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-pic"> - <term> - <parameter>--disable-pic</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inactive PIC pour les shared objects - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-posix"> - <term> - <parameter>--disable-posix</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3; Utilisez plutôt <link - linkend="install.configure.without-posix">--without-posix</link> - </para> - <para> - PHP 4: Inactive les fonctions POSIX. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-rpath"> - <term> - <parameter>--disable-rpath</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inactive le passage de chemins supplémentaires - pour la recherche de librairie lors de l'exécution. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-session"> - <term> - <parameter>--disable-session</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inactive le support session. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-bcmath"> - <term> - <parameter>--enable-bcmath</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3; bcmath est compilée par - défaut. Utilisez plutôt - <link linkend="install.configure.disable-bcmath">--disable-bcmath</link>, - pour l'inactiver. - </para> - <para> - PHP 4: Active le support de l'extension bc maths. - Voir aussi <link linkend="ref.bc">les fonctions BCMath</link>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-c9x-inline"> - <term> - <parameter>--enable-c9x-inline</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active les sémantiques C9x-inline - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-calendar"> - <term> - <parameter>--enable-calendar</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support des conversions calendaires - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-debug"> - <term> - <parameter>--enable-debug</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile sans les symboles de débuggages - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-debugger"> - <term> - <parameter>--enable-debugger</parameter> - </term> - <listitem> - <para> - PHP 3: Compile avec les fonctions de débuggage à distance - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-discard-path"> - <term> - <parameter>--enable-discard-path</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Si cette option est activée, le CGI PHP peut être - placé hors de l'arborescence web, pour que personne ne puisse l'atteindre, - même en contournant les .htaccess. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-dmalloc"> - <term> - <parameter>--enable-dmalloc</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active dmalloc - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-exif"> - <term> - <parameter>--enable-exif</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support exif. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-experimental-zts"> - <term> - <parameter>--enable-experimental-zts</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Cela risque fortement de ne plus compiler du tout! - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-fast-install"> - <term> - <parameter>--enable-fast-install[=PKGS]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Optimise pour les installations rapides for fast installation - (par défaut, <literal>no</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-force-cgi-redirect"> - <term> - <parameter>--enable-force-cgi-redirect</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active la vérification interne des redirections serveurs. - Il est recommandé d'utiliser cette option si vous avez compilé - PHP en CGI. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-inline-optimization"> - <term> - <parameter>--enable-inline-optimization</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Si vous avez beaucoup de mémoire disponible et que vous - utilisez gcc, essayez donc ça. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-libgcc"> - <term> - <parameter>--enable-libgcc</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active explicitement les liens avec libgcc - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-maintainer-mode"> - <term> - <parameter>--enable-maintainer-mode</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active des règles de make et de dépendances qui - sont parfois absconses et ne servent pas aux utilisateurs - habituels (Bref, ne l'utilisez pas). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-memory-limit"> - <term> - <parameter>--enable-memory-limit</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile avec le support de la limitation de mémoire - (par défaut, <literal>no</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-safe-mode"> - <term> - <parameter>--enable-safe-mode</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le SAFE_MODE (par défaut, <literal>yes</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-satellite"> - <term> - <parameter>--enable-satellite</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support CORBA via Satellite (Requiert ORBit) - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-shared"> - <term> - <parameter>--enable-shared[=PKGS]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile les librairies partagées - (par défaut, <literal>yes</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sigchild"> - <term> - <parameter>--enable-sigchild</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le gestionnaire SIGCHLD propre à PHP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-static"> - <term> - <parameter>--enable-static[=PKGS]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile les librairies en statique - (par défaut, <literal>yes</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sysvsem"> - <term> - <parameter>--enable-sysvsem</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support des sémaphores System V. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sysvshm"> - <term> - <parameter>--enable-sysvshm</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support de partage de mémoire System V. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-trans-sid"> - <term> - <parameter>--enable-trans-sid</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active la propagation transparente des identifiants de session. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cdb"> - <term> - <parameter>--with-cdb[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le support CDB. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-config-file-path"> - <term> - <parameter>--with-config-file-path=PATH</parameter> - </term> - <listitem> - <para> - PHP 3: Indique le chemin dans lequel aller lire le fichier - <filename>php3.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. - </para> - <para> - PHP 4: Indique le chemin dans lequel allet lire le fichier - <filename>php.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-cpdflib"> - <term> - <parameter>--with-cpdflib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support ClibPDF. DIR est le dossier - d'installation de ClibPDF (par défaut, <literal>/usr/local</literal>). - </para> - <para> - PHP 4: Inclut le support ClibPDF.(requires cpdflib >= 2). - DIR est le dossier d'installation de cpdfllib (par défaut, - <literal>/usr</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-esoob"> - <term> - <parameter>--with-esoob[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Easysoft OOB. DIR est le dossier - d'installation de OOB (par défaut, - <literal>/usr/local/easysoft/oob/client</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-exec-dir"> - <term> - <parameter>--with-exec-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: N'autorise que les exécutables placés dans le dossier - DIR, lorsque le SAFE MODE est activé (par défaut, c'est - <literal>/usr/local/php/bin</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-fdftk"> - <term> - <parameter>--with-fdftk[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support fdftk. DIR est le dossier - d'installation de fdftk (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gnu-ld"> - <term> - <parameter>--with-gnu-ld</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Suppose que le compilateur C utilise GNU ld - (par défaut, <literal>no</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-icap"> - <term> - <parameter>--with-icap[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support ICAP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-imap"> - <term> - <parameter>--with-imap[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support IMAP. DIR est le dossier - d'include d'IMAP (et aussi c-client.a). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-imsp"> - <term> - <parameter>--with-imsp[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support IMSP.(DIR est le dossier d'installation - IMSP, là où il y a les dossiers d'include et libimsp.a). - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-java"> - <term> - <parameter>--with-java[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Java. DIR est le dossier - d'installation du JDK). Cette extension peut uniquement être - compilée comme "dl". - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-kerberos"> - <term> - <parameter>--with-kerberos[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support Kerberos dans IMAP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mcal"> - <term> - <parameter>--with-mcal[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support MCAL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mcrypt"> - <term> - <parameter>--with-mcrypt[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support mcrypt. DIR est le dossier - d'installation de mcrypt. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mhash"> - <term> - <parameter>--with-mhash[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support mhash. DIR est le dossier - d'installation de mhash. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mm"> - <term> - <parameter>--with-mm[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support mm pour le stockage de session. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mod_charset"> - <term> - <parameter>--with-mod_charset</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le transfert des tables depuis le module Apache - mod_charset (Rus Apache). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pdflib"> - <term> - <parameter>--with-pdflib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support pdflib (testé avec 0.6 et 2.0). DIR est - le dossier d'installation de pdflib (par défaut, c'est - <filename>/usr/local</filename>). - </para> - <para> - PHP 4: Inclut le support pdflib 3.x/4.x. DIR est le dossier - d'installation de pdflib. Par défaut, c'est <filename>/usr/local</filename>. - </para> - <para> - PHP 4 et PDFlib 3.x/4.x requiert les librairies JPEG et TIFF. - Lors de la compilation du support PDFlib utilise les options - <link linkend="install.configure.with-jpeg-dir">--with-jpeg-dir</link> et - <link linkend="install.configure.with-tiff-dir">--with-tiff-dir</link>. - Vous pouvez aussi utiliser - <link linkend="install.configure.with-png-dir">--with-png-dir</link> et - <link linkend="install.configure.with-zlib-dir">--with-zlib-dir</link>, - pour compiler le support PNG et Zlib avec PDFlib. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-shared-pdflib"> - <term> - <parameter>--enable-shared-pdflib</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut pdflib comme shared librairy. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-readline"> - <term> - <parameter>--with-readline[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support readline. DIR est le dossier - d'installation de readline. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-regex"> - <term> - <parameter>--with-regex=TYPE</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Type de librairie d'expressions régulières : - système, apache, php - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-servlet"> - <term> - <parameter>--with-servlet[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support servlet. DIR est le dossier - d'installation de JSDK. Ce SAPI demande que l'extension - Java soit compilée comme shared dl. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ming"> - <term> - <parameter>--with-ming</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Flash 4 avec Ming. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-swf"> - <term> - <parameter>--with-swf[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support SWF. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-system-regex"> - <term> - <parameter>--with-system-regex</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive la librairie d'expressions régulières - livrée avec PHP. - </para> - <para> - PHP 4: (Obsolète) Utilise la librairie d'expressions - régulières système. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-tsrm-pth"> - <term> - <parameter>--with-tsrm-pth[=pth-config]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Utilise GNU Pth. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-tsrm-pthreads"> - <term> - <parameter>--with-tsrm-pthreads</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Utilise les threads POSIX (par défaut). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-x"> - <term> - <parameter>--with-x</parameter> - </term> - <listitem> - <para> - PHP 3: Utilise X Window System - </para> - <para> - PHP 4: Option non disponible en PHP 4 - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-bzip2-dir"> - <term> - <parameter>--with-bz2[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 4: Ajoute le support bzip2. DIR - est le dossier d'installation de bzip2. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zlib-dir"> - <term> - <parameter>--with-zlib-dir[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Dossier zlib pour pdflib 2.0 ou active le support zlib. - </para> - <para> - PHP 4: Dossier zlib pour pdflib 3.x/4.x ou active le support zlib. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zlib"> - <term> - <parameter>--with-zlib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support zlib. (requiert zlib >= 1.0.9). DIR - est le dossier d'installation de zlib (par défaut, <literal>/usr</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zziplib"> - <term> - <parameter>--with-zziplib[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 4: Inclut le support ZZIPlib (requiert ZZIPlib >= 0.10.6). DIR - est le dossier d'installation de ZZIPliby (par défaut, - <literal>/usr/local</literal>). - </para> - <para> - La dernière version de ZZIPlib est disponible à - <ulink url="&url.zziplib;">&url.zziplib;</ulink>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.without-pcre-regex"> - <term> - <parameter>--without-pcre-regex</parameter> - </term> - <listitem> - <para> - PHP 3: Inactive le support des expressions régulières Perl. - </para> - <para> - PHP 4: Inactive le support des expressions régulières Perl. Utilisez - --with-pcre-regex=DIR pour spécifier le dossier d'installation de - PCRE, si vous n'utilisez pas la librairie livrée en standard. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.without-posix"> - <term> - <parameter>--without-posix</parameter> - </term> - <listitem> - <para> - PHP 3: N'Inclut pas lrs fonctions POSIX. - </para> - <para> - PHP 4: Option non disponible en PHP 4; utilisez plutôt - <link linkend="install.configure.disable-posix">--disable-posix</link>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.networking"> - <title>Réseau</title> - <variablelist> - <varlistentry id="install.configure.with-curl"> - <term> - <parameter>--with-curl[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support CURL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-ftp"> - <term> - <parameter>--enable-ftp</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-ftp">--with-ftp</link> - </para> - <para> - PHP 4: Active le support FTP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-ftp"> - <term> - <parameter>--with-ftp</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support FTP. - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-ftp">--enable-ftp</link> - instead - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-url-fopen-wrapper"> - <term> - <parameter>--disable-url-fopen-wrapper</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inactive le support des URL avec <function>fopen</function>. - </para> - <warning> - <para> - Cette option n'est disponible que jusqu'à la version 4.0.3. Les - versions plus récentes fournissent un paramètre dans le - fichier <filename>php.ini</filename> appelé <parameter>allow_url_fopen</parameter>, - afin de vous éviter de faire ce choix au moment de la - compilation. - </para> - </warning> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mod-dav"> - <term> - <parameter>--with-mod-dav=DIR</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support DAV, grâce au module Apache mod_dav. - DIR est le dossier d'installation de mod_dav (valable uniquement pour les serveurs - Apache). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-openssl"> - <term> - <parameter>--with-openssl[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support OpenSSL avec SNMP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-snmp"> - <term> - <parameter>--with-snmp[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support SNMP. DIR est le dossier - d'installation de SNMP (par défaut, il scanne un nombre de - dossiers habituels de l'installation SNMP). Utilisez la valeur de - "shared" pour compiler sous forme de "dl", ou "shared,DIR" - pour compiler sous forme de "dl" tout en spécifiant un dossier. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-ucd-snmp-hack"> - <term> - <parameter>--enable-ucd-snmp-hack</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active le hack UCD SNMP - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sockets"> - <term> - <parameter>--enable-sockets</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support des sockets. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-yaz"> - <term> - <parameter>--with-yaz[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support YAZ.(ANSI/NISO Z39.50). DIR est le dossier - d'installation de YAZ (dossier bin). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-yp"> - <term> - <parameter>--enable-yp</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible; utilisez plutôt <link - linkend="install.configure.with-yp">--with-yp</link> - </para> - <para> - PHP 4: Active le support YellowPages (YP). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-yp"> - <term> - <parameter>--with-yp</parameter> - </term> - <listitem> - <para> - PHP 3: Active le support YellowPages (YP). - </para> - <para> - PHP 4: Option non disponible; utilisez plutôt <link - linkend="install.configure.enable-yp">--enable-yp</link> - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-mnogosearch"> - <term> - <parameter>--with-mnogosearch</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support mnoGoSearch. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.php"> - <title>Comportement PHP</title> - <variablelist> - <varlistentry id="install.configure.enable-magic-quotes"> - <term> - <parameter>--enable-magic-quotes</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Active les magic quotes par défaut. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-short-tags"> - <term> - <parameter>--disable-short-tags</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Désactive la forme courte des balises PHP (<? ?>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-track-vars"> - <term> - <parameter>--enable-track-vars</parameter> - </term> - <listitem> - <para> - PHP 3: Active le suivi des variables GET/POST/Cookie par défaut. - </para> - <para> - PHP 4: Option non disponible en PHP 4; à partir de - PHP 4.0.2, cette option est toujours activée. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.servers"> - <title>Serveur</title> - <variablelist> - <varlistentry id="install.configure.with-aolserver-src"> - <term> - <parameter>--with-aolserver-src=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Indique le chemin jusqu'à la distribution source - de AOLserver - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-aolserver"> - <term> - <parameter>--with-aolserver=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Indique le chemin jusqu'à la distribution installée - de AOLserver. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-apache"> - <term> - <parameter>--with-apache[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile PHP en module Apache. DIR est le dossier - d'installation supérieur d'Apache (par défaut, - <literal>/usr/local/etc/httpd</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-apxs"> - <term> - <parameter>--with-apxs[=FILE]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile PHP comme module partagé d'Apache module. FILE - est le chemin optionnel jusqu'à Apache apxs tool; par défaut, - c'est apxs). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-versioning"> - <term> - <parameter>--enable-versioning</parameter> - </term> - <listitem> - <para> - PHP 3: Tire profit du système de versionnage et de scoping fourni - par Solaris 2.x et Linux - </para> - <para> - PHP 4: Exporte uniquement les symboles nécessaires. Voyez l'installation - pour plus de détails. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-caudium"> - <term> - <parameter>--with-caudium[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP sous forme de module Pike pour être utilisé avec le - serveur web Caudium. DIR est le dossier - d'installation de Caudium (par défaut, - <literal>$prefix/caudium/server</literal>. Le préfixe est paramétré - par l'option --prefix (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-fhttpd"> - <term> - <parameter>--with-fhttpd[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Compile PHP comme module fhttpd. DIR est le dossier - d'installation de fhttpd (par défaut, - <literal>/usr/local/src/fhttpd</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-nsapi"> - <term> - <parameter>--with-nsapi=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Indique le chemin jusqu'au serveur Netscape - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-phttpd"> - <term> - <parameter>--with-phttpd=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pi3web"> - <term> - <parameter>--with-pi3web=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP comme module pour Pi3Web. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-roxen"> - <term> - <parameter>--with-roxen=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP comme module pour Pi3Web Pike. DIR est le dossier - d'installation de Roxen (par défaut, - <literal>/usr/local/roxen/server</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-roxen-zts"> - <term> - <parameter>--enable-roxen-zts</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile le module Roxen en utilisant - Zend Thread Safety. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-thttpd"> - <term> - <parameter>--with-thttpd=SRCDIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-zeus"> - <term> - <parameter>--with-zeus=DIR</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Compile PHP comme module ISAPI pour Zeus. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.text"> - <title>Texte et langue</title> - <variablelist> - <varlistentry id="install.configure.with-aspell"> - <term> - <parameter>--with-aspell[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support ASPELL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-gettext"> - <term> - <parameter>--with-gettext[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4: Inclut le support GNU gettext. DIR est le dossier - d'installation de gettext (par défaut, <literal>/usr/local</literal>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-iconv"> - <term> - <parameter>--with-iconv[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support iconv. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-pspell"> - <term> - <parameter>--with-pspell[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Inclut le support PSPELL. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-recode"> - <term> - <parameter>--with-recode[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Inclut le support GNU recode. - </para> - <para> - PHP 4: Inclut le support recode. DIR est le dossier - d'installation de recode. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-shmop"> - <term> - <parameter>--enable-shmop</parameter> - </term> - <listitem> - <para> - PHP 3, PHP 4 : Inclut le support shmop. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="install.configure.xml"> - <title>XML</title> - <variablelist> - <varlistentry id="install.configure.with-dom"> - <term> - <parameter>--with-dom[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support DOM. (requiert libxml >= 2.0). - DIR est le dossier d'installation de libxml (par défaut, - <filename>/usr</filename>). - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-sablot-errors-descriptive"> - <term> - <parameter>--enable-sablot-errors-descriptive</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active les erreurs descriptives. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-sablot"> - <term> - <parameter>--with-sablot[=DIR]</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support Sablotron. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.enable-wddx"> - <term> - <parameter>--enable-wddx</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3 - </para> - <para> - PHP 4: Active le support WDDX. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.disable-xml"> - <term> - <parameter>--disable-xml</parameter> - </term> - <listitem> - <para> - PHP 3: Option non disponible en PHP 3; Les fonctions XML - ne sont pas construites par défaut. Utilisez plutôt - <link linkend="install.configure.with-xml">--with-xml</link> - pour les activer. - </para> - <para> - PHP 4: Inactive le support XML, qui utilise la librairie expat, - livrée avec PHP. - </para> - </listitem> - </varlistentry> - <varlistentry id="install.configure.with-xml"> - <term> - <parameter>--with-xml</parameter> - </term> - <listitem> - <para> - PHP 3: Active le support XML. - </para> - <para> - PHP 4: Option non disponible en PHP 4; Le support XML est - activé par défaut. Utilisez plutôt - <link linkend="install.configure.disable-xml">--disable-xml</link> pour - l'inactiver. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - </sect1> - <sect1 id="install.windows"> - <title>Installation sous Windows 9x/ME/NT/2000</title> - <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;">téléchargement</ulink>, installe la version - CGI de PHP, et configure les serveurs web IIS, PWS, et Xitami. - </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 <filename>php.ini</filename> 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> - </sect2> - <sect2 id="install.windows.manual"> - <title>Instructions Générales d'installation</title> - <simpara> - Ce guide vous permet d'installer et de configurer manuellement - PHP sur vos stations Windows 9x/Me/NT/2000. 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> - </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. Notez cependant que les - modules SAPI <emphasis>ne sont pas</emphasis> considéré comme ayant - atteint une qualité de production. La raison à cela est que - les modules SAPI utilisent le système de thread sécurisé de - PHP, ce qui est nouveau en PHP 4, et qui n'a pas été testé et - torturé suffisamment pour être considérés comme stable. - Il y a encore - quelques bugs qui trainent. D'un autre côté, certains d'entre - vous ont rapporté des résultats significativement meilleurs avec - les modules SAPI, même si nous ne connaissons actuellement personne - qui le fasse fonctionner en production. En clair, faites votre choix : - soit vous avez absolument besoin de stabilité, et il vaut mieux - laisser les performances SAPI de côté; soit vous avez besoin de - performances, et alors c'est l'occasion de tester en production - et de nous rapporter vos résultats. - </para> - <para> - Si vous choisissez l'un des modules SAPI et utilisez Windows 95, - pensez à télécharger la mise à jour DCOM à - <ulink url="http://download.microsoft.com/msdownload/dcom/95/x86/en/dcom95.exe">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> - 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 95/98</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). - </member> - </simplelist> - </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 '<filename>php.ini</filename>'. Votre dossier - '%WINDOWS%' ou '%SYSTEMROOT%' est généralement : - <simplelist> - <member>c:\windows pour Windows 95/98</member> - <member>c:\winnt ou c:\winnt40 pour les serveurs NT/2000</member> - </simplelist> - </para> - </listitem> - <listitem> - <para> - Editez votre fichier <filename>php.ini</filename> : - <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 - </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. Vous pouvez décommenter les lignes - 'extension=php_*.dll' pour charger ces modules. - Certains modules requièrent que des librairies - supplémentaires soient installées sur votre - système. La <ulink url="&url.php.faq;">FAQ</ulink> - PHP a plus d'informations sur ces librairies. Vous pouvez - aussi charger dynamiquement ces librairies avec - <command>dl("php_*.dll");</command>. Voyez la - section sur les - <link linkend="install.windows.extensions">extensions Windows</link>. - </simpara> - </listitem> - <listitem> - <simpara> - Sous PWS et IIS, vous pouvez modifier le fichier - <filename>browscap.ini</filename> pour qu'il pointe sur : - <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous - Windows 95/98 et <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> - sous NT. - </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.prepare"> - <title>Préparation</title> - <para> - Avant de commencer, il faut télécharger un maximum de fichiers! - </para> - <itemizedlist> - <listitem> - <simpara> - Pour commencer, téléchargez le Cygwin depuis le miroir <ulink - url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink> - le plus proche. Cela vous donnera les utilitaires GNU les plus - populaires, utilisés durant le processus de compilation. - </simpara> - </listitem> - <listitem> - <simpara> - Téléchargez le reste des utilitaires de compilation dont vous aurez besoin - depuis le site PHP à <ulink url="http://www.php.net/extra/win32build.zip"> - http://www.php.net/extra/win32build.zip</ulink>. - </simpara> - </listitem> - <listitem> - <simpara> - Téléchargez le code source du DNS utilisé par PHP - à <ulink url="http://www.php.net/extra/bindlib_w32.zip"> - http://www.php.net/extra/bindlib_w32.zip</ulink>. Il - remplacera le fichier <filename>resolv.lib</filename> - inclut dans <filename>win32build.zip</filename>. - </simpara> - </listitem> - <listitem> - <simpara> - Si vous n'avez pas d'utilitaire de dézippage, vous devez en - télécharger un. Une version libre est disponible à <ulink - url="http://www.cdrom.com/pub/infozip/UnZip.html">InfoZip</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="http://www.php.net/anoncvs.php">anonyme</ulink>. Si vous - téléchargez une version - <ulink url="http://snaps.php.net/">intermédiaire</ulink> - ou la <ulink url="http://www.php.net/downloads.php">source</ulink>, vous - devez non seulement extraire les fichiers, mais aussi convertir les - nouvelles lignes en leur équivalent windows (crlf) dans les fichiers - <filename>*.dsp</filename> et <filename>*.dsw</filename> avant que - Microsoft Visual C++ ne soit capable de les comprendre. - </simpara> - <note> - <simpara> - Placez les dossiers <filename>Zend</filename> et - <filename>TSRM</filename> dans le dossier - <filename>php4</filename> pour que les projets puissent les - trouver durant la compilation. - </simpara> - </note> - </sect3> - <sect3 id="install.windows.build.install"> - <title>Mettre tout ensemble</title> - <itemizedlist> - <listitem> - <simpara> - Suivez les instructions pour installer l'utilitaire d'unzip de - votre choix. - </simpara> - </listitem> - <listitem> - <simpara> - Exécutez <filename>setup.exe</filename> et suivez les instructions - d'installation. Si vous décidez d'installer dans un autre - dossier que <filename>c:\cygnus</filename>, indiquez le au processus de - compilation en modifiant la variable d'environnement - Cygwin. Sous Windows 95/98, modifier une variable - d'environnement se fait en ajoutant une ligne dans le - fichier <filename>autoexec.bat</filename>. Sous Windows NT, allez - dans le menu "Démarrer => Paramètres => Panneau de contrôle => Système " - ("My Computer => Control Panel => System ") et - sélectionnez l'onglet "environnement" ("environment"). - </simpara> - <warning> - <simpara> - Créez un dossier temporaire pour Cygwin, sinon de nombreuses - commandes (comme bison) échoueront. Sous Windows 95/98, - <userinput>mkdir C:\TMP</userinput>. Sous Windows NT, - <userinput>mkdir %SystemDrive%\tmp</userinput>. - </simpara> - </warning> - </listitem> - <listitem> - <simpara> - Créez un dossier et dézippez <filename>win32build.zip</filename> dedans. - </simpara> - </listitem> - <listitem> - <simpara> - Lancez Microsoft Visual C++, et allez dans le menu - "select Tools => Options". Dans le dialogue, sélectionnez - l'onglet "directories". Assurez-vous que <filename>cygwin\bin</filename>, - <filename>win32build\include</filename>, et - <filename>win32build\lib</filename> sont bien - dans les menus déroulants "Executables", "Include", et "Library". - (Pour ajouter une entrée, sélectionnez une ligne - blanche, et tapez). Une entrée typique ressemble à ceci : - </simpara> - <itemizedlist> - <listitem> - <simpara> - <filename>c:\cygnus\bin</filename> - </simpara> - </listitem> - <listitem> - <simpara> - <filename>c:\php-win32build\include</filename> - </simpara> - </listitem> - <listitem> - <simpara> - <filename>c:\php-win32build\lib</filename> - </simpara> - </listitem> - </itemizedlist> - <simpara> - Pressez "OK", et sortez de Visual C++. - </simpara> - </listitem> - <listitem> - <simpara> - Créez un autre dossier et dézippez <filename>bindlib_w32.zip</filename> - dedans. Décidez si vous avez besoin des symboles de débuggage - (bindlib - Win32 Debug) ou non (bindlib - Win32 Release). - Compilez la configuration adéquate : - </simpara> - <itemizedlist> - <listitem> - <simpara> - Pour les utilisateurs de GUI, 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> - <listitem> - <simpara> - 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. - </simpara> - </listitem> - </itemizedlist> - </listitem> - </itemizedlist> - </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 une librairie <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> - Répétez les instructions ci-dessus avec <filename>php4isapi.dsp</filename> - (qui est dans <filename>sapi\isapi</filename>) pour compiler le - code nécessaire pour intégrer PHP avec Microsoft IIS. - </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 <filename>php.ini</filename>. - 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.4pl1, les extensions BCMath, BCMath,Calendar, COM, - FTP, MySQL, ODBC, PCRE, Sessions, WDDX et XML sont activées - <emphasis>par défaut</emphasis>. Vous n'avez rien à - faire pour qu'elles soient inclues. Lisez le fichier - <filename>README.txt</filename> ou <filename>install.txt</filename> - dans votre distribution pour connaître la liste des modules par - défaut. - </para> - </note> - <para> - <table> - <title>Extensions PHP</title> - <tgroup cols="2"> - <tbody> - <row> - <entry>php_bz2.dll</entry> - <entry>Fonctions de compression Bzip2</entry> - </row> - <row> - <entry>php_calendar.dll</entry> - <entry>Fonctions de conversions calendaires (Depuis PHP 4.03, elles sont - activées par défaut)</entry> - </row> - <row> - <entry>php_cpdf.dll</entry> - <entry>Fonctions ClibPDF</entry> - </row> <row> - <entry>php_crypt.dll</entry> - <entry>Fonctions de cryptage</entry> - </row> - <row> - <entry>php_ctype.dll</entry> - <entry>Fonctions ctype</entry> - </row> - <row> - <entry>php_curl.dll</entry> - <entry>Fonctions CURL</entry> - </row> - <row> - <entry>php_cybercash.dll</entry> - <entry>Fonctions de paiement Cybercash</entry> - </row> - <row> - <entry>php_db.dll</entry> - <entry>Fonctions DBM</entry> - </row> - <row> - <entry>php_dba.dll</entry> - <entry>Fonctions dbm-style</entry> - </row> - <row> - <entry>php_dbase.dll</entry> - <entry>Fonctions DBase</entry> - </row> - <row> - <entry>php3_dbm.dll</entry> - <entry>Librairie d'émulation GDBM via Berkely DB2</entry> - </row> - <row> - <entry>php_domxml.dll</entry> - <entry>Fonctions DOM XML</entry> - </row> - <row> - <entry>php_dotnet.dll</entry> - <entry>Fonctions .NET</entry> - </row> - <row> - <entry>php_exif.dll</entry> - <entry>Entêtes EXIF des images JPEG</entry> - </row> - <row> - <entry>php_fbsql.dll</entry> - <entry>Fonctions FrontBase</entry> - </row> - <row> - <entry>php_fdf.dll</entry> - <entry>Fonction FDF (Forms Data Format)</entry> - </row> - <row> - <entry>php_filepro.dll</entry> - <entry>Lecture des bases filepro</entry> - </row> - <row> - <entry>php_ftp.dll</entry> - <entry>Fonctions FTP(Depuis PHP 4.0.3, elles sont activées par défaut)</entry> - </row> - <row> - <entry>php_gd.dll</entry> - <entry>Bibliothèque GD (pour les manipulations d'images)</entry> - </row> - <row> - <entry>php_gettext.dll</entry> - <entry>Fonctions GNU Gettext</entry> - </row> - <row> - <entry>php_hyperwave.dll</entry> - <entry>Fonctions HyperWave</entry> - </row> - <row> - <entry>php_iconv.dll</entry> - <entry>Fonctions de conversions ICONV</entry> - </row> - <row> - <entry>php_ifx.dll</entry> - <entry>Fonctions Informix</entry> - </row> - <row> - <entry>php_iisfunc.dll</entry> - <entry>Fonctions IIS</entry> - </row> - <row> - <entry>php_imap.dll</entry> - <entry>Fonctions IMAP 4(en PHP 3: php3_imap4r1.dll)</entry> - </row> - <row> - <entry>php_ingres.dll</entry> - <entry>Fonctions Ingres II</entry> - </row> - <row> - <entry>php_interbase.dll</entry> - <entry>Fonctoins InterBase</entry> - </row> - <row> - <entry>php_java.dll</entry> - <entry>Extension Java</entry> - </row> - <row> - <entry>php_ldap.dll</entry> - <entry>Fonctions LDAP</entry> - </row> - <row> - <entry>php_mhash.dll</entry> - <entry>Fonctions Mhash</entry> - </row> - <row> - <entry>php_ming.dll</entry> - <entry>Fonctions Ming pour Flash</entry> - </row> - <row> - <entry>php_msql.dll</entry> - <entry>Fonctions mSQL</entry> - </row> - <row> - <entry>php3_msql1.dll</entry> - <entry>Fonctions mSQL 1</entry> - </row> - <row> - <entry>php3_msql2.dll</entry> - <entry>Fonctions mSQL 2</entry> - </row> - <row> - <entry>php_mssql.dll</entry> - <entry>Fonctions MSSQL (anciennement php_mssql70.dll, - requiert MSSQL DB-Libraries)</entry> - </row> - <row> - <entry>php3_mysql.dll</entry> - <entry>Fonctions MySQL (Activées par défaut en PHP 4)</entry> - </row> - <row> - <entry>php_nsmail.dll</entry> - <entry>Fonctions Netscape mail</entry> - </row> - <row> - <entry>php3_oci73.dll</entry> - <entry>Fonctions Oracle</entry> - </row> - <row> - <entry>php_oci8.dll</entry> - <entry>Fonctions Oracle 8</entry> - </row> - <row> - <entry>php_openssl.dll</entry> - <entry>Fonctions OpenSSL</entry> - </row> - <row> - <entry>php_oracle.dll</entry> - <entry>Fonctions Oracle</entry> - </row> - <row> - <entry>php_pdf.dll</entry> - <entry>Fonctions PDF</entry> - </row> - <row> - <entry>php_pgsql.dll</entry> - <entry>Fonctions PostgreSQL</entry> - </row> - <row> - <entry>php_printer.dll</entry> - <entry>Fonctions d'impression</entry> - </row> - <row> - <entry>php_sablot.dll</entry> - <entry>Focntions XSLT</entry> - </row> - <row> - <entry>php_snmp.dll</entry> - <entry>Fonctions <acronym>SNMP</acronym> get et walk (NT uniquement!)</entry> - </row> - <row> - <entry>php_sybase_ct.dll</entry> - <entry>Fonctions Sybase</entry> - </row> - <row> - <entry>php_yaz.dll</entry> - <entry>Fonctions YAZ</entry> - </row> - <row> - <entry>php_zlib.dll</entry> - <entry>Fonctions ZLib</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </sect2> - </sect1> - <sect1 id="install.apache"> - <title>Installation du 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> - <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 (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. - <informalexample> - <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> - </informalexample> - 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 : - <informalexample> - <programlisting> -./configure --with-apxs --with-pgsql - </programlisting> - </informalexample> - </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> - <informalexample> - <programlisting> -./configure --with-apxs --with-pgsql=shared - </programlisting> - </informalexample> - </para> - <para> - Cette commande va créer une autre librairie partagée - <filename>libphp4.so</filename>, mais va aussi créer une - librairie partagée <filename>pgsql.so</filename> qui sera chargée - dans PHP avec les options de configurations du fichier - <filename>php.ini</filename> ou par chargement dynamique - avec <function>dl</function>. - </para> - <para> - <informalexample> - <programlisting> -./configure --with-apache=/path/to/apache_source --with-pgsql - </programlisting> - </informalexample> - </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 inclus Apache et PHP. - </para> - <para> - <informalexample> - <programlisting> -./configure --with-apache=/path/to/apache_source --with-pgsql=shared - </programlisting> - </informalexample> - </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 - <filename>php.ini</filename> 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 - <ulink url="&url.apachedso;">webpage on DSO support</ulink>. - </para> - </sect2> - <sect2 id="install.apache.windows"> - <title>Détails sur l'installation de 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> - <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> - Pour utiliser les fonctionnalités de mise en évidence du code - source, créez simplement un script PHP et ajoutez le code suivant : - <literal><?php show_source("original_php_script.php"); ?></literal>. - Remplacez le fichier <literal>original_php_script.php</literal> par le fichier - que vous voulez afficher : c'est la seule manière de le faire. - </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. - </simpara> - </note> - </sect2> - </sect1> - <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 vous voulez - que votre serveur web supporte le PHP, compiler le PHP comme un CGI - permet d'obtenir de meilleures 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 - <link linkend="ini.safe-mode">safe mode</link> 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 <link linkend="ini.safe-mode">safe mode</link> 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> - </sect1> - <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 - <option role="configure"><link linkend="install.configure.with-fhttpd">--with-fhttpd</link>=<replaceable>DIR</replaceable></option> - 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> - <sect1 id="install.caudium"> - <title>Installation sur serveur Caudium</title> - <para> - PHP 4 peut être compilé comme module Pike pour le serveur web Caudium. - 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 à <filename>PHP4.so</filename>. De même, assurez-vous - que <filename>caudium/server/lib/[pike-version]/PHP4.so</filename> - 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 <link linkend="install.configure.with-mysql">--with-mysql</link>. - </para> - </note> - </sect1> - <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. - ex: <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 %s %s</literal>. Les '%s %s' sont TRES - importants, PHP ne fonctionnera pas sans. - </simpara> - </listitem> - <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 %s %s</literal> (en supposant - que vous avez dézippé PHP dans <filename>c:\php\</filename>). - Vous DEVEZ ajouter <literal>%s %s</literal> à la fin : PHP ne - fonctionnera pas correctement sans. - </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". - 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épandus.) - </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 - </simpara> - </listitem> - <listitem> - <simpara> - Démarrez IIS - </simpara> - </listitem> - </itemizedlist> - </para> - </sect2> - </sect1> - <sect1 id="install.netscape-enterprise"> - <title>Installation sous Netscape et iPlanet Enterprise Serveur</title> - <para> - Pour compiler PHP avec NES ou iPlanet web, ajoutez le dossier - d'installation dans l'option de configuration - <option role="configure"><link linkend="install.configure.with-nsapi">--with-nsapi</link> = <replaceable>DIR</replaceable></option> . - Par défaut, le dossier est - <filename class="directory">/opt/netscape/suitespot/</filename>. - Lisez aussi le fichier <filename>/php-xxx-version/sapi/nsapi/nsapi-readme.txt</filename> - pour plus de détails. - </para> - <para> - <example id="install.netscape-enterprise.solaris"> - <title> - Installation de Netscape Enterprise sous Solaris - </title> - <programlisting> -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 - </programlisting> - </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> - <programlisting> -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> - </programlisting> - </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> - 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> - </sect1> - <sect1 id="install.omnihttpd"> - <title>Installation OmniHTTPd</title> - <para> - Cette section contient des notes et conseils spécifiques à OmniHTTPd. - </para> - <sect2 id="install.omnihttpd.windows"> - <title>OmniHTTPd 2.0b1 et plus récent pour Windows</title> - <simpara> - La méthode la plus simple pour configurer le serveur est : - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - Step 1: Installez Omni server. - </para> - </listitem> - <listitem> - <para> - Step 2: Faites un clic-droit sur l'icone bleue d'OmniHTTPd, sur le - bureau, 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". - </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". - </para> - </listitem> - <listitem> - <para> - Step 6: Cliquez sur <literal>OK</literal>. - </para> - </listitem> - </itemizedlist> - </para> - <simpara> - Réptez les étapes 2 à 6 pour chaque extension que - vous voulez associer à PHP. - </simpara> - <note> - <para> - Certains package OmniHTTPd sont livrés avec le support - PHP déjà intégré. Vous pouvez choisir au moment de la - configuration de faire un paramétrage poussé et de décocher - le support PHP. Nous vous conseillons d'utiliser les - dernières versions de PHP. Certains serveurs OmniHTTPd sont - encore livrés avec des versions beta de PHP : il - est recommandé de ne pas les installer, mais d'installer - votre propre version. Si le serveur est déjà sur votre - machine, vous pouvez utiliser le bouton "Replace" dans les - étapes 4 et 5 pour en choisir un nouveau et à jour. - </para> - </note> - </sect2> - </sect1> - <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 ".php" - 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> - <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 http://127.0.0.1/admin), 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> - </itemizedlist> - </para> - </sect2> - </sect1> - <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.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> - <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 à - <ulink url="&url.php.faq;">&url.php.faq;</ulink>. - </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.bugdosdonts;">Bugs-Dos-And-Donts</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> - <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, - <link linkend="ini.safe-mode">safe mode</link>...), et - n'hésitez pas à envoyer suffisamment de code pour que nous - puissions reproduire l'erreur. - </simpara> - </sect2> - </sect1> -</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 -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.32 $ --><chapter id="installation"> <title>Installation</title> <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. Vous pouvez trouver une liste de ces compagnies à <ulink url="&url.php.hosts;">&url.php.hosts;</ulink>. </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="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> <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 les codes sources) </simpara> </listitem> <listitem> <simpara> bison (pour les codes sources) </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>Référence 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> Instructions d'installation PHP 4 (Version Module Apache) </title> <programlisting>1. gunzip apache_1.3.x.tar.gz2. tar xvf apache_1.3.x.tar3. gunzip php-x.x.x.tar.gz4. tar xvf php-x.x.x.tar5. cd apache_1.3.x6. ./configure --prefix=/www7. cd ../php-x.x.x8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars9. make10. make install11. cd ../apache_1.3.x12. ./configure --activate-module=src/modules/php4/libphp4.a13. make14. make install15. cd ../php-x.x.x16. cp php.ini-dist /usr/local/lib/php.ini17. "Editez votre fichier httpd.conf ou srm.conf et ajoutez : " AddType application/x-httpd-php .php18. "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> <sect1 id="install.linux"> <title>Installation sous Linux</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> <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> <programlisting>From: paul_mckay@clearwater-it.co.uk04-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'undes 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 etles 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 ilsemble oublier qu'il est sur une machine HP-UX. Il y a des méthodes plusrusé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é. Sousapache_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 sousHP-UX, ce qui fait que vous devez le compiler en statique. Suivezsimplement 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 nogrouppar vos valeurs, par exemple : User www Group sysIl n'est pas possible d'éxécuter Apache avec l'utilisateur nobody sousHP-UX. A partir de ce moment là, PHP et Apache doivent fonctionner.J'espère que cela aidera quelqu'un.Paul Mckay. </programlisting> </example> </sect1> <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> <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</ulink>. </para> <sect2 id="install.openbsd.ports"> <title>Utilisation des ports</title> <simpara> Ceci est la méthode recommandée d'installation de PHP sous OpenBSD, car elle prend en compte les dernières modifications et mises à jour de sécurité. Pour utiliser cette méthode, assurez vous que vous avez bien <ulink url="&url.openbsd.ports;">ports tree</ulink> récent. Choisissez alors simplement la version que vous souhaitez installer, et utilisez la commande <command>make install</command>. Ci-dessous, voici un exemple. </simpara> <example id="install.openbsd.ports.example"> <title>Exemple d'installation de PHP sous OpenBSD avec Ports</title> <programlisting>$ cd /usr/ports/www/php4$ make show VARNAME=FLAVORS (choisissez les versions que vous souhaitez sur votre liste).$ env FLAVOR="imap gettext ldap mysql gd" make install$ /usr/local/sbin/php4-enable </programlisting> </example> </sect2> <sect2 id="install.openbsd.packages"> <title>Utilisation des Packages</title> <simpara> Il existe des packages pré-compilés disponibles en téléchargement à <ulink url="&url.openbsd;">OpenBSD</ulink>. Ils s'intègrent automatiquement avec la version d'Apache installée sur votre OS. Cependant, comme il y a un grand nombre d'options (appelées <emphasis>flavors</emphasis>) disponibles, vous trouverez peut-être plus facile de le compiler à partir de l'arbre de ports. Lisez le manuel <ulink url="&url.openbsd.packages;">packages(7)</ulink> pour plus de détails sur les packages disponibles (en anglais). </simpara> </sect2> </sect1> <sect1 id="install.macosx"> <title>Installation sous Mac OS X</title> <para> Cette section contient les notes et conseils d'installation de PHP sur les distributions Mac OS X. </para> <sect2 id="install.macosx.packages"> <title>Utilisation des packages</title> <simpara> Il existe quelques versions pré-packagée et pré-compilées de PHP pour Mac OS X. Ils permettent de réaliser rapidement des installations standard, mais si vous avez des configurations personnelles, (comme un serveur sécurisé SSL ou un pilote de base de données exotique), vous devrez compiler PHP et/ou votre serveur web vous-même. 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> <sect2 id="install.macosx.compile"> <title>Compilation pour serveur OS X</title> <simpara> Il existe deux versions légèrement différentes de Mac OS X, client et serveur. Cette installation est faite pour le OS X Serveur. </simpara> <example id="install.macosx.compile.example"> <title>Installation sous Mac OS X serveur</title> <programlisting>1. Téléchargez la dernière version de Apache et PHP2. Décompressez puis désarchivez la, puis configurez Apache comme ceci : ./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=apache4. Vous aurez peut être besoin d'ajouter ces lignes ci, pour optimiser lacompilation : setenv OPTIM=-O25. Puis, allez dans le dossier source de PHP 4, et configurez le : ./configure --prefix=/usr \ --sysconfdir=/etc \ --localstatedir=/var \ --mandir=/usr/share/man \ --with-xml \ --with-apache=/src/apache_1.3.12 Si vous avez d'autres composants (MySQL, GD, etc.), n'oubliez pas de les ajouter à ce moment la. Pour l'option --with-apache, ajoutez le chemin jusqu'au dossier source d'Apache, par exemple "/src/apache_1.3.12".6. Exécutez un "make"7. Exécutez un "make install" Cette commande ajoutera un dossier dans le dossier Apache : src/modules/php4.8. Maintenant, reconfigurez Apache pour compiler 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 Vous pouvez rencontrer un message qui vous dira que libmodphp4.a est obsolète. Si c'est le cas, allez dans le dossier src/modules/php4 de votre dossier Apache et exécutez la commande suivante : ranlib libmodphp4.a Puis, revenez à la racine de la distribution Apache, et recommencez la configuration. Cela aura mis à jour la table de liens.9. Exécutez un "make"10. Exécutez un "make install"11. Copiez et renommez le fichier php.ini-dist de votre distribution PHP 4 dans votre dossier "bin": cp php.ini-dist /usr/local/bin/php.ini ou (si vous n'avez pas de dossier local) cp php.ini-dist /usr/bin/php.ini </programlisting> </example> <simpara> D'autres exemples pour <ulink url="&url.stepwise.macosx-client;">Mac OS X client</ulink> et <ulink url="&url.stepwise.macosx-client;">Mac OS X server</ulink> sont disponibles à <ulink url="&url.stepwise;">Stepwise</ulink>. </simpara> </sect2> <sect2 id="install.macosx.client"> <title>Compilation pour MacOS X client</title> <simpara> Ces conseils sont gracieusement fourni par <ulink url="&url.macosx;">Marc Liyanage</ulink>. </simpara> <simpara> Le module PHP pour Apache est inclus dans Mac OS X. Cette version inclus le support des bases de données MySQL et PostgreSQL. </simpara> <simpara> NOTE: Soyez prudent avec cette manipulation, vous risquez de mettre votre serveur Apache à terre! </simpara> <para> Insctructions : <itemizedlist> <listitem> <simpara> 1. Ouvrez un terminal </simpara> </listitem> <listitem> <simpara> 2. Tapez "wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz", attendez la fin du 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 ouvrira le fichier de configuration. Recherchez ces deux lignes, vers la fin du fichier (Utilisez la commande Find) <programlisting> * #AddType application/x-httpd-php .php * #AddType application/x-httpd-php-source .phps </programlisting> Supprimez les deux marques de commentaires (<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 fonctionner. Vous pouvez le tester en placant un script dans le dossier "Sites". Par exemple, le fichier "test.php", qui contient la simple ligne : "<literal><?php phpinfo() ?></literal>". </para> <para> Ouvrez l'URL <literal>127.0.0.1/~your_username/test.php</literal> dans votre navigateur. Vous obtiendrez le tableau de bord de PHP. </para> </sect2> </sect1> <sect1 id="install.configure"> <title>Liste complète des options de configuration</title> <para> Cette section rassemble la liste complète des options de configuration supportées par PHP 3 et PHP 4, à utiliser avec le fichier <filename>configure</filename>, lors de la configuration sous Unix. Certaines options sont disponibles sous PHP 3, d'autres sous PHP 4 et certains sous PHP 3 et PHP 4, comme inidiqué. Il y a de nombreuses options dont le nom a changé entre PHP 3 et PHP 4. Ces options ont des liens entre elles : si vous vous souvenez d'un nom d'option en PHP 3, regardez si le nom a changé. </para> <itemizedlist> <listitem> <para> <link linkend="install.configure.databases">Base de données</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.ecommerce">E-commerce</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.graphics">Images</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.misc">Divers</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.networking">Réseau</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.php">Comportement PHP</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.servers">Serveur</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.text">Texte et langue</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.xml">XML</link> </para> </listitem> </itemizedlist> <sect2 id="install.configure.databases"> <title>Base de données</title> <variablelist> <varlistentry id="install.configure.with-adabas"> <term> <parameter>--with-adabas[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Adabas D. DIR est le dossier d'installation de Adabas (par défaut, <literal>/usr/local</literal>). </para> <para> <ulink url="&url.adabas;">Adabas home page</ulink> </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dba"> <term> <parameter>--enable-dba=shared</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile DBA comme module partagé </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dbx"> <term> <parameter>--enable-dbx</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support DBX. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dbase"> <term> <parameter>--enable-dbase</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-dbase">--with-dbase</link> instead. </para> <para> PHP 4: Active la librairie dbase livrée avec PHP. Aucune librairie supplémentaire n'est nécessaire. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-dbase"> <term> <parameter>--with-dbase</parameter> </term> <listitem> <para> PHP 3: Active la librairie dbase livrée avec PHP. Aucune librairie supplémentaire n'est nécessaire. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-dbase">--enable-dbase</link> instead. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-db2"> <term> <parameter>--with-db2[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support Berkeley DB2. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-db3"> <term> <parameter>--with-db3[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Berkeley DB3. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-dbm"> <term> <parameter>--with-dbm[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support DBM. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-dbmaker"> <term> <parameter>--with-dbmaker[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3. </para> <para> PHP 4: Inclut le support DBMaker. DIR est le dossier d'installation DBMaker (par défaut, c'est le dossier de la dernière installation DBMaker, comme <literal>/home/dbmaker/3.6</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-empress"> <term> <parameter>--with-empress[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Empress. DIR est le dossier d'installation Empress (par défaut, <literal>$EMPRESSPATH</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-filepro"> <term> <parameter>--enable-filepro</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-filepro">--with-filepro</link> instead. </para> <para> PHP 4: Active la librairie filePro (lecture seule) livrée avec PHP. Aucune librairie supplémentaire n'est nécessaire. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fbsql"> <term> <parameter>--with-fbsql[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible. </para> <para> PHP 4: Inclut le support de FrontBase SQL. DIR est le chemin jusqu'à l'installation de FrontBase base. Par défaut, c'est le dossier standard d'installation Frontbase. L'installation dépend de votre OS : Solaris: <literal>/opt/FrontBase</literal>, WinNT: <literal>\usr\FrontBase</literal>, Linux: <literal>/usr/frontbase</literal>, Mac OSX: <literal>/Library/FrontBase</literal>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-filepro"> <term> <parameter>--with-filepro</parameter> </term> <listitem> <para> PHP 3: Inclut le support IBM DB2. Aucune librairie supplémentaire n'est nécessaire. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-filepro">--enable-filepro</link>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gdbm"> <term> <parameter>--with-gdbm[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support GDBM. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-hyperwave"> <term> <parameter>--with-hyperwave</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support Hyperwave. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ibm-db2"> <term> <parameter>--with-ibm-db2[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support IBM DB2. DIR est le dossier d'installation de DB2 (par défaut, <filename>/home/db2inst1/sqllib</filename>). </para> <para> <ulink url="&url.ibmdb2;">IBM DB2</ulink> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-informix"> <term> <parameter>--with-informix[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Informix. DIR est le dossier d'installation d'Informix (par défaut, aucune valeur). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ingres"> <term> <parameter>--with-ingres[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Ingres II. DIR est le dossier d'installation d'Ingres (par défaut, <literal>/II/ingres</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-interbase"> <term> <parameter>--with-interbase[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support InterBase. DIR est le dossier d'installation d'InterBase (par défaut, <filename>/usr/interbase</filename>). </para> <simpara> <link linkend="ref.ibase">Fonctions Interbase</link> </simpara> <simpara> <ulink url="&url.ibase;">Interbase</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-ldap"> <term> <parameter>--with-ldap[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support LDAP. DIR est le dossier d'installation de LDAP (par défaut <filename>/usr</filename> et <filename>/usr/local</filename>). </para> <para> PHP 4: Inclut le support LDAP. DIR est le dossier d'installation de LDAP. (par défaut; <filename class="directory">/usr/local/ldap</filename>). </para> <simpara> Plus de détails sur LDAP sont disponibles à <ulink url="&url.rfc;rfc1777.html">RFC1777</ulink> et <ulink url="&url.rfc;rfc1778.html">RFC1778</ulink>. </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-msql"> <term> <parameter>--with-msql[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support mSQL. DIR est le dossier d'installation de mSQL (par défaut <filename>/usr</filename> et <filename>/usr/local/Hughes</filename>, pour la version 2.0). <command>configure</command> détecte automatiquement la version de mSQL qui fonctionne. PHP supporte les versions 1.0 et 2.0, mais si vous compilez PHP avec mSQL 1.0, vous ne pourrez accéder qu'à des bases mSQL 1.0, et vice-versa. </para> <simpara> Voir aussi <link linkend="ini.sect.msql">Configuration mSQL</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> <simpara> <ulink url="&url.msql;">mSQL</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-mysql"> <term> <parameter>--with-mysql[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support MySQL. DIR est le dossier d'installation de MySQL (par défaut, il cherche dans différents dossiers où MySQL a coutume d'être installé). </para> <para> PHP 4: Inclut le support MySQL. DIR est le dossier de l'installation MySQL. S'il est omis, la librairie MySQL livrée en standard avec PHP sera utilisée par défaut. </para> <para> Voir aussi <link linkend="ini.sect.mysql">Configuration MySQL</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </para> <para> <ulink url="&url.mysql;">MySQL</ulink> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ndbm"> <term> <parameter>--with-ndbm[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support NDBM. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ovrimos"> <term> <parameter>--with-ovrimos</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Ovrimos. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-oci8"> <term> <parameter>--with-oci8[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Oracle-oci8. DIR est le dossier d'installation de Oracle-oci8 (par défaut, <filename>ORACLE_HOME</filename>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-oracle"> <term> <parameter>--with-oracle[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support Oracle database. DIR est le dossier d'installation de Oracle (par défaut, <filename>$ORACLE_HOME</filename>). </para> <para> PHP 4: Inclut le support Oracle-oci7. DIR est le dossier d'installation de Oracle-oci7 (par défaut, <filename>ORACLE_HOME</filename>). </para> <simpara> Inclut le support Oracle. Ce support a été testé et permet de travailler avec les versions d'Oracle de 7.0 à 7.3. Le paramètre est le dossier <envar>ORACLE_HOME</envar>. Vous n'avez pas à spécifier ce paramètre si votre environnement Oracle a été configuré. </simpara> <simpara> <ulink url="&url.oracle;">Oracle</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-pgsql"> <term> <parameter>--with-pgsql[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support PostgresSQL. DIR est le dossier d'installation de PostgresSQL (par défaut, <filename>/usr/local/pgsql</filename>). </para> <para> PHP 4: Inclut le support PostgreSQL. DIR est le dossier d'installation de PostgreSQL (par défaut, <filename>/usr/local/pgsql</filename>). Pour compiler en "dl", utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", mais spécifier DIR malgré tout. </para> <simpara> Voir aussi <link linkend="ini.sect.pgsql">Postgres</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> <simpara> <ulink url="&url.pgsql;">PostgreSQL</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-solid"> <term> <parameter>--with-solid[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Solid. DIR est le dossier d'installation de Solid (par défaut, <literal>/usr/local/solid</literal>). </para> <simpara> <ulink url="&url.solid;">Solid</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-sybase-ct"> <term> <parameter>--with-sybase-ct[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Sybase-CT. DIR est le dossier d'installation de Sybase (par défaut, <literal>/home/sybase</literal>). </para> <simpara> Voir aussi <link linkend="ini.sect.sybct">Sybase-CT</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-sybase"> <term> <parameter>--with-sybase[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support Sybase-DB. DIR est le dossier d'installation de Sybase (par défaut, <filename>/home/sybase</filename>). </para> <simpara> Voir aussi <link linkend="ini.sect.sybase">Sybase</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> <simpara> <ulink url="&url.sybase;">Sybase</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-openlink"> <term> <parameter>--with-openlink[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support OpenLink ODBC. DIR est le dossier d'installation d'OpenLink (par défaut <literal>/usr/local/openlink</literal>). A partir de PHP 4.0.6, cette option n'est plus valable. Utilisez plutôt <link linkend="install.configure.with-iodbc"><option> --with-iodbc</option></link> si vous voulez utiliser l'ODBC de OpenLink Software. </para> <simpara> <ulink url="&url.openlink;">OpenLink Software</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-iodbc"> <term> <parameter>--with-iodbc[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support iODBC. DIR est le dossier d'installation d'iODBC (par défaut, <filename>/usr/local</filename>). </para> <para> Cette fonctionnalité a d'abord été développée avec le gestionnaire iODBC Driver Manager, un pilote ODBC librement distribuable, qui fonctionne sous divers UNIX. </para> <simpara> <ulink url="&url.freeodbc;">FreeODBC</ulink> ou <ulink url="&url.iodbc;">iODBC</ulink> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-custom-odbc"> <term> <parameter>--with-custom-odbc[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support ODBC, avec une librairie tierce. Le paramètre DIR est le nom du dossier d'installation de cette librairie. Par défaut, il vaut <filename class="directory">/usr/local</filename>. </para> <simpara> Cette option implique qus vous avez défini CUSTOM_ODBC_LIBS lorsque vous éxécutez le script de configuration. Vous devez aussi avoir une en-tête <filename>odbc.h</filename> valide dans vos dossiers d'Inclution. Si vous n'en avez pas, créez le, et ajoutez-y vos en-têtes spécifiques. Votre en-tête peut aussi réclamer d'autres définitions, surtout si elle est multi-plate-forme. Définissez les dans CFLAGS. </simpara> <simpara> Par exemple, vous pouvez utilisez Sybase SQL Anywhere sous QNX comme ceci : <literal> CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50 </literal> </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.disable-unified-odbc"> <term> <parameter>--disable-unified-odbc</parameter> </term> <listitem> <para> PHP 3: Inactive le support unified ODBC. Uniquement valable si iODBC, Adabas, Solid, Velocis ou une interface spéciale ODBC a été activée. </para> <para> PHP 4: Option non disponible en PHP 4 </para> <simpara> Le module Unified ODBC est commun à toutes les bases de données ODBC, comme par exemple Solid, IBM DB2 et Adabas D. Il fonctionne aussi avec les librairies ODBC normales. Des tests ont été menés avec iODBC, Solid, Adabas D, IBM DB2 et Sybase SQL Anywhere. Il requiert une (et une seule) de ces extensions, ou l'extension Velocis, ou une librairie ODBC spéciale. Cette option n'est possible qu'avec l'utilisation de l'une des options suivantes : <link linkend="install.configure.with-iodbc">--with-iodbc</link>, <link linkend="install.configure.with-solid">--with-solid</link>, <link linkend="install.configure.with-ibm-db2">--with-ibm-db2</link>, <link linkend="install.configure.with-adabas">--with-adabas</link>, <link linkend="install.configure.with-velocis">--with-velocis</link>, ou <link linkend="install.configure.with-custom-odbc">--with-custom-odbc</link>. </simpara> <simpara> Voir aussi <link linkend="ini.sect.uodbc">Unified ODBC</link> dans le fichier de <link linkend="configuration.file">configuration</link>. </simpara> </listitem> </varlistentry> <varlistentry id="install.configure.with-unixODBC"> <term> <parameter>--with-unixODBC[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support unixODBC. DIR est le dossier d'installation d'unixODBC (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-velocis"> <term> <parameter>--with-velocis[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclus le support Velocis. DIR est le dossier d'installation de Velocis (par défaut, <literal>/usr/local/velocis</literal>). </para> <simpara> <ulink url="&url.velocis;">Velocis</ulink> </simpara> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.ecommerce"> <title>E-commerce</title> <variablelist> <varlistentry id="install.configure.with-ccvs"> <term> <parameter>--with-ccvs[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Ajoute le support CCVS. DIR est le dossier d'installation de CCVS. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cybermut"> <term> <parameter>--with-cybermut[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support de Cybermut pour PHP 4. DIR est le dossier du SDK Cybermut, qui contient les deux fichiers <filename>libcm-mac.a</filename> et <filename>cm-mac.h</filename>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mck"> <term> <parameter>--with-mck[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support Cybercash MCK. DIR est le dossier d'installation de cybercash mck (par défaut, <filename>/usr/src/mck-3.2.0.3-linux</filename>). Plus d'aide dans le dossier <filename>extra/cyberlib</filename>. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.with-cybercash">--with-cybercash</link> instead. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cybercash"> <term> <parameter>--with-cybercash[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-mck">--with-mck</link> instead. </para> <para> PHP 4: Inclut le support CyberCash. DIR est le dossier d'installation de CyberCash MCK. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pfpro"> <term> <parameter>--with-pfpro[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Verisign Payflow Pro. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.graphics"> <title>Images</title> <variablelist> <varlistentry id="install.configure.enable-freetype-4bit-antialias-hack"> <term> <parameter>--enable-freetype-4bit-antialias-hack</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support de FreeType2 (expérimental). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gd"> <term> <parameter>--with-gd[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support GD. DIR est le dossier d'installation de GD. </para> <para> PHP 4: Inclut le support GD. DIR est le dossier d'installation de GD. Pour compiler en "dl", utilisez la valeur "shared", ou "shared,DIR", pour compiler en "dl", mais spécifier DIR malgré tout. </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-gd"> <term> <parameter>--without-gd</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inactive le support GD . </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-imagick"> <term> <parameter>--with-imagick[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support ImageMagick. DIR est le dossier d'installation de ImageMagick. S'il est omis, PHP essaiera de le trouver de lui-même (expérimental). </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-jpeg-dir"> <term> <parameter>--with-jpeg-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: dossier JPEG pour pdflib 2.0 </para> <para> PHP 4: dossier JPEG pour pdflib 3.x et 4.x </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-png-dir"> <term> <parameter>--with-png-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: dossier PNG pour pdflib 3.x et 4.x </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-t1lib"> <term> <parameter>--enable-t1lib</parameter> </term> <listitem> <para> PHP 3: Active le support t1lib. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.with-t1lib">--with-t1lib</link> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-t1lib"> <term> <parameter>--with-t1lib[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-t1lib">--enable-t1lib</link>. </para> <para> PHP 4: Inclut le support T1lib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tiff-dir"> <term> <parameter>--with-tiff-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: dossier TIFF pour pdflib 2.0 </para> <para> PHP 4: dossier TIFF pour pdflib 3.x et 4.x </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ttf"> <term> <parameter>--with-ttf[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support FreeType. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-xpm-dir"> <term> <parameter>--with-xpm-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: dossier XPM pour GD-1.8+ </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.misc"> <title>Divers</title> <para> Ces options seront classées ultérieurement, lorsqu'une catégorie adéquate apparaîtra. </para> <variablelist> <varlistentry id="install.configure.disable-bcmath"> <term> <parameter>--disable-bcmath</parameter> </term> <listitem> <para> PHP 3: Inactive la librairie BCmath. </para> <para> PHP 4: Option non disponible en PHP 4. La librairie BCmath n'est pas compilée par défaut. Utilisez <link linkend="install.configure.enable-bcmath">--enable-bcmath</link> pour l'inclure. </para> </listitem> </varlistentry> <varlistentry id="install.configure.gmp"> <term> <parameter>--with-gmp</parameter> </term> <listitem> <para> PHP 3, PHP 4 : Inclut le support GMP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-display-source"> <term> <parameter>--disable-display-source</parameter> </term> <listitem> <para> PHP 3: Compile sans afficher le support des sources </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-libtool-lock"> <term> <parameter>--disable-libtool-lock</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Empêche le verrouillage (risque d'empêcher certaines compilations paralléles). </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-pear"> <term> <parameter>--disable-pear</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: N'installe pas PEAR </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-pic"> <term> <parameter>--disable-pic</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inactive PIC pour les shared objects </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-posix"> <term> <parameter>--disable-posix</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3; Utilisez plutôt <link linkend="install.configure.without-posix">--without-posix</link> </para> <para> PHP 4: Inactive les fonctions POSIX. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-rpath"> <term> <parameter>--disable-rpath</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inactive le passage de chemins supplémentaires pour la recherche de librairie lors de l'exécution. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-session"> <term> <parameter>--disable-session</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inactive le support session. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-bcmath"> <term> <parameter>--enable-bcmath</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3; bcmath est compilée par défaut. Utilisez plutôt <link linkend="install.configure.disable-bcmath">--disable-bcmath</link>, pour l'inactiver. </para> <para> PHP 4: Active le support de l'extension bc maths. Voir aussi <link linkend="ref.bc">les fonctions BCMath</link>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-c9x-inline"> <term> <parameter>--enable-c9x-inline</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active les sémantiques C9x-inline </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-calendar"> <term> <parameter>--enable-calendar</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support des conversions calendaires </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debug"> <term> <parameter>--enable-debug</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile sans les symboles de débuggages </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-debugger"> <term> <parameter>--enable-debugger</parameter> </term> <listitem> <para> PHP 3: Compile avec les fonctions de débuggage à distance </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-discard-path"> <term> <parameter>--enable-discard-path</parameter> </term> <listitem> <para> PHP 3, PHP 4: Si cette option est activée, le CGI PHP peut être placé hors de l'arborescence web, pour que personne ne puisse l'atteindre, même en contournant les .htaccess. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-dmalloc"> <term> <parameter>--enable-dmalloc</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active dmalloc </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-exif"> <term> <parameter>--enable-exif</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support exif. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-experimental-zts"> <term> <parameter>--enable-experimental-zts</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Cela risque fortement de ne plus compiler du tout! </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-fast-install"> <term> <parameter>--enable-fast-install[=PKGS]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Optimise pour les installations rapides for fast installation (par défaut, <literal>no</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-force-cgi-redirect"> <term> <parameter>--enable-force-cgi-redirect</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active la vérification interne des redirections serveurs. Il est recommandé d'utiliser cette option si vous avez compilé PHP en CGI. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-inline-optimization"> <term> <parameter>--enable-inline-optimization</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Si vous avez beaucoup de mémoire disponible et que vous utilisez gcc, essayez donc ça. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-libgcc"> <term> <parameter>--enable-libgcc</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active explicitement les liens avec libgcc </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-maintainer-mode"> <term> <parameter>--enable-maintainer-mode</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active des règles de make et de dépendances qui sont parfois absconses et ne servent pas aux utilisateurs habituels (Bref, ne l'utilisez pas). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-memory-limit"> <term> <parameter>--enable-memory-limit</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile avec le support de la limitation de mémoire (par défaut, <literal>no</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-safe-mode"> <term> <parameter>--enable-safe-mode</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le SAFE_MODE (par défaut, <literal>yes</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-satellite"> <term> <parameter>--enable-satellite</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support CORBA via Satellite (Requiert ORBit) </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared"> <term> <parameter>--enable-shared[=PKGS]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile les librairies partagées (par défaut, <literal>yes</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sigchild"> <term> <parameter>--enable-sigchild</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le gestionnaire SIGCHLD propre à PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-static"> <term> <parameter>--enable-static[=PKGS]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile les librairies en statique (par défaut, <literal>yes</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sysvsem"> <term> <parameter>--enable-sysvsem</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support des sémaphores System V. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sysvshm"> <term> <parameter>--enable-sysvshm</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support de partage de mémoire System V. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-trans-sid"> <term> <parameter>--enable-trans-sid</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active la propagation transparente des identifiants de session. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cdb"> <term> <parameter>--with-cdb[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le support CDB. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-config-file-path"> <term> <parameter>--with-config-file-path=PATH</parameter> </term> <listitem> <para> PHP 3: Indique le chemin dans lequel aller lire le fichier <filename>php3.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. </para> <para> PHP 4: Indique le chemin dans lequel allet lire le fichier <filename>php.ini</filename>. Par défaut, c'est <filename>/usr/local/lib</filename>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-cpdflib"> <term> <parameter>--with-cpdflib[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support ClibPDF. DIR est le dossier d'installation de ClibPDF (par défaut, <literal>/usr/local</literal>). </para> <para> PHP 4: Inclut le support ClibPDF.(requires cpdflib >= 2). DIR est le dossier d'installation de cpdfllib (par défaut, <literal>/usr</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-esoob"> <term> <parameter>--with-esoob[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Easysoft OOB. DIR est le dossier d'installation de OOB (par défaut, <literal>/usr/local/easysoft/oob/client</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-exec-dir"> <term> <parameter>--with-exec-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: N'autorise que les exécutables placés dans le dossier DIR, lorsque le SAFE MODE est activé (par défaut, c'est <literal>/usr/local/php/bin</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fdftk"> <term> <parameter>--with-fdftk[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support fdftk. DIR est le dossier d'installation de fdftk (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gnu-ld"> <term> <parameter>--with-gnu-ld</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Suppose que le compilateur C utilise GNU ld (par défaut, <literal>no</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-icap"> <term> <parameter>--with-icap[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support ICAP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-imap"> <term> <parameter>--with-imap[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support IMAP. DIR est le dossier d'include d'IMAP (et aussi c-client.a). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-imsp"> <term> <parameter>--with-imsp[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support IMSP.(DIR est le dossier d'installation IMSP, là où il y a les dossiers d'include et libimsp.a). </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-java"> <term> <parameter>--with-java[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Java. DIR est le dossier d'installation du JDK). Cette extension peut uniquement être compilée comme "dl". </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-kerberos"> <term> <parameter>--with-kerberos[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support Kerberos dans IMAP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mcal"> <term> <parameter>--with-mcal[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support MCAL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mcrypt"> <term> <parameter>--with-mcrypt[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support mcrypt. DIR est le dossier d'installation de mcrypt. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mhash"> <term> <parameter>--with-mhash[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support mhash. DIR est le dossier d'installation de mhash. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mm"> <term> <parameter>--with-mm[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support mm pour le stockage de session. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod_charset"> <term> <parameter>--with-mod_charset</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le transfert des tables depuis le module Apache mod_charset (Rus Apache). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pdflib"> <term> <parameter>--with-pdflib[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support pdflib (testé avec 0.6 et 2.0). DIR est le dossier d'installation de pdflib (par défaut, c'est <filename>/usr/local</filename>). </para> <para> PHP 4: Inclut le support pdflib 3.x/4.x. DIR est le dossier d'installation de pdflib. Par défaut, c'est <filename>/usr/local</filename>. </para> <para> PHP 4 et PDFlib 3.x/4.x requiert les librairies JPEG et TIFF. Lors de la compilation du support PDFlib utilise les options <link linkend="install.configure.with-jpeg-dir">--with-jpeg-dir</link> et <link linkend="install.configure.with-tiff-dir">--with-tiff-dir</link>. Vous pouvez aussi utiliser <link linkend="install.configure.with-png-dir">--with-png-dir</link> et <link linkend="install.configure.with-zlib-dir">--with-zlib-dir</link>, pour compiler le support PNG et Zlib avec PDFlib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shared-pdflib"> <term> <parameter>--enable-shared-pdflib</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut pdflib comme shared librairy. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-readline"> <term> <parameter>--with-readline[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support readline. DIR est le dossier d'installation de readline. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-regex"> <term> <parameter>--with-regex=TYPE</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Type de librairie d'expressions régulières : système, apache, php </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-servlet"> <term> <parameter>--with-servlet[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support servlet. DIR est le dossier d'installation de JSDK. Ce SAPI demande que l'extension Java soit compilée comme shared dl. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ming"> <term> <parameter>--with-ming</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Flash 4 avec Ming. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-swf"> <term> <parameter>--with-swf[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support SWF. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-system-regex"> <term> <parameter>--with-system-regex</parameter> </term> <listitem> <para> PHP 3: Inactive la librairie d'expressions régulières livrée avec PHP. </para> <para> PHP 4: (Obsolète) Utilise la librairie d'expressions régulières système. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tsrm-pth"> <term> <parameter>--with-tsrm-pth[=pth-config]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Utilise GNU Pth. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-tsrm-pthreads"> <term> <parameter>--with-tsrm-pthreads</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Utilise les threads POSIX (par défaut). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-x"> <term> <parameter>--with-x</parameter> </term> <listitem> <para> PHP 3: Utilise X Window System </para> <para> PHP 4: Option non disponible en PHP 4 </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-bzip2-dir"> <term> <parameter>--with-bz2[=DIR]</parameter> </term> <listitem> <para> PHP 4: Ajoute le support bzip2. DIR est le dossier d'installation de bzip2. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zlib-dir"> <term> <parameter>--with-zlib-dir[=DIR]</parameter> </term> <listitem> <para> PHP 3: Dossier zlib pour pdflib 2.0 ou active le support zlib. </para> <para> PHP 4: Dossier zlib pour pdflib 3.x/4.x ou active le support zlib. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zlib"> <term> <parameter>--with-zlib[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support zlib. (requiert zlib >= 1.0.9). DIR est le dossier d'installation de zlib (par défaut, <literal>/usr</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zziplib"> <term> <parameter>--with-zziplib[=DIR]</parameter> </term> <listitem> <para> PHP 4: Inclut le support ZZIPlib (requiert ZZIPlib >= 0.10.6). DIR est le dossier d'installation de ZZIPliby (par défaut, <literal>/usr/local</literal>). </para> <para> La dernière version de ZZIPlib est disponible à <ulink url="&url.zziplib;">&url.zziplib;</ulink>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-pcre-regex"> <term> <parameter>--without-pcre-regex</parameter> </term> <listitem> <para> PHP 3: Inactive le support des expressions régulières Perl. </para> <para> PHP 4: Inactive le support des expressions régulières Perl. Utilisez --with-pcre-regex=DIR pour spécifier le dossier d'installation de PCRE, si vous n'utilisez pas la librairie livrée en standard. </para> </listitem> </varlistentry> <varlistentry id="install.configure.without-posix"> <term> <parameter>--without-posix</parameter> </term> <listitem> <para> PHP 3: N'Inclut pas lrs fonctions POSIX. </para> <para> PHP 4: Option non disponible en PHP 4; utilisez plutôt <link linkend="install.configure.disable-posix">--disable-posix</link>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.networking"> <title>Réseau</title> <variablelist> <varlistentry id="install.configure.with-curl"> <term> <parameter>--with-curl[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support CURL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-ftp"> <term> <parameter>--enable-ftp</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-ftp">--with-ftp</link> </para> <para> PHP 4: Active le support FTP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-ftp"> <term> <parameter>--with-ftp</parameter> </term> <listitem> <para> PHP 3: Inclut le support FTP. </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-ftp">--enable-ftp</link> instead </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-url-fopen-wrapper"> <term> <parameter>--disable-url-fopen-wrapper</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inactive le support des URL avec <function>fopen</function>. </para> <warning> <para> Cette option n'est disponible que jusqu'à la version 4.0.3. Les versions plus récentes fournissent un paramètre dans le fichier <filename>php.ini</filename> appelé <parameter>allow_url_fopen</parameter>, afin de vous éviter de faire ce choix au moment de la compilation. </para> </warning> </listitem> </varlistentry> <varlistentry id="install.configure.with-mod-dav"> <term> <parameter>--with-mod-dav=DIR</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support DAV, grâce au module Apache mod_dav. DIR est le dossier d'installation de mod_dav (valable uniquement pour les serveurs Apache). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-openssl"> <term> <parameter>--with-openssl[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support OpenSSL avec SNMP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-snmp"> <term> <parameter>--with-snmp[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support SNMP. DIR est le dossier d'installation de SNMP (par défaut, il scanne un nombre de dossiers habituels de l'installation SNMP). Utilisez la valeur de "shared" pour compiler sous forme de "dl", ou "shared,DIR" pour compiler sous forme de "dl" tout en spécifiant un dossier. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-ucd-snmp-hack"> <term> <parameter>--enable-ucd-snmp-hack</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active le hack UCD SNMP </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sockets"> <term> <parameter>--enable-sockets</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support des sockets. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-yaz"> <term> <parameter>--with-yaz[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support YAZ.(ANSI/NISO Z39.50). DIR est le dossier d'installation de YAZ (dossier bin). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-yp"> <term> <parameter>--enable-yp</parameter> </term> <listitem> <para> PHP 3: Option non disponible; utilisez plutôt <link linkend="install.configure.with-yp">--with-yp</link> </para> <para> PHP 4: Active le support YellowPages (YP). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-yp"> <term> <parameter>--with-yp</parameter> </term> <listitem> <para> PHP 3: Active le support YellowPages (YP). </para> <para> PHP 4: Option non disponible; utilisez plutôt <link linkend="install.configure.enable-yp">--enable-yp</link> </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-mnogosearch"> <term> <parameter>--with-mnogosearch</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support mnoGoSearch. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.php"> <title>Comportement PHP</title> <variablelist> <varlistentry id="install.configure.enable-magic-quotes"> <term> <parameter>--enable-magic-quotes</parameter> </term> <listitem> <para> PHP 3, PHP 4: Active les magic quotes par défaut. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-short-tags"> <term> <parameter>--disable-short-tags</parameter> </term> <listitem> <para> PHP 3, PHP 4: Désactive la forme courte des balises PHP (<? ?>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-track-vars"> <term> <parameter>--enable-track-vars</parameter> </term> <listitem> <para> PHP 3: Active le suivi des variables GET/POST/Cookie par défaut. </para> <para> PHP 4: Option non disponible en PHP 4; à partir de PHP 4.0.2, cette option est toujours activée. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.servers"> <title>Serveur</title> <variablelist> <varlistentry id="install.configure.with-aolserver-src"> <term> <parameter>--with-aolserver-src=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Indique le chemin jusqu'à la distribution source de AOLserver </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-aolserver"> <term> <parameter>--with-aolserver=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Indique le chemin jusqu'à la distribution installée de AOLserver. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-apache"> <term> <parameter>--with-apache[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile PHP en module Apache. DIR est le dossier d'installation supérieur d'Apache (par défaut, <literal>/usr/local/etc/httpd</literal>. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-apxs"> <term> <parameter>--with-apxs[=FILE]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile PHP comme module partagé d'Apache module. FILE est le chemin optionnel jusqu'à Apache apxs tool; par défaut, c'est apxs). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-versioning"> <term> <parameter>--enable-versioning</parameter> </term> <listitem> <para> PHP 3: Tire profit du système de versionnage et de scoping fourni par Solaris 2.x et Linux </para> <para> PHP 4: Exporte uniquement les symboles nécessaires. Voyez l'installation pour plus de détails. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-caudium"> <term> <parameter>--with-caudium[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP sous forme de module Pike pour être utilisé avec le serveur web Caudium. DIR est le dossier d'installation de Caudium (par défaut, <literal>$prefix/caudium/server</literal>. Le préfixe est paramétré par l'option --prefix (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-fhttpd"> <term> <parameter>--with-fhttpd[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Compile PHP comme module fhttpd. DIR est le dossier d'installation de fhttpd (par défaut, <literal>/usr/local/src/fhttpd</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-nsapi"> <term> <parameter>--with-nsapi=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Indique le chemin jusqu'au serveur Netscape </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-phttpd"> <term> <parameter>--with-phttpd=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pi3web"> <term> <parameter>--with-pi3web=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP comme module pour Pi3Web. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-roxen"> <term> <parameter>--with-roxen=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP comme module pour Pi3Web Pike. DIR est le dossier d'installation de Roxen (par défaut, <literal>/usr/local/roxen/server</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-roxen-zts"> <term> <parameter>--enable-roxen-zts</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile le module Roxen en utilisant Zend Thread Safety. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-thttpd"> <term> <parameter>--with-thttpd=SRCDIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-zeus"> <term> <parameter>--with-zeus=DIR</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Compile PHP comme module ISAPI pour Zeus. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.text"> <title>Texte et langue</title> <variablelist> <varlistentry id="install.configure.with-aspell"> <term> <parameter>--with-aspell[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support ASPELL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-gettext"> <term> <parameter>--with-gettext[=DIR]</parameter> </term> <listitem> <para> PHP 3, PHP 4: Inclut le support GNU gettext. DIR est le dossier d'installation de gettext (par défaut, <literal>/usr/local</literal>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-iconv"> <term> <parameter>--with-iconv[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support iconv. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-pspell"> <term> <parameter>--with-pspell[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Inclut le support PSPELL. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-recode"> <term> <parameter>--with-recode[=DIR]</parameter> </term> <listitem> <para> PHP 3: Inclut le support GNU recode. </para> <para> PHP 4: Inclut le support recode. DIR est le dossier d'installation de recode. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-shmop"> <term> <parameter>--enable-shmop</parameter> </term> <listitem> <para> PHP 3, PHP 4 : Inclut le support shmop. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="install.configure.xml"> <title>XML</title> <variablelist> <varlistentry id="install.configure.with-dom"> <term> <parameter>--with-dom[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support DOM. (requiert libxml >= 2.0). DIR est le dossier d'installation de libxml (par défaut, <filename>/usr</filename>). </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-sablot-errors-descriptive"> <term> <parameter>--enable-sablot-errors-descriptive</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active les erreurs descriptives. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-sablot"> <term> <parameter>--with-sablot[=DIR]</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support Sablotron. </para> </listitem> </varlistentry> <varlistentry id="install.configure.enable-wddx"> <term> <parameter>--enable-wddx</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3 </para> <para> PHP 4: Active le support WDDX. </para> </listitem> </varlistentry> <varlistentry id="install.configure.disable-xml"> <term> <parameter>--disable-xml</parameter> </term> <listitem> <para> PHP 3: Option non disponible en PHP 3; Les fonctions XML ne sont pas construites par défaut. Utilisez plutôt <link linkend="install.configure.with-xml">--with-xml</link> pour les activer. </para> <para> PHP 4: Inactive le support XML, qui utilise la librairie expat, livrée avec PHP. </para> </listitem> </varlistentry> <varlistentry id="install.configure.with-xml"> <term> <parameter>--with-xml</parameter> </term> <listitem> <para> PHP 3: Active le support XML. </para> <para> PHP 4: Option non disponible en PHP 4; Le support XML est activé par défaut. Utilisez plutôt <link linkend="install.configure.disable-xml">--disable-xml</link> pour l'inactiver. </para> </listitem> </varlistentry> </variablelist> </sect2> </sect1> <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;">téléchargement</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 <filename>php.ini</filename> 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>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. 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> <para> Notez cependant que les modules SAPI <emphasis>ne sont pas</emphasis> considéré comme ayant atteint une qualité de production. La raison à cela est que les modules SAPI utilisent le système de thread sécurisé de PHP, ce qui est nouveau en PHP 4, et qui n'a pas été testé et torturé suffisamment pour être considérés comme stable. </para> <para> Il y a encore quelques bugs qui trainent. D'un autre côté, certains d'entre vous ont rapporté des résultats significativement meilleurs avec les modules SAPI, même si nous ne connaissons actuellement personne qui le fasse fonctionner en production. En clair, faites votre choix : soit vous avez absolument besoin de stabilité, et il vaut mieux laisser les performances SAPI de côté; soit vous avez besoin de performances, et alors c'est l'occasion de tester en production et de nous rapporter vos résultats. </para> <para> Si vous choisissez l'un des modules SAPI et utilisez Windows 95, pensez à télécharger la mise à jour DCOM à <ulink url="http://download.microsoft.com/msdownload/dcom/95/x86/en/dcom95.exe">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 '<filename>php.ini</filename>'. 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 <filename>php.ini</filename> : <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. Vous pouvez décommenter les lignes 'extension=php_*.dll' pour charger ces modules. Certains modules requièrent que des librairies supplémentaires soient installées sur votre système. La <ulink url="&url.php.faq;">FAQ</ulink> PHP a plus d'informations sur ces librairies. Vous pouvez aussi charger dynamiquement ces librairies avec <command>dl("php_*.dll");</command>. Voyez la section sur les <link linkend="install.windows.extensions">extensions Windows</link>. </simpara> </listitem> <listitem> <simpara> Sous PWS et IIS, vous pouvez modifier le fichier <filename>browscap.ini</filename> pour qu'il pointe sur : <filename>c:\windows\system\inetsrv\browscap.ini</filename> sous Windows 9x/Me et <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> sous NT/2000. </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> </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.prepare"> <title>Préparation</title> <para> Avant de commencer, il faut télécharger un maximum de fichiers! </para> <itemizedlist> <listitem> <simpara> Pour commencer, téléchargez le Cygwin depuis le miroir <ulink url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink> le plus proche. Cela vous donnera les utilitaires GNU les plus populaires, utilisés durant le processus de compilation. </simpara> </listitem> <listitem> <simpara> Téléchargez le reste des utilitaires de compilation dont vous aurez besoin depuis le site PHP à <ulink url="http://www.php.net/extra/win32build.zip"> http://www.php.net/extra/win32build.zip</ulink>. </simpara> </listitem> <listitem> <simpara> Téléchargez le code source du DNS utilisé par PHP à <ulink url="http://www.php.net/extra/bindlib_w32.zip"> http://www.php.net/extra/bindlib_w32.zip</ulink>. Il remplacera le fichier <filename>resolv.lib</filename> inclut dans <filename>win32build.zip</filename>. </simpara> </listitem> <listitem> <simpara> Si vous n'avez pas d'utilitaire de dézippage, vous devez en télécharger un. Une version libre est disponible à <ulink url="http://www.cdrom.com/pub/infozip/UnZip.html">InfoZip</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="http://www.php.net/anoncvs.php">anonyme</ulink>. Si vous téléchargez une version <ulink url="http://snaps.php.net/">intermédiaire</ulink> ou la <ulink url="http://www.php.net/downloads.php">source</ulink>, vous devez non seulement extraire les fichiers, mais aussi convertir les nouvelles lignes en leur équivalent windows (crlf) dans les fichiers <filename>*.dsp</filename> et <filename>*.dsw</filename> avant que Microsoft Visual C++ ne soit capable de les comprendre. </simpara> <note> <simpara> Placez les dossiers <filename>Zend</filename> et <filename>TSRM</filename> dans le dossier <filename>php4</filename> pour que les projets puissent les trouver durant la compilation. </simpara> </note> </sect3> <sect3 id="install.windows.build.install"> <title>Mettre tout ensemble</title> <itemizedlist> <listitem> <simpara> Suivez les instructions pour installer l'utilitaire d'unzip de votre choix. </simpara> </listitem> <listitem> <simpara> Exécutez <filename>setup.exe</filename> et suivez les instructions d'installation. Si vous décidez d'installer dans un autre dossier que <filename>c:\cygnus</filename>, indiquez le au processus de compilation en modifiant la variable d'environnement Cygwin. Sous Windows 9x/Me, modifier une variable d'environnement se fait en ajoutant une ligne dans le fichier <filename>autoexec.bat</filename>. Sous Windows NT, allez dans le menu "Démarrer => Paramètres => Panneau de contrôle => Système " ("My Computer => Control Panel => System ") et sélectionnez l'onglet "environnement" ("environment"). </simpara> <warning> <simpara> Créez un dossier temporaire pour Cygwin, sinon de nombreuses commandes (comme bison) échoueront. Sous Windows 9x/Me, <userinput>mkdir C:\TMP</userinput>. Sous Windows NT, <userinput>mkdir %SystemDrive%\tmp</userinput>. </simpara> </warning> </listitem> <listitem> <simpara> Créez un dossier et dézippez <filename>win32build.zip</filename> dedans. </simpara> </listitem> <listitem> <simpara> Lancez Microsoft Visual C++, et allez dans le menu "select Tools => Options". Dans le dialogue, sélectionnez l'onglet "directories". Assurez-vous que <filename>cygwin\bin</filename>, <filename>win32build\include</filename>, et <filename>win32build\lib</filename> sont bien dans les menus déroulants "Executables", "Include", et "Library". (Pour ajouter une entrée, sélectionnez une ligne blanche, et tapez). Une entrée typique ressemble à ceci : </simpara> <itemizedlist> <listitem> <simpara> <filename>c:\cygnus\bin</filename> </simpara> </listitem> <listitem> <simpara> <filename>c:\php-win32build\include</filename> </simpara> </listitem> <listitem> <simpara> <filename>c:\php-win32build\lib</filename> </simpara> </listitem> </itemizedlist> <simpara> Pressez "OK", et sortez de Visual C++. </simpara> </listitem> <listitem> <simpara> Créez un autre dossier et dézippez <filename>bindlib_w32.zip</filename> dedans. Décidez si vous avez besoin des symboles de débuggage (bindlib - Win32 Debug) ou non (bindlib - Win32 Release). Compilez la configuration adéquate : </simpara> <itemizedlist> <listitem> <simpara> Pour les utilisateurs de GUI, 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> <listitem> <simpara> 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. </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> </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 une librairie <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> Répétez les instructions ci-dessus avec <filename>php4isapi.dsp</filename> (qui est dans <filename>sapi\isapi</filename>) pour compiler le code nécessaire pour intégrer PHP avec Microsoft IIS. </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 <filename>php.ini</filename>. 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.4pl1, les extensions BCMath, BCMath,Calendar, COM, FTP, MySQL, ODBC, PCRE, Sessions, WDDX et XML sont activées <emphasis>par défaut</emphasis>. Vous n'avez rien à faire pour qu'elles soient inclues. Lisez le fichier <filename>README.txt</filename> ou <filename>install.txt</filename> dans votre distribution pour connaître la liste des modules par défaut. </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> </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>Extensions PHP</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 Bzip2</entry> <entry>Aucune</entry> </row> <row> <entry>php_calendar.dll</entry> <entry>Fonctions de conversions calendaires (Depuis PHP 4.03, elles sont activées par défaut)</entry> <entry>Activée automatiquement depuis PHP 4.0.3</entry> </row> <row> <entry>php_cpdf.dll</entry> <entry>Fonctions ClibPDF</entry> </row> <row> <entry>php_crypt.dll</entry> <entry>Fonctions de cryptage</entry> <entry>Aucune</entry> </row> <row> <entry>php_ctype.dll</entry> <entry>Fonctions ctype</entry> <entry>Aucune</entry> </row> <row> <entry>php_curl.dll</entry> <entry>Fonctions CURL</entry> <entry>Requiert : libeay32.dll, ssleay32.dll (fournies)</entry> </row> <row> <entry>php_cybercash.dll</entry> <entry>Fonctions de paiement Cybercash</entry> <entry>Aucune</entry> </row> <row> <entry>php_db.dll</entry> <entry>Fonctions DBM</entry> <entry>Obsolète. Utilisez DBA à la place (php_dba.dll)</entry> </row> <row> <entry>php_dba.dll</entry> <entry>Fonctions dbm-style</entry> <entry>Aucune</entry> </row> <row> <entry>php_dbase.dll</entry> <entry>Fonctions DBase</entry> <entry>Aucune</entry> </row> <row> <entry>php3_dbm.dll</entry> <entry>Librairie d'émulation GDBM via Berkely DB2</entry> <entry>Aucune</entry> </row> <row> <entry>php_domxml.dll</entry> <entry>Fonctions DOM XML</entry> <entry>Requiert : libxml2.dll (fournie)</entry> </row> <row> <entry>php_dotnet.dll</entry> <entry>Fonctions .NET</entry> <entry>Aucune</entry> </row> <row> <entry>php_exif.dll</entry> <entry>Entêtes EXIF des images JPEG</entry> <entry>Aucune</entry> </row> <row> <entry>php_fbsql.dll</entry> <entry>Fonctions FrontBase</entry> <entry>Aucune</entry> </row> <row> <entry>php_fdf.dll</entry> <entry>Fonction FDF (Forms Data Format)</entry> <entry>Requiert: fdftk.dll (fournie)</entry> </row> <row> <entry>php_filepro.dll</entry> <entry>Lecture des bases filepro</entry> <entry>Accès en lecture seule</entry> </row> <row> <entry>php_ftp.dll</entry> <entry><link linkend="ref.ftp">Fonctions FTP</link></entry> <entry>Activée par défaut depuis PHP 4.0.3</entry> </row> <row> <entry>php_gd.dll</entry> <entry>Bibliothèque GD (pour les manipulations d'images)</entry> <entry>Aucune</entry> </row> <row> <entry>php_gettext.dll</entry> <entry>Fonctions GNU Gettext</entry> <entry>Requiert : gnu_gettext.dll (fournie)</entry> </row> <row> <entry>php_hyperwave.dll</entry> <entry>Fonctions HyperWave</entry> <entry>Aucune</entry> </row> <row> <entry>php_iconv.dll</entry> <entry>Fonctions de conversions ICONV</entry> <entry>Requiert : iconv-1.3.dll (fournie)</entry> </row> <row> <entry>php_ifx.dll</entry> <entry>Fonctions Informix</entry> <entry>Requiert: librairies Informix</entry> </row> <row> <entry>php_iisfunc.dll</entry> <entry>Fonctions IIS</entry> <entry>Aucune</entry> </row> <row> <entry>php_imap.dll</entry> <entry>Fonctions IMAP 4(en PHP 3: php3_imap4r1.dll)</entry> <entry>PHP 3: php3_imap4r1.dll</entry> </row> <row> <entry>php_ingres.dll</entry> <entry>Fonctions Ingres II</entry> <entry>Requiert: librairies Ingres II</entry> </row> <row> <entry>php_interbase.dll</entry> <entry>Fonctions InterBase</entry> <entry>Requiert: gds32.dll (fournie)</entry> </row> <row> <entry>php_java.dll</entry> <entry>Extension Java</entry> <entry>Requiert: jvm.dll (fournie)</entry> </row> <row> <entry>php_ldap.dll</entry> <entry>Fonctions LDAP</entry> <entry>Requiert: libsasl.dll (fournie)</entry> </row> <row> <entry>php_mhash.dll</entry> <entry>Fonctions Mhash</entry> <entry>Aucune</entry> </row> <row> <entry>php_ming.dll</entry> <entry>Fonctions Ming pour Flash</entry> <entry>Aucune</entry> </row> <row> <entry>php_msql.dll</entry> <entry>Fonctions mSQL</entry> <entry>Requiert: msql.dll (fournie)</entry> </row> <row> <entry>php3_msql1.dll</entry> <entry>Fonctions mSQL 1</entry> <entry>Aucune</entry> </row> <row> <entry>php3_msql2.dll</entry> <entry>Fonctions mSQL 2</entry> <entry>Aucune</entry> </row> <row> <entry>php_mssql.dll</entry> <entry>Fonctions MSSQL (anciennement php_mssql70.dll, requiert MSSQL DB-Libraries)</entry> <entry>Requiert: ntwdblib.dll (fournie)</entry> </row> <row> <entry>php3_mysql.dll</entry> <entry>Fonctions MySQL (Activées par défaut en PHP 4)</entry> <entry>Aucune</entry> </row> <row> <entry>php_nsmail.dll</entry> <entry>Fonctions Netscape mail</entry> <entry>Aucune</entry> </row> <row> <entry>php3_oci73.dll</entry> <entry>Fonctions Oracle</entry> <entry>Aucune</entry> </row> <row> <entry>php_oci8.dll</entry> <entry>Fonctions Oracle 8</entry> <entry>Requiert: librairies clientes Oracle 8</entry> </row> <row> <entry>php_openssl.dll</entry> <entry>Fonctions OpenSSL</entry> <entry>Requiert: libeay32.dll (fournie)</entry> </row> <row> <entry>php_oracle.dll</entry> <entry>Fonctions Oracle</entry> <entry>Requiert: librairies clientes Oracle 7</entry> </row> <row> <entry>php_pdf.dll</entry> <entry>Fonctions PDF</entry> <entry>Aucune</entry> </row> <row> <entry>php_pgsql.dll</entry> <entry>Fonctions PostgreSQL</entry> <entry>Aucune</entry> </row> <row> <entry>php_printer.dll</entry> <entry>Fonctions d'impression</entry> <entry>Aucune</entry> </row> <row> <entry>php_sablot.dll</entry> <entry>Focntions XSLT</entry> <entry>Requiert: sablot.dll (fournie)</entry> </row> <row> <entry>php_snmp.dll</entry> <entry>Fonctions <acronym>SNMP</acronym> get et walk</entry> <entry>NT uniquement!</entry> </row> <row> <entry>php_sybase_ct.dll</entry> <entry>Fonctions Sybase</entry> <entry>Requiert: librairies clientes Sybase</entry> </row> <row> <entry>php_yaz.dll</entry> <entry>Fonctions YAZ</entry> <entry>Aucune</entry> </row> <row> <entry>php_zlib.dll</entry> <entry>Fonctions ZLib</entry> <entry>Aucune</entry> </row> </tbody> </tgroup> </table> </para> </sect2> </sect1> <sect1 id="install.apache"> <title>Installation du 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 (version module) </title> <programlisting>1. gunzip apache_1.3.x.tar.gz2. tar xvf apache_1.3.x.tar3. gunzip php-x.x.x.tar.gz4. tar xvf php-x.x.x.tar5. cd apache_1.3.x6. ./configure --prefix=/www7. cd ../php-x.x.x8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars9. make10. make install11. cd ../apache_1.3.x12. for PHP 3: ./configure --activate-module=src/modules/php3/libphp3.a for PHP 4: ./configure --activate-module=src/modules/php4/libphp4.a13. make14. 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.x16. 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 envoyerun 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. <informalexample> <programlisting>1. Nombreuses variantes Linux SysV :/etc/rc.d/init.d/httpd restart2. Avec les scripts apachectl :/path/to/apachectl stop/path/to/apachectl start3. httpdctl et httpsdctl (utilisant OpenSSL), similaire à apachectl:/path/to/httpsdctl stop/path/to/httpsdctl start4. En utilisant mod_ssl, ou un autre seveur SSL, manuellement :/path/to/apachectl stop/path/to/apachectl startssl </programlisting> </informalexample> 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 : <informalexample> <programlisting>./configure --with-apxs --with-pgsql </programlisting> </informalexample> </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> <informalexample> <programlisting>./configure --with-apxs --with-pgsql=shared </programlisting> </informalexample> </para> <para> Cette commande va créer une autre librairie partagée <filename>libphp4.so</filename>, mais va aussi créer une librairie partagée <filename>pgsql.so</filename> qui sera chargée dans PHP avec les options de configurations du fichier <filename>php.ini</filename> ou par chargement dynamique avec <function>dl</function>. </para> <para> <informalexample> <programlisting>./configure --with-apache=/path/to/apache_source --with-pgsql </programlisting> </informalexample> </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 inclus Apache et PHP. </para> <para> <informalexample> <programlisting>./configure --with-apache=/path/to/apache_source --with-pgsql=shared </programlisting> </informalexample> </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 <filename>php.ini</filename> 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 <ulink url="&url.apachedso;">webpage on DSO support</ulink>. </para> </sect2> <sect2 id="install.apache.windows"> <title>Détails sur l'installation de 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> <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> <note> <simpara> Avec Apache 1.3.22 pour Windows, le fichier de configuration par défaut (<filename>httpd.conf-dist-win</filename>) a une directive <literal>ClearModuleList</literal> incluse par défaut. Si cette directive est utilisé, il est nécessaire de mettre une ligne <literal>AddModule mod_php4.c</literal> à la liste <literal>AddModule</literal>, sinon PHP ne sera pas enregistré comme Module Apache. </simpara> </note> <simpara> Pour utiliser les fonctionnalités de mise en évidence du code source, créez simplement un script PHP et ajoutez le code suivant : <literal><?php show_source("original_php_script.php"); ?></literal>. Remplacez le fichier <literal>original_php_script.php</literal> par le fichier que vous voulez afficher : c'est la seule manière de le faire, car il n'y a pas de fonctionnalités phps sous Windows. </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> <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 vous voulez que votre serveur web supporte le PHP, compiler le PHP comme un CGI permet d'obtenir de meilleures 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 <link linkend="ini.safe-mode">safe mode</link> 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 <link linkend="ini.safe-mode">safe mode</link> 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> </sect1> <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 <option role="configure"><link linkend="install.configure.with-fhttpd">--with-fhttpd</link>=<replaceable>DIR</replaceable></option> 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> <sect1 id="install.caudium"> <title>Installation sur serveur Caudium</title> <para> PHP 4 peut être compilé comme module Pike pour le serveur web Caudium. 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/server4. make5. make install6. Redémarrez Caudium s'il était en fonctionnement7. 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 à <filename>PHP4.so</filename>. De même, assurez-vous que <filename>caudium/server/lib/[pike-version]/PHP4.so</filename> 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 <link linkend="install.configure.with-mysql">--with-mysql</link>. </para> </note> </sect1> <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> <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 <option><link linkend="install.configure.with-nsapi">--with-nsapi</link> = <replaceable>DIR</replaceable></option> 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> <programlisting>Instructions pour Sun Solaris 2.6 avec Netscape Enterprise Server 3.6From: bhager@invacare.com1. Installez les packages suivants depuis le serveur www.sunfreeware.comou 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 PATH3. 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.tar5. cd ../php-x.x.x6. Pour les étapes suivantes, assurez-vous que /opt/netscape/suitespot/ correspondbien à votre installation du serveur netscape. Sinon, indiquez le chemincorrect : /configure --with-mysql=/usr/local/mysql --with-nsapi=/opt/netscape/suitespot/ --enable-track-vars --enable-libgcc7. make8. make install </programlisting> </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> <programlisting>Instructions de configuration for Netscape Enterprise ServerFrom: bhager@invacare.com1. Ajoutez les lignes suivantes dans mime.types: type=magnus-internal/x-httpd-php exts=php2. Ajoutez les lignes suivantes dans obj.conf. shlib peut dépendre devotre 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> </programlisting> </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> 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>assoc .php=PHPScriptftype 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>assoc .php=PHPScriptftype 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>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>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>+<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> <sect1 id="install.omnihttpd"> <title>Installation OmniHTTPd</title> <para> Cette section contient des notes et conseils spécifiques à OmniHTTPd. </para> <sect2 id="install.omnihttpd.windows"> <title>OmniHTTPd 2.0b1 et plus récent pour Windows</title> <simpara> Vous devez compléter les étapes suivantes pour configurer PHP avec OmniHTTPd. Ceci est une installation sous forme de CGI. SAPI est supporté par OmniHTTPd, mais des tests ont montrés que ce n'est pas stable d'utiliser PHP en module ISAPI avec OmniHTTPd. </simpara> <para> <itemizedlist> <listitem> <para> Step 1: Installez Omni server. </para> </listitem> <listitem> <para> Step 2: Faites un clic-droit sur l'icone bleue d'OmniHTTPd, sur le bureau, 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". </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". </para> </listitem> <listitem> <para> Step 6: Cliquez sur <literal>OK</literal>. </para> </listitem> </itemizedlist> </para> <simpara> Réptez les étapes 2 à 6 pour chaque extension que vous voulez associer à PHP. </simpara> <note> <para> Certains packages OmniHTTPd sont livrés avec le support PHP déjà intégré. Vous pouvez choisir au moment de la configuration de faire un paramétrage poussé et de décocher le support PHP. Nous vous conseillons d'utiliser les dernières versions de PHP. Certains serveurs OmniHTTPd sont encore livrés avec des versions beta de PHP : il est recommandé de ne pas les installer, mais d'installer votre propre version. Si le serveur est déjà sur votre machine, vous pouvez utiliser le bouton "Replace" dans les étapes 4 et 5 pour en choisir un nouveau et à jour. </para> </note> </sect2> </sect1> <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> <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> </itemizedlist> </para> </sect2> </sect1> <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.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> <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 à <ulink url="&url.php.faq;">&url.php.faq;</ulink>. N'envoyez pas de rapport de bug ou de courriers personnels sur la liste de diffusion. Le système de bug est aussi capable de traiter les suggestions. </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> <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, <link linkend="ini.safe-mode">safe mode</link>...), et n'hésitez pas à envoyer suffisamment de code pour que nous puissions reproduire l'erreur. </simpara> </sect2> </sect1></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:tsgml-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/security.xml diff -u phpdoc/fr/chapters/security.xml:1.16 phpdoc/fr/chapters/security.xml:1.17 --- phpdoc/fr/chapters/security.xml:1.16 Wed Jul 25 15:13:42 2001 +++ phpdoc/fr/chapters/security.xml Mon Nov 12 00:03:38 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.17 $ --> <chapter id="security"> <title>Sécurité</title> <simpara> @@ -39,6 +41,57 @@ toute sécurité. Puis, viennent les considérations de niveaux de sécurité, et les conseils généraux. </simpara> + <sect1 id="security.general"> + <title>Considérations générales</title> + <simpara> + Un système complètement sûr est une impossiblité virtuelle. + L'approche souvent utilisée par les professionnels de la + sécurité est d'équilibrer les risques et l'ergonomie. + Si chaque variable fournie par l'utilisateur demandaient deux + formes de validation biométrique (un scan de la rétine et + une empreinte digitale), on obtiendrait un système avec + un niveau de sécurité d'un bon niveau. Il faudrait aussi une + bonne heure pour remplir un formulaire simple, ce qui encouragerait + les utilisateurs à trouver un moyen de contourner cette sécurité. + </simpara> + <simpara> + La meilleure sécurité est suffisamment discrète pour assurer + un maximum de sécurité sans ajouter de contraintes insurmontables + pour l'utilisateur ou de systèmes complexes de programmation. + Souvent, les attaques sur un script sont des exploitations + des sysèmes de sécurité trop complexes, qui s'érodent au cour + du temps. + </simpara> + <simpara> + Un principe qu'il est bon de retenir : Un système est aussi sur + que son maillon le plus faible. Si toutes les transactions sont + bien notées dans une base, avec confirmation mais que l'utilisateur + n'est authentifiée que par un cookie, la robustesse de votre + système est sévèrement réduite. + </simpara> + <simpara> + Lorsque vous testez votre site, gardez en tête que vous ne pourrez + jamais tester toutes les situations, même pour les pages les plus + simples. Les valeurs que vous attendez seront toujours complétement + différentes des valeurs qu'un employé négligent, un hacker qui a toute + la nuit devant lui ou encore le chat de la maison qui marche sur le clavier. + C'est pourquoi il est préférable de regarder le code d'un point de vue + logique, pour repérer les points d'entrée des données inattendues, + puis de voir comment elles pourront être modifiées, + amplifiées ou réduites. + </simpara> + <simpara> + L'Internet est rempli d'individu qui tentent de se faire une renommée + en piratant vos programmes, en bloquant votre site, en envoyant des contenus + inappropriés, qui rendent vos journées si "spéciales". + Peut importe que vous ayez un grand portail ou un petit web, vous pouvez + être la cible pour tout quidam avec une connexion. Vous êtes une + cible potentielle dès que vous êtes connecté vous-même. + Certains programmes de piratage ne font pas dans la demi-mesure, et + testent systématiquement des millions d'IP, à la recherche + de victimes : ne soyez pas la prochaine. + </simpara> + </sect1> <sect1 id="security.cgi"> <title>Binaires CGI</title> <sect2 id="security.cgi.attacks"> @@ -304,6 +357,13 @@ Pour les professionnels de la sécurité, une telle utilisation est à exclure d'office. </simpara> + <simpara> + Il existe des solutions plus simples. En utilisant + <function>open_basedir</function> vous pouvez contrôler et restraindre + l'accès à certains dossiers qui pourront être utilisés par PHP. Vous pouvez + aussi des aires de restrictions Apache, pour restraindre les activités + anonymes liées aux internautes. + </simpara> </sect1> <sect1 id="security.filesystem"> <title>Sécurité des fichiers</title> @@ -337,7 +397,7 @@ <programlisting role="php"> <?php // efface un fichier dans un dossier racine -$username = $user_submitted_name; +$username = $HTTP_POST_VARS['user_submitted_name']; $homedir = "/home/$username"; $file_to_delete = "$userfile"; unlink ($homedir/$userfile); @@ -362,7 +422,7 @@ $homedir = "/home/../etc/"; $file_to_delete = "passwd"; unlink ("/home/../etc/passwd"); -echo "/home/../etc/passwd" has been deleted!"; +echo "/home/../etc/passwd a été effacé!"; ?> </programlisting> </example> @@ -381,39 +441,46 @@ </simpara> </listitem> </itemizedlist> - Voici le script renforcé : + Voici un script renforcé : <example> <title>Une vérification renforcée</title> <programlisting role="php"> <?php // Efface un fichier sur le disque où l'utilisateur à le droit d'aller -$username = get_env("REMOTE_USER"); + $username = $HTTP_SERVER_VARS['REMOTE_USER']; // utilise un mécanisme d'authentification -$homedir = "/home/$username"; -$file_to_delete = basename("$userfile"); + $homedir = "/home/$username"; + $file_to_delete = basename("$userfile"); // supprime le chemin excédentaire -unlink ($homedir/$file_to_delete); -$fp = fopen("/home/logging/filedelete.log","+a"); //note l'effacement -$logstring = "$HTTP_REMOTE_USER $homedir $file_to_delete"; -fputs ($fp, $logstring); -fclose($fp); -echo "$file_to_delete a été éffacé!"; + unlink ($homedir/$file_to_delete); + $fp = fopen("/home/logging/filedelete.log","+a"); //note l'effacement + $logstring = "$username $homedir $file_to_delete"; + fputs ($fp, $logstring); + fclose($fp); + echo "$file_to_delete a été éffacé!"; ?> </programlisting> </example> - Vous pouvez-vous protéger avec une vérification telle que : + Cependant, même cette technique n'est pas sans faille. + Si votre système d'identification permet aux utilisateurs + de créer leur propre login, et qu'un utilisateur choisi + le login "../etc/", le système est de nouveau exposé. Pour cette + raison, vous pouvez essayez d'écrire un script renforcé : <example> <title>Vérification de noms de fichier sécurisée</title> <programlisting role="php"> <?php -$username = $HTTP_REMOTE_USER; -$homedir = "/home/$username"; -if (!ereg('^[^./][^/]*$', $userfile)) - die('Erreur de nom de fichier'); //meurt, ne pas traiter! + $username = $HTTP_SERVER_VARS['REMOTE_USER'];; + $homedir = "/home/$username"; + if (!ereg('^[^./][^/]*$', $username)) + die('Erreur de nom de fichier'); + //meurt, ne SURTOUT pas traiter! //etc... ?> </programlisting> </example> + </para> + <para> Suivant votre système d'exploitation, vous devrez protéger un grand nombre de fichiers, notamment les entrées de périphériques, (/dev/ ou COM1), les fichiers de configuration (fichiers /etc/ et .ini), @@ -424,13 +491,30 @@ </sect1> <sect1 id="security.errors"> <title>Rapport d'erreur</title> - <simpara> + <para> + En terme de sécurité, il y a deux conséquence au rapport d'erreur. + D'un coté, cela améliore la sécurité, + mais d'un autre, cela la réduit aussi. + </para> + <para> Une tactique d'attaque standard consiste à faire faire des erreurs au système, et lire les variables d'environnement et de contexte qui sont retournées. Cela permet au pirate de lire de nombreuses informations sur le serveur, et de détecter des faiblesses du serveur. - </simpara> - <simpara> + Par exemple, si un intrus a glané des informations sur votre page, avec + une première utilisation de votre site, il peut essayer de remplacer les + variables par ses propres valeurs : + <example> + <title>Attacque de site avec une page HTML personnalisée</title> + <programlisting role="php"> +<form method="post" action="http://www.site.cible.com/?username=badfoo&password=badfoo"> +<input type="hidden" name="username" value="badfoo"> +<input type="hidden" name="password" value="badfoo"> +</form> + </programlisting> + </example> + </para> + <para> Les erreurs PHP qui sont normalement retournées peuvent être très pratiques pour un développeur qui essaie de débugger un script, car elles donnent de précieux renseignements tels que @@ -439,17 +523,35 @@ ces informations sont exploitables. Il est commun aux développeurs PHP d'utiliser les fonctions <function>show_source</function>, <function>highlight_string</function>, ou <function>highlight_file</function> - comme outils de débuggage, mais sur un site en production, cela expose + comme outils de débuggage, mais sur un site en production, cela expose des variables cachées, des syntaxes non vérifiées - ou d'autres informations dangereuses. - </simpara> - <simpara> - Par exemple, le style d'erreur indique sur quel système PHP fonctionne. + ou d'autres informations critiques. Il est particulièrement dangeureux + d'exécuter du code de sources connues, avec les gestionnaires de + débuggage. Si l'intrus peut comprendre votre technique habituelle + d'utilisation, il peut tenter une attaque frontale sur une page, en + envoyant des chaînes de débuggage : + <example> + <title>Exploiter des variables classiques de débuggage</title> + <programlisting role="php"> +<form method="post" action="http://www.site.cible.com/?errors=Y&showerrors=1"&debug=1"> +<input type="hidden" name="errors" value="Y"> +<input type="hidden" name="showerrors" value="1"> +<input type="hidden" name="debug" value="1"> +</form> + </programlisting> + </example> + </para> + <para> + Indépendamment de la gestion des erreurs, la possibilité de tester + la gestion des erreurs d'un système conduit à un trou de sécurité, + et la diffusion de plus d'informations sur votre système. + </para> + <para> Si un pirate affiche une page <acronym>html</acronym>, et essaye de la tester (pour rechercher des faiblesses du système), il peut déterminer sur quel système PHP a été compilé. - </simpara> - <simpara> + </para> + <para> Une erreur de fonction indique si un système supporte une base de données spécifique, ou bien indique comment la page a été générée. Cela peut orienter l'intrus @@ -458,23 +560,123 @@ erronées, par exemple, un pirate peut déterminer l'ordre d'authentification dans un script (à partir des lignes d'erreurs), et d'essayer de les exploiter ailleurs, dans le script. - </simpara> - <simpara> + </para> + <para> Une erreur de fichier, ou une erreur générale PHP peut indiquer quelles sont les permissions du serveur web, ainsi que la structure et l'organisation des fichiers. Les gestionnaires d'erreurs utilisateurs peuvent aussi aggraver ce problème, en permettant l'exploitation facile d'informations préalablement cachées. - </simpara> - <simpara> - Il y a trois solutions majeures à ces problèmes : la première est - de scruter toutes les fonctions, et essayer de traiter toutes les + </para> + <para> + Il y a trois solutions majeures à ces problèmes : la première + est de scruter toutes les fonctions, et d'essayer de traiter toutes les erreurs. La deuxième est d'inactiver le rapport d'erreur, dès que le script est en production. La troisième est d'utiliser les fonctions de gestions des erreurs. Suivant votre politique de sécurité, vous pouvez utiliser un panachage savant des trois méthodes. - </simpara> + </para> + <para> + Une méthode pour gagner du temps est d'utiliser la fonction + <function>error_reporting</function>, pour vous aider à + sécuriser le code, et détecter les utilisations dangeureuses de variables. + Vous testez votre code en béta-test avec la valeur <constant>E_ALL</constant>, + et vous pouvez rapidement repérer les variables qui ne sont pas + protégées. Une fois que le code est prêt à être déployé, + utilisez la constante <constant>E_NONE</constant>, pour isoler + votre code. + <example> + <title>Détecter des variables non protégées avec E_ALL</title> + <programlisting role="php"> +<?php + if ($username) { +// Non initialisée, ou vérifée avant utilisation + $good_login = 1; + } + if ($good_login == 1) { +// Si le test ci-dessus échoue, les valeurs n'ont pas été testées + fpassthru ("/données/très/très/sensibles/index.html"); + } +?> + </programlisting> + </example> + </para> + </sect1> + <sect1 id="security.registerglobals"> + <title>Utilisation des variables HTTP</title> + <para> + Une fonctionnalité de PHP qui peut être utilisée pour + améliorer la sécurité est de configurer PHP en inactivant l'option + <link linkend="ini.register-globals">register_globals</link>. + En supprimant la possibilité que les variables envoyées + par les internautes soient injectées automatiquement dans + le script PHP, vous pouvez restreindre la quantité de + variables non-protégées. Les intrus devront prendre beaucoup plus + de temps pour corrompre les mécanismes d'envoi de données, + et vos variables internes seront nettement mieux protégées. + </para> + <para> + Bien que cela augmente d'autant les efforts à fournir pour + écrire un script PHP, les bénéfices peuvent en être + nettement plus interessants. + <example> + <title>Travailler avec register_globals actif</title> + <programlisting role="php"> +<?php + if ($username) { +// attention, cette valeur peut être parasitée via GET/POST/COOKIES + $good_login = 1; + } +if ($good_login == 1) { +// attention, cette valeur peut être parasitée via GET/POST/COOKIES + fpassthru ("/données/très/très/sensibles/index.html"); +} +?> + </programlisting> + </example> + <example> + <title>Travailler avec register_globals actif</title> + <programlisting role="php"> +<?php + if($HTTP_COOKIE_VARS["username"]){ +// ne peut provenir que d'un cookie, corrompu ou pas + $good_login = 1; +// Impossible à parasiter + fpassthru ("/données/très/très/sensibles/index.html"); + } +?> + </programlisting> + </example> + En utilisant intelligemment ceci, il est même possible + de détecter les tentatives de corruption. Si vous savez à l'avance + d'où la variable doit venir (GET ou POST ou COOKIE), vous pouvez + tester les données. Même si cela ne vous garantit pas contre + la corruption de ces données, cela impose aux pirates de bien + savoir comment corrompre les données. + <example> + <title>Détection de corruption de variables</title> + <programlisting role="php"> +<?php + if ($HTTP_COOKIE_VARS['username'] && + !$HTTP_POST_VARS['username'] && + !$HTTP_GET_VARS['username'] ) { + // D'autres vérifications pour vérifier l'origine du nom d'utilisateur fourni + $good_login = 1; + fpassthru ("/données/très/très/sensibles/index.html"); + } else { + mail("admin@example.com", "Tentative de piratage", $HTTP_SERVER_VARS['REMOTE_ADDR']); + echo "Problème de sécurité, l'administrateur est alerté."; + exit; + } +?> + </programlisting> + </example> + Bien entendu, inactiver l'option register_globals ne signifie pas + que votre code devient ouvert à tous. Mais il faut aussi + vérifier toutes les données qui vous sont fournies par les + utilisateurs, et plutôt deux fois qu'une. + </para> </sect1> <sect1 id="security.variables"> <title>Données transmises par les internautes</title> @@ -491,12 +693,12 @@ <?php // efface un fichier à la racine d'un utilisateur... ou peut être // de quelqu'un d'autre? -unlink ($evil_var); + unlink($evil_var); // Note l'accès de ce fichier ... ou pas? -fputs ($fp, $evil_var); -// Exécute une commande triviale... ou pas? -system ($evil_var); -exec ($evil_var); + fputs($fp, $evil_var); +// Exécute une commande triviale... ou ajoute une entrée dans /etc/password ? + system($evil_var); + exec($evil_var); ?> </programlisting> </example> @@ -549,61 +751,51 @@ à la source). </para> </sect1> - <sect1 id="security.general"> - <title>Considérations générales</title> - <simpara> - Un système complètement sécurisé est - virtuellement impossible. De ce fait, une approche qui - équilibre les risques et l'ergonomie est souvent retenue. - Si toutes les variables envoyées par l'utilisateur - nécessitaient deux formes d'identification biométriques - (comme par exemple un scanner de la rétine, et une - empreinte digitale), vous pourriez avoir un niveau de - sécurité élevé. Cela prendrait aussi - une demi-heure pour remplir les conditions de sécurité, - ce qui pousserait les utilisateurs à éviter d'utiliser - votre système. - </simpara> - <simpara> - La meilleure sécurité est celle qui protège - votre système, sans empêcher les utilisateurs de faire - leur travail. En général, les attaques exploitent - des trous de sécurité entre diverses couches d'identification : cet - empilement devient trop complexe, et finalement, peu fiable. - </simpara> - <simpara> - Une phrase qui vaut la peine d'être retenue : un système est - aussi fiable que son maillon le plus faible. Si toutes les - transactions sont exhaustivement notées (heure, lieu, type, etc...) - mais que l'utilisateur n'est authentifié que par un cookie, - la validité de votre système de surveillance est intimement - liée à la validité du cookie (et donc, - sévèrement réduite). - </simpara> - <simpara> - Lors de vos tests, gardez à l'esprit que vous ne pourrez pas - tester toutes les configurations, mais probablement les plus - simples. Les données en entrées auxquelles vous pouvez vous - attendre ne seront rien comparées aux données - incohérentes d'un employé négligent, un - pirate disposant d'autant de temps qu'il veut, ou du chat de la - maison marchant sur le clavier. Il est donc bon de regarder le - code logiquement, de chercher où des données incohérentes - peuvent être introduites, modifiées, réduites ou - amplifiées. - </simpara> - <simpara> - L'Internet est rempli de personnes qui tentent de se faire une renommée - en piratant vos programmes, en bloquant votre site, en envoyant des contenus - inappropriés, qui rendent vos journées si "spéciales". - Peut importe que vous ayez un grand portail ou un petit web, vous pouvez - être la cible pour tout quidam avec une connexion. Vous êtes une - cible potentielle dès que vous êtes connecté vous-même. - Certains programmes de piratage ne font pas dans la demi-mesure, et - testent systématiquement des millions d'IP, à la recherche - de victimes : ne soyez pas la prochaine. - </simpara> - </sect1> + <sect1 id="security.hiding"> + <title>Masquer PHP</title> + <para> + Quelques astuces permettent de masquer PHP, et cela entrave les + pirates qui recherchent des faiblesses dans votre système. En + inactivant l'option expose_php dans votre fichier <filename>php.ini</filename>, + vous pouvez réduire la quantité d'informations disponible. + </para> + <para> + Une autre astuce est de configurer le serveur web, comme Apache, + pour qu'il utilise plusieurs types de fichiers différents avec PHP, + soit localement avec le fichier <filename>.htaccess</filename>, soit + dans le fichier de configuration lui-même. Vous pouvez utiliser des + informations déroutantes comme ceci : + <example> + <title>Masquer PHP avec un autre langage</title> + <programlisting role="php"> +// Faire que le code PHP ressemble à un autre type +AddType application/x-httpd-php .asp .py .pl + </programlisting> + </example> + Ou masquez le complètement : + <example> + <title>Masquer PHP avec des types inconnus</title> + <programlisting role="php"> +// Faire que le code PHP ressemble à un autre langage qui n'existe pas +AddType application/x-httpd-php .bop .foo .133t + </programlisting> + </example> + Ou encore, cachez le sous forme de html. Cela a un légèr impact négatif + sur les performances générales, car tous les fichiers HTML seront aussi + analysés et traités par le moteur PHP : + <example> + <title>Utiliser le type html pour les extensions PHP</title> + <programlisting role="php"> +// Faire que le code PHP ressemble à du html +AddType application/x-httpd-php .htm .html + </programlisting> + </example> + Pour que cela fonctionne efficacement, pensez à renommer tous vos + fichiers avec les extensions ci-dessus. Même si c'est une forme + de sécurité du non-dit, c'est une mesure de prévention mineure, + avec peu d'inconvénients. + </para> + </sect1> <sect1 id="security.current"> <title>Etre à jour</title> <simpara> Index: phpdoc/fr/chapters/config.xml diff -u phpdoc/fr/chapters/config.xml:1.12 phpdoc/fr/chapters/config.xml:1.13 --- phpdoc/fr/chapters/config.xml:1.12 Sat Jul 7 18:21:57 2001 +++ phpdoc/fr/chapters/config.xml Mon Nov 12 00:03:38 2001 @@ -1,1422 +1 @@ - <chapter id="configuration"> - <title>Configuration</title> - <sect1 id="configuration.file"> - <title>Le fichier de configuration</title> - <simpara> - Le fichier de configuration (appelé <filename>php3.ini</filename> - dans la version 3.0 du PHP, et simplement <filename>php.ini</filename> - dans la version 4.0) est lu par le PHP au démarrage. Si vous - avez compilé PHP en module, le fichier n'est lu qu'une seule - fois, au lancement du démon <acronym>HTTP</acronym>. Pour la version - <acronym>CGI</acronym> le fichier est lu à chaque invocation. - </simpara> - <simpara> - Lorsque vous utilisez le module Apache vous pouvez aussi changer - les paramètres de configurations en utilisant les directives - dans les fichiers de configuration d'Apache et dans les fichiers - <filename>.htaccess</filename>. - </simpara> - <simpara> - Dans la version 3.0, à chaque directive de configuration - présente dans le fichier de configuration d'Apache correspond - une directive de configuration dans le fichier - <filename>php3.ini</filename> à l'exception des directives - préfixées par "php3_". - </simpara> - <simpara> - Dans la version 4.0, il n'y a seulement que quelques directives - dans le fichier de configuration d'Apache qui vous permettent de - modifier la configuration de PHP. - </simpara> - <variablelist> - <varlistentry> - <term> - <systemitem role="directive">php_value</systemitem> - <parameter>name</parameter> - <parameter>value</parameter> - </term> - <listitem> - <para> - Cette directive affecte une valeur à la variable - spécifiée. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <systemitem role="directive">php_flag</systemitem> - <parameter>name</parameter> - <parameter>on|off</parameter> - </term> - <listitem> - <para> - Cette directive est utilisée pour activer ou - désactiver une option. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <systemitem role="directive">php_admin_value</systemitem> - <parameter>name</parameter> - <parameter>value</parameter> - </term> - <listitem> - <para> - Cette directive affecte une valeur à la variable - spécifiée. La directive "Admin" ne peut être - utilisée que dans le fichier de configuration d'Apache, et - non dans un fichier <filename>.htaccess</filename>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <systemitem role="directive">php_admin_flag</systemitem> - <parameter>name</parameter> - <parameter>on|off</parameter> - </term> - <listitem> - <para> - Cette directive est utilisée pour activer ou désactiver l'option - précédente. - </para> - </listitem> - </varlistentry> - </variablelist> - <simpara> - Vous pouvez voir l'état de votre configuration en utilisant - la fonction <function>phpinfo</function>. Vous pouvez aussi - accéder aux valeurs de votre configuration de manière - individuelle en utilisant la fonction <function>get_cfg_var</function>. - </simpara> - <sect2 id="ini.sect.general"> - <title>Directives de configuration générale</title> - <variablelist> - <varlistentry id="ini.allow-url-fopen"> - <term> - <parameter>allow_url_fopen</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Cette option autorise les accès au réseau des fonctions - <function>fopen</function>. Par défaut, l'accès est - autorisé aux procédures - d'<link linkend="features.remote-files">accès distants</link>, - avec les protocoles <acronym>FTP</acronym>, <acronym>NNTP</acronym>, - et certaines extensions telles ques zlib. - </para> - <note> - <para> - Cette option a été introduite immédiatement - après la version 4.0.3. Pour les versions jusqu'à - la 4.0.3 inclus, vous pouvez désactiver cette - fonctionnalité au moment de la compilation en utilisant - la configuration - <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. - </para> - </note> - </listitem> - </varlistentry> - <varlistentry id="ini.asp-tags"> - <term> - <parameter>asp_tags</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active l'utilisation des balises de type ASP <% %>, en plus des - traditionnelles balises <?php ?> . Cela inclus l'utilisation du raccourcis - <%= $value %>. Pour plus d'informations, reportez vous à - <link linkend="language.basic-syntax.phpmode">inclusion dans le HTML</link>. - </para> - <note> - <para>Le support des balises ASP a été ajouté dans la version 3.0.4. - </para> - </note> - </listitem> - </varlistentry> - <varlistentry id="ini.auto-append-file"> - <term> - <parameter>auto_append_file</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Spécifie le nom d'un fichier qui sera automatiquement ajouté - après le fichier principal. Le fichier est inclus comme si il avait - été appelé avec la fonction <function>include</function>, - donc <link linkend="ini.include-path">include_path</link> est utilisé. - </para> - <para> - Le mot réservé <systemitem class="constant">NONE</systemitem> - désactive l'auto-appending. - </para> - <note> - <para> - Si le script s'arrête par la fonction <function>exit</function>, - auto-append <emphasis>ne fonctionnera pas</emphasis>. - </para> - </note> - </listitem> - </varlistentry> - <varlistentry id="ini.auto-prepend-file"> - <term> - <parameter>auto_prepend_file</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Spécifie le nom d'un fichier qui sera automatiquement ajouté - avant le fichier principal. Le fichier est inclus comme si il avait - été appelé avec la fonction <function>include</function>, - donc <link linkend="ini.include-path">include_path</link> est utilisé. - </para> - <para> - Le mot réservé <systemitem class="constant">NONE</systemitem> - désactive l'auto-appending. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.cgi-ext"> - <term> - <parameter>cgi_ext</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - (NDT : aucune documentation n'est fournie). - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.display-errors"> - <term> - <parameter>display_errors</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette directive détermine si les erreurs doivent être - affichées à l'écran au format HTML ou non. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.doc-root"> - <term> - <parameter>doc_root</parameter> - <type>string</type> - </term> - <listitem> - <para> - Le dossier racine de PHP. Utilisée uniquement si elle est définie. - Si PHP est configuré en <link linkend="ini.safe-mode">safe mode</link>, - aucun fichier en dehors de ce dossier ne sera accessible. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.engine"> - <term> - <parameter>engine</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Cette directive ne sert vraiment que si PHP est un module Apache. - Elle sert aux sites qui veulent activer ou désactiver l'analyse des fichiers - par PHP, dossier par dossier. En mettant <userinput>php3_engine off</userinput> - au bon endroit, dans le fichier <filename>httpd.conf</filename>, PHP peut être - activé ou desactivé. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.error-log"> - <term> - <parameter>error_log</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom du fichier oú les erreurs seront enregistrées. Si la valeur spéciale - <literal>syslog</literal> est utilisée, les erreurs sont envoyées au système - standard d'historique. Sous UNIX, c'est syslog(3) et sous Windows NT c'est - l'historique d'événements. L'historique système n'est pas supporté sous - Windows 95.</para> - </listitem> - </varlistentry> - <varlistentry id="ini.error-reporting"> - <term> - <parameter>error_reporting</parameter> - <type>integer</type> - </term> - <listitem> - <para> - Fixe le niveau d'erreur. Ce paramètre est un entier, représentant un - champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau - que vous désirez : - <table> - <title>Niveau de rapport d'erreur</title> - <tgroup cols="2"> - <thead> - <row> - <entry>valeur du bit</entry> - <entry>niveau choisi</entry> - </row> - </thead> - <tbody> - <row> - <entry>1</entry> - <entry>erreurs normales</entry> - </row> - <row> - <entry>2</entry> - <entry>alertes normales</entry> - </row> - <row> - <entry>4</entry> - <entry>erreurs d'analyseur (parser errors)</entry> - </row> - <row> - <entry>8</entry> - <entry>alertes non critiques</entry> - </row> - </tbody> - </tgroup> - </table> - Par défaut, la valeur est de 7 (erreurs normales, alertes normales - et erreurs d'analyseur sont affichées). - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.open-basedir"> - <term> - <parameter>open_basedir</parameter> - <type>string</type> - </term> - <listitem> - <para> - Limite l'espace oú PHP peut ouvrir des fichiers. - </para> - <para> - Lorsqu'un script essaie d'ouvrir un fichier avec les fonctions - fopen ou gzopen (par exemple), la localisation du fichier est vérifiée. - Si ce fichier est hors du dossier cité dans cette directive, PHP refusera - de l'ouvrir. Tous les liens symboliques sont résolus, et subissent aussi - la restriction. - </para> - <para> - La valeurs spéciale <systemitem class="constant">.</systemitem> - indique que le dossier courant du script est utilisé comme open_basedir. - </para> - <para> - Sous Windows, séparez les noms de dossiers par un point virgule (;). - Sur les autres systèmes, séparez les noms de dossiers par des deux points (:). - Lorsque PHP est un module Apache, la valeur de la directive open_basedir - des dossiers parents sont automatiquement hérités par les fils. - </para> - <note> - <para>Le support pour les dossiers multiples a été ajouté dans 3.0.7.</para> - </note> - <para> - La valeur par défaut est : libre accès à tous les fichiers. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.gpc-order"> - <term> - <parameter>gpc_order</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Etablit l'ordre de préséance des méthodes GET/POST/COOKIE. - Par défaut, cette directive est établie à "GPC". En affectant "GP" à - cette directive, PHP ignorera les cookies, et écrasera toute méthode - GET utilisée par une méthode POST avec des variables du même nom. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ignore-user-abort"> - <term> - <parameter>ignore_user_abort</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Désactivée par défaut. Si cette directive est activée, alors tous les scripts - lancés iront jusqu'à leur terme, même si le client se déconnecte en plein - milieu. Voir aussi la fonction <function>ignore_user_abort</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.include-path"> - <term> - <parameter>include_path</parameter> - <type>string</type> - </term> - <listitem> - <para> - Spécifie une liste de dossier oú les fonctions <function>require</function>, - <function>include</function> et fopen_with_path (NDtraducteur : cette fonction - semble avoir disparue) iront chercher les fichiers. Le format est le même - que celui de la variable d'environnement <envar>PATH</envar> : une liste de dossiers, - séparés par des deux points (:) sous UNIX, et des points virgules (;), - sous Windows. - <example> - <title>UNIX include_path</title> - <programlisting role="php3.ini"> -include_path=.:/home/httpd/php-lib - </programlisting> - </example> - <example> - <title>Windows include_path</title> - <programlisting role="php3.ini"> -include_path=".;c:\www\phplib" - </programlisting> - </example> - La valeur par défaut pour cette directive est <literal>.</literal>, - c'est à dire le dossier courant.</para> - </listitem> - </varlistentry> - <varlistentry id="ini.isapi-ext"> - <term> - <parameter>isapi_ext</parameter> - <type>string</type> - </term> - <listitem> - <para> - (Aucune documentation n'est fournie) - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.log-errors"> - <term> - <parameter>log_errors</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Indique oú les messages d'erreur générés doivent - être écrits. Cette fonction est spécifique aux serveurs. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.magic-quotes-gpc"> - <term> - <parameter>magic_quotes_gpc</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Fixe le mode magic_quotes pour les opérations GPC (Get/Post/Cookie). - Lorsque magic_quotes est activé, tous les caractères ' - (guillemets simples), " (guillemets doubles), \ (antislash) et NUL - sont échappés avec un antislash. Si magic_quotes_sybase - fonctionne aussi, les guillemets simples seront échappés - avec un autre guillemet simple, plutôt qu'un antislash. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.magic-quotes-runtime"> - <term> - <parameter>magic_quotes_runtime</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Si <parameter>magic_quotes_runtime</parameter> est activé, toutes les fonctions - qui retournent des données d'une source externe, y compris les bases de - données et les fichiers texte, verront leur guillemets échappés avec un - antislash. Si <parameter>magic_quotes_sybase</parameter> est aussi activé, - les guillemets simples seront échappés avec un autre guillemet simple, - plutôt qu'un antislash. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.magic-quotes-sybase"> - <term> - <parameter>magic_quotes_sybase</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Si <parameter>magic_quotes_sybase</parameter> est activé, les guillemets - simples seront échappés avec un autre guillemet simple, plutôt - qu'un antislash, si <parameter>magic_quotes_gpc</parameter> ou - <parameter>magic_quotes_runtime</parameter> est activé. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.max-execution-time"> - <term> - <parameter>max_execution_time</parameter> - <type>integer</type> - </term> - <listitem> - <para> - Fixe le temps maximal d'éxécution d'un script, en secondes. Cela permet - d'éviter que des scripts en boucles infinies ne saturent le serveur. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.memory-limit"> - <term> - <parameter>memory_limit</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Grâce à cette option, vous pouvez donner la quantité maximale - de mémoire qu'un script peut allouer. Cela permet de reserver toute la - mémoire d'un serveur à un seul script. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.nsapi-ext"> - <term> - <parameter>nsapi_ext</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Aucune documentation n'est fournie. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.register-globals"> - <term> - <parameter>register_globals</parameter> - <type>boolean</type> - </term> - <listitem> - <para> - Cette option active l'enregistrement des variables EGPCS - (Environement, GET, POST, Cookie, Serveur), en tant que - variables globales. Vous pouvez désactiver cette fonction - si vous ne voulez pas truffer vos scripts avec des - valeurs utilisateurs. Cette option est surtout utile lorsqu'elle - est utilisée conjointement avec <link - linkend="ini.track-vars">track_vars</link> - dans ce cas, - vous pouvez accéder à toutes les variables EGPCS grâce aux tableaux - <varname>$HTTP_ENV_VARS</varname>, - <varname>$HTTP_GET_VARS</varname>, - <varname>$HTTP_POST_VARS</varname>, - <varname>$HTTP_COOKIE_VARS</varname>, et - <varname>$HTTP_SERVER_VARS</varname>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.short-open-tag"> - <term> - <parameter>short_open_tag</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive l'utilisation des balises courtes, - (<userinput><? ?></userinput>). Si vous voulez utiliser PHP et XML en même - temps, vous devez désactiver cette option. Si cette option est - désactivée, vous devez utiliser la forme longue des tags, - (<userinput><?php ?></userinput>).</para> - </listitem> - </varlistentry> - <varlistentry id="ini.sql.safe-mode"> - <term> - <parameter>sql.safe_mode</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Aucune documentation n'est fournie. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.track-errors"> - <term> - <parameter>track_errors</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Si cette option est activée, le dernier message d'erreur sera placé dans la - variable globale <symbol>$php_errormsg</symbol>.</para> - </listitem> - </varlistentry> - <varlistentry id="ini.track-vars"> - <term> - <parameter>track_vars</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Si cette option est activée, lors de l'appel des méthodes GET, POST et - l'utilisation des cookies, les variables sont disponibles dans des tableaux - associatifs globaux appelés respectivement <symbol>$HTTP_GET_VARS</symbol>, - <symbol>$HTTP_POST_VARS</symbol> et <symbol>$HTTP_COOKIE_VARS</symbol>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.upload-tmp-dir"> - <term> - <parameter>upload_tmp_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Indique le répertoire utilisé lors du chargement d'un fichier sur un - serveur. Ce répertoire doit être accessible en lecture pour - l'utilisateur qui lance le script PHP. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.user-dir"> - <term> - <parameter>user_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Répertoire oú sont stockés les fichiers PHP dans le - répertoire d'un utilisateur. Par exemple, <literal>public_html</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.warn-plus-overloading"> - <term> - <parameter>warn_plus_overloading</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Si cette option est activée, PHP émet un warning lorsque - l'opérateur plus (<literal>+</literal>) est utilisé sur une - chaîne de caractères. Cela permet de réperer plus - facilement les scripts qui doivent être réécrits en - utilisant l'opérateur de concaténation (<literal>.</literal>) - plutôt que l'opérateur plus. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.mail"> - <title>Configuration des directives concernant le mail</title> - <variablelist> - <varlistentry id="ini.smtp"> - <term> - <parameter>SMTP</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Sous Windows, adresse IP ou nom que PHP doit utiliser pour envoyer - du mail avec la fonction <function>mail</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sendmail-from"> - <term> - <parameter>sendmail_from</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Sous Windows, valeur du champs "From:" qui doit être utilisée lors - de l'envoie de mail. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sendmail-path"> - <term> - <parameter>sendmail_path</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Localisation du programme de <command>sendmail</command>, habituellement - <filename>/usr/sbin/sendmail</filename> ou <filename>/usr/lib/sendmail</filename>. - <command>configure</command> essaye de repérer la présence de sendmail - par lui même, et affecte ce résultat par défaut. En cas de - problème de localisation, vous pouvez établir une nouvelle valeur - par défaut ici. - </para> - <para> - Tout système n'utilisant pas <command>sendmail</command> doit établir cette - directive à la valeur chemin du programme de substitution qui remplace le - serveur de mail, si celui-ci existe, par exemple, - <ulink url="http://www.qmail.org/">Qmail</ulink>. - Dans ce cas la, vous devez mettre: <filename>/var/qmail/bin/sendmail</filename>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.safe-mode"> - <title>Directives de configuration du "Safe Mode"</title> - <variablelist> - <varlistentry id="ini.safe-mode"> - <term> - <parameter>safe_mode</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette directive active ou désactive l'option "safe mode". - Lisez le chapitre <link linkend="security">sécurité </link> pour plus - d'informations. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.safe-mode-exec-dir"> - <term> - <parameter>safe_mode_exec_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Si l'option "SAFE MODE" est activée, <function>system</function> et les - autres fonctions exécutant des programmes systèmes refusent de se lancer - si ces programmes ne sont pas placés dans ce répertoire. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.debugger"> - <title>Directives de configuration de débbugage.</title> - <variablelist> - <varlistentry id="ini.debugger.host"> - <term> - <parameter>debugger.host</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Adresse IP ou nom de l'hôte utilisé pour le déboggage. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.debugger.port"> - <term> - <parameter>debugger.port</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Numéro du port utilisé pour le déboggage. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.debugger.enabled"> - <term> - <parameter>debugger.enabled</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Activation ou désactivation du debugger.</para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.extension"> - <title>Directives de chargement des extensions</title> - <variablelist> - <varlistentry id="ini.enable-dl"> - <term> - <parameter>enable_dl</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette directive n'est réellement utile que dans le cas d'une compilation - comme module Apache. Vous pouvez activer le chargement dynamique des - extensions avec la fonction <function>dl</function>, et cela de manière - locale à chaque serveur virtuel ou à chaque répertoire. - </para> - <para> - La principale raison qui pousse à désactiver le chargement - dynamique est un problème de sécurité. Lorsque le - chargement dynamique est activé, il est possible d'ignorer les - directives <link linkend="ini.safe-mode">safe mode</link> - ou "open_basedir". - </para> - <para> - Par défaut, il est possible d'utiliser le chargement dynamique, sauf - lorsque la directive <link linkend="ini.safe-mode">safe mode</link> est - activée. En effet, il est alors impossible d'utiliser la fonction - <function>dl</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.extension-dir"> - <term> - <parameter>extension_dir</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Définit le répertoire dans lequel le PHP doit chercher les extensions lors - du chargement dynamique. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.extension"> - <term> - <parameter>extension</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Définit les extensions qui doivent être chargées lors du - démarrage du PHP. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.mysql"> - <title>MySQL Configuration Directives</title> - <variablelist> - <varlistentry id="ini.mysql.allow-persistent"> - <term> - <parameter>mysql.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistentes à la base de - données MySQL. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.default-host"> - <term> - <parameter>mysql.default_host</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Adresse par défaut du serveur, à utiliser lors de la connexion à - un serveur MySQL, si aucun hôte n'est spécifié. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.default-user"> - <term> - <parameter>mysql.default_user</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Utilisateur par défaut, à utiliser lors de la connexion à un serveur - MySQL, si aucun utilisateur n'est spécifié. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.default-password"> - <term> - <parameter>mysql.default_password</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Mot de passe par défaut, à utiliser lors de la connexion à un serveur - MySQL, si aucun mot de passe n'est spécifié. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.max-persistent"> - <term> - <parameter>mysql.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de donnée MySQL, - par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.mysql.max-links"> - <term> - <parameter>mysql.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre de connexion maximum à une base de donnée MySQL, - par processus, incluant les connexions persistantes - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.msql"> - <title>Directives de configuration mSQL</title> - <variablelist> - <varlistentry id="ini.msql.allow-persistent"> - <term> - <parameter>msql.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistentes à la base de données mSQL. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.msql.max-persistent"> - <term> - <parameter>msql.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de donnée mSQL, - par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.msql.max-links"> - <term> - <parameter>msql.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de donnée mSQL, - par processus, incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.pgsql"> - <title>Directives de configuration Postgres</title> - <variablelist> - <varlistentry id="ini.pgsql.allow-persistent"> - <term> - <parameter>pgsql.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistantes à la base de - données Postgres. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.pgsql.max-persistent"> - <term> - <parameter>pgsql.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données - Postgres, par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.pgsql.max-links"> - <term> - <parameter>pgsql.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximal de connexions à une base de donnée Postgres, - par processus, incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.sesam"> - <title>Directives de configuration SESAM</title> - <variablelist> - <varlistentry id="ini.sesam-oml"> - <term> - <parameter>sesam_oml</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom de la librairieBS2000 PLAM contenant les pilotes de connexion SESAM. - Obligatoire pour les fonctions SESAM. La librairie BS2000 PLAM - doit être configurée avec ACCESS=READ,SHARE=YES - car elle doit être accessible à l'utilisateur Apache. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sesam-configfile"> - <term> - <parameter>sesam_configfile</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom du fichier de configuration de l'application SESAM. - Obligatoire pour les fonctions SESAM. Le fichier - BS2000 doit être accessible être accessible à l'utilisateur Apache. - </para> - <para> - Le fichier de configuration de l'application va contenir la configuration - sur le schéma suivant (voir le manuel SESAM) : - <informalexample> - <programlisting role="bs2000"> -CNF=B -NAM=K -NOTYPE</programlisting> - </informalexample> - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sesam-messagecatalog"> - <term> - <parameter>sesam_messagecatalog</parameter> - <type>string</type> - </term> - <listitem> - <para> - Nom du catalogue de messages SESAM. Dans la plus part des - cas, cette directive n'est pas nécessaire. Seulement, si - le fichier de messages SESAM n'est pas installé dans la - table de messages BS2000, il faut indiquer sa localisation avec - cette directive. - </para> - <para> - Le catalogue de messages doit être paramétré avec - ACCESS=READ,SHARE=YES car elle doit être accessible à l'utilisateur Apache. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.sybase"> - <title>Directives de configuration Sybase</title> - <variablelist> - <varlistentry id="ini.sybase.allow-persistent"> - <term> - <parameter>sybase.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistentes à la base de données Sybase. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybase.max-persistent"> - <term> - <parameter>sybase.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données Sybase par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybase.max-links"> - <term> - <parameter>sybase.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de données Sybase, par processus, - incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.sybct"> - <title>Sybase-CT Configuration Directives</title> - <variablelist> - <varlistentry id="ini.sybct.allow-persistent"> - <term> - <parameter>sybct.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active ou désactive les connexions persistantes à la base de données - Sybase-CT. Par défaut, cette option est activée. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.max-persistent"> - <term> - <parameter>sybct.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données Sybase-CT par - processus. Par défaut, cette option est à -1, ce qui signifie que le nombre de - connexion est illimité. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.max-links"> - <term> - <parameter>sybct.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de données Sybase-CT, par processus, - incluant les connexions persistantes. Par défaut, cette option est à -1, - ce qui signifie que le nombre de connexions est illimitée. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.min-server-severity"> - <term> - <parameter>sybct.min_server_severity</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Les messages en provenance du serveur d'un niveau d'erreur égal à - sybct.min_server_severity seront considérés comme des alertes (warnings). - Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction - sybase_min_server_severity (NDtraducteur : cette fonction semble ne pas exister). - Par défaut, cette valeur vaut 10. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.min-client-severity"> - <term> - <parameter>sybct.min_client_severity</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Les messages en provenance de la librairie client avec un niveau d'erreur égal - ou supérieur à sybct.min_client_severity seront considérés comme des alertes. - Cette valeur peut être modifiée à l'intérieur du script en appelant la - fonction sybase_min_client_severity (NDtraducteur : cette fonction semble ne pas exister). - Par défaut, cette valeur vaut 10, ce qui annule tout rapport d'erreur. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.login-timeout"> - <term> - <parameter>sybct.login_timeout</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Délai de validité d'une tentative de connexion. Il est à - noter que si max_execution_time est dépassé avant que la connexion - n'éxpire, le script sera terminé avant le message d'erreur. - Par défaut, cette valeur vaut 1 minute. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.timeout"> - <term> - <parameter>sybct.timeout</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Temps maximum en secondes avant qu'une tentative de requête "select_db" ou - "query" non aboutie renvoie une erreur. Il est à noter que si - max_execution_time est dépassé avant que la requête - n'éxpire, votre script sera terminé avant le message d'erreur. - Par défaut, il n'y a pas de limite. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.sybct.hostname"> - <term> - <parameter>sybct.hostname</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Nom de l'hôte à partir duquel vous vous connectez, afin d'être affiché par - la fonction sp_who (NDtraducteur : cette fonction semble ne pas exister). - Par défaut, cette valeur égale à 0. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.informix"> - <title>Directives de configuration Informix</title> - <variablelist> - <varlistentry id="ini.ifx.allow-persistent"> - <term> - <parameter>ifx.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Active les connexions persistantes à une base de données Informix. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.max-persistent"> - <term> - <parameter>ifx.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes à une base de données Informix, - par processus. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.max-links"> - <term> - <parameter>ifx.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions à une base de données Informix par processus, - en incluant les connexions persistantes. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.default-host"> - <term> - <parameter>ifx.default_host</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Hôte par défaut oú se connecter si aucun hôte n'est spécifié par les - fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.default-user"> - <term> - <parameter>ifx.default_user</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Utilisateur par défaut si aucun utilisateur n'est spécifié par les fonctions - <function>ifx_connect</function> ou <function>ifx_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.default-password"> - <term> - <parameter>ifx.default_password</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Mot de passe par défaut si aucun mot de passe n'est spécifié par les fonctions - <function>ifx_connect</function> ou <function>ifx_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.blobinfile"> - <term> - <parameter>ifx.blobinfile</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de type "blob" seront retournées - dans un fichier. Par défaut, elles seront retournées en mémoire. Il est possible - de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_blobinfile_mode</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.textasvarchar"> - <term> - <parameter>ifx.textasvarchar</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de type "TEXT" seront retournées - dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible - de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_textasvarchar</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.byteasvarchar"> - <term> - <parameter>ifx.byteasvarchar</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de type "BYTE" seront retournées - dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. - Il est possible de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_textasvarchar</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.charasvarchar"> - <term> - <parameter>ifx.charasvarchar</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les espaces en fin de chaîne de caractères - seront conservés lors d'une commande FETCH. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.ifx.nullformat"> - <term> - <parameter>ifx.nullformat</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Lorsque cette option est activée, les colonnes de valeur &null; seront retournées - comme des chaînes de caractères vides. - Il est possible de modifier dynamiquement cette valeur grâce à la fonction - <function>ifx_nullformat</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.bcmath"> - <title>Directives de configuration pour les calculs mathématiques.</title> - <variablelist> - <varlistentry id="ini.bcmath.scale"> - <term> - <parameter>bcmath.scale</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre de chiffres après la virgule pour toutes les fonctions de - précision mathématique arbitraire. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.browscap"> - <title>Directives de configuration du navigateur.</title> - <variablelist> - <varlistentry id="ini.browscap"> - <term> - <parameter>browscap</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Nom du fichier de descriptif des clients HTML. - Voir aussi <function>get_browser</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - <sect2 id="ini.sect.uodbc"> - <title>Directives de configuration du driver ODBC unifié</title> - <variablelist> - <varlistentry id="ini.uodbc.default-db"> - <term> - <parameter>uodbc.default_db</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Source de données ODBC à utiliser par défaut avec les fonctions - <function>odbc_connect</function> ou <function>odbc_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.default-user"> - <term> - <parameter>uodbc.default_user</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Nom d'utilisateur défaut avec les fonctions <function>odbc_connect</function> ou - <function>odbc_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.default-pw"> - <term> - <parameter>uodbc.default_pw</parameter> - <type>chaîne de caractères</type> - </term> - <listitem> - <para> - Mot de passe par défaut dans les fonctions <function>odbc_connect</function> ou - <function>odbc_pconnect</function>. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.allow-persistent"> - <term> - <parameter>uodbc.allow_persistent</parameter> - <type>booléen</type> - </term> - <listitem> - <para> - Cette option active ou désactive les connexions persistantes à la base de - données, via le canal ODBC. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.max-persistent"> - <term> - <parameter>uodbc.max_persistent</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions persistantes autorisées à la base de données. - </para> - </listitem> - </varlistentry> - <varlistentry id="ini.uodbc.max-links"> - <term> - <parameter>uodbc.max_links</parameter> - <type>entier</type> - </term> - <listitem> - <para> - Nombre maximum de connexions (persistantes ou non), par processus, - à la base de données. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - </sect1> - </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 -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.13 $ --> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> <title>Le fichier de configuration</title> <simpara> Le fichier de configuration (appelé <filename>php3.ini</filename> dans la version 3.0 du PHP, et simplement <filename>php.ini</filename> dans la version 4.0) est lu par le PHP au démarrage. Si vous avez compilé PHP en module, le fichier n'est lu qu'une seule fois, au lancement du démon <acronym>HTTP</acronym>. Pour la version <acronym>CGI</acronym> le fichier est lu à chaque invocation. </simpara> <para> <example> <title>Extrait du php.ini</title> <programlisting role="ini">; tout texte sur une ligne, situé après un point-virgule ";" est ignoré[php] ; les marqueur de section (texte entre crochets) sont aussi ignorés; Les valeurs booléenne peuvent être spécifiées comme ceci :; true, on, yes; ou false, off, no, noneregister_globals = offmagic_quotes_gpc = yes; vous pouvez placer les chaînes de caractères entre guillemetsinclude_path = ".:/usr/local/lib/php"; Les anti-slash sont traités comme n'importe quel caractèreinclude_path = ".;c:\php\lib"</programlisting><!-- TODO: add more details about values and expressions --> </example> </para> <simpara> Lorsque vous utilisez le module Apache, vous pouvez aussi changer les paramètres de configurations en utilisant les directives dans les fichiers de configuration d'Apache et dans les fichiers <filename>.htaccess</filename>. </simpara> <simpara> Dans la version 3.0, à chaque directive de configuration présente dans le fichier de configuration d'Apache correspond une directive de configuration dans le fichier <filename>php3.ini</filename>, à l'exception des directives préfixées par "php3_". </simpara> <simpara> Dans la version 4.0, il n'y a que quelques directives dans le fichier de configuration d'Apache qui vous permettent de modifier la configuration de PHP. </simpara> <variablelist> <varlistentry> <term> <systemitem role="directive">php_value</systemitem> <parameter>name</parameter> <parameter>value</parameter> </term> <listitem> <para> Cette directive affecte une valeur à la variable spécifiée. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_flag</systemitem> <parameter>name</parameter> <parameter>on|off</parameter> </term> <listitem> <para> Cette directive est utilisée pour activer ou désactiver une option. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_admin_value</systemitem> <parameter>name</parameter> <parameter>value</parameter> </term> <listitem> <para> Cette directive affecte une valeur à la variable spécifiée. La directive "Admin" ne peut être utilisée que dans le fichier de configuration d'Apache, et non dans un fichier <filename>.htaccess</filename>. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_admin_flag</systemitem> <parameter>name</parameter> <parameter>on|off</parameter> </term> <listitem> <para> Cette directive est utilisée pour activer ou désactiver l'option précédente. </para> </listitem> </varlistentry> </variablelist> <para> <example> <title>Exemple de configuration Apache</title> <programlisting role="ini"><IfModule mod_php4.c> php_value include_path ".:/usr/local/lib/php" php_flag safe_mode on</IfModule><IfModule mod_php3.c> php3_include_path ".:/usr/local/lib/php" php3_safe_mode on</IfModule></programlisting> </example> </para> <simpara> Vous pouvez voir l'état de votre configuration en utilisant la fonction <function>phpinfo</function>. Vous pouvez aussi accéder aux valeurs de votre configuration de manière individuelle en utilisant la fonction <function>get_cfg_var</function>. </simpara> <sect2 id="ini.sect.general"> <title>Directives de configuration générale</title> <variablelist> <varlistentry id="ini.allow-url-fopen"> <term> <parameter>allow_url_fopen</parameter> <type>boolean</type> </term> <listitem> <para> Cette option autorise les accès au réseau des fonctions <function>fopen</function>. Par défaut, l'accès est autorisé aux procédures d'<link linkend="features.remote-files">accès distants</link>, avec les protocoles <acronym>FTP</acronym>, <acronym>NNTP</acronym>, et certaines extensions telles ques zlib. </para> <note> <para> Cette option a été introduite immédiatement après la version 4.0.3. Pour les versions jusqu'à 4.0.3 incluse, vous pouvez désactiver cette fonctionnalité au moment de la compilation en utilisant la configuration <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.asp-tags"> <term> <parameter>asp_tags</parameter> <type>booléen</type> </term> <listitem> <para> Active l'utilisation des balises de type ASP <% %>, en plus des traditionnelles balises <?php ?> . Cela inclut l'utilisation du raccourcid <%= $value %>. Pour plus d'informations, reportez-vous à <link linkend="language.basic-syntax.phpmode">inclusion dans le HTML</link>. </para> <note> <para> Le support des balises ASP a été ajouté dans la version 3.0.4. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.auto-append-file"> <term> <parameter>auto_append_file</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Spécifie le nom d'un fichier qui sera automatiquement ajouté après le fichier principal. Le fichier est inclus comme s'il avait été appelé avec la fonction <function>include</function>, donc <link linkend="ini.include-path">include_path</link> est utilisé. </para> <para> Le mot réservé <systemitem class="constant">NONE</systemitem> désactive l'auto-appending. </para> <note> <para> Si le script s'arrête par la fonction <function>exit</function>, auto-append <emphasis>ne fonctionnera pas</emphasis>. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.auto-prepend-file"> <term> <parameter>auto_prepend_file</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Spécifie le nom d'un fichier qui sera automatiquement ajouté avant le fichier principal. Le fichier est inclus comme s'il avait été appelé avec la fonction <function>include</function>, donc <link linkend="ini.include-path">include_path</link> est utilisé. </para> <para> Le mot réservé <systemitem class="constant">NONE</systemitem> désactive l'auto-appending. </para> </listitem> </varlistentry> <varlistentry id="ini.cgi-ext"> <term> <parameter>cgi_ext</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> (NDT : aucune documentation n'est fournie). </para> </listitem> </varlistentry> <varlistentry id="ini.display-errors"> <term> <parameter>display_errors</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive détermine si les erreurs doivent être affichées à l'écran au format HTML ou non. </para> </listitem> </varlistentry> <varlistentry id="ini.doc-root"> <term> <parameter>doc_root</parameter> <type>string</type> </term> <listitem> <para> Le dossier racine de PHP. Cette directive n'est utilisée que si elle est définie. Si PHP est configuré en <link linkend="ini.safe-mode">safe mode</link>, aucun fichier en dehors de ce dossier ne sera accessible. </para> </listitem> </varlistentry> <varlistentry id="ini.engine"> <term> <parameter>engine</parameter> <type>boolean</type> </term> <listitem> <para> Cette directive ne sert vraiment que si PHP est un module Apache. Elle sert aux sites qui veulent activer ou désactiver l'analyse des fichiers par PHP, dossier par dossier. En mettant <userinput>php3_engine off</userinput> au bon endroit, dans le fichier <filename>httpd.conf</filename>, PHP peut être activé ou désactivé. </para> </listitem> </varlistentry> <varlistentry id="ini.error-log"> <term> <parameter>error_log</parameter> <type>string</type> </term> <listitem> <para> Nom du fichier où les erreurs seront enregistrées. Si la valeur spéciale <literal>syslog</literal> est utilisée, les erreurs sont envoyées au système standard d'historique. Sous UNIX, c'est <literal>syslog(3)</literal> et sous Windows NT, c'est l'historique d'événements. L'historique système n'est pas supporté sous Windows 95. </para> </listitem> </varlistentry> <varlistentry id="ini.error-reporting"> <term> <parameter>error_reporting</parameter> <type>integer</type> </term> <listitem> <para> Fixe le niveau d'erreur. Ce paramètre est un entier, représentant un champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau que vous désirez : <table> <title>Niveau de rapport d'erreur</title> <tgroup cols="2"> <thead> <row> <entry>valeur du bit</entry> <entry>niveau choisi</entry> </row> </thead> <tbody> <row> <entry>1</entry> <entry>erreurs normales</entry> </row> <row> <entry>2</entry> <entry>alertes normales</entry> </row> <row> <entry>4</entry> <entry>erreurs d'analyseur (parser errors)</entry> </row> <row> <entry>8</entry> <entry>alertes non critiques</entry> </row> </tbody> </tgroup> </table> Par défaut, la valeur est de 7 (erreurs normales, alertes normales et erreurs d'analyseur sont affichées). </para> </listitem> </varlistentry> <varlistentry id="ini.open-basedir"> <term> <parameter>open_basedir</parameter> <type>string</type> </term> <listitem> <para> Limite l'espace où PHP peut ouvrir des fichiers. </para> <para> Lorsqu'un script essaie d'ouvrir un fichier avec les fonctions fopen ou gzopen (par exemple), la localisation du fichier est vérifiée. Si ce fichier est hors du dossier cité dans cette directive, PHP refusera de l'ouvrir. Tous les liens symboliques sont résolus, et subissent aussi la restriction. </para> <para> La valeur spéciale <systemitem class="constant">.</systemitem> indique que le dossier courant du script est utilisé comme open_basedir. </para> <para> Sous Windows, séparez les noms de dossiers par un point virgule (;). Sur les autres systèmes, séparez les noms de dossiers par des deux points (:). Lorsque PHP est un module Apache, la valeur de la directive <literal>open_basedir</literal> des dossiers parents est automatiquement héritée par les fils. </para> <note> <para> Le support pour les dossiers multiples a été ajouté dans 3.0.7. </para> </note> <para> La valeur par défaut est : libre accès à tous les fichiers. </para> </listitem> </varlistentry> <varlistentry id="ini.gpc-order"> <term> <parameter>gpc_order</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Etablit l'ordre de préséance des méthodes GET/POST/COOKIE. Par défaut, cette directive est établie à "GPC". En affectant "GP" à cette directive, PHP ignorera les cookies, et écrasera toute méthode GET utilisée par une méthode POST avec des variables du même nom. </para> </listitem> </varlistentry> <varlistentry id="ini.ignore-user-abort"> <term> <parameter>ignore_user_abort</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Désactivée par défaut. Si cette directive est activée, alors tous les scripts lancés iront jusqu'à leur terme, même si le client se déconnecte en plein milieu. Voir aussi la fonction <function>ignore_user_abort</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.include-path"> <term> <parameter>include_path</parameter> <type>string</type> </term> <listitem> <para> Spécifie une liste de dossiers, où les fonctions <function>require</function>, <function>include</function> et fopen_with_path() (NDtraducteur : cette fonction semble avoir disparu) iront chercher les fichiers. Le format est le même que celui de la variable d'environnement <envar>PATH</envar> : une liste de dossiers, séparés par des deux points (:) sous UNIX, et par des points virgules (;) sous Windows. <example> <title>UNIX include_path</title> <programlisting role="php3.ini">include_path=.:/home/httpd/php-lib </programlisting> </example> <example> <title>Windows include_path</title> <programlisting role="php3.ini">include_path=".;c:\www\phplib" </programlisting> </example> La valeur par défaut pour cette directive est <literal>.</literal>, c'est-à-dire le dossier courant.</para> </listitem> </varlistentry> <varlistentry id="ini.isapi-ext"> <term> <parameter>isapi_ext</parameter> <type>string</type> </term> <listitem> <para> (Aucune documentation n'est fournie) </para> </listitem> </varlistentry> <varlistentry id="ini.log-errors"> <term> <parameter>log_errors</parameter> <type>boolean</type> </term> <listitem> <para> Indique où les messages d'erreur générés doivent être écrits. Cette fonction est spécifique aux serveurs. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-gpc"> <term> <parameter>magic_quotes_gpc</parameter> <type>boolean</type> </term> <listitem> <para> Fixe le mode magic_quotes pour les opérations GPC (Get/Post/Cookie). Lorsque magic_quotes est activé, tous les caractères ' (guillemets simples), " (guillemets doubles), \ (antislash) et NUL sont échappés avec un antislash. Si magic_quotes_sybase fonctionne aussi, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-runtime"> <term> <parameter>magic_quotes_runtime</parameter> <type>boolean</type> </term> <listitem> <para> Si <parameter>magic_quotes_runtime</parameter> est activé, toutes les fonctions qui obtiennent des données auprès d'une source externe, y compris les bases de données et les fichiers texte, verront leur guillemets échappés avec un antislash. Si <parameter>magic_quotes_sybase</parameter> est aussi activé, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-sybase"> <term> <parameter>magic_quotes_sybase</parameter> <type>boolean</type> </term> <listitem> <para> Si <parameter>magic_quotes_sybase</parameter> est activé, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash, si <parameter>magic_quotes_gpc</parameter> ou <parameter>magic_quotes_runtime</parameter> est activé. </para> </listitem> </varlistentry> <varlistentry id="ini.max-execution-time"> <term> <parameter>max_execution_time</parameter> <type>integer</type> </term> <listitem> <para> Fixe le temps maximal d'éxécution d'un script, en secondes. Cela permet d'éviter que des scripts en boucles infinies saturent le serveur. </para> </listitem> </varlistentry> <varlistentry id="ini.memory-limit"> <term> <parameter>memory_limit</parameter> <type>entier</type> </term> <listitem> <para> Grâce à cette option, vous pouvez donner la quantité maximale de mémoire qu'un script peut allouer. Cela permet de réserver toute la mémoire d'un serveur à un seul script. </para> </listitem> </varlistentry> <varlistentry id="ini.nsapi-ext"> <term> <parameter>nsapi_ext</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Aucune documentation n'est fournie. </para> </listitem> </varlistentry> <varlistentry id="ini.register-globals"> <term> <parameter>register_globals</parameter> <type>boolean</type> </term> <listitem> <para> Cette option active l'enregistrement des variables EGPCS (Environnement, GET, POST, Cookie, Serveur), en tant que variables globales. Vous pouvez désactiver cette fonction si vous ne voulez pas truffer vos scripts avec des valeurs utilisateurs. Cette option est surtout utile lorsqu'elle est utilisée conjointement avec <link linkend="ini.track-vars">track_vars</link> - dans ce cas, vous pouvez accéder à toutes les variables EGPCS grâce aux tableaux <varname>$HTTP_ENV_VARS</varname>, <varname>$HTTP_GET_VARS</varname>, <varname>$HTTP_POST_VARS</varname>, <varname>$HTTP_COOKIE_VARS</varname>, et <varname>$HTTP_SERVER_VARS</varname>. </para> </listitem> </varlistentry> <varlistentry id="ini.short-open-tag"> <term> <parameter>short_open_tag</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive l'utilisation des balises courtes, (<userinput><? ?></userinput>). Si vous voulez utiliser PHP et XML en même temps, vous devez désactiver cette option. Si cette option est désactivée, vous devez utiliser la forme longue des tags, (<userinput><?php ?></userinput>).</para> </listitem> </varlistentry> <varlistentry id="ini.sql.safe-mode"> <term> <parameter>sql.safe_mode</parameter> <type>booléen</type> </term> <listitem> <para> Aucune documentation n'est fournie. </para> </listitem> </varlistentry> <varlistentry id="ini.track-errors"> <term> <parameter>track_errors</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, le dernier message d'erreur sera placé dans la variable globale <symbol>$php_errormsg</symbol>.</para> </listitem> </varlistentry> <varlistentry id="ini.track-vars"> <term> <parameter>track_vars</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, lors de l'appel des méthodes GET, POST et l'utilisation des cookies, les variables sont disponibles dans des tableaux associatifs globaux appelés respectivement <symbol>$HTTP_GET_VARS</symbol>, <symbol>$HTTP_POST_VARS</symbol> et <symbol>$HTTP_COOKIE_VARS</symbol>. </para> </listitem> </varlistentry> <varlistentry id="ini.upload-tmp-dir"> <term> <parameter>upload_tmp_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Indique le répertoire utilisé lors du chargement d'un fichier sur un serveur. Ce répertoire doit être accessible en lecture pour l'utilisateur qui lance le script PHP. </para> </listitem> </varlistentry> <varlistentry id="ini.upload-max-filesize"> <term> <parameter>upload_max_filesize</parameter> <type>entier</type> </term> <listitem> <para> La taille maximale d'un fichier téléchargé sur le serveur. La valeur doit être en octets. Par défaut, elle est de 2 méga-octets. in bytes. </para> </listitem> </varlistentry> <varlistentry id="ini.user-dir"> <term> <parameter>user_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Répertoire où sont stockés les fichiers PHP dans le répertoire d'un utilisateur. Par exemple, <literal>public_html</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.warn-plus-overloading"> <term> <parameter>warn_plus_overloading</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, PHP émet une alerte lorsque l'opérateur plus (<literal>+</literal>) est utilisé sur une chaîne de caractères. Cela permet de réperer plus facilement les scripts qui doivent être réécrits en utilisant l'opérateur de concaténation (<literal>.</literal>) plutôt que l'opérateur plus. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mail"> <title>Directives de configuration concernant le mail</title> <variablelist> <varlistentry id="ini.smtp"> <term> <parameter>SMTP</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Sous Windows, adresse IP ou nom que PHP doit utiliser pour envoyer du mail avec la fonction <function>mail</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.sendmail-from"> <term> <parameter>sendmail_from</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Sous Windows, valeur du champs "From:" qui doit être utilisée lors de l'envoi de mail. </para> </listitem> </varlistentry> <varlistentry id="ini.sendmail-path"> <term> <parameter>sendmail_path</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Localisation du programme de <command>sendmail</command> : habituellement <filename>/usr/sbin/sendmail</filename> ou <filename>/usr/lib/sendmail</filename>. <command>configure</command> essaye de repérer la présence de sendmail par lui-même, et affecte ce résultat par défaut. En cas de problème de localisation, vous pouvez établir une nouvelle valeur par défaut ici. </para> <para> Tout système n'utilisant pas <command>sendmail</command> doit établir cette directive à la valeur chemin du programme de substitution qui remplace le serveur de mail, si celui-ci existe, par exemple, <ulink url="&url.qmail;">Qmail</ulink>. Dans ce cas là, vous devez mettre: <filename>/var/qmail/bin/sendmail</filename>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.safe-mode"> <title>Directives de configuration du "Safe Mode"</title> <variablelist> <varlistentry id="ini.safe-mode"> <term> <parameter>safe_mode</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive active ou désactive l'option "safe mode". Lisez le chapitre <link linkend="security">sécurité </link> pour plus d'informations. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-exec-dir"> <term> <parameter>safe_mode_exec_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Si l'option "SAFE MODE" est activée, <function>system</function> et les autres fonctions exécutant des programmes systèmes refusent de se lancer si ces programmes ne sont pas placés dans ce répertoire. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.debugger"> <title>Directives de configuration de débugage.</title> <variablelist> <varlistentry id="ini.debugger.host"> <term> <parameter>debugger.host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Adresse IP ou nom de l'hôte utilisé pour le débugage. </para> </listitem> </varlistentry> <varlistentry id="ini.debugger.port"> <term> <parameter>debugger.port</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Numéro du port utilisé pour le débugage. </para> </listitem> </varlistentry> <varlistentry id="ini.debugger.enabled"> <term> <parameter>debugger.enabled</parameter> <type>booléen</type> </term> <listitem> <para> Activation ou désactivation du débugueur.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.extension"> <title>Directives de chargement des extensions</title> <variablelist> <varlistentry id="ini.enable-dl"> <term> <parameter>enable_dl</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive n'est réellement utile que dans le cas d'une compilation comme module Apache. Vous pouvez activer le chargement dynamique des extensions avec la fonction <function>dl</function>, et cela de manière locale à chaque serveur virtuel ou à chaque répertoire. </para> <para> La principale raison qui pousse à désactiver le chargement dynamique est un problème de sécurité. Lorsque le chargement dynamique est activé, il est possible d'ignorer les directives <link linkend="ini.safe-mode">safe mode</link> ou "open_basedir". </para> <para> Par défaut, il est possible d'utiliser le chargement dynamique, sauf lorsque la directive <link linkend="ini.safe-mode">safe mode</link> est activée. En effet, il est alors impossible d'utiliser la fonction <function>dl</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.extension-dir"> <term> <parameter>extension_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Définit le répertoire dans lequel le PHP doit chercher les extensions lors du chargement dynamique. </para> </listitem> </varlistentry> <varlistentry id="ini.extension"> <term> <parameter>extension</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Définit les extensions qui doivent être chargées lors du démarrage du PHP. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mysql"> <title>Directives de configuration MySQL</title> <variablelist> <varlistentry id="ini.mysql.allow-persistent"> <term> <parameter>mysql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données MySQL. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-host"> <term> <parameter>mysql.default_host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Adresse par défaut du serveur, à utiliser lors de la connexion à un serveur MySQL, si aucun hôte n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-user"> <term> <parameter>mysql.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Utilisateur par défaut, à utiliser lors de la connexion à un serveur MySQL, si aucun utilisateur n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-password"> <term> <parameter>mysql.default_password</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut, à utiliser lors de la connexion à un serveur MySQL, si aucun mot de passe n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-port"> <term> <parameter>mysql.default_port</parameter> <type>string</type> </term> <listitem> <para> Le numéro de port TCP par défaut, utilisé pour se connecter à la base de données, lorsqu'aucun port n'est spécifié. Si aucun port par défaut est spécifié, le port sera alors obtenu en lisant la variable d'environnement <literal>MYSQL_TCP_PORT</literal>, l'entrée <literal>mysql-tcp</literal> dans le fichier <filename>/etc/services</filename> ou encore la constante de compilation <literal>MYSQL_PORT</literal>, dans cet order. Win32 n'utilisera aussi que la constante <literal>MYSQL_PORT</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-socket"> <term> <parameter>mysql.default_socket</parameter> <type>string</type> </term> <listitem> <para> Le nom par défaut de la socket lorsque l'on se conecte au serveur local, si aucune autre socket n'est spécifiée. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.max-persistent"> <term> <parameter>mysql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données MySQL, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.max-links"> <term> <parameter>mysql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre de connexions maximum à une base de données MySQL, par processus, incluant les connexions persistantes </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.msql"> <title>Directives de configuration mSQL</title> <variablelist> <varlistentry id="ini.msql.allow-persistent"> <term> <parameter>msql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données mSQL. </para> </listitem> </varlistentry> <varlistentry id="ini.msql.max-persistent"> <term> <parameter>msql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données mSQL, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.msql.max-links"> <term> <parameter>msql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données mSQL, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.pgsql"> <title>Directives de configuration Postgres</title> <variablelist> <varlistentry id="ini.pgsql.allow-persistent"> <term> <parameter>pgsql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Postgres. </para> </listitem> </varlistentry> <varlistentry id="ini.pgsql.max-persistent"> <term> <parameter>pgsql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Postgres, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.pgsql.max-links"> <term> <parameter>pgsql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximal de connexions à une base de données Postgres, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sesam"> <title>Directives de configuration SESAM</title> <variablelist> <varlistentry id="ini.sesam-oml"> <term> <parameter>sesam_oml</parameter> <type>string</type> </term> <listitem> <para> Nom de la librairieBS2000 PLAM contenant les pilotes de connexion SESAM. Obligatoire pour les fonctions SESAM. La librairie BS2000 PLAM doit être configurée avec <literal>ACCESS=READ,SHARE=YES</literal>, car elle doit être accessible à l'utilisateur Apache. </para> </listitem> </varlistentry> <varlistentry id="ini.sesam-configfile"> <term> <parameter>sesam_configfile</parameter> <type>string</type> </term> <listitem> <para> Nom du fichier de configuration de l'application SESAM. Obligatoire pour les fonctions SESAM. Le fichier BS2000 doit être accessible être accessible à l'utilisateur Apache. </para> <para> Le fichier de configuration de l'application va contenir la configuration sur le schéma suivant (voir le manuel SESAM) : <informalexample> <programlisting role="bs2000">CNF=BNAM=KNOTYPE</programlisting> </informalexample> </para> </listitem> </varlistentry> <varlistentry id="ini.sesam-messagecatalog"> <term> <parameter>sesam_messagecatalog</parameter> <type>string</type> </term> <listitem> <para> Nom du catalogue de messages SESAM. Dans la plupart des cas, cette directive n'est pas nécessaire. Seulement, si le fichier de messages SESAM n'est pas installé dans la table de messages BS2000, il faut indiquer sa localisation avec cette directive. </para> <para> Le catalogue de messages doit être paramétré avec <literal>ACCESS=READ,SHARE=YES</literal>, car il doit être accessible à l'utilisateur Apache. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sybase"> <title>Directives de configuration Sybase</title> <variablelist> <varlistentry id="ini.sybase.allow-persistent"> <term> <parameter>sybase.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Sybase. </para> </listitem> </varlistentry> <varlistentry id="ini.sybase.max-persistent"> <term> <parameter>sybase.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Sybase par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.sybase.max-links"> <term> <parameter>sybase.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Sybase, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sybct"> <title>Directives de configuration Sybase-CT</title> <variablelist> <varlistentry id="ini.sybct.allow-persistent"> <term> <parameter>sybct.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Sybase-CT. Par défaut, cette option est activée. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.max-persistent"> <term> <parameter>sybct.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Sybase-CT par processus. Par défaut, cette option est à -1, ce qui signifie que le nombre de connexion est illimité. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.max-links"> <term> <parameter>sybct.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Sybase-CT, par processus, incluant les connexions persistantes. Par défaut, cette option est à -1, ce qui signifie que le nombre de connexions est illimité. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.min-server-severity"> <term> <parameter>sybct.min_server_severity</parameter> <type>entier</type> </term> <listitem> <para> Les messages en provenance du serveur d'un niveau d'erreur égal à sybct.min_server_severity seront considérés comme des alertes (warnings). Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction sybase_min_server_severity (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur vaut 10. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.min-client-severity"> <term> <parameter>sybct.min_client_severity</parameter> <type>entier</type> </term> <listitem> <para> Les messages en provenance de la librairie client avec un niveau d'erreur égal ou supérieur à sybct.min_client_severity seront considérés comme des alertes. Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction sybase_min_client_severity (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur vaut 10, ce qui annule tout rapport d'erreur. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.login-timeout"> <term> <parameter>sybct.login_timeout</parameter> <type>entier</type> </term> <listitem> <para> Délai de validité d'une tentative de connexion. Il est à noter que si max_execution_time est dépassé avant que la connexion n'expire, le script sera terminé avant le message d'erreur. Par défaut, cette valeur vaut 1 minute. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.timeout"> <term> <parameter>sybct.timeout</parameter> <type>entier</type> </term> <listitem> <para> Temps maximum en secondes avant qu'une tentative de requête "select_db" ou "query" non aboutie renvoie une erreur. Il est à noter que si max_execution_time est dépassé avant que la requête n'expire, votre script sera terminé avant le message d'erreur. Par défaut, il n'y a pas de limite. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.hostname"> <term> <parameter>sybct.hostname</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom de l'hôte à partir duquel vous vous connectez, afin d'être affiché par la fonction sp_who (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur égale à 0. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.informix"> <title>Directives de configuration Informix</title> <variablelist> <varlistentry id="ini.ifx.allow-persistent"> <term> <parameter>ifx.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active les connexions persistantes à une base de données Informix. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.max-persistent"> <term> <parameter>ifx.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Informix, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.max-links"> <term> <parameter>ifx.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Informix par processus, en incluant les connexions persistantes. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-host"> <term> <parameter>ifx.default_host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Hôte par défaut où se connecter si aucun hôte n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-user"> <term> <parameter>ifx.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Utilisateur par défaut si aucun utilisateur n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-password"> <term> <parameter>ifx.default_password</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut si aucun mot de passe n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.blobinfile"> <term> <parameter>ifx.blobinfile</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "blob" seront retournées dans un fichier. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_blobinfile_mode</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.textasvarchar"> <term> <parameter>ifx.textasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "TEXT" seront retournées dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_textasvarchar</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.byteasvarchar"> <term> <parameter>ifx.byteasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "BYTE" seront retournées dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_textasvarchar</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.charasvarchar"> <term> <parameter>ifx.charasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les espaces en fin de chaîne de caractères seront conservés lors d'une commande FETCH. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.nullformat"> <term> <parameter>ifx.nullformat</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de valeur &null; seront retournées comme des chaînes de caractères vides. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_nullformat</function>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.bcmath"> <title> Directives de configuration pour les calculs mathématiques. </title> <variablelist> <varlistentry id="ini.bcmath.scale"> <term> <parameter>bcmath.scale</parameter> <type>entier</type> </term> <listitem> <para> Nombre de chiffres après la virgule pour toutes les fonctions de précision mathématique arbitraire. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.browscap"> <title>Directives de configuration du navigateur.</title> <variablelist> <varlistentry id="ini.browscap"> <term> <parameter>browscap</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom du fichier de descriptif des clients HTML. Voir aussi <function>get_browser</function>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.uodbc"> <title>Directives de configuration du pilote ODBC unifié</title> <variablelist> <varlistentry id="ini.uodbc.default-db"> <term> <parameter>uodbc.default_db</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Source de données ODBC à utiliser par défaut avec les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.default-user"> <term> <parameter>uodbc.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom d'utilisateur défaut avec les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.default-pw"> <term> <parameter>uodbc.default_pw</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut dans les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.allow-persistent"> <term> <parameter>uodbc.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Cette option active ou désactive les connexions persistantes à la base de données, via le canal ODBC. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.max-persistent"> <term> <parameter>uodbc.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes autorisées à la base de données. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.max-links"> <term> <parameter>uodbc.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions (persistantes ou non), par processus, à la base de données. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mbstring"> <title>Directives de configuration des chaînes mulit-octets</title> <variablelist> <varlistentry id="ini.mbstring.internal-encoding"> <term> <parameter>mbstring.internal_encoding</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.internal_encoding</literal> définit l'encodage interne par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.http-input"> <term> <parameter>mbstring.http_input</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.http_input</literal> définit l'encodage de reception HTTP par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.http-output"> <term> <parameter>mbstring.http_output</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.http_output</literal> définit l'encodage d'affichage HTTP par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.detect-order"> <term> <parameter>mbstring.detect_order</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.detect_order</literal> définit l'ordre de détection des encodages par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.substitute-character"> <term> <parameter>mbstring.substitute_character</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.substitute_character</literal> définit l'encodage de substitution par défaut : il est utilisé pour les caractères invalides. </para> </listitem> </varlistentry> </variablelist> </sect2> </sect1> </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:tsgml-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