# idea-php-symfony2-plugin: Symfony support in PhpStorm that moved to a paid tier

> idea-php-symfony2-plugin adds Symfony awareness to IntelliJ IDEA and PhpStorm, from Twig and Doctrine helpers to console and annotation support. Since PhpStorm 2022.1 it is a freemium plugin: the open source features stay free, a minority are flagged as paid, and a license has to be activated in the IDE.

**Haehnchen/idea-php-symfony2-plugin** — IntelliJ IDEA / PhpStorm Symfony Plugin

- Repository: https://github.com/Haehnchen/idea-php-symfony2-plugin
- Website: https://plugins.jetbrains.com/plugin/7219
- Stars: 929 · Forks: 145
- Language: Java
- License: MIT
- Published: 2026-10-20 · Updated: 2026-10-20 · Language: en
- Canonical page: https://hysenlabs.com/projects/haehnchen-idea-php-symfony2-plugin

## A Symfony plugin that outlived its own name

The repository name still says symfony2, but the plugin supports Symfony 2, 3, 4 and onwards, and it is published on the JetBrains Marketplace as plugin 7219 under the id fr.adrienbrault.idea.symfony2plugin. It is a Java plugin for IntelliJ IDEA and PhpStorm, and its feature surface is broader than the name suggests. The repository topics list annotation, autocomplete, doctrine, drupal, twig, php, intellij and symfony, which is a decent summary of what a Symfony plugin ends up touching once it also tries to serve Drupal projects and other Symfony-adjacent frameworks. The plugin is installed the ordinary IDE way, from the plugin browser:

```bash
Settings -> Plugins -> Browse repositories
```

and then searched for Symfony. Documentation lives outside the repository, on espend.de/phpstorm/plugin/symfony, with a feature list and tutorials, while the repository carries a CHANGELOG and a MAINTENANCE document alongside the source. There is no GitHub release history for the project, so the Marketplace version and the CHANGELOG are where version facts live.

## Freemium since PhpStorm 2022.1, with a 15 minute grace period

This is the part of the plugin that changed the adoption conversation. The README states that since PhpStorm 2022.1 the plugin is marked as a Freemium, and that all features inside the GitHub repository are free to use unless there is a reason, for example supporting an old Symfony version. Non-free features are flagged with a paid marker in the documentation and in the CHANGELOG, so a reader can tell which is which before installing anything. Two practical details follow from the model. There is roughly a 15 minute grace period after opening a project during which all features are available, which is the trial window and also a diagnostic window, since a feature that stops working after fifteen minutes is a paid feature rather than a bug. And a license has to be activated through PhpStorm or IntelliJ, using the Help -> Register menu or by searching for the Manage License action in Search Everywhere. The licence itself is bought on the JetBrains Marketplace. For an evaluation, the grace period is generous enough to check the features your team actually uses, but it is per project opening rather than a month.

## The plugin is enabled per project and depends on the PhpStorm indexer

Two installation details catch people out. First, the plugin is enabled per project rather than globally, and the path is:

```bash
File -> Settings -> Languages & Framework -> PHP -> Symfony
```

A developer who installs the plugin once and opens a second project will find the features absent there, which reads like a broken install. Second, the plugin needs a valid PhpStorm indexer, and the README advises using File > Invalidate Caches / Restart when something is going wrong. That dependency on the IDE index is structural rather than a preference: a Symfony plugin resolves controllers, routes, services and container parameters by reading the project, so it inherits the indexer's state. A stale or broken index produces missing or wrong completions that look like plugin bugs. The README also recommends installing the Php Annotation plugin to get all of the annotation support, since the annotation features build on it rather than shipping their own parser.

## Autocomplete that needs CTRL+SPACE and a checklist of settings

The README has a dedicated section for autocomplete not working, and it is short enough to read as a support policy. Autocomplete usually needs to be triggered manually by pressing CTRL+SPACE, or a different shortcut depending on the keymap, which suggests the plugin does not force the completion popup open on every keystroke. The second item on the list is to check File -> Settings -> PHP -> Symfony -> Enable Plugin for this Project, the same per-project switch described above. The remaining troubleshooting advice is generic and points at the documentation and the issue tracker. The tracker has a requested format for new reports, asking which PhpStorm version you are on, which plugin version, a stack trace if an error occurred, and whether you are on the PhpStorm eap channel. A reporter who skips those fields will get a slower answer, since the plugin has to guess which IDE build introduced a behaviour change.

## Running the plugin from source through the Gradle runIde task

The build is Gradle based, with build.gradle.kts, settings.gradle.kts, gradle.properties and the wrapper scripts in the repository root, and a CI workflow that runs on the master branch. To work on the plugin you need IntelliJ IDEA, and the README says the Community Edition works fine. Open the project, open the Gradle tool window, and run the sandbox task:

```bash
idea-php-symfony2-plugin > Tasks > intellij > runIde
```

The runIde task starts a sandbox IDE instance with the plugin loaded, which is the standard way to test a plugin without installing a release into your working IDE. There is a prepare-release.sh script in the root, and the repository keeps a MAINTENANCE.md that documents build and deployment alongside the CHANGELOG. The tree also carries AGENTS.md, CLAUDE.md and a .claude directory, so some of the development workflow has been described for coding agents. The README also points at the JetBrains documentation on plugin development for anyone who is stuck on the toolchain itself.

## What the documentation leaves out

The README is a practical guide rather than a specification, and for a decision that means several things have to be checked elsewhere. It does not list which features are paid, only that paid features are flagged in the documentation and the changelog, so a team has to read both to price the plugin accurately. It does not state which Symfony versions map to which feature sets, beyond the general claim that Symfony 2, 3, 4 and onwards are supported, and the mention that supporting an old Symfony version is one reason a feature may not be free. It does not document an upgrade path from an older plugin version, or what happens to settings when the plugin moves between IDE builds. Compatibility with the PhpStorm eap channel is only mentioned as a troubleshooting question to include in a bug report, which is a hint that bleeding edge IDE builds can break behaviour. The screenshot labelled as a technical diagram is marked work in progress in the README itself, so the internals of how the plugin resolves the Symfony container are not documented there. For a team standardising on IntelliJ tooling, the practical entry point is the feature list on espend.de/phpstorm/plugin/symfony rather than the repository.

## Conclusion

idea-php-symfony2-plugin fits a PHP team on PhpStorm or IntelliJ IDEA that wants Symfony aware navigation and completion in the IDE and accepts the freemium licensing model, especially where the paid features are already covered by a JetBrains subscription. It does not fit a team that needs every feature for free, because the README states that non-free features are flagged as paid in the documentation and changelog, and it does not fit a team that cannot activate a license in the IDE. Verify first that the paid features you rely on are actually listed as paid rather than free in the documentation at espend.de/phpstorm/plugin/symfony, then confirm the 15 minute grace period behaviour matches how your developers open projects. The licence field on the repository says MIT, and the last push was on 2026-10-15.

## FAQ

### Is idea-php-symfony2-plugin free to use?

It is a Freemium plugin since PhpStorm 2022.1. All features inside the GitHub repository are free to use unless there is a reason, such as supporting an old Symfony version, and non-free features are flagged as paid in the documentation and in the CHANGELOG.

### How do I install the Symfony plugin in PhpStorm?

Go to Settings -> Plugins -> Browse repositories, search for Symfony and install it. You then have to enable it for the project through File -> Settings -> Languages & Framework -> PHP -> Symfony, and install the Php Annotation plugin to get the full annotation support.

### Why does autocomplete not work in idea-php-symfony2-plugin?

The README says you usually need to trigger the autocomplete popup yourself with CTRL+SPACE, depending on your keymap, and to check that Enable Plugin for this Project is set under File -> Settings -> PHP -> Symfony. The plugin also needs a valid PhpStorm indexer, so File > Invalidate Caches / Restart is the next thing to try.

### Which Symfony versions does the plugin support?

The README states that the plugin supports Symfony 2, 3, 4 and onwards. Some features that relate to older Symfony versions are among the ones that can be marked as paid.

### How do I activate a license for the Symfony plugin?

A license has to be activated through PhpStorm or IntelliJ, using the Help -> Register menu or by using Search Everywhere to find the Manage License action. The licence is bought on the JetBrains Marketplace, and there is a grace period of roughly 15 minutes after opening a project during which all features are available.

## Sources

- [Haehnchen/idea-php-symfony2-plugin on GitHub](https://github.com/Haehnchen/idea-php-symfony2-plugin)
- [Issues](https://github.com/Haehnchen/idea-php-symfony2-plugin/issues)
- [License: MIT](https://github.com/Haehnchen/idea-php-symfony2-plugin/blob/master/LICENSE)
- [Project website](https://plugins.jetbrains.com/plugin/7219)
- [README](https://github.com/Haehnchen/idea-php-symfony2-plugin/blob/master/README.md)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/haehnchen-idea-php-symfony2-plugin