README

流行的开发环境 Laravel Valet（Laravel Valet）的 Windows 平台版本。

简介

Valet 是为 Windows 优化的 Laravel 开发环境。无需 Vagrant，无需 /etc/hosts 文件。您甚至可以使用本地隧道公开共享您的网站。 是的，我们也喜欢它。

Laravel Valet 配置您的 Windows 在启动时始终在后台运行 Nginx。然后，使用 Acrylic DNS，Valet 将 *.test 域下的所有请求代理到您本地计算机上安装的网站。

文档

在安装之前，请确保没有其他程序（如 Apache 或 Nginx）正在绑定到您本地计算机的端口 80。
此外，请确保以管理员身份打开您首选的终端（Windows Terminal、CMD、Git Bash、PowerShell 等）。

• 如果您没有安装 PHP，请以管理员身份打开 PowerShell（3.0+）并运行

Set-ExecutionPolicy RemoteSigned -Scope Process; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri "https://github.com/cretueusebiu/valet-windows/raw/master/bin/php.ps1" -OutFile $env:temp\php.ps1; .$env:temp\php.ps1 "8.3"

（您可以替换 8.3 为您想要安装的 PHP 版本：7.4、8.0、8.1、8.2、8.3）

此脚本将为您下载和安装 PHP，并将其添加到您的环境路径变量中。PowerShell 仅在此步骤中需要。

• 如果您没有安装 Composer，请确保安装它。

• 使用 composer global require cretueusebiu/valet-windows 命令通过 Composer 安装 Valet。

• 运行 valet install 命令。这将配置和安装 Valet，并将 Valet 的守护进程注册为在系统启动时启动。

• 如果您在 Windows 10/11 上安装，可能需要手动配置 Windows 使用 Acrylic DNS 代理。

Valet 将在您的计算机启动时自动启动其守护进程。一旦完成 Valet 的初始安装，就无需再次运行 valet start 或 valet install。

有关更多信息，请参阅 Laravel 网站的官方文档。

已知问题

• 由于 Acrylic DNS 代理，WSL2 分发版失败（microsoft/wsl#4929）。请使用 valet stop，启动 WSL2，然后 valet start。
• PHP-CGI 进程使用端口 9001。如果已被占用，请在 ~/.config/valet/config.json 中更改它，然后再次运行 valet install。
• 在共享网站时，URL 不会复制到剪贴板。
• 您必须从安装 Valet 的驱动器运行 valet 命令，除了 park 和 link。请参阅 #12。
• 如果您的计算机未连接到互联网，您必须手动将域名添加到您的 hosts 文件中，或者您可以安装 Microsoft Loopback Adapter，因为它模拟了一个活跃的本地网络接口，Valet 可以绑定到该接口。

Xdebug

要启用调试会话，您可以使用 Xdebug Helper 或设置名为 XDEBUG_SESSION 的Cookie。

测试

使用以下命令运行单元测试：

composer test-unit

在首次运行集成测试之前，您必须使用以下命令构建Docker容器：

composer build-docker

接下来，您可以使用以下命令运行集成测试：

composer test-integration

变更日志

有关最近更改的更多信息，请参阅 变更日志。

许可证

Laravel Valet 是开源软件，遵循 MIT 许可协议。