cvs: phpdoc-fr /install pecl.xml

From: Date: Mon, 08 Dec 2008 21:17:07 +0000
Subject: cvs: phpdoc-fr /install pecl.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6151@lists.php.net to get a copy of this message
dams Mon Dec 8 21:17:07 2008 UTC Modified files: /phpdoc-fr/install pecl.xml Log: synch with 23

http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/pecl.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/install/pecl.xml diff -u phpdoc-fr/install/pecl.xml:1.21 phpdoc-fr/install/pecl.xml:1.22 --- phpdoc-fr/install/pecl.xml:1.21 Sun Jun 8 15:10:24 2008 +++ phpdoc-fr/install/pecl.xml Mon Dec 8 21:17:07 2008 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <chapter xml:id="install.pecl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Installation d'extensions PECL</title> @@ -45,6 +45,11 @@ Il existe plusieurs méthodes pour télécharger des extensions PECL : </simpara> <itemizedlist> + <simpara> + La commande <literal>pecl install extname</literal> télécharge le code + des extensions automatiquement, ce qui évite de réaliser + un téléchargement particulier. + </simpara> <listitem> <simpara> <link xlink:href="&url.pecl;">&url.pecl;</link> @@ -102,21 +107,180 @@ </sect1> <sect1 xml:id="install.pecl.windows"> - <title>PECL sur Windows</title> - <simpara> - Comme pour toute extension PHP <acronym>DLL</acronym>, - l'installation est aussi simple que de copier la bibliothèque DDL de l'extension PECL dans - le dossier <link linkend="ini.extension-dir">extension_dir</link> et de la charger - dans le &php.ini;. Par exemple, ajoutez la ligne suivante dans votre &php.ini; : - </simpara> + <title>Installer une extension PHP</title> + <para> + Sur Windows, vous avez deux moyens de charger une extension PHP : + soit vous la compiler dans PHP, soit vous chargez une DLL. Charger une + extension précompilée est la méthode la plus pratique et la plus recommandée. + </para> <para> - <screen> -extension=php_extname.dll - </screen> + Pour charger une extension, vous devez disposer de son fichier ".dll" sur votre système. + Toutes les extensions sont automatiquement et périodiquement compilée par le groupe PHP + (voyez la section de téléchargements). </para> - <simpara> - Après cela, relancez le service Web. - </simpara> + <para> + Pour compiler une extension dans PHP, reportez-vous à la + documentation sur <link linkend="install.windows.building"> + la compilation des sources</link>. + </para> + <para> + Pour compiler une extension autonome, (c'est-à-dire un fichier DLL), reportez-vous + documentation sur <link linkend="install.windows.building"> + la compilation des sources</link>. Si le fichier DLL est absent de votre distribution + PHP et de PECL, il vous faudra la compiler avant de pouvoir l'utiliser. + </para> + </sect1> + + <sect1 xml:id="install.pecl.windows.find"> + <title>Où trouver une extension?</title> + <para> + Les extensions PHP sont généralement appelées "php_*.dll" (où les astérisques + représentent le nom de l'extension) et elles sont rangées dans le dossier + "PHP\ext" ("PHP\extensions" en PHP4). + </para> + <para> + PHP est livré avec les extensions qui sont le plus utiles à la majorité des utilisateurs. + Elles sont appelées des extensions coeur, ou "core". + </para> + <para> + Cependant, si vous avez besoins de fonctionnalités qui ne sont pas fournies par + une extension coeur, vous pourriez quand même les trouver dans PECL. Le + PHP Extension Community Library (PECL, aussi dit Bibliothèque d'Extensions Communautaires de PHP) + est un dépôt de code pour les extensions PHP, qui fournit un annuaire de toutes les + extensions connues, et un service d'hébergement pour télécharger et + développer ces extensions. + </para> + <para> + Si vous avez développé une extension pour votre propre usage, vous pourriez avoir envie + de l'héberger sur PECL, pour que tous ceux qui ont eu le même problème que vous puisse + avoir accès à la même solution. Cela vous donne de bonnes chances d'avoir des retours + de la communauté, et, peut-être, des remerciements, des rapports de bugs, et même des + correctifs. Avant que vous n'envoyez votre extension sur les serveurs PECL, il est + recommandé de lire &url.pecl.submit;. + </para> + + <sect2 xml:id="install.pecl.windows.which"> + <title>Quelles extensions télécharger?</title> + <para> + <emphasis>Souvent, vous trouverez plusieurs versions de chaque DLL : </emphasis> + <itemizedlist> + <listitem> + <simpara> + Différents numéros de versions (au moins, les deux premiers chiffres doivent être les mêmes) + </simpara> + </listitem> + <listitem> + <simpara> + Différentes configurations de sécurité de threads + </simpara> + </listitem> + <listitem> + <simpara> + Différentes configurations de processeurs (x86, 64 bits...) + </simpara> + </listitem> + <listitem> + <simpara> + Différentes configurations de débogage + </simpara> + </listitem> + <listitem> + <simpara> + <literal>etc.</literal> + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Il est recommandé de choisir les extensions pour qu'elles soient adaptées + à la machine serveur sur laquelle vous utilisez PHP. Le script suivant + va vous afficher <emphasis>toutes</emphasis> vos configurations PHP : + <screen> +<![CDATA[ +<?php +phpinfo(); +?> +]]> + </screen> + </para> + <para> + Ou bien, en ligne de commande : + <screen> +<![CDATA[ +drive:\\path\to\php\executable\php.exe -i +]]> + </screen> + </para> + </sect2> + + <sect2 xml:id="install.pecl.windows.loading"> + <title>Charger une extension</title> + <para> + Le moyen le plus courant pour charger une extension PHP est de l'inclure dans votre + fichier de configuraiton <filename>php.ini</filename>. Notez que de nombreuses extensions + sont déjà présentes dans le fichier <filename>php.ini</filename> et que vous avez + simplement à supprimer le point-virgule pour les activer. + <screen> +<![CDATA[ +;extension=php_extname.dll +]]> + </screen> + <screen> +<![CDATA[ +extension=php_extname.dll +]]> + </screen> + </para> + <para> + Cependant, certains serveurs Web sont déroutants, car ils n'utilisent pas le fichier + <filename>php.ini</filename> rangé avec votre exécutable PHP. Pour en savoir plus sur votre véritable + <filename>php.ini</filename>, recherchez son dossier dans le fichier + <function>phpinfo</function>: + <screen> +<![CDATA[ +Configuration File (php.ini) Path C:\WINDOWS +]]> + </screen> + <screen> +<![CDATA[ +Loaded Configuration File C:\Program Files\PHP\5.2\php.ini +]]> + </screen> + </para> + <para> + Après activation d'une extension, sauvez le fichier <filename>php.ini</filename>, et + relancez le serveur Web, puis vérifiez à nouveau le fichier <function>phpinfo</function>. + La nouvelle extension devrait y avoir sa section. + </para> + </sect2> + + <sect2 xml:id="install.pecl.windows.problemsolving"> + <title>Résolution de problèmes</title> + <para> + Si l'extension n'apparaît pas dans le fichier <function>phpinfo</function>, + vous devriez jeter un oeil dans les logs pour savoir d'où vient le problème. + </para> + <para> + Si vous utilisez PHP en ligne de commande (CLI), l'erreur de chargement de l'extension + devrait être lisible directement sur l'écran. + </para> + <para> + Si vous utilisez PHP sur un serveur Web, la position et le format des logs + varient grandement d'un serveur à l'autre. Lisez la documentation de votre + serveur Web pour savoir où ils sont : PHP ne peut pas vous aider pour cela. + </para> + <para> + Les problèmes les plus courants sont la localisation du fichier DLL, + la valeur de la directive "<link linkend="ini.extension-dir">extension_dir</link>" + dans le <literal>php.ini</literal> et les incohérences de compilations. + </para> + <para> + Si le problème est une incohérence de compilation, vous avez probablement téléchargé + une mauvaise DLL. Essayez d'en charger une nouvelle, avec les bonnes configurations pour + votre serveur. <function>phpinfo</function> vous sera alors très utile. + </para> + </sect2> + </sect1> <sect1 xml:id="install.pecl.pear">
« previous php.doc.fr (#6151) next »