Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dereuromark/cakephp-ide-helper
IDE Helper plugin for CakePHP
https://github.com/dereuromark/cakephp-ide-helper
annotations autocompletion cakephp cakephp-plugin ide-helper support-annotations typehinting
Last synced: 9 days ago
JSON representation
IDE Helper plugin for CakePHP
- Host: GitHub
- URL: https://github.com/dereuromark/cakephp-ide-helper
- Owner: dereuromark
- License: mit
- Created: 2017-02-18T15:25:50.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-10-17T10:11:29.000Z (22 days ago)
- Last Synced: 2024-10-19T14:29:50.771Z (20 days ago)
- Topics: annotations, autocompletion, cakephp, cakephp-plugin, ide-helper, support-annotations, typehinting
- Language: PHP
- Homepage:
- Size: 2.3 MB
- Stars: 183
- Watchers: 15
- Forks: 39
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: docs/Contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-phpstorm - CakePHP IdeHelper - Framework plugin for better IDE autocomplete/typehinting support. (Plugins / Frameworks)
- awesome-cakephp - IdeHelper plugin - Helps to make IDE support better by adding annotations to your existing code similar to what baking does to new code. (Code Analysis)
README
# CakePHP IdeHelper Plugin
[](https://github.com/dereuromark/cakephp-ide-helper/actions/workflows/ci.yml?query=branch%3Amaster)
[](https://app.codecov.io/github/dereuromark/cakephp-ide-helper/tree/master)
[](https://phpstan.org/)
[](https://packagist.org/packages/dereuromark/cakephp-ide-helper)
[](https://php.net/)
[](LICENSE)
[](https://packagist.org/packages/dereuromark/cakephp-ide-helper)
IdeHelper plugin for CakePHP applications.
> Boost your productivity. Avoid mistakes.
This branch is for use with **CakePHP 5.0+**. For details see [version map](https://github.com/dereuromark/cakephp-ide-helper/wiki#cakephp-version-map).
## Features
The main idea is to improve IDE compatibility and use annotations to make the IDE understand the
"magic" of CakePHP, so you can click through the class methods and object chains as well as spot obvious issues and mistakes easier. The IDE will usually mark problematic code yellow (missing, wrong method etc).
This also improves compatibility with tools like [PHPStan](https://github.com/phpstan/phpstan).
Those can then follow the code easier and provide more valuable help.
- Add annotations to existing code (e.g. when upgrading an application) just like baking would to new code.
- Can run multiple times without adding the annotations again.
- It can also replace or remove outdated annotations.
- Works with your application as well as any loaded plugin.
- CI check support, hook it up just like the coding standards check.
Supports annotations for:
- Models (Tables and Entities)
- Controllers (including prefixes like `Admin`) and Components
- View (AppView) and Helpers
- Templates (`.php` PHP template files including elements)
- Commands, Shells and Tasks
- ... and more
Supports code completion help for:
- Behaviors (property access on the BehaviorRegistry)
Supports IDE autocomplete/typehinting of (magic)strings as well as return types/values for:
- Plugins, Components, Behaviors, Helpers, Mailers
- Associations, Validation
- I18n Translation, Cache
- Elements and layouts
- Tables and their fields
- Route paths, Request/ENV, Connection
- ... and more (using PhpStorm meta file)
Supports better IDE usage with Illuminator tasks to enhance existing code:
- EntityFieldTask adds all entity fields as class constants for easier usage in IDEs
### IDE support
This plugin is supposed to work with ANY IDE that supports annotations and code completion.
IDEs tested so far for 100% compatibility:
- **[PhpStorm](https://github.com/dereuromark/cakephp-ide-helper/wiki/PHPStorm)** (incl. meta file generator)
- IntelliJ
- Atom
- **[VS Code](https://github.com/dereuromark/cakephp-ide-helper/wiki/Visual-Studio-Code)**
- ... [Report or PR your IDE of choice here to confirm its full compatibility]
See [Wiki](https://github.com/dereuromark/cakephp-ide-helper/wiki) for details and tips/settings.
### Plugins with meta file generator tasks
The following plugins use this plugin to improve IDE compatibility around factory and magic string usage:
- [Migrations](https://github.com/cakephp/migrations) for migration file writing (included in IdeHelper directly).
- [Queue](https://github.com/dereuromark/cakephp-queue) for `QueuedJobsTable::createJob()` usage.
- [Burzum/CakeServiceLayer](https://github.com/burzum/cakephp-service-layer) for `loadService()` usage.
- ... (add yours here)
### Plugins with Illuminator tasks
- [StateMachine](https://github.com/spryker/cakephp-statemachine) for syncing states from XML into PHP.
- ... (add yours here)
### More
More collections of useful tasks can be found in the [IdeHelperExtra plugin](https://github.com/dereuromark/cakephp-ide-helper-extra).
### Install, Setup, Usage
See the **[Docs](docs/)** for details.