Chapitre 16. Le fichier de définition de package package.xml

Table des matières
Introduction au fichier de définition de package package.xml

Introduction au fichier de définition de package package.xml

package.xml version 1.0 est obsolète

package.xml 1.0 est obsolète, utilisez plutôt package.xml version 2.0, la documentation peut être trouvée sur la page package.xml 2.0.

Le fichier de définition de package package.xml est, comme son nom l'indique, un fichier XML contenant toutes les informations sur le package PEAR.

Ce chapitre va décrire les éléments composant un fichier de définition et les procédures permettant de créer un tel fichier pour votre package.

Le package PEAR_PackageFileManager simplifie la création de fichier de description. Vous pouvez installer PEAR_PackageFileManager gâce à la commande


$ pear install PEAR_PackageFileManager
      

Balises à utiliser

La balise de premier niveau composant un fichier package.xml est la balise <package version="1.0">. Les balises de sous niveau permises sont :

Validation

Pour valider vos fichiers package.xml, vous pouvez utiliser l'utilitaire xmllint fourni avec libxml2.

xmllint --dtdvalid http://pear.php.net/dtd/package-1.0 --noout package.xml

Créer un fichier de définition de 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.

Définir les dépendances

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>: