NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #4267 most downloaded on Packagist
A CakePHP plugin to shim applications between major framework versions.
Latest stable
3.9.2
Last release 1 months ago
11 Oct 2026
Release timing varies
gaps range from 2 weeks to 5 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
88 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
With this first release for CakePHP 3.x it is now easier than ever to upgrade existing CakePHP 2.x apps to the next major version. You might already h
With this first release for CakePHP 3.x it is now easier than ever to upgrade existing CakePHP 2.x apps to the next major version. You might already have shimmed your 2.x project using the corresponding branch of this plugin to ease migration upwards, but even without that you can leverage many of the included shims to make the upgrading process smoother and faster.
The idea:
Shims include
Many more shims are included in the 2.x branch already, so bottom line, if you want to save time and resources: In case you know you want to upgrade your 2.x app to 3.x, but it will still take a few months, maybe look ahead, use the tips provided (incl. the official migration guide on top) to avoid additional work in the future, use the 2.x Shim plugin versions in your project already and prepare for the upgrade as best as possible.
Happy baking!
Fixed inputDefaults shim false positives by @bancer in https://github.com/dereuromark/cakephp-shim/pull/87
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/dereuromark/cakephp-shim/compare/0.7.5...0.7.6
Fixed up deprecated keys for FormShimHelper
Added assertHeaderContains() for IntegrationTestCase
CakePHP 2.x maintenance release.
CakePHP 2.x maintenance release.
CakePHP 2.x maintenance release.
CakePHP 2.x maintenance release.
Configure::write('Shim.warnAboutBindModelMethod', true); added to warn you about the usage of bindModel() method.Configure::write('Shim.warnAboutValidateProperty', true); added to warn you if Model::$validate was set as a class property.Shim.Tree behavior fixed upCakePHP 2.x maintenance release.
CakePHP 2.x maintenance release.
Added 'Shim.warnAboutRelationProperty' Backported validationDefault() method Fixed some small issues
Backported Table::addAssociations()
Backported Table::addAssociations()
### Bugfixes Small 2.x fixes.
Small 2.x fixes.
Backport enableBeforeRedirect to allow disabling the requestAction() internal pseudo redirect for RequestHandler.
Backport enableBeforeRedirect to allow disabling the requestAction() internal pseudo redirect for RequestHandler.
Better handling of deprecation exceptions mainly.
Better handling of deprecation exceptions mainly.
Configure::write('Shim.deprecateSaveParams', true); can now help finding
Configure::write('Shim.deprecateSaveParams', true); can now help finding
$this->save($data, false, ['username'])
which should be
$this->save($data, ['validate' => false, 'fieldList' => ['username']]
Nothing published for this version
exists() in 3.x uses array and delete() requires an argument (no $this->id internally).
exists() in 3.x uses array and delete() requires an argument (no $this->id internally).
Some core components still use the now deprecated way. Those should be excluded from throwing notices.
Some core components still use the now deprecated way. Those should be excluded from throwing notices.
Also now shims saveField() via saveFieldById().
Param ext should be _ext in URL arrays
ext should be _ext in URL arraysfull_base should be _full in URL arraysLater those will be very hard to catch with those millions of lines changed when upgrading to 3.x. They will also be silently ignored then, so better to adjust them now already.
The TreeBehavior of 3.x has been shimmed. generateTreeList(), children() and getPath() will not be existent anymore.
The TreeBehavior of 3.x has been shimmed.
generateTreeList(), children() and getPath() will not be existent anymore.
You can now use the custom finders of 3.x in your 2.x app:
That includes the options that will now be the 2nd argument instead of a long list of arguments.
Note that the TreeBehavior has still to be loaded for the Model to be able to use those finders.
RequestHandlerComponent backport into 2.x for isMobile() and isTablet() using an up-to-date vendor library. In order to use that, you will need to com
RequestHandlerComponent backport into 2.x for isMobile() and isTablet() using an up-to-date vendor library.
In order to use that, you will need to composer require "mobiledetect/mobiledetectlib": "2.*".
Backport of _jsonOptions support for 2.x as well as setting the 3.x defaults here as well (JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_AMP | JSON_HEX_QUOT).
When upgrading your code to 3.x the output then doesn't change. These 4 flags are recommended to comply to RFC4627.
See the docs for details.
Conditionally deprecate better to allow people to react in time.
Conditionally deprecate better to allow people to react in time.
Add UrlShimHelper for Url::build() and alike
With the last addition you can then use $this->Url->build() (instead of $this->Html->url()) already in 2.x.
Using the MyUpgrade shell command cake Upgrade.MyUpgrade shim you can automate the migration.
Only disable recursive property with 'Shim.disableRecursive' Configure value set to avoid BC issues. Also fixed a small session issue.
Only disable recursive property with 'Shim.disableRecursive' Configure value set to avoid BC issues. Also fixed a small session issue.
Use Configure::write('Shim.checkPaths', true); to assert that all paths are correctly set up, including a trailing DS and the correct directory separa
Use Configure::write('Shim.checkPaths', true); to assert that all paths are correctly set up, including a trailing DS and the correct directory separator (as DS constant).
Routing speedup via precompiled and cached routes.php file.
field() shim + deprecation info
SEO duplicate content prevention
The Configure namespace has been changed from App to Shim.
Make sure you adjust it in your bootstrap/configs.
Some detection shims have been added to find left-overs of the deprecated $confirmMessage param used.
Some detection shims have been added to find left-overs of the deprecated $confirmMessage param used.
get() has been added to quickly retrieving records in controller actions (backport of 3.x).
assertResponseSuccess() added for 2xx/3xx range check (backport of 3.x).
Added two convenience methods for IntegrationTestCase:
Added two convenience methods for IntegrationTestCase:
It helps the migration process and provides tools to detect and resolve deprecations.
This plugin is mainly a shim towards 3.x when you are still forced to use 2.x for a while. It helps the migration process and provides tools to detect and resolve deprecations.
It also addresses some core issues and provides possible fixes or workarounds.
One column per quarter.