JetBrains released PhpStorm 2026.3 on November 5, 2026, its third major PhpStorm version this year. The update ships JetBrains Air for running coding agents inside the IDE, adds PHP 8.6 support ahead of that language release, and reworks how the IDE handles WSL and remote machines.
The release matters for PHP teams because PHP 8.6 is due later in November. Developers can start testing their code against the new version now, while Laravel users get extra inspections and a place to manage long-running processes.
PHP 8.6 support and smarter type inference
You can point the IDE at PHP 8.6 through the PHP language level setting or through the php constraint in composer.json. Once set, PhpStorm offers completion and type inference for the functions, classes and APIs that arrive in the new version.
A new inspection flags any constructor or destructor that returns something or uses yield, both deprecated in PHP 8.6. A matching quick-fix strips the returned value but keeps early exits. The IDE also warns about the deprecated mb_ereg family of functions.
Projects that still target PHP 8.5 or older are covered too. PhpStorm highlights 8.6-only syntax as well as uses of newly added functions like clamp(). For readonly properties with a default value, it suggests moving the initialization into the constructor.
Type inference improves for generics, callables and array shapes. The list includes the @param-closure-this tag, templates in @method declarations, generic factories taking a class-string argument, and arrays assembled with spread syntax.
JetBrains Air and agent tooling
Air is the new agentic development layer that JetBrains is adding across its IDEs. In PhpStorm it supports Claude Agent, Junie, Codex, GitHub Copilot, Gemini, OpenCode and any other agent compatible with the Agent Client Protocol. Agents you have set up locally are found automatically and can be linked with a single click.
Existing subscriptions, API keys and custom base URLs carry over, and no JetBrains AI subscription is needed. A free Junie Lite configuration is included for anyone with a JetBrains Account. Agent sessions, files and diffs open side by side in editor tabs.
While reviewing agent output, you can attach a note to one line of the diff and pass it back to the agent. With the PhpStorm MCP server on, agents can run PHP and Laravel inspections and apply fixes themselves. A bundled php-runtime-tools skill gives them the project interpreter rather than the system PHP.
Laravel, Git and terminal updates
Laravel support adds several inspections that work both in the editor and through MCP:
- Unknown config keys, which catches configuration lookups that do not exist.
- Missing resource route methods in Laravel routes.
- Unknown Livewire component methods.
- A new Processes tab in the Laravel tool window for long-running jobs such as queue workers, the development server and npm scripts.
Git worktrees get more practical. PhpStorm can copy your local .idea settings, including run configurations, into each new worktree. A .worktreeinclude file lists extra local or ignored files to copy, and a custom script can run on creation, for example to install Composer dependencies.
GitHub pull requests and GitLab merge requests can now be opened in their own worktree, so your branch and uncommitted edits stay untouched. GitLab accounts can also be linked through a browser OAuth sign-in instead of a personal access token.
The built-in terminal now runs on libghostty, the library behind the Ghostty terminal. JetBrains says this improves shortcuts, emoji and styling for command-line tools, including AI agents. Terminal tabs can also be moved into the editor area and split next to source files.
WSL, remote development and databases
For Windows users on WSL, PhpStorm now finds every PHP binary in a distribution and fills in the connection details automatically. Xdebug connections are forwarded into the distribution, so debugging with a WSL interpreter needs no extra network setup. File pickers in Composer, test and quality tool settings open WSL paths directly.
Remote development is now started from inside the IDE through a built-in SSH flow. A light mode lets you edit, search and use the terminal while the remote IDE is still installing. JetBrains IDEs also switch to native OpenSSH, which adds certificate login, YubiKey tokens, Kerberos SSPI, X11 forwarding and ProxyJump.
The database tools add a Workspace data source built on DuckDB that runs in memory. It lets you join tables from different data sources, even different database systems, in one query. Agents in Air can also run SQL and reference database objects from the chat.
What it means for developers
The most useful step right now is to set the language level to PHP 8.6 on a branch and let the new inspections list what needs attention. Fixing deprecated constructor returns and mb_ereg calls early will make the actual upgrade far less stressful.
Teams that already use agents should look at the MCP integration. Letting an agent run the same inspections a developer sees is a cheap way to catch broken config keys or missing route methods before review.
Windows shops that moved PHP work into WSL should notice less manual setup, especially around Xdebug. Note also that PhpStorm now sends error and freeze reports to JetBrains by default. You can disable this under Settings, Appearance and Behavior, System Settings, Data Sharing if your company policy requires it.
Developers who use more than one JetBrains IDE will see the same Air, worktree and OpenSSH changes elsewhere. Our coverage of IntelliJ IDEA 2026.3 and of GitHub Copilot in JetBrains Air gives more context.
Other changes
The old Welcome screen gives way to a Home window where you can open a single file, use the terminal, or reach Git and database tools before any project loads.
Accessibility work adds sound cues for errors, version control line marks and finished builds or tests. A plugin called LSP Connection Manager lets you attach any Language Server Protocol server from the settings.
JetBrains also reports many freeze fixes, covering Composer-based projects, Twig debugging, type inference and deployment, achieved by moving blocking work off the UI thread.
Conclusion
PhpStorm 2026.3 arrives just in time for PHP 8.6 and pairs that support with a broad push into agent workflows. The WSL, remote development and worktree improvements address daily friction for many PHP teams. Updating through the Toolbox App or the IDE itself is the quickest way to try it.
Sources
See my articles more often when you search Google.
