Difference between revisions 2031623 and 2031632 on mediawikiwiki

< previous diff
next diff >
Manual:PHP unit testing/Installing PHPUnit
{{Manual:PHP_unit_testing/navigation}}

You must have PHPUnit 3.7.0 (or later) installed to run the unit tests. Most developers use the very latest PHPUnit version, so there is no guarantee an older one will actually pass the tests we wrote.

{{notice|
Depending on your distribution and configuration, you may have to run the following commands as root.
}}

== Install methods ==
Several methods are available to you.
Note the [[#Known issues|known issue below]], the Debian/Ubuntu package is broken.

The [http://phpunit.de/manual/current/en/installation.html recommended way to install PHPUnit] is by downloading a PHP Archive (PHAR file). With the resolution of [[bugzilla:58881|bug 58881]], this should work now.

=== MediaWiki PHPUnit installer ===
We provide a shell script for Unix-like operating systems (Ubuntu, Mac OS X, Linux...). The script will attempt to install PHPUnit using various methods and usually manage to get it installed. It will try [http://pear.php.net PEAR], falling back to the [[w:Advanced Packaging Tool|apt]] and [[w:Yellowdog Updater, Modified|yum]] package managers.

The script is located in <tt>tests/phpunit</tt> and requires root access.

Example installing PHPUnit under an Unix system:

<source lang="bash">
$ cd tests/phpunit
$ sudo ./install-phpunit.sh
</source>

This might be the easiest way to install PHPUnit. ⏎
⏎
=== Using PEAR ===

[https://github.com/sebastianbergmann/phpunit/wiki/End-of-Life-for-PEAR-Installation-Method Installing PHPUnit via PEAR is no longer supported .] 

PEAR is a package manager for PHP, the MediaWiki PHPUnit installer attempt to use it as a first method. You will obviously need to install pear first.
<syntaxhighlight lang="bash">
sudo pear channel-discover pear.phpunit.de
sudo pear channel-discover components.ez.no
(contracted; show full)
If you get the error...
 This version of PHPUnit requires PHP 5.6.
...you either need to upgrade PHP or downgrade PHPUnit. PHPUnit 4.8 is compatible with PHP 5.5 and earlier.

== Notes ==

<references />