The Blog

❊ Perpl ❊ 2.7 Released

The ❊ Perpl ❊ Team – 30 March 2026

Do away with the winter blues, we have some springtime news:

We have released ❊ Perpl ❊ 2.7 in March and ❊ Perpl ❊ 2.6 earlier in November.

Also, we have a new repo! It enables you to create a Docker test environment and is avalaible under https://github.com/perplorm/perpl-test-docker, see also our Announcement info.

We are continuously working on stabilizing, cleaning up and improving the old code while also adding fresh new stuff:

Feature Highlights

  • Support for PHP 8.5 and Symfony 8 components with Symfony 5 support removed in PR #98 and PR #103
  • Since PR #83 we use fully typed column fields in objects from generated classes. This also affects the generated phpDoc blocks removing the typehint from the docblock if applicable. This behavior can be overridden by setting the newly introduced config key generator.objectModel.typeColumnDataFields to false
  • Native ENUM and SET column type support for MySQL and PostgreSQL in PR #99
  • Improving the CLI interface with more useful messaging in PR #93
  • Adding a new CLI command config:preview in PR #94
  • Disabling virtual file system in tests is now possible since PR #88

Improvements and Bugfixes Highlights

  • Separate templates from class code in PR #109
  • cleanup and streamline model methods in PR #89
  • Fixed relation type hints to reference Stub class instead of Base class in PR #111
  • Underscore methods like ->_if() and ->_endif() no more silently produce wrong queries when the underscore is forgotten but throw an exception since PR #110 and additionally types have been added to those and other conditional methods using PropelConditionalProxy in PR #113
  • Fixed wrong SQL generated in queries while filtering array columns with Criteria::CONTAINS_ALL, Criteria::CONTAINS_SOME or Criteria::CONTAINS_NONE, see PR #91
  • Fixed failed CI runs with some Symfony versions in PR #87, for further information see also this Symfony CVE

Compare all changes to version 2.5 under https://github.com/perplorm/perpl/compare/v2.5.0...v2.7.0

Download

You can download & install ❊ Perpl ❊ via Composer. Please give it a try and report any bugs you spot:

{
  "require": {
    "perplorm/perpl": ">=2.0"
  }
}

Of course you can also download the zipped or tarred source code from our releases.

All releases: github.com/perplorm/perpl/releases

❊ Perpl ❊ 2.5 Released

The ❊ Perpl ❊ Team – 08 November 2025

❊ Perpl ❊ has a new release!

We have released ❊ Perpl ❊ 2.5.

Also, we have decided to move the ❊ Perpl ❊ repository to its own organisation, https://github.com/perplorm/. This website had already been moved to the new organisation, now we are making it official with the main repository!

Features

We are continuously working on stabilizing, cleaning up and improving the old code:

  • Further refined filter system in PR #28, PR #33 and PR #70
  • Better handling of DateTime objects and the timestampable behavior
  • Better code testability
  • And as always: various bugfixes & code cleanup
  • Preview: there is WIP for better typing in generated classes

Compare all changes to the previous release under https://github.com/perplorm/perpl/compare/v2.4.0...v2.5.0

Documentation

To reflect the continuous progress in ❊ Perpl ❊, this documentation has also been updated:

  • Added update-info time stamps on each page of the documentation (main headline and footer) so you will always know, when a particular documentation page has been last updated!
  • Added a ❊ new ❊ indicator for newly added pages
  • Documented the new synced_table behavior from PR #10
  • Documented the new config_store behavior from PR #13
  • Documented of the new bulk-load table attribute from PR #15
  • Added a note on the new option to use multiple user-contributed behaviors from the same Github repo
  • Finally fixed the active link indication of the page you are currently visiting after 12 years (*lol*)
  • Replaced and fixed a lot of dead, old and http-only links
  • Introduced a site-wide dark mode!
  • Changed the whole color scheme to purplish hues to visually reflect the difference to the old Propel homepage
  • Added conditional splitting of blog post previews to better handle & separate long and short posts on the blog page
  • Replaced some old libraries
  • Replaced the old table join chart with a more clean and legible inline version
  • Fixed multiple typos

Download

You can download ❊ Perpl ❊ via Composer. Please give it a try and report any bugs you spot:

{
  "require": {
    "perplorm/perpl": ">=2.0"
  }
}

All releases: github.com/perplorm/perpl/releases

❊ Perpl ❊ Released

The ❊ Perpl ❊ Team – 04 June 2025

❊ Perpl ❊ aims to proceed where the original Propel seems to be stuck and unmaintained at the moment.

The initiative for this new start originated in discussions on the original repository between different Propel enthusiasts and Moritz Ringler gave it a headstart so it could be realised.

Since April 2025, three releases of ❊ Perpl ❊ have been made availaible.

Additionally the original Propel documentation has been forked in June and made available under this website and will also be improved step by step.

You will still find a lot of places where there are still links to the original Propel repositories but those will be gradually replaced over time with according links for ❊ Perpl ❊.

Also, as you might find, we are still experimenting with branding.

Features

Some of the new and improved features below:

  • Runs successfully tested for PHP 8.4
  • Improved type-preserving
  • Code cleanup for better readability and maintainabilty
  • Performance improvements
  • Enhanced filter system for easier performing complex queries
  • New and improved behaviors
  • Added option for importing multiple user-contributed behaviors from the same (user) repo
  • Deprecation of some old internal methods

For the (few) BC-breaking changes and more detailed information on new and updated features, please visit https://github.com/perplorm/perpl

Download

You can download ❊ Perpl ❊ via Composer. Please give it a try and report any bugs you spot:

{
  "require": {
    "perplorm/perpl": ">=2.0"
  }
}

All releases: github.com/perplorm/perpl/releases

Of course all of this would not have been possible without the original Propel Team & countless other people!

As Isaac Newton said: If I have seen further it is by standing on yͤ shoulders of Giants.

Propel2 Beta 2 Release

The Propel Team – 04 July 2022

With this release, we continue version cleanups aiming API stabilization.

Many thanks to our contributors!

2.0.0-beta2

Here are the changes:

  • PHP 8.1 and 8.2 compatibility
  • Added strict types to generated code
  • Added Symfony 6 support
  • Dropped Symfony 3 support. The minimum required Symfony version is 4.4.0 now.
  • Added Monolog 2 support
  • Added a type safe access to the StandardServiceContainer via Propel::getStandardServiceContainer() method
  • Added support for the DATETIME column type
  • Moved templates into own root level
  • Overall code quality improvements
  • Fixed DatabaseComparator in order to skip migration creation if table has skipSql flag
  • Fixed an issue with many-to-many mapping
  • Fixed usage of deprecated date format
  • Fixed column’s time format issue
  • Fixed issue with identifier quoting being ignored
  • Fixed a debug mode behavior in order to use new connection with it

BC breaking impact

Please note that all methods have param and return types being added now where they were feasible and ensure better code quality. Make sure any extensions are updated here regarding their method signature. TIMESTAMP column type in schema files for the MySql databases now generates column with actual TIMESTAMP type instead of DATETIME as it was previously. Propel diff considers it as a table structure change and generates migration. As another side effect timestamps are only valid until 2037 (32bit). Make sure to adjust any databuilders or fixtures accordingly.

Download

You can download this release as usual via Composer. Please give it a try and report any bugs you spot:

{
  "require": {
    "propel/propel": "2.0.0-beta2"
  }
}

All changes/commits: github.com/propelorm/Propel2/compare/2.0.0-beta1…2.0.0-beta2

All releases: github.com/propelorm/Propel2/releases

Propel2 Beta 1 Release

The Propel Team – 07 December 2021

With this release, we continue version cleanups aiming API stabilization.

Many thanks to our contributors!

2.0.0-beta1

Here are the changes:

  • PHP 8.1 compatibility
  • Fixes for PHP 7.4 preloading
  • Fixed usage of default on-update and on-delete behavior
  • Show names of uncommitted migrations
  • BehaviorLocator now looks in dev packages, as well
  • Aggregate multiple columns behavior & parameter list support
  • Fixes around aliases and cross joins and subqueries
  • Added support for keytype in the magic import/export methods
  • PSR naming fixes for variables and methods
  • Reset partial flag when populating a relation
  • Added exists operator
  • Escape quotes in behavior
  • Quote primary table name if identifier quoting is enabled
  • Formats insert DATE values as Y-m-d instead of Y-m-d H:i:s.u
  • Allow default-value for concrete-inheritance to be instantiable
  • Pluralize Box to Boxes
  • Allow NO ACTION for foreign key references (in the dtd/xsd)
  • Use object-equality instead of reference-equality to compare object properties
  • Generates data dictionary documentation
  • PHPStan related code cleanup

BC breaking impact

Please note that methods have param and return types being added now where they were feasible and ensure better code quality. Make sure any extensions are updated here regarding their method signature. Some internal methods were also renamed to fit PSR coding standards.

Due to the support of PHP 7.4 preloading, an update will need the configuration to be rebuilt once by calling config:convert, see https://github.com/propelorm/Propel2/wiki/Exception-Target:-Loading-the-database#for-imported-configuration

Download

You can download this release as usual via Composer. Please give it a try and report any bugs you spot:

{
  "require": {
    "propel/propel": "2.0.0-beta1"
  }
}

All changes/commits: github.com/propelorm/Propel2/compare/2.0.0-alpha12…2.0.0-beta1

All releases: github.com/propelorm/Propel2/releases