README

Sail 为 Laravel 提供了兼容 macOS、Windows (WSL2) 和 Linux 的基于 Docker 的本地开发体验。

该库已经对 Laravel Sail 的工作进行了调整，以适应 WordPress 环境。

除了 Docker 之外，在开始使用 Sail 之前，不需要在您的本地计算机上安装任何软件或库。Sail 的简单 CLI 意味着您可以在没有任何 Docker 经验的情况下开始构建您的 Laravel 应用程序。

灵感

WordPress Sail 吸收了 Laravel Sail 的灵感，而 Laravel Sail 又吸收了 Vessel 的灵感，Vessel 是由 Chris Fidao 开发的。如果您想深入了解 Docker，可以查看 Chris 的课程：Shipping Docker。

安装

从 Bedrock 项目中引入 WordPress Sail

composer require sterner-stuff/wordpress-sail

为了确保本地自动加载器作为 WP-CLI 生命周期的一部分运行，请确保它包含在您的 wp-cli.yml 文件中

require:
    - vendor/autoload.php

构建您的 docker-composer.yml 文件

wp sail:install [--with=]

默认情况下，MySQL 和 Mailhog 容器将附加，但您也可以使用 Redis 等其他容器

wp sail:install --with=mysql,mailhog,redis

在此阶段，您可能需要更改 docker-compose.yml 文件中使用的 PHP 版本。

version: '3'
services:
    wordpress.test:
        build:
            context: ./vendor/sterner-stuff/wordpress-sail/runtimes/8.1 <-- Supports 7.4, 8.0, and 8.1
            dockerfile: Dockerfile
            args:
                WWWGROUP: '${WWWGROUP}'
        image: wordpress-sail-8.1/app <-- Update here as well.
        extra_hosts:
            - 'host.docker.internal:host-gateway'
        # ...

最后，构建您的容器

vendor/bin/sail build

在主机机器上不使用 PHP/Composer 安装

如果您只想使用纯 Docker 来开始，这也是一种选择。我们假设您已经启动了 Bedrock 项目并更新了 wp-cli.yml。然后您可以运行这两个命令

// Require Sail
docker run -it --rm \
	-u "$(id -u):$(id -g)" \
	-v $(pwd):/var/www/html \
	-w /var/www/html \
	composer \
	require --dev sterner-stuff/wordpress-sail

// Scaffold your docker-compose.yml file
docker run -it --rm \
	-u "$(id -u):$(id -g)" \
	-v $(pwd):/var/www/html \
	-w /var/www/html \
	wordpress:cli-php8.1 \
	sail:install

当使用 wordpress:cli-phpx.x 镜像时，您应该使用与您的应用程序相同的 PHP 版本（7.4、8.0 或 8.1）。

用法

WordPress Sail 尽可能地与 Laravel Sail 保持一致。WP-CLI 现在也包含在您的容器中，因此您不需要使用捆绑的版本。

您可能需要进行以下操作（假设您已将 sail 别名为 vendor/bin/sail）

sail up -d
sail down
sail wp cli info
sail tinker # alias for wp shell

如果您想自定义使用的 Dockerfile

sail up -d
sail wp sail:publish
sail down

在自定义您的 Sail 安装后，更改应用程序容器在您的应用程序的 docker-compose.yml 文件中的镜像名称，以确保它不会与其他使用默认 Dockerfile 的项目冲突。然后运行 sail build --no-cache

在已安装 Sail 的项目中开始

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v $(pwd):/var/www/html \
    -w /var/www/html \
    laravelsail/php81-composer:latest \
    composer install --ignore-platform-reqs

当使用 laravelsail/phpXX-composer 镜像时，您应该使用与您的应用程序相同的 PHP 版本（74、80 或 81）。

官方文档

WordPress Sail 应该被视为不稳定，目前没有文档。Sail 的文档可以在 Laravel 网站 上找到。

贡献

感谢您考虑为 Sail 贡献！您可以在 此处 阅读贡献指南。

许可

Laravel Sail 是开源软件，受 MIT 许可证 许可。