FAQ

* How to write "atoum"? "ATOUM"? "Atoum"?
The official name is "atoum".

* How to contribute to atoum?
Just send an email to lead@atoum.org to say that you want to contribute to atoum.

* Why some classes has name *\phpClass instead of *\class?
The word "class" is reserved by PHP, so it's not possible to use this name for a class.
In this case, the atoum convention is to prefix name with word "php".

* Where is the documentation?
There is an english and a french documentation available: http://docs.atoum.org/.
It's a work in progress and you're welcome to improve it.
Moreover, atoum's unit test is the documentation.
You find them in the directory path/to/atoum/tests/units.

* Why php mageekguy.atoum.phar does not works?
Try a "php -n mageekguy.atoum.phar" in a terminal.
If it works, the problem is in your PHP configuration.
Try to remove ioncube extension, which seems not compatible with atoum.
If you use suhosin, you can also add "suhosin.executor.include.whitelist="phar"" to your php.ini.
Try to add "detect_unicode=0" in your php.ini.

* What can i do to avoid error about __COMPILER_HALT_OFFSET__?
Use only require_once to include mageekguy.atoum.phar in your scripts.

* Why I get a fail message when testing a class that uses APC?
APC is "a free, open, and robust framework for caching and optimizing PHP intermediate code" (http://php.net/apc.configuration) distributed under the form of a PHP extension.
When testing classes that use APC, you may get some failure messages showing that apc_fetch is unable to retrieve a value.
As all PHP extension, APC has some configuration options to enable it:
  - apc.enabled: whether to enable or disable APC,
  - apc.enable_cli: whether to enable or disable APC for PHP CLI.
Setting apc.enabled to 1 in your CLI configuration does not do the trick: to avoid these failure messages, you have to set the apc.enable_cli option to 1, otherwise, the extension won't be enabled for the PHP CLI version, which is used by atoum.