Propel2

Propel2 is an open-source Object-Relational Mapping (ORM) for PHP 5.5 and up.

Requirements

Propel2 uses the following Symfony2 Components:

• Console
• Yaml
• Finder
• Validator
• Filesystem

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.5 and up.

Installation

Read the Propel documentation.

Contribute

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. Also check out the roadmap to get an overview of what we are working on!

Please see our contribution guideline. Thank you!

Status of the project

Never ending alpha releases?

Propel v2 started as very big refactoring of the old Propel version 1, making it PSR1-2 compatible, introducing namespaces
and refactoring a lot of internal stuff.
However, the heart (and most complex code at the same time) of Propel 1 and 2 is the
Query
and
Object classes builder,
together 8k unmaintainable lines of code. These 2 files (and with it the architecture) is the main problem why we can not
release a stable version, because it never went stable and due to the lack of contributions (and mean, nobody is surprised
when you look at the very complex structure of those 2 files) we are simply not able to release a version that indicates
that you get somehow support for bugs and new features, which is our aspiration to do so once a official stable version is tagged.

Because Propel2 took so much time (several years) and ActiveRecord (the way it was built in Propel1 and 2) is not modern
anymore (only hardly testable, not so much enjoyable) along with other reasons, we decided to rewrite the very heart of Propel.
The result is Propel3 a data-mapper implementation with optional active-record traits.
It is much cleaner now, is able to support also NoSQL databases and its data-mapper implementation allows you to write tests
in a more enjoyable way. To sum up: A very modern approach that is also designed to work in a high-performance
application-server environment like PHP-PM.

In our eyes it makes no sense to tag a Propel2 stable version, because there is simply too less manpower on this very complex
project, we do not want to maintain an old obsolete architecture and want to invest our life time more in a modern approach
of doing ORM in modern PHP.

Our advice:

1. Use Doctrine if you are looking for a long-term supported, full-featured (and difficult to learn) and stable ORM.
2. Use easy to learn Eloquent for prototyping and smaller projects.
3. Help us build Propel3, which aims someday to be both of the above.

License

See the LICENSE file.