Les lettres autorisés dans les éléments sont A-Z et a-z.
Les autres caractères, comme é
doivent être remplacés par leurs entités
(dans ce cas : é).
Si vous créez votre fichier package.xml en utilisant le
PEAR_PackageFileManager, mettez à jour votre installation de PEAR
à la version 1.4.0a2 ou supérieure et vous n'aurez plus à vous souciez de
cela car le gestionnaire de fichier s'occupe de cela automatiquement.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<package version="1.0">
<name>argent_facile</name>
<summary>faites de l'argent facile</summary>
<description>
Ce package vous aide à faire de l'argent facile.
</description>
<license>PHP License</license>
<maintainers>
<maintainer>
<user>foo</user>
<name>Joe Foo</name>
<email>foo@example.com</email>
<role>lead</role>
</maintainer>
</maintainers>
<release>
<version>1.0</version>
<date>2002-05-27</date>
<state>stable</state>
<notes>
Ceci est la première version.
</notes>
<filelist>
<dir name="/" baseinstalldir="Argent">
<file role="php" name="Fast.php" />
</dir>
</filelist>
</release>
</package>
Ce fichier package.xml
peut vous servir de modèle.
Il contient tous les éléments nécessaires.
Il vous suffit de changer
les textes pour vous en servir avec votre package.
Dans cet exemple, nous pouvons découvrir une
caractéristique intéressante:
Lorsqu'un répertoire de votre package
ne contient que des fichiers du
même type, vous pouvez utiliser
l'attribut rôle directement dans la balise
<dir> au lieu de
l'ajouter à chaque balise
<file>.
Avec les connaissances que vous venez d'acquérir sur ce chapitre,
vous devriez maintenant être capable de créer un fichier de
définition pour votre package.
Si vous avez des questions à ce sujet,
n'hésitez pas à les poser sur la
mailinglist.
Le gestionnaire de package PEAR permet de vérifier
les différentes caractéristiques du système.
Il vous est possible de définir des
dépendances avec la balise
<dep>:
L'attribut optional
peut être utilisé lorsqu'une
dépendance n'est pas indispensable
mais que la présence du package donne
accès à des fonctionnalités avancées.
Les seules valeurs acceptées sont
"yes" et "no".
Si l'attribut optional n'est pas
présent, la dépendance est indispensable.
Lorsque optional="yes" est utilisé,
les messages suivants apparaîtront à l'installation:
$ pear install <package>
Optional dependencies:
Package `XML_Tree' is recommended to utilize some features.
Package `MDB' is recommended to utilize some features.