# PHP

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

您可以通过安装 [PHP 插件](https://plugins.jetbrains.com/plugin/6610-php)来扩展 IntelliJ IDEA Ultimate 的 PHP 开发功能。 该插件实现了 [PhpStorm](https://www.jetbrains.com/zh-cn/phpstorm/) 这一面向 PHP 开发者的独立 IDE 的全部功能。},{ 如需了解有关支持功能的更多信息，请参阅 [PhpStorm 文档](https://www.jetbrains.com/zh-cn/help/phpstorm/)。

> **Note: 安装 PHP 插件**
> PHP  插件 未 与 IntelliJ IDEA 捆绑，但可以在   设置 | 插件   页面安装，如 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo) 中所述。

## 在 IntelliJ IDEA 中处理 PHP 项目

Procedure: 配置 PHP 环境

PHP 开发环境包括 PHP 引擎、Web 服务器和数据库服务器，即所谓的 AMP (Apache、MySQL、PHP) 技术栈；它可以作为预配置软件包（如 [XAMPP](https://www.apachefriends.org/download.html) 或 [MAMP](https://www.mamp.info/en/downloads/)）或单独组件安装到本地或远程操作系统、虚拟机或 Docker 容器中。

IntelliJ IDEA 与您的 PHP 开发环境集成，以运行、调试或单元测试在 IDE 中打开的应用程序。

要将您的开发环境与 IntelliJ IDEA 集成：

1. 将您的  PHP 引擎 与 IntelliJ IDEA 集成，如 [配置本地 PHP 解释器](https://www.jetbrains.com/zh-cn/help/phpstorm/configuring-local-interpreter.html)或 [配置远程 PHP 解释器](https://www.jetbrains.com/zh-cn/help/phpstorm/configuring-remote-interpreters.html)中所述。

2. 设置 IntelliJ IDEA 与您的  web 服务器  之间的连接，如 [连接到 Web 服务器](configuring-synchronization-with-a-remote-host.html) 中所述。

3. 将您的  数据库服务器  按照 [创建数据源](managing-data-sources.html#create_a_data_source) 中描述的方式与 IntelliJ IDEA 集成。

4. 按照 [调试：终极指南](https://www.jetbrains.com/zh-cn/help/phpstorm/debugging-with-phpstorm-ultimate-guide.html)中的说明设置  调试引擎 。

Procedure: 打开或创建一个 PHP 项目

您可以 [打开](import-project-or-module-wizard.html)或克隆一个现有的 PHP 项目在 IntelliJ IDEA 或创建一个新的。 创建 PHP 项目：

1. 请前往  `文件 | 新建 | 项目` 或在 [欢迎屏幕](null)上，点击   新建项目  。

2. 在打开的   新建项目   对话框中：

* 请提供新项目文件夹的名称及路径。 > **Tip:** > 要在本地 Web 服务器上运行和调试您的应用程序，请在 Web 服务器文档根目录下创建项目根目录。 因此，您的应用程序源代码将对本地 Web 服务器“可见”。

* 请选择 PHP 作为项目类型。

* 选中 添加 'composer.json' 复选框以自动创建一个 `composer.json` 文件用于项目依赖。 > **Tip:** > 有关 PHP 插件中 Composer 支持的更多信息，请参见 [Composer 依赖管理工具](https://www.jetbrains.com/zh-cn/help/phpstorm/using-the-composer-dependency-manager.html)。 ![新建 PHP 项目](https://resources.jetbrains.com/help/img/idea/2026.3/ij_create_new_php_project.png)

Procedure: 代码智能辅助

* PHP代码补全。  PHP插件通过上下文感知的 [PHP代码补全](https://www.jetbrains.com/zh-cn/help/phpstorm/auto-completing-code.html)和 [PHP类型检查](https://www.jetbrains.com/zh-cn/help/phpstorm/php-type-checking.html)帮助您加快编码过程。

![数组形状示例](https://resources.jetbrains.com/help/img/idea/2026.3/ps_array_shape_completion.animated.gif)

* 静态代码分析。  PHP 插件附带一套广泛的 [检查](running-inspections.html) 用于 PHP 代码的静态分析。 一种特定类型的检查是 [第三方工具的代码质量检查](https://www.jetbrains.com/zh-cn/help/phpstorm/php-code-quality-tools.html)，例如 PHP CS Fixer、Laravel Pint、PHPStan、Psalm、PHP_CodeSniffer 和 PHP Mess Detector。

![在编辑器中查看检测](https://resources.jetbrains.com/help/img/idea/2026.3/php_inspections_in_opened_file_ij.png)

检查不仅会告诉您问题在哪里，还会提供 [quick-fixes](resolving-problems.html)来帮助您立即处理它。 对于正确（即未在编辑器中高亮显示）但在当前上下文中仍可优化的代码，可以使用 [意图操作](intention-actions.html)。

* 代码生成和实时代码模板 . 该插件提供多种方式来 [生成](generating-code.html)样板 PHP 代码。 对于更大的代码结构，比如循环、条件、声明或打印语句，可以使用 [PHP 实时模板](https://www.jetbrains.com/zh-cn/help/phpstorm/using-live-templates.html)。

![ps_quick_start_generate_code_mac.png](https://resources.jetbrains.com/help/img/idea/2026.3/ps_quick_start_generate_code_mac.animated.gif)

* PHPDoc 注释 。 对于文档注释，插件默认启用智能补全功能。 IntelliJ IDEA 会在您输入 [PHPDoc blocks](https://docs.phpdoc.org/guide/getting-started/what-is-a-docblock.html)的  `/**`  开始标签并按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))，或按下 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 并指定要文档化的代码结构（类、方法、函数等）时创建存根。

![生成 PHPDoc](https://resources.jetbrains.com/help/img/idea/2026.3/ps_reference_generate_phpdoc.animated.gif)

> **Tip:**
> 如需更多信息，请参见 [PhpStorm 中的 PHPDoc 注释](https://www.jetbrains.com/zh-cn/help/phpstorm/phpdoc-comments.html)。

Procedure: 运行 PHP 代码

有几种方法可以在 IntelliJ IDEA 中 [运行](running-applications.html) PHP 应用程序：

* 从 IntelliJ IDEA 使用类型为 [PHP 网页](https://www.jetbrains.com/zh-cn/help/phpstorm/run-debug-configuration-php-web-application.html)的 [运行配置](run-debug-configuration.html)，在浏览器中查看应用程序输出。

* 从 IntelliJ IDEA 使用 [PHP 脚本](https://www.jetbrains.com/zh-cn/help/phpstorm/run-debug-configuration-php-script.html)运行配置，在 运行 工具窗口中查看应用程序输出。

* 从 IntelliJ IDEA 使用 [内置 Web 服务器](https://www.jetbrains.com/zh-cn/help/phpstorm/run-debug-configuration-php-built-in-web-server.htmlComposer_Page.topic)。 这种方法可以节省您的时间和精力，因为您不需要部署应用程序源代码。

Procedure: 调试 PHP 代码

此插件支持使用 Xdebug 和 Zend Debugger 进行 PHP 代码调试。 使用 Xdebug，IDE 会自动化获取调试器并运行的过程，在此过程中显示必要的提示和操作链接。

> **Tip:**
> 详细指南和故障排除说明，请参阅 PhpStorm 文档中的 [调试：终极指南](https://www.jetbrains.com/zh-cn/help/phpstorm/debugging-with-phpstorm-ultimate-guide.html)。

除了交互式调试之外，集成开发环境与 [Xdebug](http://xdebug.org/) 的集成还支持性能分析。 IntelliJ IDEA 提供 Xdebug 生成的分析快照的可视化表示，帮助您检查 PHP 应用程序如何使用执行时间和内存。

> **Tip:**
> 如需更多信息，请参阅 PhpStorm 文档中的 [使用 Xdebug 进行性能分析](https://www.jetbrains.com/zh-cn/help/phpstorm/profiling-with-xdebug.html)。

Procedure: 测试 PHP 代码

PHP 插件支持与最流行的 PHP 测试框架集成： [PHPUnit](https://www.jetbrains.com/zh-cn/help/phpstorm/using-phpunit-framework.html)、 [Pest](https://www.jetbrains.com/zh-cn/help/phpstorm/pest.html)、 [Behat](https://www.jetbrains.com/zh-cn/help/phpstorm/using-behat-framework.html)、 [PHPSpec](https://www.jetbrains.com/zh-cn/help/phpstorm/using-phpspec.html) 和 [Codeception](https://www.jetbrains.com/zh-cn/help/phpstorm/using-codeception-framework.html)，您可以在 IDE 中创建、管理、执行测试并查看测试结果。

您可以在 PHP 项目的不同模块中独立配置和运行测试。 如果您的 PHP 项目包含多个 [由 Composer 管理的子项目](https://www.jetbrains.com/zh-cn/help/phpstorm/using-the-composer-dependency-manager.html#manage-multiple-composer-files)，并且每个子项目都有自己的测试框架可执行文件和/或配置文件，IntelliJ IDEA 会为每个子项目创建单独的测试框架配置。

> **Tip:**
> 有关更多信息，请参阅 PhpStorm 文档中的 [Testing](https://www.jetbrains.com/zh-cn/help/phpstorm/testing.html)。

Procedure: 部署 PHP 应用程序

使用 IntelliJ IDEA，您可以灵活配置 PHP 应用程序的部署。 例如，您可以从一开始就在本地 Web 服务器上设置 PHP 项目，或者在本地开发和测试应用程序，然后将其上传到远程 Web 服务器，等等。

> **Tip:**
> 如需更多信息，请参阅 PhpStorm 文档中的 [部署您的应用程序](https://www.jetbrains.com/zh-cn/help/phpstorm/deploying-applications.html)。

## 支持的 PHP 框架和工具

|  框架/工具  |  必需插件  |
| --- | --- |
|  [Blade 模板](https://www.jetbrains.com/zh-cn/help/phpstorm/blade-templates-support.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)、 [Blade](https://plugins.jetbrains.com/plugin/7569-blade)  |
|  [Drupal](https://www.jetbrains.com/zh-cn/help/phpstorm/drupal-support.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)， [Drupal](https://plugins.jetbrains.com/plugin/7352-drupal)  |
|  [Joomla!](https://www.jetbrains.com/zh-cn/help/phpstorm/joomla-support.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)、 [Joomla!](https://plugins.jetbrains.com/plugin/8288-joomla-)  |
|  [Laravel](https://www.jetbrains.com/zh-cn/help/phpstorm/laravel.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)， [Laravel Idea](https://plugins.jetbrains.com/plugin/13441-laravel-idea)（付费）  |
|  [Pest](https://www.jetbrains.com/zh-cn/help/phpstorm/pest.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)、 [Pest](https://plugins.jetbrains.com/plugin/14636-pest)  |
|  [PHP 命令行工具](https://www.jetbrains.com/zh-cn/help/phpstorm/php-specific-command-line-tools.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)， [PHP Command Line Tool](https://plugins.jetbrains.com/plugin/6630-command-line-tool)  |
|  [Symfony](https://www.jetbrains.com/zh-cn/help/phpstorm/symfony-support.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)， [Symfony 支持](https://plugins.jetbrains.com/plugin/7219-symfony-support)  |
|  [WordPress](https://www.jetbrains.com/zh-cn/help/phpstorm/using-wordpress-content-management-system.html)  |  [PHP](https://plugins.jetbrains.com/plugin/6610-php)、 [WordPress](https://plugins.jetbrains.com/plugin/7434-wordpress)  |

## See also

### 过程

[项目](creating-and-managing-projects.html) [数据源](managing-data-sources.html) [运行/调试配置](run-debug-configuration.html)

### 参考

[PHP 参考](php.html) [部署](settings-deployment.html) [调试器设置](settings-debugger.html)

