original par Tobias Schlitt

(Février 2005)

Pour commencer vous pouvez "découvrir" et utiliser son propre petit channel de test:

pear channel-discover pear.schlitt.info
pear install -f schlitt/Services_Trackback

Si ces commandes ne fonctionnent pas c'est que vous n'avez pas la dernière version de PEAR (>=1.4)

Conditions préliminaires

Les conditions préliminaires pour l'installation de PEAR_Server sont:

• PHP 5.0.3 (ou plus récent).
• PEAR 1.4.0a2 (ou plus récent) installé.
• Un accès a une base MySQL.
• Un nom de domaine valide pour faire tourner le serveur dans un environement dédié.

Les infos de base pour installer PHP5 sont ici

MySQL le nom de domaine (tel que pear.schlitt.info) semblent des conditions préliminaires comunes et ne nécéssitent pas d'autre introduction La dépendance à un nom de domaine devraient être supprimée dans le futur.

Précautions

Avertissement: Ce qui suit est la manipulation du logiciel qui est considéré en "alpha". N'employez jamais ceci dans un environnement de production. Tout ce que que vous faites est à partir de ce moment là à votre propre risque.

Récuperer PEAR 1.4

Pour récuperer la version actuelle de PEAR utilisez go-pear.org (si vous n'avez pas encore de PEAR installé) ensuite passez les commandes

pear clear-cache
pear upgrade PEAR

Si vous rencontrez un quelconque problème en installant cette version, c'est que peut-être vous avez setté un autre preferred_state que "alpha" (ce qui n'aurait rien d'anormal!). Pour résoudre ce problème lancez la commande

pear upgrade -f PEAR

Ce qui vous permet d'installer le paquet même si il n'est pas disponible dans votre preferred_state. Une fois fini, vous avez upgradé PEAR à 1.4. Facile, ce n'était pas?

Découvrir un channel

"discover" est la commande pear pour ajouter un channel

L'étape suivante est de "découvrir" le channel de Greg, qui se trouve sur pear.chiaraquartet.net, parce que le package PEAR_Server package n'est pas encore officiellement releasé:

pear channel-discover pear.chiaraquartet.net

Le channel.xml de ce channel est automatiquement downloadé et le channel est enregistré localement. Certaines informations sont fournies par pear list-channels et pear channel-info chiara.

Comme vous pourrez le constater ici, le channel a aussi publié sont racourci/alias (chiara) sur votre installeur PEAR.

Installer PEAR_Server

Maintenant nous allons installer ce package PEAR_Server, qui fonctionnera comme un charme avec

pear install -f --alldeps PEAR_Server

Si cela ne fonctionne pas (J'ai vécu des des problèmes avec le channel et les résolutions de nom de channel dans une version plus ancienne), essayez un de ce qui suit:

pear install -f --alldeps chiara/PEAR_Server pear install -f --alldeps pear.chiaraquartet.net/PEAR_Server

Notez que dans les commentaires, Tobias se reprends et dit : À moins que vous ayez configuré chiara comme default_channel, vous devrez toujours mettre en tête des noms de paquet, le canal comme dans chiara/PEAR_Server. Si cela fonctionne sans ceci, c'est un bogue:)

Une fois l'installation finie, l'installateur nous indiquera que le paquet PEAR_Server a des tâches post-installation à exécuter. Ceci devrait être fait maintenant, si toutes les conditions préalables sont accomplies (C'est-à-dire une base de données MySQL vierge, login/pass appropriés pour cette base, une racine htdocs vierge):

pear run-scripts PEAR_Server

On vous posera plusieurs questions sur votre base de données, les htdocs, les petits détails de votre canal et vous en tant qu'administrateur intial. Si tout fonctionne correctement, l'installateur de PEAR devrait créer les tables nécessaires et les entrées à l'intérieur de la base de données (4 tables et quelques entrées pour l'utilisateur et le canal) et créer la structure des répertoires de votre serveur de canal dans le répertoire de htdocs que vous avez fourni. Votre channel devrait également être enregistré dans votre installateur de PEAR immédiatement.

Ajustments manuels

Quelques ajustement doivent être fait sur l'installation que vous venez de réaliser. La première, créer un index.htm dans le répertoire htdocs est recommandé, pour empècher les gens de naviguer au sein du répertoire. Ensuite renomer le fichier frontend.php (creaté par l'installateur) pour empècher qu'une autre personne accède a votre interface d'administration.

Ajouter une release

L'interface d'administration vous permet alors d'éffectuer les étapes suivantes. Avec votre navigateur, allez à l'adresse http://votre.domaine.de.channel/le_nouveau_nom_de_frontend.php. Vous devriez arriver à un formulair d'authentification. Fournissez vos paramètres d'authentification choisis pendant l'installation et accedez ainsi à l'administration de votre serveur PEAR.

Que devons nous faire en premier pour enregistrer un nouveau package. Entrez les infos utiles à propos du package (particulièrement un nom correct) et soumettez le formulaire. Après quoi nous avons à éditer le package créé à nouveau. En faisant cela un nouveau lien apparaît près du formulaire des détails du package appelé "Manage Package Maintainers". Ici nous devrions ajouter nous-même comme étant le mainteneur responsable du Package, ainsi nous pourrons uploader les releases.

So, what we need now is a package release to upload. Ainsi, ce dont nous avons besoin maintenant est une release de package à uploader.

Le paquet de release remplir les conditions préalables suivantes:

• Avoir un package2.xml (so being build by PEAR 1.4).
• Votre channel doit être configuré dans le package2.xml.

Tobias a fourni des informations sur la façon de traiter avec package2.xml dans son dernier article.

À l'intérieur du remplacez simplement le pear.php.net du tag <channel/> avec l'URI de vôtre channel.

Ayant ainsi construit correctement votre package, vous pourrez le télécharger par l'interface web de votre serveur.

Tester votre channel

Félicitation, vous venez de mettre en place votre propre channel PEAR, qui fournis la première release.

Tester votre propre channel est très simple, essayez simplement d'installer le package que vous venz d'ajouter au channel avec la commande:

pear install Nom_de_votre_package

Prenez note que les noms de packages sont actuellement semblent sensibles à la casse (dans certains cas). Si la syntaxe proposée ne fonctionne pas, essayez d'utiliser une des suivantes:

pear install Alias_de_votre_channel/Nom_de_votre_package
pear install URI_de_votre_channel/Nom_de_votre_package

Une de ces commandes devrait fonctionner, si ce n'est pas le cas quelque chose ne tourne pas rond avec votre client ou votre serveur.

Support

Si vous éprouvez n'importe quelles difficultés en traitant les étapes ci-dessus décrites, essyez s'il vous plait un peu de corriger vous-même en utilisant l'option verbose de l'installateur de PEAR.

Ensuite vous pourrez trouver de l'aide a) en adressant un courrier sur la liste pear-general et/ou b) en demandant de l'aide sur irc : #pear sur Efnet. Si vous êtes sur que vous avez trouvé un bug , alors créez directement un rapport sur pear.php.net.

Astuces de Greg (master of chiara)

1. Si vous settez à '1' le param de config 'auto_discover, vous ne devrez plus faire un discover-channel avant de l'utiliser.

Notes supplémentaires