WSL
WSL (WSL 2 )——Windows Subsystem for Linux——是一个兼容层,用于在 Windows 10 及更高版本上本地运行 Linux 二进制可执行文件。 目前,它支持若干 Linux 发行版 ,例如 Ubuntu、OpenSUSE 和 SLES。
配置 WSL
从 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按照 配置远程 PHP 解释器 中的描述配置基于 WSL 的远程解释器。 您可以将创建的解释器指定用于所有常见任务:执行 脚本或 Composer 命令 ,运行 PHP 质量工具等。
在 WSL 文件系统中打开项目
在 PhpStorm,您可以直接打开存储在 WSL 文件系统中的项目,并像处理其他项目一样进行操作。
请点击 打开 在 欢迎屏幕或从主菜单中选择 。
在打开的 选择路径对话框中,选择包含要打开项目的 WSL 文件系统中的文件夹,或者手动输入项目位置的路径。
路径语法为
\\wsl.localhost\DistributionName,其中DistributionName是您的 Linux 发行版名称,例如 Ubuntu、Debian、Arch 等。
防火墙配置
您需要执行以下步骤以确保项目构建正常运行。
配置防火墙设置
以管理员身份运行 Windows PowerShell。

执行以下命令以允许使用 WSL 进行连接:
New-NetFirewallRule -DisplayName "WSL" -Direction Inbound -InterfaceAlias "vEthernet (WSL)" -Action Allow使用以下命令检查确切的接口名称,例如
vEthernet (WSL)、vEthernet (WSL2),或者如果您已重命名则可能是其他名称:Get-NetAdapter然后执行命令以更新防火墙规则:
Get-NetFirewallProfile -Name Public | Get-NetFirewallRule | where DisplayName -ILike "IntelliJ IDEA*" | Disable-NetFirewallRule现在开始调试会话。 当 Windows 防火墙 弹出窗口出现时,选择 公共网络 复选框。
