Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
99 lines (52 sloc) 2.92 KB


Propel2 is an open-source Object-Relational Mapping (ORM) for PHP 5.3.

Build Status


Propel2 uses the following Symfony2 Components:

Propel2 also relies on Composer to manage dependencies but you also can use ClassLoader (see the autoload.php.dist file for instance).

Propel2 is only supported on PHP 5.3.3 and up.


Read the Propel documentation.


Everybody can contribute to Propel2. Just fork it, and send Pull Requests. You have to follow Propel2 Coding Standards and provides unit tests as much as possible.

Note: you can fix checkstyle before to submit a Pull Request by using the Symfony2 check_cs script. You just need to install Finder and the script:

git clone git:// vendor/Symfony/Component/Finder


Then use it:

php php-cs-fixer.phar fix .

Unit Tests

To run unit tests, you'll have to install vendors by using Composer. If you don't have an available composer.phar command, just download it:


If you haven't wget on your computer, use curl instead :

curl -s | php

Then, install dependencies:

php composer.phar install


The Propel test suite requires a database (test for instance, but feel free to choose the name you want), and three database schemas: bookstore_schemas, contest, and second_hand_books.

Here is the set of commands to run in your shell in order to setup requirements if you want to use MySQL:

mysql -uroot -e 'create database test'
mysql -uroot -e 'create schema bookstore_schemas'
mysql -uroot -e 'create schema contest'
mysql -uroot -e 'create schema second_hand_books'

Once done, build fixtures (default vendor is mysql):

bin/propel test:prepare


Create mandatory databases, then run:

bin/propel test:prepare --vendor=postgres --dsn="dbname=test" --user="postgres"


There is nothing to setup, just run:

bin/propel test:prepare --vendor=sqlite --dsn="sqlite:/tmp/database.sqlite" --user="" --password=""

Now you can run the test suite by running:


You can also pass a --verbose argument if you want to know where tests fail. It's useful if you want to contribute.


See the LICENSE file.

Jump to Line
Something went wrong with that request. Please try again.