What’s New in PhpStorm 2025.1

This release improves PhpStorm’s PHPStan annotation support, introducing code completion for array shape aliases in @phpstan-type and @phpstan-import-type. Using the local type aliases defined in PHPDoc’s @phpstan-type annotation (or referenced in the @phpstan-import-type annotation), the IDE autocompletes array keys in class bodies.

Version 2025.1 extends PhpStorm’s .env file support to include nested variables syntax. Code completion, navigation between declarations and usages, inspections, and quick-fixes now also work for environment variables wrapped in ${…}.

The AI model selection in the chat has just been expanded! Now, you can take full control of your AI experience by choosing from the latest and most advanced language models, including:

• Claude 3.7 Sonnet
• OpenAI GPT-4.1 (сoming soon)
• Gemini 2.0 Flash

And we’re not stopping here! JetBrains is committed to continuously integrating AI models to ensure you have access to the most up-to-date AI technologies.

AI Assistant gives you the flexibility to work with local models offline or leverage cloud-based AI processing. With the new offline mode, you can now work without an internet connection while still benefiting from AI-powered coding assistance. Use local models via Ollama or LM Studio for chat, code generation, commit messages, inline documentation, and more.

Editing multiple files has never been easier! AI Assistant now supports multi-file edits in the chat, suggesting changes across your project while leveraging retrieval-augmented generation (RAG) to locate the most relevant files. Reduce repetitive tasks and implement modifications across multiple files with a single interaction.

Now, when the AI chat suggests a code snippet, you can use the Apply button to automatically find the optimal place to insert the newly generated code – no more manual copy-pasting. This feature significantly streamlines your workflow.

You can further enhance your control over what AI Assistant sees by configuring an .aiignore file. This allows you to prevent JetBrains AI from accessing specific files or folders, ensuring that sensitive information is never processed.

With the new /web command, AI Assistant can now fetch documentation, troubleshooting tips, and the latest technical resources directly from the web – right inside your chat window. No more switching tabs or searching manually!

Explanations are more effective when they use all the relevant context. Now, when you ask AI Assistant to explain a query, the corresponding schema is automatically attached to the chat.

PhpStorm simplifies Xdebug setup in many ways, including by detecting when the debugger is not installed for the PHP interpreter that’s in use. If Xdebug is missing, in PhpStorm 2025.1, you can have it downloaded and installed automatically right from the CLI Interpreters dialog.

JetBrains has teamed up with Fraser Chapman to publish and maintain an official Xdebug toggler for Chrome and Firefox browsers. The Xdebug Helper by JetBrains extension is open source and developed by Fraser, but committing to its testing and release allows us to make sure you are provided with reliable tools for interruption-free debugging.

In order to provide support for WordPress projects, PhpStorm needs to know the path to the WordPress core installation on your machine. While you were previously prompted to specify this path manually on project startup, starting with version 2025.1, PhpStorm attempts to discover the path and automatically enables support for the WordPress framework.

If it’s unable to detect the path, the IDE will open the PHP | Frameworks settings page so you can provide the required information.

PhpStorm now makes it easier to start new Vue projects with Nuxt CLI (nuxi) integration in the New Project wizard, allowing for a smoother setup experience.

We've also improved support for Vue’s global properties by correctly resolving custom properties added through module augmentation. Additionally, issues with autocomplete and auto-import for packaged components declared with __VLS_WithTemplateSlots have been fixed, ensuring a more reliable development experience in Vue projects.

Working in a monorepo just got smoother! PhpStorm now respects Prettier configs per subproject, offers smarter auto-imports and path alias resolution via improved exports handling, and delivers faster code completion and navigation in large Nx workspaces. Enjoy a more consistent and efficient coding experience across all your projects.

The 2025.1 release introduces a reworked terminal architecture, which is available in Beta. The terminal now runs on a stable, standards-compliant core and uses the IDE’s editor to render the UI. This change lets us introduce new features while preserving compatibility and performance across various platforms, whether local or remote. Get more details about our plans and progress in this blog post.

In PhpStorm 2025.1, you can search within Markdown previews. Since README.md previews are often the first thing you see when opening or cloning a project, this update makes it easier to find key information instantly.

PhpStorm now defaults to using native Windows file dialogs instead of the IDE’s custom implementation. This gives you a more familiar experience when opening or saving files. If you prefer the previous behavior, you can restore it in Advanced Settings | User Interface.

We are refining the non-modal commit workflow, the default built-in option, in response to the extensive feedback we received during the Early Access Program. The modal commit interface is becoming a plugin, which can be activated in Settings | Advanced Settings | Version Control. Git. In version 2025.1, the plugin will be bundled with the IDE, so you’ll be able to continue using the interface without having to install it manually.