RedBeanPHP 4
The Power ORM


RedBeanPHP is actively developed by a community of open source developers.

Future versions

This roadmap can change every moment but my plan for RedBeanPHP is pretty simple. As of version 4.0 RedBeanPHP has reached full maturity. Therefore I do not intend to add many more features because that would only make the library bloated, instead I will focus on maintenance, fixing bugs (if there are any ;) ), improving performance, testing and maybe add some convenience methods here and there.

We are currently not testing a beta release. Next beta test: March 2015.

RedBeanPHP 4.2 (April 2015)

  • DONE (shipped in 4.1.4)Add static public R::$f to improve backward compatibility for people using QueryBuilder from 3.5
  • REJECTED Keep parent bean and parent id in sync (researching)
  • DONE (shipped in 4.1.4)Throw exception if a method on a model does not exist
  • DONEAutomatically resolve aliases using foreign key inspection (researching)
  • Support for cursors (for large datasets)
  • R::findOrCreate() to directly create a bean with certain values if it does not exist yet
  • hasChanged should be able to give info for lists as well (researching)
  • DONE Add CUBRID QueryWriter to core again and improve it*
  • Improving documentation
  • Regular maintenance & clean up
  • More tests

RedBeanPHP 4.3 (October 2015)

  • Compatibility with PHP 7
  • Refactor Replica build script to use native PHP arrays instead of XML
  • Easier way to setup logging
  • Support for Firebird/Interbase databases*
  • Improving documentation
  • Regular maintenance & clean up
  • More tests

RedBeanPHP 4.4 (April 2016)

  • Improve CLI interface
  • Support for Apache Derby*
  • Improving documentation
  • Regular maintenance & clean up
  • More tests

RedBeanPHP 4.5 LTS (October 2016)

  • Support Ingres Database*
  • Improving documentation
  • Regular maintenance & clean up
  • More tests

RedBeanPHP 4.6 (April 2017)

  • Support more databases*
  • Maintenance and testing

* Supporting new databases is quite an undertaking. Please do not rely on this schedule for future database support. Supporting a new database is always tricky and may take more time than expected. My intention is to implement support for lots of database platforms, however I do not have much time so I can't promise anything. Anything regarding database support in this schedule must be regarded as mere intentions, nothing more.

Release cycle

The release cycle of RedBeanPHP is two times a year; a spring release and an autumn release. This means every six months there will be a new version of RedBeanPHP.

  • Spring Beta release: March
  • Spring Final release: April
  • Autumn Beta release: September
  • Autumn Final release: October


RedBeanPHP uses a very sane version numbering system. The version number tells you something about the version; it has meaning. All RedBeanPHP versions have a version number. The version number consists of three parts; major, minor and point release.

Version X.X.X



Major version

When the major version number increases, this means the new version is NOT backward compatible with all previous versions. Most of the time this means you better not use it in your current project if you are already using RedBeanPHP or you might have to make some changes to the project to make it work with the new version of RedBeanPHP. This is not always as bad as it sounds. For instance version 3 is not backward compatible with version 2, but only if you use the optimizers (which by default are turned off). So while this is a major version bump it's actually not that bad. However, while difference between 2 and 3 is relatively small, the gap between 1 and 2 was a really big one. Anyway whenever the major version number changes make sure you check the changelog to determine whether you can upgrade or not.

Minor version

A minor version change means new features! Minor versions don't break backward compatibiltity, they just mean new features have been added. Often, this goes hand in hand with changes in documentation or bugfixes. Therefore it's relatively safe to do a minor upgrade. Be sure though to check the changelog on the website. You might be able to take advantage of the new features!

Point version

A point version or point release happens when the last digit has been increased. Note that although you might assume a digit normally varies from 0-9, you might encounter minor and point releases like X.X.12 or X.30.X. Not sure if this will happen, however as RedBeanPHP matures you will see less major upgrades and more minor upgrades and point releases. A point release version is normally a maintenance version. This may include bugfixes, new tests, documentation changes or just some code cleanup. While it's always a good idea to scan the changelog most of the time you can be pretty sure there are no compatibility issues nor interesting new feature. Of course if you have reported an issue the point release can be quite interesting because the bug might have been fixed. In this case, the Github bug report number and the fix will be mentioned in the changelog.


RedBeanPHP Easy ORM for PHP © 2015 () and the RedBeanPHP community () - Licensed New BSD/GPLv2 - RedBeanPHP Archives