Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Guard::PHPUnit automatically runs your tests

tag: v0.0.3

Fetching latest commit…

Cannot retrieve the latest commit at this time

Guard::PHPUnit Build Status

PHPUnit guard allows to automatically & intelligently launch tests when files are modified.

Tested on MRI Ruby 1.8.7, 1.9.2 and 1.9.3.


Please be sure to have Ruby running on your machine. The latest versions of Ruby come with a packages-manger called Gem. Gem can be used to install various packages, including PHPUnit guard.

Before you continue, also make sure you have the Guard gem installed

To install the PHPUnit gem, run the following command in the terminal:

gem install guard-phpunit


Please read the Guard usage documentation.


Guard::PHPUnit can be used with any kind of PHP projects that uses PHPUnit as its testing framwork. Please read the Guard documentation for more information about the Guardfile DSL.

By default, Guard::PHPUnit will use the current working directory (pwd) to search for tests and run them on start (if you enabled the :all_on_start option).

Example PHP project

The PHPUnit documentaion uses the Object Freezer library as an example on how to organize tests. This project uses the Tests directory for its tests.

An example of the Guardfile for the same project would look something like:

guard 'phpunit', :tests_path => 'Tests', :cli => '--colors' do
  # Watch tests files

  # Watch library files and run their tests
  watch(%r{^Object/(.+)\.php}) { |m| "Tests/#{m[1]}Test.php" }


The following options can be passed to Guard::PHPUnit:

:all_on_start => false        # Run all tests on startup.
                              # default: true

:tests_path => 'tests'        # Relative path to the tests directory. This path
                              # is used when running all the tests.
                              # default: the current working directory (pwd)

:cli => '--colors'            # The options passed to the phpunit command
                              # when running the tests.
                              # default: nil


Pull requests are very welcome! Make sure your patches are well tested. Please create a topic branch for every separate change you make.


Maher Sallam

Something went wrong with that request. Please try again.