Skip to content

Commit

Permalink
[DOCUMENTATION] Update tests README
Browse files Browse the repository at this point in the history
  • Loading branch information
Jean85 committed Jan 20, 2016
1 parent a4d84e0 commit 2c70f4e
Showing 1 changed file with 17 additions and 18 deletions.
35 changes: 17 additions & 18 deletions tests/README.markdown
Original file line number Diff line number Diff line change
@@ -1,25 +1,24 @@
# Running the Doctrine 2 Testsuite

## Setting up a PHPUnit Configuration XML
To execute the Doctrine2 testsuite, you just need to execute this simple steps:

..
* Clone the project from GitHub
* Enter the Doctrine2 folder
* Install the dependencies
* Execute the tests

All this is (normally) done with:

## Testing Lock-Support
```
git clone [email protected]:doctrine/doctrine2.git
cd doctrine2
composer install
./vendor/bin/phpunit
```

The Lock support in Doctrine 2 is tested using Gearman, which allows to run concurrent tasks in parallel.
Install Gearman with PHP as follows:
## Pre-requisites
Doctrine2 works on many database vendors; the tests can detect the presence of installed vendors, but you need at least one of those; the easier to install is SQLite.

1. Go to http://www.gearman.org and download the latest Gearman Server
2. Compile it and then call ldconfig
3. Start it up "gearmand -vvvv"
4. Install pecl/gearman by calling "gearman-beta"
If you're using a Debian-derivative Linux distribution, you can install SQLite with:

You can then go into tests/ and start up two workers:

php Doctrine/Tests/ORM/Functional/Locking/LockAgentWorker.php

Then run the locking test-suite:

phpunit --configuration <myconfig.xml> Doctrine/Tests/ORM/Functional/Locking/GearmanLockTest.php

This can run considerable time, because it is using sleep() to test for the timing ranges of locks.
sudo apt-get install sqlite

0 comments on commit 2c70f4e

Please sign in to comment.