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 :
- à l’aide de composer ;
- en téléchargeant l”archive PHAR ;
- en clonant le dépôt Github ;
- voir aussi l’integration d’atoum dans votre framework.
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
à 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