PhpStorm 2025.2 Help

Symfony 代码补全和导航

Symfony Support 插件通过代码补全和导航功能增强了 PhpStorm 对 Symfony 的内置支持。 此插件未与 PhpStorm 捆绑,需要在每个项目中单独 安装并启用。

Symfony Support 插件是开源的。 您可以在 GitHub 上找到该插件的源代码及其问题跟踪器。 有关功能的完整列表,请参阅 插件文档

为项目启用 Symfony Support 插件

安装 Symfony Support 插件后,您需要为项目显式启用它。 创建或打开 Symfony 项目后,PhpStorm 将显示一条通知消息,建议您启用该插件。

  1. 执行以下任意操作:

    • 单击通知消息中的 启用插件 链接。

      Symfony Support 插件通知
    • 设置 对话框(Ctrl+Alt+S )中,导航到 PHP | Symfony 并选中 为此项目启用插件 复选框。

  2. 重新启动 PhpStorm 以使更改生效。

指定其他设置

根据 Symfony 项目的结构,您可能需要在 PHP | Symfony 下更改一些其他设置。 当使用由例如 symfony/framework-standard-edition Composer 项目生成的结构的 Symfony 应用程序时,默认路径和设置将正常工作。

请注意, appDevDebugProjectContainer.xml appDevUrlGenerator.php 文件必须位于 Symfony 的默认路径下,才能使用 Symfony Support 插件提供的所有功能。 当找不到这些文件时,它将使用回退机制,但在这种情况下,补全和导航的精确度会降低。

当使用非默认项目结构时,应在 Symfony 设置中更新以下路径:

  • 翻译根路径 :所有翻译被复制到的位置路径。 此路径应设置为 缓存 文件夹下的翻译路径,以便插件发现所有可能的翻译。

    在 Symfony 4 及更高版本中,默认路径为 ./var/cache/dev/translations/

  • 应用程序目录 应用程序 目录的路径。

    在 Symfony 4 及更高版本中,默认路径为 ./config/

  • Web 目录 web 目录的路径。

    在 Symfony 4 及更高版本中,默认路径为 ./public/

Symfony 通用设置

Symfony 分析器

当为项目启用 Symfony Support 插件时,PhpStorm 状态栏中将添加一个额外的区域。 单击状态栏中的 Symfony 将打开弹出菜单,其中包含对我们 Symfony 应用程序的最新请求的相关目标。

Symfony 分析器工具栏
  • 单击分析器弹出菜单中的相应项目:

    • 调试 URL :给定请求的 Symfony 分析器 URL,例如 /app_dev.php/_profiler/355651

    • 路由 :应用程序中的路由注册

    • Controller :参与创建响应的控制器。

    • 模板 :与响应相关的任何模板。

最后修改日期: 2025年 9月 26日