如何在LaravelSail本地开发环境中轻松启用HTTPS？ryoluo/sail-ssl助你一键搞定！-composer-PHP中文网

如何在LaravelSail本地开发环境中轻松启用HTTPS？ryoluo/sail-ssl助你一键搞定！

心靈之曲

发布： 2025-10-14 09:30:26

原创

127人浏览过

如何在laravelsail本地开发环境中轻松启用https？ryoluo/sail-ssl助你一键搞定！

可以通过一下地址学习composer：学习地址

你是否也曾遇到这样的困扰？在本地使用 Laravel Sail 开发项目时，突然发现某个第三方服务（比如微信支付回调、OAuth 认证）要求必须通过 HTTPS 访问，或者你只是想让本地环境尽可能地模拟生产环境，确保代码在安全连接下也能正常运行。然而，当你尝试在 Sail 环境中手动配置 Nginx 的 SSL 证书时，却发现这远比想象中复杂：生成自签名证书、修改 docker-compose.yml、调整 Nginx 配置、处理浏览器警告……一系列操作下来，不仅耗费大量时间，还可能引入新的问题，让人焦头烂额。

这种痛苦我深有体会。每次遇到需要 HTTPS 的场景，都得硬着头皮去翻阅各种教程，然后小心翼翼地修改配置文件，生怕一个字母的错误就导致整个环境崩溃。有没有一种更优雅、更“Laravel”的方式来解决这个问题呢？

好在，我们有 ryoluo/sail-ssl 这个 Composer 插件！它简直是 Laravel Sail 开发者的福音，能够让你以最简单、最快捷的方式，为你的本地 Sail 环境启用 HTTPS 连接，告别繁琐的手动配置。

`ryoluo/sail-ssl` 是什么？

ryoluo/sail-ssl 是一个专为 Laravel Sail 设计的 Composer 插件，它通过自动化 Nginx 配置和 SSL 证书生成，使得在 Sail 环境中启用 HTTPS 变得轻而易举。它将复杂的底层操作封装起来，让你只需几条简单的命令，就能拥有一个支持 HTTPS 的本地开发环境。

如何使用 Composer 轻松启用 HTTPS？

使用 ryoluo/sail-ssl 插件非常简单，只需以下几个步骤：

安装插件

首先，你需要通过 Composer 将 ryoluo/sail-ssl 添加到你的 Laravel 项目中。由于它是一个开发依赖，我们使用 --dev 标志：

如果你在本地 PHP 环境中运行 Composer：
```
<code class="bash">composer require ryoluo/sail-ssl --dev</code>
```
登录后复制
如果你更倾向于在 Sail 容器中运行 Composer：
```
<pre class="brush:php;toolbar:false;">./vendor/bin/sail up -d # 先启动 Sail 容器
./vendor/bin/sail composer require ryoluo/sail-ssl --dev
```
登录后复制
安装 SSL 配置

安装完插件后，运行 Artisan 命令来生成必要的 SSL 证书并配置 Nginx：

本地 PHP 环境：

一键抠图
在线一键抠图换背景

30

查看详情
```
<code class="bash">php artisan sail-ssl:install</code>
```
登录后复制
Sail 容器内：
```
<code class="bash">./vendor/bin/sail artisan sail-ssl:install</code>
```
登录后复制
这条命令会自动帮你完成几件事：
- 在 docker-compose.yml 中添加或修改 Nginx 服务，使其支持 SSL。
- 生成自签名的 SSL 证书和密钥，用于本地 HTTPS 连接。
- 更新 Nginx 的配置文件模板。
启动 Sail 环境

如果你的 Sail 容器正在运行，建议先停止并重新启动，以加载新的配置：
```
<pre class="brush:php;toolbar:false;">./vendor/bin/sail down
./vendor/bin/sail up
```
登录后复制
现在，你可以尝试访问 https://localhost (或你配置的其他域名)，你的 Laravel 应用应该已经可以通过 HTTPS 访问了！浏览器可能会提示证书不安全，这是因为它是自签名证书，在本地开发中是正常现象，接受即可。