(( gitHubWatchers )) (( gitHubStars )) (( gitHubForks ))

atoum is a modern and intuitive testing framework for PHP.

A simple, modern and intuitive unit testing framework for PHP.

Just like SimpleTest or PHPUnit, atoum is a unit testing framework specific to the PHP language. However, it has been designed from the start up with the following ideas in mind:

  • Can be implemented rapidly,
  • Simplifies test development,
  • Allows for writing reliable, readable, and clear unit tests.

It allows to run your tests in several different modes: in parallel, in concurrency, or simply one by one.

It also ships with several helping tools for a developer in their day-to-day usage.


Install from a Git repository (with Git)

Make sure you have git and Composer installed.

Git clone the repository:
git clone git://
Change into the new directory:
cd atoum
Install the project dependencies:
composer install
Run it:

Install from a PHP Archive (with curl or wget)

The PHPUnit documentation has a clear manual on how to install PHARs on Windows.

If you have the Suhosin extension enabled, make sure to allow the execution of PHARs in your php.ini:
suhosin.executor.include.whitelist = phar

Locally (X.X.X)

Download it:
wget -O atoum.phar
curl -sSL -o atoum.phar
Use it:
php atoum.phar

Globally (X.X.X)

Download it:
wget -O atoum.phar
curl -sSL -o atoum.phar
Install it as an executable:
chmod a+x atoum.phar
sudo mv atoum.phar /usr/local/bin/atoum
Use it: