cakephp-shimBridge CakePHP versions

A zero-dependency compatibility layer that shims functionality up and down across major CakePHP versions — so large applications can be upgraded one step at a time.

Get Started

Upgrade Guide

View on GitHub

🌉

Smooth Upgrades

Keep large legacy codebases running on the new major version first, then refactor at your own pace. Touch far fewer lines to get green again.

🪶

Zero Dependencies

Apart from the framework core itself, this plugin pulls in nothing. It is safe to have around — nothing loads unless you actually use it.

🧩

Pick What You Need

Use only the pieces you want. Database types, ORM shims, controller traits, view helpers, and test utilities are all opt-in.

🗃️

ORM Compatibility

Re-use legacy table properties and behaviors, custom database types, and a paginator that still understands contain and conditions options.

🛡️

Type-Safe Controllers

Assert and cast request data into the right scalar types with the CastTrait — static-analyzer friendly for PHPStan and strict types.

🧪

Test Helpers

A TestSuite trait for invoking protected methods and properties, capturing console output, and conditional debug output for faster tests.