Attachment 98253 Details for Bug 149331 – French translation

French translation

php-upgrading-fr.xml (text/plain), 24.35 KB, created by Nicolas Litchinko on 2006-09-27 11:21:20 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Nicolas Litchinko

Created: 2006-09-27 11:21:20 UTC

Size: 24.35 KB

patch

obsolete

><?xml version="1.0" encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="php-upgrading.xml" lang="fr">
><title>Mettre Ã  jour PHP</title>
>
><author title="Author">
>  <mail link="akorthaus@web.de">Andreas Korthaus</mail>
></author>
>
><author title="Translator">
>  <mail link="n.litchinko@noos.fr">Nicolas Litchinko</mail>
></author>
>
><abstract>
>Ce document dÃ©crit la procÃ©dure que les utilisateurs devraient suivre
>pour mettre Ã  jour leur installation de PHP en toute sÃ©curitÃ©.
></abstract>
>
>
>
><license/>
>
><version>1.1</version>
><date>2006-03-19</date>
>
><chapter>
><title>Introduction</title>
><section>
><body>
>
><p>
>Il a Ã©tÃ© demandÃ© de nombreuses fois pourquoi PHP5 n'Ã©tait pas encore marquÃ©
>comme stable dans portage. Le problÃ¨me n'est pas le paquet PHP5 lui-mÃªme&nbsp;;
>la principale raison pour laquelle PHP5 n'est pas encore marquÃ© comme stable est
>qu'il y a beaucoup d'applications, d'extensions de PHP et de paquets dans
>portage qui ne fonctionnent pas avec PHP5 et il n'y a rien que nous ne puissions
>faire pour y remÃ©dier. PHP5 n'est pas compatible Ã  100% avec PHP4 et tous les
>programmes PHP4 ne peuvent Ãªtre ou ne seront pas portÃ©s pour Ãªtre utilisÃ©s avec
>PHP5. Beaucoup d'utilisateurs vont encore avoir besoin du support de PHP4 pour
>un bon moment.
></p>
>
><p>
>La solution Ã  ces problÃ¨mes est de fournir un environnement comportant Ã  la fois
>PHP4 et PHP5. Ce n'Ã©tait toutefois pas possible avec la configuration actuelle
>des paquets et eclasses de PHP&nbsp;; il a donc Ã©tÃ© nÃ©cessaire de mettre
>beaucoup d'efforts dans la mise en place d'une nouvelle configuration, de
>nouvelles eclasses et de nouveaux ebuilds.
></p>
>
><p>
>Ce document explique comment mettre Ã  jour sans dÃ©tÃ©riorer votre systÃ¨me.
></p>
>
><note>
>Les nouveaux paquets PHP nÃ©cessitent la nouvelle configuration d'Apache. Lisez donc
>le guide <uri 
>link="http://www.gentoo.org/doc/fr/apache-upgrading.xml">Mettre Ã  Jour Apache
></uri> si vous ne l'avez pas dÃ©jÃ  fait.
></note>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Changements</title>
><section>
><title>La consolidation des paquets PHP de base</title>
><body>
>
><p>
>Tous les ebuilds de PHP <c>dev-php/php</c>, <c>dev-php/php-cgi</c> et
><c>dev-php/mod_php</c> ont Ã©tÃ© rassemblÃ©s en un seul ebuild&nbsp;:
><c>dev-lang/php</c>. 
></p>
>
><p>
>Pour choisir la SAPI que vous dÃ©sirez, utilisez les USE flags suivants&nbsp;:
></p>
>
><ul>
>  <li><c>cgi</c> - compile &amp; installe <path>/usr/bin/php-cgi</path></li>
>  <li><c>cli</c> - compile &amp; installe <path>/usr/bin/php</path></li>
>  <li><c>apache</c> - compile &amp; installe <c>mod_php</c> pour Apache 1.3 (nouvelle 
>configuration)</li>
>  <li><c>apache2</c> - compile &amp; installe <c>mod_php</c> pour Apache 2.0
>(nouvelle configuration)</li>
></ul>
>
><p>
>Vous pouvez mÃ©langez ces USE flags Ã  ceci prÃ¨s que vous ne pouvez pas activer
><c>apache</c> et <c>apache2</c> en mÃªme temps.
></p>
>
><p>
>Le principal objectif de ces ebuilds est de vous permettre d'avoir PHP4 et
>PHP5 installÃ©s en parallÃ¨le&nbsp;:
></p>
>
><pre caption="installer PHP">
><comment>(installer la derniÃ¨re version de PHP avec les modules CLI et Apache2)</comment>
><i>USE="cli apache2" emerge 'dev-lang/php'</i>
>
><comment>(installer uniquement PHP4)</comment>
><i>USE="cli apache2" emerge '=dev-lang/php-4*'</i>
>
><comment>(installer les deux, PHP4 et PHP5)</comment>
><i>USE="cli apache2" emerge '=dev-lang/php-4*' '=dev-lang/php-5*'</i>
></pre>
>
><note>
>Les USE flags ne devraient pas Ãªtre configurÃ©s de cette faÃ§on. RÃ©fÃ©rez vous au
>fichier <path>/etc/portage/package.use</path> comme expliquÃ© plus loin.
></note>
>  
></body>
></section>
>
><section>
><title>Nouvelles CatÃ©gories Dans Portage</title>
><body>
>
><p>
>Les nouveaux ebuilds de PHP ont Ã©tÃ© dÃ©placÃ©s de <c>dev-php</c> vers
><c>dev-lang/php</c>. Pour permettre d'installer les paquets indÃ©pendamment
>pour PHP4 et PHP5, deux nouvelles catÃ©gories ont Ã©tÃ© introduites dans portage&nbsp;:
><c>dev-php4</c> et <c>dev-php5</c>.
>Ces catÃ©gories sont principalement utilisÃ©es par les paquets PECL comme
><c>pecl-pdo</c>, <c>pecl-apc</c>, <c>php-java-bridge</c> ou <c>xdebug</c>.
></p>
>
><p>
>Pour installer <c>pecl-apc</c>&nbsp;:
></p>
>
><pre caption="installer une extension PHP comme PECL::APC (exemple)">
><comment>(installer APC pour PHP4 uniquement)</comment>
><i>emerge dev-php4/pecl-apc</i>
>
><comment>(installer APC pour PHP5 uniquement)</comment>
><i>emerge dev-php5/pecl-apc</i>
>
><comment>(installer APC pour PHP4 et PHP5)</comment>
><i>emerge dev-php4/pecl-apc dev-php5/pecl-apc</i>
></pre>
>
></body>
></section>
>
><section>
><title>Nouveaux Dossiers</title>
><body>
>
><ul>
>  <li>Ces nouveaux ebuils installent leur content dans <path>/usr/lib/php4</path> 
>et <path>/usr/lib/php5</path> (les modules Apache sont placÃ©s au bon endroit
>pour Apache).</li>
>  <li>Les paquets PEAR et les autres librairies PHP sont installÃ©s dans
><path>/usr/share/php</path> (au lieu de <path>/usr/lib/php</path> auparavant).
></li>
>  <li>Les paquets PECL n'ajouteront plus d'instructions de configuration dans le
>fichier de configuration <path>php.ini</path>, mais ajouteront un fichier
><path>[PAQUET].ini</path> dans le rÃ©pertoire <path>/etc/php/[SAPI]/ext</path>.
></li>
></ul>
>
></body>
></section>
>
><section>
><title>Liens vers les binaires de PHP</title>
><body>
>
><p>
>Si vous installez plus d'une version de PHP, par exemple&nbsp;:
></p>
>
><pre caption="emerge PHP4 et PHP5">
><i>USE="cgi cli apache2" emerge '=dev-lang/php-4*' '=dev-lang/php-5*'</i>
></pre>
>
><p>
>Ces ebuilds vont crÃ©er des liens symboliques dans <path>/usr/bin</path> vers la
>derniÃ¨re version de PHP que vous avez installÃ©, et dans ce cas c'est PHP5 car il
>a Ã©tÃ© installÃ© aprÃ¨s PHP4. Si vous voulez que <path>/usr/bin/php</path> ou
><path>/usr/bin/php-cgi</path> pointe vers PHP4 ou alors l'un vers PHP4 et
>l'autre vers PHP5, etc., vous pouvez <uri link="#doc_chap3_sect5">utilisez
>l'outil php-select</uri> fourni par <c>app-admin/php-toolkit</c>.
><c>php-select</c> rend trÃ¨s simple la modification des liens vers les binaires
>de votre choix.
></p>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Instructions de Mise Ã  Jour</title>
><section>
><title>Trouvez les paquets Ã  mettre Ã  jour</title>
><body>
>
><p>
>Tout d'abord, vous devez dÃ©terminer quels paquets additionnels vous devez mettre
>Ã  jour. Vous pouvez faire cela en utilisant l'outil <c>equery</c>, fourni par le
>paquet <c>app-portage/gentoolkit</c>&nbsp;:
></p>
>
><pre caption="lister les paquets installÃ© depuis dev-php">
>$ <i>equery list 'dev-php/'</i>
>[ Searching for all packages in 'dev-php' among: ]
> * installed packages
>[I--] [  ] dev-php/php-4.4.0 (0)
>[I--] [  ] dev-php/mod_php-4.4.0 (1)
>[I--] [  ] dev-php/smarty-2.6.10 (0)
>[I--] [  ] dev-php/PEAR-PEAR-1.3.5-r1 (0)
>[I--] [  ] dev-php/PEAR-Mail-1.1.6 (0)
>[I--] [  ] dev-php/PEAR-MDB-1.3.0 (0)
>[I--] [  ] dev-php/PECL-apc-3.0.6 (0)
>[I--] [  ] dev-php/PECL-imagick-0.9.11 (0)
>[I--] [  ] dev-php/xdebug-2.0.0_beta3 (0)
></pre>
>
><impo>
>Les paquets que vous avez installÃ© peuvent Ãªtre complÃ¨tement diffÃ©rents, assurez
>vous que vous utilisez cette commande en personne. Vous devriez sauvegarder la
>liste gÃ©nÃ©rÃ©e pour vous assurer de mettre Ã  jour tous les paquets.
></impo>
>
><note>
>De nombreuses applications web ne sont pas affectÃ©es du tout car elles utilisent pour
>la plupart l'eclass webapp qui se charge de les installer correctement. Vous pourriez
>vÃ©rifier qu'il n'existe pas de nouvelle rÃ©vision.
></note>
>
><p>
>Les extensions de PHP comme
></p>
>
><ul>
>  <li><c>PECL-apc</c></li>
>  <li><c>PECL-imagick</c></li>
>  <li><c>xdebug</c></li>
></ul>
>
><p>
>ont Ã©tÃ© sÃ©parÃ©es en 2 catÃ©gories dans portage&nbsp;: <c>dev-php4</c> et
><c>dev-php5</c>. Cela permet de les utiliser indÃ©pendemment avec les deux
>versions de PHP. De plus, la plupart de ces paquets ont Ã©tÃ© renommÃ©s&nbsp;:
></p>
>
><p>
>Exemples de nouveaux dossiers et de changements de noms&nbsp;:
></p>
>
><table>
>  <tr>
>    <th>Extension PHP</th>
>    <th>ancien</th>
>    <th>nouveau pour PHP4</th>
>    <th>nouveau pour PHP5</th>
>  </tr>
>  <tr>
>    <ti>APC</ti>
>    <ti>dev-php/PECL-apc</ti>
>    <ti>dev-php4/pecl-apc</ti>
>    <ti>dev-php5/pecl-apc</ti>
>  </tr>
>  <tr>
>    <ti>Imagick</ti>
>    <ti>dev-php/PECL-imagick</ti>
>    <ti>dev-php4/pecl-imagick</ti>
>    <ti>dev-php5/pecl-imagick</ti>
>  </tr>
>  <tr>
>    <ti>Xdebug</ti>
>    <ti>dev-php/xdebug</ti>
>    <ti>dev-php4/xdebug</ti>
>    <ti>dev-php5/xdebug</ti>
>  </tr>
></table>
>
><note>
>Avant d'installer Ã  nouveau ces extensions, vous devez trouvez dans 
><path>/usr/portage</path> comment ces paquets ont Ã©tÃ© renommÃ©s.
></note>
>
></body>
></section>
>
><section>
><title>Supprimer les Anciens Paquets</title>
><body>
>
><p>
>Nous avons effectuÃ©s de nombreux changements dans le fonctionnement de PHP sous
>Gentoo. Vous devez supprimer complÃ¨tement vos anciens paquets PHP avant
>d'installer les nouveaux paquets&nbsp;:
></p>
>
><pre caption="supprimer les anciens paquets (exemple)">
><comment>(supprimer les paquets PHP)</comment>
><i>emerge --unmerge php mod_php</i>
>
><comment>(supprimer les extensions de PHP)</comment>
><i>emerge --unmerge PECL-apc PECL-imagick xdebug</i>
>
><comment>(suprimer les bibliothÃ¨ques/applications PHP)</comment>
><i>emerge --unmerge PEAR-PEAR PEAR-Mail PEAR-MDB smarty</i>
></pre>
>
></body>
></section>
>
><section>
><title>Configurer les USE flags</title>
><body>
>
><p>
>Comme nous avons ajoutÃ© de nouveaux USE flags, vous dÃ©sirez probablement les
>passer en revue et ajouter les lignes appropriÃ©es Ã 
><path>/etc/portage/package.use</path> (ce fichier doit Ãªtre crÃ©Ã© s'il n'existe
>pas). 
></p>
>
><note>
><path>/etc/portage/package.use</path> va configurer les USE flags pour votre
>installation de PHP et s'en souvenir sans que vous n'ayez Ã  Ã©diter 
><path>make.conf</path>.
></note>
>
><p>
>Veuillez configurer les USE flags en fonction des fonctionnalitÃ©s que vous
>dÃ©sirez intÃ©grer Ã  votre installation de PHP (il est recommandÃ© de dÃ©finir au
>moins l'USE flag <c>cli</c>)&nbsp;:
></p>
>
><pre caption="USE flags pour dev-lang/php (exemple)">
>dev-lang/php -* cli apache2 ctype expat fastbuild ftp gd hash iconv memlimit mysql nls pcre pic pdo reflection session simplexml sockets spl ssl tokenizer truetype unicode xml xsl zlib
></pre>
>
><note>
><c>-*</c> dÃ©sactivera tous les USE flags (ceci dÃ©sactivera Ã©galement les
>plus basiques des fonctionnalitÃ©s de PHP comme le support de Session, PCRE, gd
>ou MySQL&nbsp;!) et vous devez donc prÃ©ciser tous les USE flags relatifs aux
>extensions/fonctions que vous dÃ©sirez utiliser. RÃ©fÃ©rez vous au guide <uri 
>link="http://svn.gnqs.org/projects/gentoo-php-overlay/wiki/ManagingExtensions">
>Managing Extensions</uri> pour de plus amples dÃ©tails. Vous devez dÃ©finir les
>USE flag pour les fonctions par dÃ©faut comme <c>pcre</c> si vous voulez utiliser
>les fonctions <uri
>link="http://svn.gnqs.org/projects/gentoo-php-overlay/wiki/PhpRefPcre">preg_* 
></uri> ou <c>session</c> si vous voulez utiliser les fonctions de <uri 
>link="http://svn.gnqs.org/projects/gentoo-php-overlay/wiki/PhpRefSession">
>gestion de session</uri>. 
></note>
>
><p>
>Si vous dÃ©sirez installer PHP4 et PHP5 en parallÃ¨le, vous pouvez dÃ©finir
>diffÃ©rents USE flags pour chaque version&nbsp;:
></p>
>
><pre caption="diffÃ©rents USE flags pour PHP4 et PHP5 (exemple)">
>=dev-lang/php-4* -* cli cgi apache2 ctype expat fastbuild force-cgi-redirect ftp gd iconv ipv6 memlimit mysql nls pcre pic posix session sockets ssl tokenizer truetype unicode xml xsl zlib
>=dev-lang/php-5* -* cli cgi apache2 ctype fastbuild force-cgi-redirect ftp gd hash iconv ipv6 memlimit mysql nls pcre pic posix pdo reflection session simplexml soap sockets spl sqlite ssl tokenizer truetype unicode xml xmlreader xmlwriter xsl zlib
></pre>
>
><note>
>Pour une liste d'USE flags recommandÃ©s, vous pouvez consulter la <uri 
>link="http://svn.gnqs.org/projects/gentoo-php-overlay/wiki/CommonQuestions#DoYouRecommendAnyUSEFlags">
>liste des USE flags recommandÃ©s</uri>. Pour la liste des USE flags disponibles,
>vous pouvez consulter la <uri 
>link="http://svn.gnqs.org/projects/gentoo-php-overlay/wiki/NewUseFlags">table 
>des USE flags</uri> sur le wiki de l'overlay.
></note>
>
></body>
></section>
>
><section>
><title>Installer PHP</title>
><body>
>
><p>
>Maintenant vous avez le choix d'installer uniquement PHP4, uniquement PHP5 ou
>les deux en parallÃ¨le. Pour installer PHP4, vous n'avez qu'Ã  installer
><c>=dev-lang/php-4*</c>&nbsp;; pour installer PHP5 (la derniÃ¨re version), vous
>pouvez utiliser <c>dev-lang/php</c>&nbsp;; et pour installer les deux en
>parallÃ¨le, vous devez installer <c>=dev-lang/php-4*</c> et
><c>=dev-lang/php-5*</c>.
></p>
>
><p>
>VÃ©rifier les USE flag&nbsp;:
></p>
>
><pre caption="vÃ©rifier les USE flags (exemple)">
><comment>(vÃ©rifier le paquet PHP4)</comment>
><i>emerge --pretend --verbose '=dev-lang/php-4*'</i>
>
><comment>(vÃ©rifier le paquet PHP5)</comment>
><i>emerge --pretend --verbose '=dev-lang/php-5*'</i>
>
><comment>(vÃ©rifier les extensions pour PHP4)</comment>
><i>emerge --pretend --verbose dev-php4/pecl-apc dev-php4/pecl-imagick dev-php4/xdebug</i>
>
><comment>(vÃ©rifier les extensions pour PHP5)</comment>
><i>emerge --pretend --verbose dev-php5/pecl-apc dev-php5/pecl-imagick</i>
>
><comment>(vÃ©rifier les bibliothÃ¨ques/applicaions PHP)</comment>
><i>emerge --pretend --verbose PEAR-PEAR PEAR-Mail PEAR-MDB smarty</i>
></pre>
>
><p>
>Installez PHP si tout est correct&nbsp;:
></p>
>
><pre caption="installer les nouveaux paquets (exemple)">
><comment>(installer le paquet PHP4)</comment>
><i>emerge '=dev-lang/php-4*'</i>
>
><comment>(installer le paquet PHP5)</comment>
><i>emerge '=dev-lang/php-5*'</i>
>
><comment>(installer les extensions pour PHP4)</comment>
><i>emerge dev-php4/pecl-apc dev-php4/pecl-imagick dev-php4/xdebug</i>
>
><comment>(installer les extensions pour PHP5)</comment>
><i>emerge dev-php5/pecl-apc dev-php5/pecl-imagick</i>
>
><comment>(installer les bibliothÃ¨ques/applications PHP)</comment>
><i>emerge PEAR-PEAR PEAR-Mail PEAR-MDB smarty</i>
></pre>
>
></body>
></section>
>
><section>
><title>PHP4 et PHP5 en parallÃ¨le&nbsp;: sÃ©lectionner l'application utilisÃ©e par
>cli/cgi</title>
><body>
>
><p>
>Une fois l'installation terminÃ©e, vous aurez des applications pour <c>cli</c>
>(N.d.t. ligne de commande) et/ou <c>cgi</c> dans <path>/usr/lib/php4/bin</path>
>et/ou <path>/usr/lib/php5/bin</path>. Si vous avez installÃ© PHP4 et PHP5,
>portage ne peut pas dÃ©cider pour vous lequel doit Ãªtre utilisÃ© par dÃ©faut et
>crÃ©e toujour un lien symbolique vers la derniÃ¨re version de PHP que vous avez
>installÃ© dans <path>/usr/bin</path>. Par consÃ©quent, si vous avez installÃ© PHP5
>en dernier, <path>/usr/bin/php</path> pointera vers
><path>/usr/lib/php5/bin/php</path>.
>Par consÃ©quent, des liens symboliques (dans <path>/usr/bin</path>) doivent
>pointer vers les applications <c>cli</c> et/ou <c>cgi</c> ainsi que
><c>php-devel</c> (responsable de la creÃ©ation des extensions PHP Ã  l'aide de
><c>phpize</c> et <c>php-config</c>). Ceci peut Ãªtre effectuÃ© facilement en
>utilisant <c>php-select</c> qui fait partie du paquet
><c>app-admin/php-toolkit</c>.
></p>
>
><note>
>Les paquets <c>dev-lang/php</c> dÃ©pendent d'<c>app-admin/php-toolkit</c>. Par
>consÃ©quent <c>php-select</c> devrait Ãªtre disponible automatiquement aprÃ¨s avoir
>installÃ© les nouveaux paquets PHP.
></note>
>
><p>
>ConsidÃ©rant que vous avez installÃ© <c>=dev-lang/php-4*</c> et
><c>=dev-lang/php-5*</c>, utilisez <c>php-select</c> et les commandes suivantes
>pour afficher les versions de PHP actuellement sÃ©lectionnÃ©es&nbsp;:
></p>
>
><pre caption="afficher les versions de PHP actuellement installÃ©es">
><comment>(pour cli)</comment>
><i>php-select php</i>
>
><comment>(pour cgi)</comment>
><i>php-select php-cgi</i>
>
><comment>(pour phpize, php-config)</comment>
><i>php-select php-devel</i>
></pre>
>
><p>
>Le rÃ©sultat devrait ressembler Ã  ceci&nbsp;:
></p>
>
><pre caption="exemple de rÃ©sultat de php-select">
># <i>php-select php</i>
>/usr/bin/php is set to /usr/lib/php5/bin/php
></pre>
>
><p>
>Ceci signifie que <path>/usr/bin/php</path>, chemin par dÃ©faut vers
>l'application cli de PHP pointe sur l'application PHP5
><path>/usr/lib/php5/bin/php</path>. Par consÃ©quent les scripts PHP utilisant
><path>/usr/bin/php</path> seront exÃ©cutÃ©s par PHP5.
></p>
>
></body>
></section>
>
><section>
><title>Utiliser php-select pour modifier les versions de PHP par dÃ©faut</title>
><body>
>
><p>
>Si vous n'Ãªtes pas satisfait de la configuration que vous avez dÃ©couverte au
>chapitre prÃ©cÃ©dent, vous pouvez utiliser <c>php-select</c> Ã  nouveau pour
>sÃ©lÃ©ctioner la version que vous voulez&nbsp;:
></p>
>
><pre caption="sÃ©lectionner la version dÃ©sirÃ©e">
><comment>(pour cli)</comment>
><i>php-select php php4</i>
>
><comment>(pour cgi)</comment>
><i>php-select php-cgi php5</i>
>
><comment>(pour phpize, php-config)</comment>
><i>php-select php-devel php5</i>
></pre>
>
><note>
>Vous pouvez utiliser <c>php-select -h</c> pour obtenir plus de dÃ©tails sur les
>possibilitÃ©s de <c>php-select</c>.
></note>
>
><p>
>VÃ©rifier les liaisons&nbsp;:
></p>
>
><pre caption="vÃ©rifier les liens symboliques">
> # <i>stat /usr/bin/php /usr/bin/php-cgi /usr/bin/phpize /usr/bin/php-config | grep File</i>
> File: `/usr/bin/php' -> `/usr/lib/php4/bin/php'
> File: `/usr/bin/php-cgi' -> `/usr/lib/php5/bin/php-cgi'
> File: `/usr/bin/phpize' -> `/usr/lib/php5/bin/phpize'
> File: `/usr/bin/php-config' -> `/usr/lib/php5/bin/php-config'
></pre>
>
><note>
>Veuillez noter que <c>php-select</c> ne modifie que les versions par dÃ©faut. Si
>vous avez installÃ© PHP4 et PHP5 cgi/cli, vous pouvez toujours utiliser les
>chemins directs que sont <path>/usr/lib/php4/bin/php</path> et
><path>/usr/lib/php5/bin/php</path> pour exÃ©cuter des scripts PHP Ã  l'aide d'une
>version spÃ©cifique. Vous pouvez utiliser PHP4 et PHP5 cgi dans la mÃªme instance
>d'Apache, mais vous ne pouvez pas utiliser deux modules PHP pour Apache
>diffÃ©rents dans une seule instance d'Apache&nbsp;; rÃ©fÃ©rez vous au <uri
>link="php4-php5-configuration.xml">Guide de Configuration de PHP4 et PHP5</uri>
>pour plus de dÃ©tails.
></note>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Migration des fichiers de configuration</title>
><section>
><body>
>
><p>
>Le paquet PHP pour Gentoo place la configuration dans <path>/etc/php</path>, qui
>contient un sous-dossier pour chaque SAPI pour chaque version de PHP&nbsp;:
></p>
>
><pre caption="contenu des dossiers de configuration de PHP">
>$ <i>ls -1 /etc/php</i>
>apache2-php4
>apache2-php5
>cli-php4
>cli-php5
></pre>
>
><p>
>Chaque sous-dossier contient son propre <path>php.ini</path>, comme les anciens
>paquets.
></p>
>
></body>
></section>
>
><section>
><title>Modifications dans php.ini</title>
><body>
>
><p>
>Vous devriez utiliser <c>etc-update</c> ou <c>dispatch-conf</c> et vÃ©rifier les
>diffÃ©rences entre vos anciens et vos nouveaux paramÃ¨tres dans
><path>php.ini</path>. Les deux directives que vous devez absolument vÃ©rifier
>sont <c>include_path</c> et <c>extension_dir</c>. Toutefois, soyez prudent, 
><c>extension_dir</c> est modifiÃ© entre les diffÃ©rentes versions de PHP (y
>compris entre les versions 5.0 et 5.1&nbsp;!).
></p>
>
><p>
>Exemple pour PHP 5.1 dans <path>/etc/php/apache2-php5/php.ini</path> et 
><path>/etc/php/cli-php5/php.ini</path>&nbsp;:
></p>
>
><pre caption="anciens paramÃ¨tres dans php.ini">
>include_path = ".:/usr/lib/php"
>extension_dir = "/usr/lib/php/extensions/no-debug-non-zts-20050617/"
></pre>
>
><pre caption="nouveaux paramÃ¨tres dans php.ini">
>include_path = ".:/usr/share/php"
>extension_dir = "/usr/lib/php5/lib/php/extensions/no-debug-non-zts-20050617/"
></pre>
>
><warn>
>Assurez vous d'utiliser <c>etc-update</c> ou <c>dispatch-conf</c> pour
>visualiser les paramÃ¨tres corrects pour chaque fichier.
></warn>
>
></body>
></section>
>
><section>
><title>Changements dans la configuration des extensions de PHP</title>
><body>
>
><p>
>Le nouveau paquet PHP ne stoque plus les directives de configuration des
>extensions externes (partagÃ©es) de PHP dans <path>php.ini</path>. Ces
>directives sont maintenant stoquÃ©es dans des fichiers de configuration
>spÃ©cifiques Ã  l'extension dans les dossiers <path>/etc/php/*/ext</path>.
>Pour activer/dÃ©sactiver les extensions partagÃ©es, les liens symboliques situÃ©s
>dans <path>/etc/php/*/ext-active</path> sont utilisÃ©s. Si vous voulez activer
>une extension, crÃ©ez un lien symbolique dans <path>/etc/php/*/ext-active</path>
>pointant vers le fichier <path>[EXTENSION].ini</path> correspondant dans 
><path>/etc/php/*/ext/</path>. Si vous voulez dÃ©sactiver une extension, supprimer
>le lien symbolique.
></p>
>
><p>
>Si vous avez installÃ© <c>dev-php/PECL-apc</c> auparavant, la configuration
>d'APC est stoquÃ©e dans votre <path>php.ini</path>. Si vous rÃ©installez le
>nouveau paquet <c>dev-php5/pecl-apc</c>, la configuration par dÃ©faut d'APC sera
>placÃ©e dans <path>/etc/php/*5/ext/apc.ini</path>.
></p>
>
><p>
>Vous devez donc dÃ©placer les directives de configuration d'APC de 
><path>/etc/php/*5/php.ini</path> vers <path>/etc/php/*5/ext/apc.ini</path> et
>crÃ©er un lien symbolique depuis <path>/etc/php/*5/ext-active/apc.ini</path> vers
><path>/etc/php/*5/ext/apc.ini</path>.
></p>
>
><note>
>Si vous installez PHP en tant que module d'Apache, assurez vous de redÃ©marrer
>Apache aprÃ¨s l'installation et la configuration.
></note>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Configurer Apache pour utiliser PHP4 et/ou PHP5</title>
><section>
><body>
>
><p>
>Pour configurer Apache pour charger le module PHP4 ou PHP5 (mod_php), vous devez
>ajouter la directive <c>-D PHP4</c> ou <c>-D PHP5</c> Ã  la variable
><c>APACHE2_OPTS</c> dans <path>/etc/conf.d/apache2</path>.
></p>
>
><pre caption="Configurer Apache pour charger mod_php">
><comment>(options pour PHP4)</comment>
><i>APACHE2_OPTS="-D PHP4"</i>
>
><comment>(ou options pour PHP5)</comment>
><i>APACHE2_OPTS="-D PHP5"</i>
></pre>
>
><p>
>Il y a de nombreuses faÃ§ons de configurer Apache pour utiliser les deux versions
>de PHP en parallÃ¨le. La plus simple est d'utiliser PHP4 et PHP5 en tant
>qu'application cgi, ou bien PHP4 en tant que cgi et PHP5 en tant que module (ou
>bien l'inverse). Il n'est pas possible d'utiliser le module PHP4 et le module
>PHP5 dans une seule instance d'Apache.
></p>
>
><p>
>Nous avons crÃ©Ã© un <uri link="php4-php5-configuration.xml">Guide de
>Configuration de PHP4 et PHP5</uri> qui explique certaines des solutions
>envisageables.
></p>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Support / Obtenir de l'Aide</title>
><section>
><body>
>
><p>
>Si vous rencontrez des problÃ¨mes avec les nouveaux paquets PHP de Gentoo, voici
>les moyens que vous avez d'obtenir de l'aide&nbsp;:
></p>
>
><ul>
>  <li><uri 
>link="http://svn.gnqs.org/projects/gentoo-php-overlay/wiki/CommonQuestions">
>Questions Courantes</uri> Ã  propos de PHP sous Gentoo</li>
>  <li><uri 
>link="http://svn.gnqs.org/projects/gentoo-php-overlay">Page de Development de 
>l'Overlay PHP</uri></li>
>  <li>#gentoo-php sur irc.freenode.net&nbsp;; c'est le salon de discussion oÃ¹
>les auteurs rÃ©guliers de l'overlay se retrouvent. Votre visite nous fera
>plaisir&nbsp;!</li>
>  <li><uri link="http://forums.gentoo.org/">Les Forums Gentoo</uri> sont un
>endroit populaire oÃ¹ vous pouvez demander de l'aide. Il y a de nombreux autres
>utilisateurs de Gentoo qui lisent les Forums tout au long de la journÃ©e, ce qui
>en fait un excellent endroit pour demander de l'aide en urgence.</li>
></ul>
>
><p>
>Pour des dÃ©tails Ã  propos de l'implÃ©mentation des nouveaux paquets, vous pouvez
>consulter les <uri 
>link="http://article.gmane.org/gmane.linux.gentoo.devel/30050">e-mails de Stuart 
>sur gentoo-dev</uri> et les entrÃ©es dans le Blog de Stuart Ã  partir de <uri 
>link="http://stu.gnqs.org/diary/gentoo.php/2005/07/11/radical_changes_for_php5_support">
>'Radical Changes for PHP5 Support'</uri> (N.d.t. 'Changements Radicaux pour le
>Support de PHP5'). 
></p>
>
><p>
>Sur la <uri 
>link="http://svn.gnqs.org/projects/gentoo-php-overlay">Page de Development</uri> 
>vous trouverez beaucoup de documentation et des ebuilds plus rÃ©cents qui seront
>intÃ©grÃ©s dans l'arbre de portage officiel plus tard.
></p>
>
></body>
></section>
></chapter>
>
></guide>

Actions: View

Attachments on bug 149331: 98253