配置本地 PHP 解释器

配置一个本地 PHP 解释器

1. 按 Ctrl+Alt+S 打开设置，然后选择 PHP。

2. 在打开的 PHP 页面上，单击 ，位于 CLI 解释器 列表旁边。

   

3. 在打开的 CLI 解释器 对话框中，单击左侧窗格中的 ，然后从弹出菜单中选择 本地。

   如果您已经在 PhpStorm 中配置了本地解释器，那么它会显示在菜单列表中，并且菜单项会更改为 其他本地。

4. 在对话框的右侧窗格中，指定新 PHP 解释器的名称和常规设置。

   

   字段	描述
   名称	输入解释器名称以便与其他解释器区分，例如 php_installation_<version>。
   PHP 可执行文件	指定 PHP 引擎安装目录的路径。 手动输入或单击 并在打开的对话框中选择相关文件夹。
   配置文件	指定自定义 php.ini 配置文件的路径。 如果您希望指定一个与 IDE 自动检测并显示在下方不可编辑的 配置文件 字段中不同的 php.ini 文件，请使用此字段。 手动输入或单击 并在打开的对话框中选择相关文件。
   仅对该项目可见	选中复选框以将解释器的可用性仅限于当前项目。

   PhpStorm 显示在指定文件夹中检测到的 PHP 引擎版本、与此 PHP 引擎关联的调试器（在 php.ini 文件中），以及一个操作链接，用于在 PhpStorm 的编辑器中打开指定的 php.ini 文件。

   单击 ，位于 PHP 可执行文件 字段旁边，会打开一个单独的信息窗口，其中包含安装详细信息以及已加载的扩展和配置选项的列表。

5. 在 其他 区域的 CLI 解释器 对话框中自定义 PHP 安装的配置设置。

   字段	描述
   调试器扩展	指定用于调试的 Xdebug 可执行文件的路径，位于 按需模式 中。 通过这种方式，即使在 php.ini 文件中禁用了 Xdebug，PhpStorm 也可以激活它。
   配置选项	组合一串配置指令，通过 -d 命令行选项 传递，从而向 php.ini 文件添加新条目。 此字段中指定的指令会覆盖 PhpStorm 生成的默认指令，例如： -dxdebug.mode=debug, -dxdebug.client_host=127.0.0.1, -dxdebug.client_port=9003, -dxdebug.start_upon_error=default 例如，如果您指定了 -dxdebug.start_upon_error=yes 指令，它将覆盖默认的 -dxdebug.start_upon_error=default 指令，从而将 Xdebug 切换到 即时模式 (JIT)。 欲了解更多信息，请参阅 在 Just-In-Time 模式下调试。 -dxdebug.remote_enable=1, -dxdebug.remote_host=127.0.0.1, -dxdebug.remote_port=9000, -dxdebug.remote_mode=req 例如，如果您指定了 -dxdebug.remote_mode=jit 指令，它将覆盖默认的 -dxdebug.remote_mode=req 指令，从而将 Xdebug 切换到 即时模式 (JIT)。 欲了解更多信息，请参阅 在 Just-In-Time 模式下调试。 为此，请单击 ，位于 配置选项 字段旁边，然后在打开的 配置选项 对话框中创建一个条目列表。 要添加新条目，请单击 。 在添加到列表的新行中，分别在 名称 和 Value 字段中指定新条目的名称及其值。 您可以根据需要添加任意多的条目，但请记住，它们将被转换为命令行，其长度限制为 256 个字符。 要删除条目，请在列表中选择它并单击 。 要更改条目的顺序，请单击 或 。 单击 确定 后，您将返回到 CLI 解释器 对话框，其中条目将被转换为命令行。

6. 单击 Apply 和 确定 以保存更改。

在配置的 PHP 解释器之间即时切换

1. 按 Ctrl+Shift+A 并开始输入 Change PHP interpreter。 在建议列表中，选择 Change PHP interpreter 操作。

   如果需要，您可以直接在建议列表中按 Alt+Enter 为此操作分配键盘快捷键，或者稍后按照 键盘快捷键 中的说明进行分配。

2. 在打开的弹出菜单中，选择一个配置的 本地 或 远程 PHP 解释器。

所选解释器将被设置为 设置 对话框 Ctrl+Alt+S 页面的默认项目解释器 PHP。 这也会影响使用默认项目解释器的配置（测试框架、 质量工具 和 运行/调试配置 ）以及在 PhpStorm 终端 中运行的命令。