2. Installation

Si vous souhaitez utiliser atoum, il vous suffit de télécharger la dernière version.

Vous pouvez installer atoum de plusieurs manières :

2.1. Composer

Composer est un outil de gestion de dépendance en PHP.

Assurez-vous que vous disposez d’une installation de composer fonctionnelle

Ajoutez atoum/atoum a vos dépendances de développement :

composer require --dev atoum/atoum

2.2. Archive PHAR

Une archive PHAR (PHp ARchive) est créée automatiquement à chaque modification d’atoum.

PHAR est un format d’archive applicative pour PHP.

2.2.1. Installation

Vous pouvez télécharger la dernière version stable d’atoum directement depuis le site officiel : http://downloads.atoum.org/nightly/atoum.phar

2.2.2. Mise à jour

Pour mettre à jour le PHAR, utiliser simplement la commande :

$ php -d phar.readonly=0 atoum.phar --update

Note

Le processus de mise à jour modifie l’archive PHAR. Cependant, par défaut la configuration de PHP ne l’autorise pas. Voilà pourquoi il faut utiliser la directive -d phar.readonly=0.

Si une version plus récente existe, elle sera alors téléchargée automatiquement et installée au sein de l’archive :

$ php -d phar.readonly=0 atoum.phar --update
Checking if a new version is available... Done !
Update to version 'nightly-2416-201402121146'... Done !
Enable version 'nightly-2416-201402121146'... Done !
Atoum was updated to version 'nightly-2416-201402121146' successfully !

S’il n’existe pas de version plus récente, atoum s’arrêtera immédiatement :

$ php -d phar.readonly=0 atoum.phar --update
Checking if a new version is available... Done !
There is no new version available !

atoum ne demande aucune confirmation de la part de l’utilisateur pour réaliser la mise à jour, car il est très facile de revenir à une version précédente.

2.2.3. Lister les versions contenues dans l’archive

Vous pouvez lister les versions disponibles dans les archives en utilisant --list-available-versions ou -lav:

$ php atoum.phar -lav
  nightly-941-201201011548
  nightly-1568-201210311708
* nightly-2416-201402121146

La liste des versions de l’archive est affichée. La version actuellement active est précédée par *.

2.2.4. Changer la version courante

Pour activer une autre version, il suffit d’utiliser l’argument --enable-version, ou -ev en version abrégée, suivi du nom de la version à utiliser :

$ php -d phar.readonly=0 atoum.phar -ev DEVELOPMENT

Note

La modification de la version courante nécessite la modification de l’archive PHAR. Cependant, par défaut la configuration de PHP ne l’autorise pas. Voilà pourquoi il faut utiliser la directive -d phar.readonly=0.

2.2.5. Suppression d’anciennes versions

Au cours du temps, l’archive peut contenir plusieurs versions d’atoum qui ne sont plus utilisées.

Pour les supprimer, il suffit d’utiliser l’argument --delete-version, ou -dv dans sa version abrégée, suivi du nom de la version à supprimer :

$ php -d phar.readonly=0 atoum.phar -dv nightly-941-201201011548

La version est alors supprimée.

Avertissement

Il n’est pas possible de supprimer la version active.

Note

La suppression d’une version nécessite la modification de l’archive PHAR. par défaut la configuration de PHP ne l’autorise pas. Voilà pourquoi il faut utiliser la directive -d phar.readonly=0.

2.3. Github

Si vous souhaitez utiliser atoum directement depuis ses sources, vous pouvez cloner ou « forker » le dépôt github : git://github.com/atoum/atoum.git