Difference between revisions 555398 and 555443 on mediawikiwiki

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

You must have PHPUnit 3.5.0 (or later) installed to run the unit tests. Most developers uses 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 with <code>sudo</code>.
}}

(contracted; show full); /some/path/to : is the installation prefix which depends upon your distribution and the installation method used. Usually one of <tt>/usr<tt>, <tt>/usr/local/</tt> or <tt>/opt/local/</tt>.
; A.B.C: is the PHPUnit version

If you have something similar to <tt>phpunit --version</tt> output above, you should be fine and can start [[Manual:PHP unit testing/Running the unit tests|running the unit tests]].

----

== 
PossibleKnown issues ==

; The a=== Apt packages for Ubuntu 11.10 are known to be broken⏎
⏎
:   ===⏎
Installation using PEAR will be the preferred way. You may have to update the installation of PEAR itself on your machine:
: <source lang="bash">
$ pear upgrade pear
</source>

: When running into an error such as [http://pastebin.com/iP1rgc8Z this one], [http://stackoverflow.com/questions/1528717/phpunit-require-once-error this] should help you out. <ref>https://bugzilla.redhat.com/show_bug.cgi?id=758832</ref>

;=== Class File_Iterator not found⏎
:  ===⏎
This might happen when trying to run PHPUnit under Ubuntu 11.04.
:<source lang="bash">
$ phpunit --version
PHP Fatal error:  Class 'File_Iterator' not found in /usr/share/php/File/Iterator/Factory.php on line 105
</source>

: ⏎
⏎
You will have to alter the PHPUnit source code shipped by Ubuntu:
: * Edit <tt>/usr/share/pear/File/Iterator/Factory.php</tt>
: * on line 44 add <tt>require_once 'File/Iterator.php';</tt>.
: (Or install using PEAR).⏎
⏎


If that doesn't work, or you're on '''Windows'''-family operating systems, follow the [http://www.phpunit.de/manual/current/en/installation.html '''installation instructions'''] in the PHPUnit manual.
;⏎
=== <code><nowikiDiffHistoryBlobTest::testXdiffAdler32</code> test failing ===
:<tt>DiffHistoryBlobTest::testXdiffAdler32 with data set <nowiki>#0 ('', 'Empty string') String is not zero-terminated ()</nowiki></code>

: tt><br/>'''xdiff_string_diff()''' [tests/002.phpt], '''xdiff_string_patch()''' [tests/006.phpt] and '''xdiff_string_merge3()''' [tests/010.phpt] unit tests fail.
: ⏎
⏎
This is [[:bugzilla:35110|bug 35110]] and [https://bugs.php.net/bug.php?id=61358 PHP  #bug 61358]. ⏎
: This might happen when using version of [http://pecl.php.net/package/xdiff pecl-xdiff PHP extension] older than 1.5.2 with PHP 5.3.10+. ⏎
: To fix, please upgrade pecl-xdiff extension to [http://pecl.php.net/package-changelog.php?package=xdiff version 1.5.2 or newer]. The '''xdiff''' tool is not affected by this problem.

== Notes ==

<references />