/cakephp-ide-helper

IDE Helper plugin for CakePHP

Primary LanguagePHPMIT LicenseMIT

CakePHP IdeHelper Plugin

Build Status Coverage Status Latest Stable Version Minimum PHP Version License Total Downloads

IdeHelper plugin for CakePHP applications.

Boost your productivity. Avoid mistakes.

This branch is for use with CakePHP 3.7+. For details see 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. 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)
  • View (AppView)
  • Templates (.ctp files including elements)
  • Shells (and Tasks)
  • Components
  • Helpers

Screenshot

Supports code completion help for:

  • Behaviors (property access on the BehaviorRegistry)

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 (incl. meta file generator)
  • IntelliJ
  • Atom
  • VS Code
  • ... [Report or PR your IDE of choice here to confirm its full compatibility]

See 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:

  • Queue for QueuedJobsTable::createJob() usage.
  • Service for loadService() usage.
  • ... (add yours here)

Plugins with illuminator tasks

  • StateMachine for syncing states from XML into PHP.
  • ... (add yours here)

Install, Setup, Usage

See the Docs for details.