Laravel Sail 安装与使用指南

目录结构及介绍

当你克隆或下载了Laravel Sail库之后，你会发现其核心组件位于不同的目录中：

• ./vendor/laravel/sail: 这是Sail的核心目录，包含了Sail的全部代码。
  • src/: 包含主要功能代码。
  • stubs/: 提供各种模板脚本用于容器生成等。
  • config/: 配置文件所在位置。

在你的 Laravel 项目根目录下，当你运行Sail相关命令时，Sail会在 .sail 文件夹内生成特定的Dockerfile和其他辅助文件，以帮助管理你的开发环境。这些生成的文件将根据你的项目需求自动调整。

启动文件介绍

Laravel Sail 的启动主要依赖于一组预定义的 shell 脚本来控制 Docker 容器和服务。

• .sail/Dockerfile: 此文件描述了构建服务容器所需的基础镜像以及安装和配置软件的过程。
• .sail/docker-compose.yml: 这个文件定义了所有关联的服务（如数据库，缓存系统）及其网络和卷设置。
• artisan sail: 是一个封装后的 Artisan 命令，用于执行 Docker 命令，例如创建、启动、重启、停止和删除Sail环境中的Docker容器。

通过运行 ./vendor/bin/sail up 或者 ./vendor/bin/sail start 等指令可以启动或初始化你的Sail环境。这些指令内部调用了 docker-compose 并结合 Dockerfile 中的定义来管理和操作容器。

配置文件介绍

Sail的配置主要是通过两个途径进行的:

在 Docker Compose 文件里

• .sail/docker-compose.yml:
  • services: 定义了多个服务如 webserver, database, redis 等，包括它们的镜像选择、端口映射、数据卷挂载和环境变量设置。
  • networks: 配置各个服务之间的网络连接，允许它们之间进行通信。

动态配置

当使用 artisan sail config:publish 命令时，它会从 Laravel 框架的 config 目录下的 sail.php 文件获取配置并将其复制到项目级别的.env文件中去，这样就可以在不修改框架源码的情况下改变Sail的行为。

Laravel .env 文件

此文件保存了所有环境相关的参数，如数据库名、用户名、密码、应用程序密钥等，在Sail环境下会被读取并应用于各个服务的配置中，确保你在不同环境中的一致性和隔离性。

总的来说，Sail提供了高度可定制化的环境配置方案，让你能够轻松地调整和适应多样化的开发场景。