WSL
WSL (WSL 2 )——Windows Subsystem for Linux——是一个兼容层,用于在 Windows 10 及更高版本上本地运行 Linux 二进制可执行文件。 目前,它支持若干 Linux 发行版 ,例如 Ubuntu、OpenSUSE 和 SLES。
配置 WSL
在 Windows 计算机上,从 Microsoft Store 下载并安装一个 WSL 发行版(例如 Ubuntu)
此步骤请务必使用至少 Windows 10 或更高版本,并安装最新的“秋季创作者更新”(最低版本 1709,构建 16299.15)。 请参阅官方指南 Install the Windows Subsystem for Linux了解详细说明。
要使用 WSL 2 ,您的 Windows 版本应为 10 版本 18917 或更高版本。 请遵循 这些指示来切换分布式。
请注意,PhpStorm 不支持 旧版 WSL ,而您可能在将系统升级到 Windows 10 build 16299.15 或更高版本之前安装过。 在这种情况下,您需要更新您的 WSL 发行版。
运行 Linux 发行版。
首次启动时,系统可能会提示您启用 Windows 可选功能。 在这种情况下,您需要执行以下操作:
以管理员身份打开 Windows PowerShell 并运行
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux重新启动您的计算机。
在 Linux 安装中,确保已安装 PHP。 有关详细的安装说明,请参阅 Debian GNU/Linux installation notes。 如果您使用的是 Ubuntu,您可以在终端中运行此命令以快速安装 PHP:
sudo apt install php php-mbstring php-xml php-zip php-curl php-xdebug
为 WSL 配置远程 PHP 解释器
安装并运行 PhpStorm,如常在 Windows 本地进行操作。
按 Ctrl+Alt+S 打开设置,然后选择 。
在打开的 PHP 页面上,单击
,位于 CLI 解释器 列表旁边。
在打开的 CLI 解释器 对话框中,单击左侧窗格中的
,然后从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、远程...。
在打开的 配置远程 PHP 解释器 对话框中,选择 WSL 方法并提供连接参数:

字段
描述
Linux 发行版
从下拉列表中选择要使用的已安装 Linux 发行版之一。
PHP 解释器路径},{
根据所选远程开发环境的配置,指定 PHP 可执行文件的位置。
对于 WSL,PhpStorm 默认建议 /usr/local/bin/php 。
若要指定不同的文件夹,请点击
并在打开的对话框中选择相关文件夹。 请注意,PHP 主目录必须可编辑。
点击 确定。 PhpStorm 会检查是否在 PHP 解释器路径 字段中指定的文件夹中实际存储了 PHP 可执行文件。
如果未找到 PHP 可执行文件,PhpStorm 会显示一条错误消息,询问您是否继续搜索或仍然保存解释器配置。
如果找到 PHP 可执行文件,您将返回到 CLI 解释器 对话框,其中显示了安装文件夹和检测到的 PHP 解释器版本。
选中 仅对该项目可见 复选框后,解释器的可用范围将仅限于当前项目。
单击
,位于 PHP 可执行文件 字段旁边,会打开一个单独的信息窗口,其中包含安装详细信息以及已加载的扩展和配置选项的列表。
现在可以从配置的 PHP 解释器列表中选择基于 WSL 的 PHP 解释器,用于所有常见任务:执行 脚本或 Composer 命令 ,运行 PHP 质量工具等。

您可以创建一个项目并将其存储在 WSL 环境中,从 WSL 文件系统中打开一个项目,并在 WSL 中进一步开发您的项目。
在 WSL 文件系统中创建一个新项目
安装并运行 PhpStorm,如常在 Windows 本地进行操作。
在欢迎屏幕上,点击 新项目。
在打开的页面上,选择要创建的项目类型。
在右侧窗格的 Location 字段中指定项目的路径。 WSL 的项目位置将显示以 \\wsl$ 开头的 WSL 文件系统的绝对路径。

点击 创建。
PhpStorm 创建一个位于 WSL 的项目,您可以在不离开 IDE 的情况下在 WSL 环境中开发和构建您的项目。
在 WSL 文件系统中打开项目
在 PhpStorm,您可以直接打开存储在 WSL 文件系统中的项目,并像处理其他项目一样进行操作。
请点击 打开 在 欢迎屏幕或从主菜单中选择 。
在打开的 选择路径对话框中,选择包含要打开项目的 WSL 文件系统中的文件夹,或者手动输入项目位置的路径。
路径语法为
\\wsl.localhost\DistributionName,其中DistributionName是您的 Linux 发行版名称,例如 Ubuntu、Debian、Arch 等。