NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #2702 most downloaded on Packagist
CakePHP IdeHelper Plugin to improve auto-completion
Latest stable
2.23.1
Last release 1 months ago
11 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
207 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Fixed TemplateAnnotator for empty templates and also around inline doc blocks.
Vendor/PluginName.ModelName syntax now works.-f/--filter option for AnnotationsShell to more quickly annotate specific new files.Added a CodeCompletion shell on top of the existing ones to allow a more generic IDE support from now on. You can generate a basic file that any IDE s
Added a CodeCompletion shell on top of the existing ones to allow a more generic IDE support from now on. You can generate a basic file that any IDE should understand. With this you can provide correct typehinting now for a lot of magic properties and methods that so far haven't worked. See the documentation on details - and on how to write your own custom (project/plugin) tasks on top!
<img width="716" alt="code_completion" src="https://user-images.githubusercontent.com/39854/30979240-6e7e4bc6-a47d-11e7-8714-de1138b163f7.png">
Give it a try - and let me know in the Wiki or via PR (pull request) if your IDE works out or what might still be missing.
MCGA - Make CakePHP Great Again! :)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Auto-create the new ROOT folder if necessary for the meta file.
Generator:
Generator:
preemptive option enabled it will now also fetch and add all custom finders to auto-completion.
But it seems to only be possible to add them all globally for the time being. Thus not all of them will work, you need to still load the behavior for it first in some cases.Annotator:
Added even more IDE auto-completion for various magic strings:
Added even more IDE auto-completion for various magic strings:
'all', 'list', 'threaded' etcFurther:
loadComponent() for Controllers
Added IDE auto-completion for
Also now allows to customize or skip certain native generator tasks.
Fixed output of annotator. Count of added lines is now shown correctly.
Fixed output of annotator. Count of added lines is now shown correctly.
Also annotate the dynamic model factory calls:
Also annotate the dynamic model factory calls:
$this->loadModel('Users')$this->getTableLocator()->get('Users')Use own error code (2) for CI and dry-run.
Use own error code (2) for CI and dry-run.
Added meta file generation for PHPStorm that allows static factory method calls to be typehinted. For now mainly TableRegistry::get(...) calls are sup
Added meta file generation for PHPStorm that allows static factory method calls to be typehinted.
For now mainly TableRegistry::get(...) calls are supported out of the box.
You can also easily add your own custom tasks to be used for the generation of this file.
Allow App helpers to be added by default
Allow App helpers to be added by default
Careful: This is still an alpha feature and experimental. Please backup everything before using -r flag and/or use -d (dry run) preview.
Careful: This is still an alpha feature and experimental. Please backup everything before using -r flag and/or use -d (dry run) preview.
Often times you have a custom mapping of e.g. JSON, array or mediumtext/longtext columns in your DB.
The Bake plugin does not handle them all currently.
With the custom map config typeMap you can specify anything (and also overwrite the current IdeHelper defaults). If you want to unset, just set the value to false for a specific key.
preemptive config option has been added to be more pre-annotative especially in View templates.-r flag.Normalize the diff output on CLI.
Normalize the diff output on CLI.
Added support for pagination annotations in Controllers. This follows recent changes in Bake plugin that also does this.
Added support for pagination annotations in Controllers. This follows recent changes in Bake plugin that also does this.
Allow for global phpcs installation to work well with this plugin.
Allow for global phpcs installation to work well with this plugin.
### Adjustments Allow for new diff major.
Allow for new diff major.
Allow $ to be optional for property annotations.
IdeHelper.prefixes.Code modification relies on the PHP token parsing/updating of the PHP_CodeSniffer tool.
Code modification relies on the PHP token parsing/updating of the PHP_CodeSniffer tool.
Fix annotations for plugin controllers regarding components.
Fix plugin controller annotations
$this->Form->create($entity, ...) for template annotationsFix controllers and their component annotations
Fix controllers and their component annotations
Fix ModelAnnotator to replace property annotations.
Allow replacing of outdated $var annotations in templates instead of just adding or skipping.
$var annotations in templates instead of just adding or skipping.$var annotations replacing via description.Added component annotations for controllers incl. AppController.
Allow skipping of template folders
A diff output in verbose mode has been added. This is especially useful for -d (dry-run) mode.
-d (dry-run) mode.Adds proper table relations, now also works for chaining
Add annotations to existing code (e.g. when upgrading an application) just like baking would to new code.
Supported annotations by this plugin:
Admin).ctp files including elements)One column per quarter.