Composer

composer.json 路径

在此字段中，指定您希望用作项目默认 Composer 文件的 composer.json 的位置。 从主菜单中通过 工具 | Composer 调用的所有 Composer 命令都将根据此配置文件中的设置执行。

在一个 PhpStorm 项目中，您可以拥有多个 composer.json 文件，并为每个文件调用 Composer 操作和命令。

如果一个项目包含具有专用 composer.json 文件的子目录，PhpStorm 会独立处理每个此类模块的 Composer 管理的依赖项和设置。 每个安装了 composer.json 的子目录将拥有其自己的 PSR-0/PSR-4 根设置、 测试框架配置 ，以及一个带有 外部库的 vendor 目录。

作为库添加软件包(A)

使用此复选框配置 Composer 包的可编辑状态。 要保护 vendor/*/* 下的包不被编辑，请保持复选框选中（这是默认设置）。

如果您想编辑 vendor/*/* 下的 Composer 包，请取消选中复选框。

将IDE 设置与 composer.json 同步(S)

选中此复选框以自动检测 PHP 语言级别，并根据 composer.json 的配置设置项目的 Source 和 Test 根目录。

PhpStorm 了解 PSR-0/PSR-4 源根及其命名空间前缀。 它根据 autoload 部分设置源根 ，并根据 autoload-dev 部分设置测试根 。 PhpStorm 还会根据 require 部分中的 php 设置检测 PHP 语言级别。

由于 composer.json 包含有关项目配置的最新信息，此自动同步可确保 Source 和 Test 文件夹与项目结构完全匹配，并自动设置正确的 PHP 语言级别。

检查可用软件包更新

使用此复选框配置可用包更新的自动检查。 默认情况下，复选框处于选中状态。 为了检索可用的包更新并在 composer.json 中提供更好的 代码辅助 ，PhpStorm 在每次您打开项目或修改 composer.json 时，会在后台运行 update --dry-run 命令。

显示具有快速操作的composer.json 顶部面板

使用此复选框切换显示在 composer.json 编辑器顶部的快速操作面板的可见性。 有关更多信息，请参阅 使用 composer.json。

缺少'vendor' 目录时通知

选中此复选框以让 PhpStorm 检查 vendor 目录是否缺失，并在每次打开项目或修改 composer.json 时显示相应的通知。 您可以使用通知中的快捷链接快速 安装 Composer 依赖项。

运行带有 ‑‑ignore‑platform‑reqs 的安装/更新

选中此复选框以让 PhpStorm 使用 --ignore-platform-reqs 选项运行 Composer 的 install 和 update 命令。

这将忽略 composer.json 文件中指定的所有平台要求（php、 hhvm、 lib-* 和 ext-* ），并强制安装/更新其他依赖项，而不考虑 PhpStorm 项目中可用的 平台包。

执行

在此区域，选择 Composer 命令的执行方式：

• 要通过全局安装的 composer 可执行文件运行命令，请选择 'composer' 可执行文件 并在字段中指定其位置。

• 要通过本地 composer.phar 存档运行命令，请选择 composer.phar。 然后，在字段中指定现有 composer.phar 文件的位置，或选中 从 getcomposer.org 下载 composer.phar 复选框以下载该文件的新实例。 下载的 composer.phar 文件将保存在项目根文件夹下。

  然后，从 PHP 解释器 列表中选择一个配置的本地 PHP 解释器。 更多信息请参阅 配置本地 PHP 解释器。

• 要通过远程解释器运行命令，请选择 远程解释器。

  • 从 CLI 解释器 列表中选择要使用的远程解释器，或单击 并按照 配置远程 PHP 解释器 中的描述配置一个新的。

    在大多数情况下，PhpStorm 会自动检测路径映射。 如有必要，您可以单击 路径映射 字段的 并在打开的 编辑项目路径映射 中手动指定它们。

  • 在 Composer 可执行文件 字段中提供 Composer 可执行文件的名称。 您可以单击 ，并在打开的 选择服务器上的路径 对话框中定位可执行文件。