cvs: peardoc /fr/chapters intro.xml
| From: | Christophe Gesch� | Date: | Mon, 11 Jul 2005 07:08:41 +0000 |
| Subject: | cvs: peardoc /fr/chapters intro.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-6499@lists.php.net to get a copy of this message | ||
moosh Mon Jul 11 03:08:41 2005 EDT
Modified files:
/peardoc/fr/chapters intro.xml
Log:
-sync to EN1.13
*1.11 Synced the information about the PFC with the reality.
* 1.12 added chapter titles
* 1.13 reverting duplicate <title> tags -- sorry
http://cvs.php.net/diff.php/peardoc/fr/chapters/intro.xml?r1=1.9&r2=1.10&ty=u Index: peardoc/fr/chapters/intro.xml diff -u peardoc/fr/chapters/intro.xml:1.9 peardoc/fr/chapters/intro.xml:1.10 --- peardoc/fr/chapters/intro.xml:1.9 Sun Jun 12 02:24:57 2005 +++ peardoc/fr/chapters/intro.xml Mon Jul 11 03:08:40 2005 @@ -1,306 +1,238 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.10 Maintainer: moosh Status: ready --> - <chapter id="introduction"> - <chapterinfo> - <author> - <firstname>Stig</firstname> - <surname>Bakken</surname> - </author> - <date>2002-02-10</date> - </chapterinfo> - <title>Introduction</title> - <subtitle>The PEAR Manifest</subtitle> - <simpara> - PEAR est dédié à Malin Bakken, - né le 21 Novembre 1999. - </simpara> - - <sect1 id="about.pear"> - <title>Qu'est-ce que PEAR ?</title> - +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.13 Maintainer: moosh Status: ready --> +<chapter id="introduction"> + <chapterinfo> + <author> + <firstname>Stig</firstname> + <surname>Bakken</surname> + </author> + <date>2002-02-10</date> + </chapterinfo> + <title>Introduction</title> + <subtitle>The PEAR Manifest</subtitle> + <simpara> + PEAR est dédié à Malin Bakken, + né le 21 Novembre 1999. + </simpara> + + <sect1 id="about.pear"> + <title>Qu'est-ce que PEAR ?</title> + + <para> + PEAR est l'abbréviation de + <quote> + PHP Extension and Application Repository + </quote> + et se prononce 'père' + (NDT : pear veut dire poire en Anglais). + + La mission de PEAR est de fournir : + <itemizedlist> + <listitem> + <simpara> + Une librairie structurée de code source libre + pour les utilisateurs de PHP + </simpara> + </listitem> + <listitem> + <simpara> + Un système de distribution du code source et de maintenance des + packages (modules) + </simpara> + </listitem> + <listitem> + <simpara> + Un style de codage pour les programmes écrit en PHP, + spécifié <link linkend="standards">là</link> + </simpara> + </listitem> + <listitem> + <simpara> + Une bibliothèque d'extensions de PHP + (PECL - PHP Extension Code Library), + <link linkend="about-pecl">voir détails ci-dessous</link> + </simpara> + </listitem> + <listitem> + <simpara> + Un site Web, des listes de diffusion et des sites mirroirs pour + supporter la communauté PHP/PEAR + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + PEAR est un projet comunautaire conduit par le + <ulink url="&url.pear.group;">Groupe PEAR</ulink>. + Le projet a été créé + par Stig S. Bakken en 1999 et + <ulink url="&url.pear.account;">beaucoup de + personnes</ulink> l'ont rejoint depuis. + </para> + <sect2 id="about-pear-stlib"> + <title>Bibliothèque structurée de code PHP</title> + <para> + Dans PEAR, le code est séparé en + <quote>packages</quote> (ou modules). + + Chaque package est un projet séparé, + avec sa propre équipe de développement, + son numéro de version, son cycle de publication, + sa documentation et une relation bien définie + avec les autres packages + (incluant les dépendances vis-à-vis d'autres packages). + + Les packages sont distribués sous la forme d'une archive tar + compressée (gzip), + comprenant un fichier de description du package, + et sont installés + sur votre système local à + l'aide du script d'installation de PEAR. + </para> <para> - PEAR est l'abbréviation de - <quote> - PHP Extension and Application Repository - </quote> - et se prononce 'père' - (NDT : pear veut dire poire en Anglais). + Il existe deux types de packages : les <quote>source packages</quote>, + qui ne contiennent que des fichiers de code source, et les + <quote>binary packages</quote>, + qui contiennent des fichiers binaires, dépendant du type + de système utilisé, + et eventuellement les fichiers de code source. - La mission de PEAR est de fournir : + Installer un <quote>source package</quote> contenant du code C, + demande evidemment un environnement de compilation. + </para> + <para> + PEAR definit les packages comme une arborescence, où chaque + <quote>noeud</quote> + de l'arborescence est représenté + par une partie du nom du package. + + Les noeuds sont organisés par sujets + élémentaires, et chaque partie + est séparée par un <quote>underscore</quote>. + + Exemples de noms de packages : + <quote>MP3_Id</quote>, + <quote>Archive_Tar</quote> + et <quote>HTTP_Post</quote>. + </para> + <para> + Les packages peuvent être liés entre eux par + des dépendances explicites, + mais il n'y a pas de relation automatique par exemple + entre un package et son parent dans l'arborescence + (par exemple, + <quote>HTTP_Post</quote> et par défaut indépendant de + <quote>HTTP</quote>). + </para> + <para> + Quelques noeuds primaires dans l'arborescence, appelés + <quote>sous-repositaires</quote>, ont des fonctions particulières. + + Il s'agit actuellement de + <link linkend="about-pecl">PECL</link>, + et <link linkend="about-gtk">Gtk</link>. + + Pour chacun d'eux des règles différentes s'appliquent, + elles sont expliquées dans leur description ci-dessous. + </para> + <para> + Un guide de style de codage, la 'Convention de Codage PEAR' + (<link linkend="standards">PEAR Coding Standards</link>, PCS en + abrégé), existe pour aider la collaboration + entre les développeurs de PEAR, + pour apporter de la qualité + et de la portabilité, + et pour aider les contributeurs + à PEAR à fournir des API cohérentes. + </para> + </sect2> + <sect2 id="about-pear-distpkg"> + <title>Distribution du Code et Gestion des Packages</title> + <para> + Tous les packages PEAR sont enregistrés + et chargés dans une base + de données centrale se trouvant sur pear.php.net. Des packages + d'autres origines, mais de sources libre, peuvent aussi être + enregistrés et chargés. + + Les packages dont le source n'est pas + libre peuvent être installés par le script d'installation de PEAR, + mais la base de données de PEAR est réservée au code libre. + </para> + <para> + Pear.php.net fournira aussi bien une interface conviviale pour + les personnes (HTML), qu'une interface pour les machines + (actuellement XML-RPC) + pour accèder à la base de données de PEAR. + + Le téléchargement des packages est effectué par HTTP. + Les autres fonctions qui seront fournies par pear.php.net sont : <itemizedlist> <listitem> <simpara> - Une librairie structurée de code source libre - pour les utilisateurs de PHP - </simpara> - </listitem> - <listitem> - <simpara> - Un système de distribution du code source et de maintenance des - packages (modules) + Gestion des comptes utilisateurs + (intégrée avec le serveur CVS) </simpara> </listitem> <listitem> - <simpara> - Un style de codage pour les programmes écrit en PHP, - spécifié <link linkend="standards">là</link> - </simpara> - </listitem> - <listitem> - <simpara> - Des Classes PHP Fondamentales (PFC - PHP Foundation Classes), - <link linkend="about-pfc">voir détails ci-dessous</link> - </simpara> - </listitem> - <listitem> - <simpara> - Une bibliothèque d'extensions de PHP - (PECL - PHP Extension Code Library), - <link linkend="about-pecl">voir détails ci-dessous</link> - </simpara> + <simpara>Gestion des packages</simpara> </listitem> <listitem> - <simpara> - Un site Web, des listes de diffusion et des sites mirroirs pour - supporter la communauté PHP/PEAR - </simpara> + <simpara>Gestion des releases</simpara> </listitem> </itemizedlist> </para> - <para> - PEAR est un projet comunautaire conduit par le - <ulink url="&url.pear.group;">Groupe PEAR</ulink>. - Le projet a été créé - par Stig S. Bakken en 1999 et - <ulink url="&url.pear.account;">beaucoup de - personnes</ulink> l'ont rejoint depuis. + Les packages sont distribués sous la forme d'une archive tar + compressée (gzip) contenant un fichier XML de description. + Ce fichier contient les informations sur le package, la liste des + fichiers et leurs rôles, ainsi que les dépendances. </para> - - <sect2 id="about-pear-stlib"> - <title>Bibliothèque structurée de code PHP</title> - <para> - Dans PEAR, le code est séparé en - <quote>packages</quote> (ou modules). - - Chaque package est un projet séparé, - avec sa propre équipe de développement, - son numéro de version, son cycle de publication, - sa documentation et une relation bien définie - avec les autres packages - (incluant les dépendances vis-à-vis d'autres packages). - - Les packages sont distribués sous la forme d'une archive tar - compressée (gzip), - comprenant un fichier de description du package, et sont installés - sur votre système local à - l'aide du script d'installation de PEAR. - </para> - <para> - Il existe deux types de packages : les <quote>source packages</quote>, - qui ne contiennent que des fichiers de code source, et les - <quote>binary packages</quote>, - qui contiennent des fichiers binaires, dépendant du type - de système utilisé, - et eventuellement les fichiers de code source. - - Installer un <quote>source package</quote> contenant du code C, demande evidemment - un environnement de compilation. - </para> - <para> - PEAR definit les packages comme une arborescence, où chaque - <quote>noeud</quote> - de l'arborescence est représenté - par une partie du nom du package. - - Les noeud sont organisés par sujets - élémentaires, et chaque partie - est séparée par un <quote>underscore</quote>. - - Exemples de noms de packages : - <quote>MP3_Id</quote>, <quote>Archive_Tar</quote> et <quote>HTTP_Post</quote>. - </para> - <para> - Les packages peuvent être liés entre eux par - des dépendances explicites, - mais il n'y a pas de relation automatique par exemple - entre un package et son parent dans l'arborescence - (par exemple, - <quote>HTTP_Post</quote> et par défaut indépendant de - <quote>HTTP</quote>). - </para> - <para> - Quelques noeuds primaires dans l'arborescence, appelés - <quote>sous-repositaires</quote>, ont des fonctions particulières. - - Il s'agit actuellement de - <link linkend="about-pecl">PECL</link>, - <link linkend="about-gtk">Gtk</link> - et <link linkend="about-app">App</link>. - - Pour chacun d'eux des règles différentes s'appliquent, - elles sont expliquées dans leur description ci-dessous. - </para> - <para> - Un guide de style de codage, la 'Convention de Codage PEAR' - (<link linkend="standards">PEAR Coding Standards</link>, PCS en - abrégé), existe pour aider la collaboration entre les développeurs - de PEAR, pour apporter de la qualité et de la portabilité, et pour - aider les contributeurs à PEAR à fournir des API cohérentes. Pour - les packages se trouvant dans <link linkend="about-pfc">PFC</link>, - cette règle s'applique de façon stricte, pour les packages en dehors - de PFC, elle s'applique de façon plus souple. - </para> - </sect2> - - <sect2 id="about-pear-distpkg"> - <title>Distribution du Code et Gestion des Packages</title> - <para> - Tous les packages PEAR sont enregistrés et chargés dans une base - de données centrale se trouvant sur pear.php.net. Des packages - d'autres origines, mais de sources libre, peuvent aussi être - enregistrés et chargés. Les packages dont le source n'est pas - libre peuvent être installés par le script d'installation de PEAR, - mais la base de données de PEAR est réservée au code libre. - </para> - <para> - Pear.php.net fournira aussi bien une interface conviviale pour - les personnes (HTML), qu'une interface pour les machines - (actuellement XML-RPC) - pour accèder à la base de données de PEAR. - Le téléchargement des packages est effectué par HTTP. - Les autres fonctions qui seront fournies par pear.php.net sont : - <itemizedlist> - <listitem> - <simpara> - Gestion des comptes utilisateurs (intégrée avec le serveur CVS) - </simpara> - </listitem> - <listitem> - <simpara>Gestion des packages</simpara> - </listitem> - <listitem> - <simpara>Gestion des releases</simpara> - </listitem> - </itemizedlist> - </para> - <para> - Les packages sont distribués sous la forme d'une archive tar - compressée (gzip) contenant un fichier XML de description. - Ce fichier contient les informations sur le package, la liste des - fichiers et leurs rôles, ainsi que les dépendances. - </para> - </sect2> - - <sect2 id="about-pfc"> - <title>Les Classes PHP Fondamentales</title> - <titleabbrev>PFC</titleabbrev> - <para> - Les Classes PHP Fondamentales (PFC - PHP Foundation Classes) sont - un sous-ensemble de PEAR qui insistent sur la qualité, - le côté générique, - l'interopérabilité et la compatibilité. - Si PHP continue à distribuer les packages PEAR - dans son propre installer, ce seront les classes PFC. - </para> - <para> - Insister sur la qualité veut dire qu'aucun package ou release de - qualité moins que "stable" n'est accepté dans les PFC. - </para> - <para> - Générique veut dire que les packages doivent être - le moins spécifiques possible à - un certain type d'environement (comme une sortie en HTML, - un système d'exploitation, un serveur Web, etc ...). - </para> - <para> - Les packages interopérables fonctionnent sans soucis avec les - autres packages, ont des API stables et standards. - Ils préfèrent - les composants bien connus (et également interopérables) qui - fonctionnent bien dans différents environnements (Version PHP, - SAPI, système d'exploitation, ...). - </para> - <para> - La compatibilité ne consiste pas simplement à supporter la - même sémantique et - syntaxe que les versions précédentes, mais aussi - à penser aux futures évolutions - lorsque le code est écrit. - - Architecturer le code de telle sorte qu'il soit facile, - ou au moins possible, d'ajouter des fonctions - que l'on attend naturellement, donne un - package qui a aussi une compatibillté ascendante. - </para> - </sect2> - + </sect2> <sect2 id="about-pecl"> - <title>La bibliothèque d'extensions de PHP (PECL)</title> - <subtitle>PECL</subtitle> - <para> - PECL (prononcer <quote>piqueule</quote>) est un sous-ensemble de PEAR pour - les extensions de PHP écrite en C, semblables à celles distribuées - avec PHP4. - De fait, avoir un lieu où déplacer les extensions - actuelles de PHP a été l'une des motivations lors de la création - de PECL. Les extensions dans PECL suivent la convention de codage - PHP plutôt que celle de PEAR, mais elles sont distribuées et - installées comme des package PEAR. - </para> - <para> - Le processus de déplacement d'une extension de PHP vers PECL est appellée - "pickling". - </para> - <para> - En Octobre 2003, PECL est devenu un projet indépendant, - qui n'appartient plus du tout à - PEAR (à l'exception de l'infrastructure, - que PECL a emprunté à PEAR). - Plus d'informations et tous les paquetages PECL - peuvent être trouvés sur la - <ulink url="&url.pecl;">page d'accueil de PECL</ulink>. - Durant le déplacement de PECL, - le projet a également été renommé de - <quote>PHP Extension Code Library</quote> en - <quote>PHP Extension Community Library</quote>. - </para> - </sect2> - + <title>La bibliothèque d'extensions de PHP (PECL)</title> + <subtitle>PECL</subtitle> + <para> + PECL (prononcer <quote>piqueule</quote>) est un sous-ensemble de PEAR pour + les extensions de PHP écrite en C, semblables à celles distribuées + avec PHP4. + De fait, avoir un lieu où déplacer les extensions + actuelles de PHP a été l'une des motivations lors de la création + de PECL. Les extensions dans PECL suivent la convention de codage + PHP plutôt que celle de PEAR, mais elles sont distribuées et + installées comme des package PEAR. + </para> + <para> + Le processus de déplacement d'une extension de PHP vers PECL est appellée + "pickling". + </para> + <para> + En Octobre 2003, PECL est devenu un projet indépendant, + qui n'appartient plus du tout à + PEAR (à l'exception de l'infrastructure, + que PECL a emprunté à PEAR). + Plus d'informations et tous les paquetages PECL + peuvent être trouvés sur la + <ulink url="&url.pecl;">page d'accueil de PECL</ulink>. + Durant le déplacement de PECL, + le projet a également été renommé de + <quote>PHP Extension Code Library</quote> en + <quote>PHP Extension Community Library</quote>. + </para> + </sect2> <sect2 id="about-gtk"> - <title>Packages Gtk</title> - <subtitle>Gtk</subtitle> - <para> - Les packages GTK mettent à disposition des applications qui utilisent - la technologie du projet <ulink url="&url.php.gtk;">PHP-GTK</ulink>. - Le code de ce sous-repositaire suit la - <link linkend="standards">convention de codage</link> de PEAR. - </para> - <para> - Pour l'instant, il n'y a pas de plan définitif - quant à la façon dont ils - seront intégrés à PEAR. - </para> - </sect2> - - <sect2 id="about-app"> - <title>Les Packages applicatifs</title> - <subtitle>App</subtitle> - <para> - A FAIRE - <!-- - Ideas: - * files may also be installed in the web server's document root - * installer knows how to configure one or more web servers to - set up a virtual host or subdirectory for the application - --> - </para> - </sect2> - - </sect1> - - </chapter> + <title>Packages Gtk</title> + <subtitle>Gtk</subtitle> + <para> + Les packages GTK mettent à disposition des applications qui utilisent + la technologie du projet <ulink url="&url.php.gtk;">PHP-GTK</ulink>. + Le code de ce sous-repositaire suit la + <link linkend="standards">convention de codage</link> de PEAR. + </para> + </sect2> + </sect1> +</chapter> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/diff.php/peardoc/fr/chapters/intro.xml?r1=1.9&r2=1.10&ty=u Index: peardoc/fr/chapters/intro.xml diff -u peardoc/fr/chapters/intro.xml:1.9 peardoc/fr/chapters/intro.xml:1.10 --- peardoc/fr/chapters/intro.xml:1.9 Sun Jun 12 02:24:57 2005 +++ peardoc/fr/chapters/intro.xml Mon Jul 11 03:08:40 2005 @@ -1,306 +1,238 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.10 Maintainer: moosh Status: ready --> - <chapter id="introduction"> - <chapterinfo> - <author> - <firstname>Stig</firstname> - <surname>Bakken</surname> - </author> - <date>2002-02-10</date> - </chapterinfo> - <title>Introduction</title> - <subtitle>The PEAR Manifest</subtitle> - <simpara> - PEAR est dédié à Malin Bakken, - né le 21 Novembre 1999. - </simpara> - - <sect1 id="about.pear"> - <title>Qu'est-ce que PEAR ?</title> - +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.13 Maintainer: moosh Status: ready --> +<chapter id="introduction"> + <chapterinfo> + <author> + <firstname>Stig</firstname> + <surname>Bakken</surname> + </author> + <date>2002-02-10</date> + </chapterinfo> + <title>Introduction</title> + <subtitle>The PEAR Manifest</subtitle> + <simpara> + PEAR est dédié à Malin Bakken, + né le 21 Novembre 1999. + </simpara> + + <sect1 id="about.pear"> + <title>Qu'est-ce que PEAR ?</title> + + <para> + PEAR est l'abbréviation de + <quote> + PHP Extension and Application Repository + </quote> + et se prononce 'père' + (NDT : pear veut dire poire en Anglais). + + La mission de PEAR est de fournir : + <itemizedlist> + <listitem> + <simpara> + Une librairie structurée de code source libre + pour les utilisateurs de PHP + </simpara> + </listitem> + <listitem> + <simpara> + Un système de distribution du code source et de maintenance des + packages (modules) + </simpara> + </listitem> + <listitem> + <simpara> + Un style de codage pour les programmes écrit en PHP, + spécifié <link linkend="standards">là</link> + </simpara> + </listitem> + <listitem> + <simpara> + Une bibliothèque d'extensions de PHP + (PECL - PHP Extension Code Library), + <link linkend="about-pecl">voir détails ci-dessous</link> + </simpara> + </listitem> + <listitem> + <simpara> + Un site Web, des listes de diffusion et des sites mirroirs pour + supporter la communauté PHP/PEAR + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + PEAR est un projet comunautaire conduit par le + <ulink url="&url.pear.group;">Groupe PEAR</ulink>. + Le projet a été créé + par Stig S. Bakken en 1999 et + <ulink url="&url.pear.account;">beaucoup de + personnes</ulink> l'ont rejoint depuis. + </para> + <sect2 id="about-pear-stlib"> + <title>Bibliothèque structurée de code PHP</title> + <para> + Dans PEAR, le code est séparé en + <quote>packages</quote> (ou modules). + + Chaque package est un projet séparé, + avec sa propre équipe de développement, + son numéro de version, son cycle de publication, + sa documentation et une relation bien définie + avec les autres packages + (incluant les dépendances vis-à-vis d'autres packages). + + Les packages sont distribués sous la forme d'une archive tar + compressée (gzip), + comprenant un fichier de description du package, + et sont installés + sur votre système local à + l'aide du script d'installation de PEAR. + </para> <para> - PEAR est l'abbréviation de - <quote> - PHP Extension and Application Repository - </quote> - et se prononce 'père' - (NDT : pear veut dire poire en Anglais). + Il existe deux types de packages : les <quote>source packages</quote>, + qui ne contiennent que des fichiers de code source, et les + <quote>binary packages</quote>, + qui contiennent des fichiers binaires, dépendant du type + de système utilisé, + et eventuellement les fichiers de code source. - La mission de PEAR est de fournir : + Installer un <quote>source package</quote> contenant du code C, + demande evidemment un environnement de compilation. + </para> + <para> + PEAR definit les packages comme une arborescence, où chaque + <quote>noeud</quote> + de l'arborescence est représenté + par une partie du nom du package. + + Les noeuds sont organisés par sujets + élémentaires, et chaque partie + est séparée par un <quote>underscore</quote>. + + Exemples de noms de packages : + <quote>MP3_Id</quote>, + <quote>Archive_Tar</quote> + et <quote>HTTP_Post</quote>. + </para> + <para> + Les packages peuvent être liés entre eux par + des dépendances explicites, + mais il n'y a pas de relation automatique par exemple + entre un package et son parent dans l'arborescence + (par exemple, + <quote>HTTP_Post</quote> et par défaut indépendant de + <quote>HTTP</quote>). + </para> + <para> + Quelques noeuds primaires dans l'arborescence, appelés + <quote>sous-repositaires</quote>, ont des fonctions particulières. + + Il s'agit actuellement de + <link linkend="about-pecl">PECL</link>, + et <link linkend="about-gtk">Gtk</link>. + + Pour chacun d'eux des règles différentes s'appliquent, + elles sont expliquées dans leur description ci-dessous. + </para> + <para> + Un guide de style de codage, la 'Convention de Codage PEAR' + (<link linkend="standards">PEAR Coding Standards</link>, PCS en + abrégé), existe pour aider la collaboration + entre les développeurs de PEAR, + pour apporter de la qualité + et de la portabilité, + et pour aider les contributeurs + à PEAR à fournir des API cohérentes. + </para> + </sect2> + <sect2 id="about-pear-distpkg"> + <title>Distribution du Code et Gestion des Packages</title> + <para> + Tous les packages PEAR sont enregistrés + et chargés dans une base + de données centrale se trouvant sur pear.php.net. Des packages + d'autres origines, mais de sources libre, peuvent aussi être + enregistrés et chargés. + + Les packages dont le source n'est pas + libre peuvent être installés par le script d'installation de PEAR, + mais la base de données de PEAR est réservée au code libre. + </para> + <para> + Pear.php.net fournira aussi bien une interface conviviale pour + les personnes (HTML), qu'une interface pour les machines + (actuellement XML-RPC) + pour accèder à la base de données de PEAR. + + Le téléchargement des packages est effectué par HTTP. + Les autres fonctions qui seront fournies par pear.php.net sont : <itemizedlist> <listitem> <simpara> - Une librairie structurée de code source libre - pour les utilisateurs de PHP - </simpara> - </listitem> - <listitem> - <simpara> - Un système de distribution du code source et de maintenance des - packages (modules) + Gestion des comptes utilisateurs + (intégrée avec le serveur CVS) </simpara> </listitem> <listitem> - <simpara> - Un style de codage pour les programmes écrit en PHP, - spécifié <link linkend="standards">là</link> - </simpara> - </listitem> - <listitem> - <simpara> - Des Classes PHP Fondamentales (PFC - PHP Foundation Classes), - <link linkend="about-pfc">voir détails ci-dessous</link> - </simpara> - </listitem> - <listitem> - <simpara> - Une bibliothèque d'extensions de PHP - (PECL - PHP Extension Code Library), - <link linkend="about-pecl">voir détails ci-dessous</link> - </simpara> + <simpara>Gestion des packages</simpara> </listitem> <listitem> - <simpara> - Un site Web, des listes de diffusion et des sites mirroirs pour - supporter la communauté PHP/PEAR - </simpara> + <simpara>Gestion des releases</simpara> </listitem> </itemizedlist> </para> - <para> - PEAR est un projet comunautaire conduit par le - <ulink url="&url.pear.group;">Groupe PEAR</ulink>. - Le projet a été créé - par Stig S. Bakken en 1999 et - <ulink url="&url.pear.account;">beaucoup de - personnes</ulink> l'ont rejoint depuis. + Les packages sont distribués sous la forme d'une archive tar + compressée (gzip) contenant un fichier XML de description. + Ce fichier contient les informations sur le package, la liste des + fichiers et leurs rôles, ainsi que les dépendances. </para> - - <sect2 id="about-pear-stlib"> - <title>Bibliothèque structurée de code PHP</title> - <para> - Dans PEAR, le code est séparé en - <quote>packages</quote> (ou modules). - - Chaque package est un projet séparé, - avec sa propre équipe de développement, - son numéro de version, son cycle de publication, - sa documentation et une relation bien définie - avec les autres packages - (incluant les dépendances vis-à-vis d'autres packages). - - Les packages sont distribués sous la forme d'une archive tar - compressée (gzip), - comprenant un fichier de description du package, et sont installés - sur votre système local à - l'aide du script d'installation de PEAR. - </para> - <para> - Il existe deux types de packages : les <quote>source packages</quote>, - qui ne contiennent que des fichiers de code source, et les - <quote>binary packages</quote>, - qui contiennent des fichiers binaires, dépendant du type - de système utilisé, - et eventuellement les fichiers de code source. - - Installer un <quote>source package</quote> contenant du code C, demande evidemment - un environnement de compilation. - </para> - <para> - PEAR definit les packages comme une arborescence, où chaque - <quote>noeud</quote> - de l'arborescence est représenté - par une partie du nom du package. - - Les noeud sont organisés par sujets - élémentaires, et chaque partie - est séparée par un <quote>underscore</quote>. - - Exemples de noms de packages : - <quote>MP3_Id</quote>, <quote>Archive_Tar</quote> et <quote>HTTP_Post</quote>. - </para> - <para> - Les packages peuvent être liés entre eux par - des dépendances explicites, - mais il n'y a pas de relation automatique par exemple - entre un package et son parent dans l'arborescence - (par exemple, - <quote>HTTP_Post</quote> et par défaut indépendant de - <quote>HTTP</quote>). - </para> - <para> - Quelques noeuds primaires dans l'arborescence, appelés - <quote>sous-repositaires</quote>, ont des fonctions particulières. - - Il s'agit actuellement de - <link linkend="about-pecl">PECL</link>, - <link linkend="about-gtk">Gtk</link> - et <link linkend="about-app">App</link>. - - Pour chacun d'eux des règles différentes s'appliquent, - elles sont expliquées dans leur description ci-dessous. - </para> - <para> - Un guide de style de codage, la 'Convention de Codage PEAR' - (<link linkend="standards">PEAR Coding Standards</link>, PCS en - abrégé), existe pour aider la collaboration entre les développeurs - de PEAR, pour apporter de la qualité et de la portabilité, et pour - aider les contributeurs à PEAR à fournir des API cohérentes. Pour - les packages se trouvant dans <link linkend="about-pfc">PFC</link>, - cette règle s'applique de façon stricte, pour les packages en dehors - de PFC, elle s'applique de façon plus souple. - </para> - </sect2> - - <sect2 id="about-pear-distpkg"> - <title>Distribution du Code et Gestion des Packages</title> - <para> - Tous les packages PEAR sont enregistrés et chargés dans une base - de données centrale se trouvant sur pear.php.net. Des packages - d'autres origines, mais de sources libre, peuvent aussi être - enregistrés et chargés. Les packages dont le source n'est pas - libre peuvent être installés par le script d'installation de PEAR, - mais la base de données de PEAR est réservée au code libre. - </para> - <para> - Pear.php.net fournira aussi bien une interface conviviale pour - les personnes (HTML), qu'une interface pour les machines - (actuellement XML-RPC) - pour accèder à la base de données de PEAR. - Le téléchargement des packages est effectué par HTTP. - Les autres fonctions qui seront fournies par pear.php.net sont : - <itemizedlist> - <listitem> - <simpara> - Gestion des comptes utilisateurs (intégrée avec le serveur CVS) - </simpara> - </listitem> - <listitem> - <simpara>Gestion des packages</simpara> - </listitem> - <listitem> - <simpara>Gestion des releases</simpara> - </listitem> - </itemizedlist> - </para> - <para> - Les packages sont distribués sous la forme d'une archive tar - compressée (gzip) contenant un fichier XML de description. - Ce fichier contient les informations sur le package, la liste des - fichiers et leurs rôles, ainsi que les dépendances. - </para> - </sect2> - - <sect2 id="about-pfc"> - <title>Les Classes PHP Fondamentales</title> - <titleabbrev>PFC</titleabbrev> - <para> - Les Classes PHP Fondamentales (PFC - PHP Foundation Classes) sont - un sous-ensemble de PEAR qui insistent sur la qualité, - le côté générique, - l'interopérabilité et la compatibilité. - Si PHP continue à distribuer les packages PEAR - dans son propre installer, ce seront les classes PFC. - </para> - <para> - Insister sur la qualité veut dire qu'aucun package ou release de - qualité moins que "stable" n'est accepté dans les PFC. - </para> - <para> - Générique veut dire que les packages doivent être - le moins spécifiques possible à - un certain type d'environement (comme une sortie en HTML, - un système d'exploitation, un serveur Web, etc ...). - </para> - <para> - Les packages interopérables fonctionnent sans soucis avec les - autres packages, ont des API stables et standards. - Ils préfèrent - les composants bien connus (et également interopérables) qui - fonctionnent bien dans différents environnements (Version PHP, - SAPI, système d'exploitation, ...). - </para> - <para> - La compatibilité ne consiste pas simplement à supporter la - même sémantique et - syntaxe que les versions précédentes, mais aussi - à penser aux futures évolutions - lorsque le code est écrit. - - Architecturer le code de telle sorte qu'il soit facile, - ou au moins possible, d'ajouter des fonctions - que l'on attend naturellement, donne un - package qui a aussi une compatibillté ascendante. - </para> - </sect2> - + </sect2> <sect2 id="about-pecl"> - <title>La bibliothèque d'extensions de PHP (PECL)</title> - <subtitle>PECL</subtitle> - <para> - PECL (prononcer <quote>piqueule</quote>) est un sous-ensemble de PEAR pour - les extensions de PHP écrite en C, semblables à celles distribuées - avec PHP4. - De fait, avoir un lieu où déplacer les extensions - actuelles de PHP a été l'une des motivations lors de la création - de PECL. Les extensions dans PECL suivent la convention de codage - PHP plutôt que celle de PEAR, mais elles sont distribuées et - installées comme des package PEAR. - </para> - <para> - Le processus de déplacement d'une extension de PHP vers PECL est appellée - "pickling". - </para> - <para> - En Octobre 2003, PECL est devenu un projet indépendant, - qui n'appartient plus du tout à - PEAR (à l'exception de l'infrastructure, - que PECL a emprunté à PEAR). - Plus d'informations et tous les paquetages PECL - peuvent être trouvés sur la - <ulink url="&url.pecl;">page d'accueil de PECL</ulink>. - Durant le déplacement de PECL, - le projet a également été renommé de - <quote>PHP Extension Code Library</quote> en - <quote>PHP Extension Community Library</quote>. - </para> - </sect2> - + <title>La bibliothèque d'extensions de PHP (PECL)</title> + <subtitle>PECL</subtitle> + <para> + PECL (prononcer <quote>piqueule</quote>) est un sous-ensemble de PEAR pour + les extensions de PHP écrite en C, semblables à celles distribuées + avec PHP4. + De fait, avoir un lieu où déplacer les extensions + actuelles de PHP a été l'une des motivations lors de la création + de PECL. Les extensions dans PECL suivent la convention de codage + PHP plutôt que celle de PEAR, mais elles sont distribuées et + installées comme des package PEAR. + </para> + <para> + Le processus de déplacement d'une extension de PHP vers PECL est appellée + "pickling". + </para> + <para> + En Octobre 2003, PECL est devenu un projet indépendant, + qui n'appartient plus du tout à + PEAR (à l'exception de l'infrastructure, + que PECL a emprunté à PEAR). + Plus d'informations et tous les paquetages PECL + peuvent être trouvés sur la + <ulink url="&url.pecl;">page d'accueil de PECL</ulink>. + Durant le déplacement de PECL, + le projet a également été renommé de + <quote>PHP Extension Code Library</quote> en + <quote>PHP Extension Community Library</quote>. + </para> + </sect2> <sect2 id="about-gtk"> - <title>Packages Gtk</title> - <subtitle>Gtk</subtitle> - <para> - Les packages GTK mettent à disposition des applications qui utilisent - la technologie du projet <ulink url="&url.php.gtk;">PHP-GTK</ulink>. - Le code de ce sous-repositaire suit la - <link linkend="standards">convention de codage</link> de PEAR. - </para> - <para> - Pour l'instant, il n'y a pas de plan définitif - quant à la façon dont ils - seront intégrés à PEAR. - </para> - </sect2> - - <sect2 id="about-app"> - <title>Les Packages applicatifs</title> - <subtitle>App</subtitle> - <para> - A FAIRE - <!-- - Ideas: - * files may also be installed in the web server's document root - * installer knows how to configure one or more web servers to - set up a virtual host or subdirectory for the application - --> - </para> - </sect2> - - </sect1> - - </chapter> + <title>Packages Gtk</title> + <subtitle>Gtk</subtitle> + <para> + Les packages GTK mettent à disposition des applications qui utilisent + la technologie du projet <ulink url="&url.php.gtk;">PHP-GTK</ulink>. + Le code de ce sous-repositaire suit la + <link linkend="standards">convention de codage</link> de PEAR. + </para> + </sect2> + </sect1> +</chapter> <!-- Keep this comment at the end of the file Local variables: