larvata/laravel-elite-image

laravel-elite-image

精简且可用于开发与生产环境的 PHP/Laravel Docker Image

Laravel Elite Image 是什么？

这是一个针对开发与生产环境特别设计的 PHP/Laravel Docker 环境，使用 https://github.com/laravel/envoy 设计启动脚本，可轻松根据开发或生产需求定制启动流程；同时集成 http://supervisord.org/index.html 管理进程，支持 Nginx、PHP-FPM、PHP Server、PHP Swoole、Laravel 排程、Laravel 队列处理等常见服务，可搭配 https://github.com/swooletw/laravel-swoole 使用高效能的 Swoole 网络通信引擎。

快速启动

该镜像适用于所有 PHP 环境，以 Laravel Framework 为例，通过以下三个步骤即可搭建 Laravel 网站：

1. 安装 Laravel

通过以下命令安装最新版 Laravel：

bash
docker run --rm -v $(pwd):/opt -w /opt docker.xuanyuan.run/larvata/laravel-elite-image:latest-php8.0 \
bash -c "composer create-project --prefer-dist laravel/laravel example-app"

可修改 example-app 更改项目文件夹名称，例如：

bash
docker run --rm -v $(pwd):/opt -w /opt docker.xuanyuan.run/larvata/laravel-elite-image:latest-php8.0 \
bash -c "composer create-project --prefer-dist laravel/laravel blog"

也可使用 = 或 : 指定版本，例如：

bash
docker run --rm -v $(pwd):/opt -w /opt docker.xuanyuan.run/larvata/laravel-elite-image:latest-php8.0 \
bash -c "composer create-project --prefer-dist laravel/laravel=7.30.1 example-app"

2. 安装环境启动配置文件

bash
cd example-app
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/7.4/setup/Dockerfile
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/7.4/setup/Envoy.blade.php
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/7.4/setup/docker-compose.yml.example
cp docker-compose.yml.example docker-compose.yml

3. 启动环境（请先配置好 .env）

bash
docker-compose up -d

完成上述步骤后，打开浏览器访问 http://localhost/，即可确认网站是否成功搭建。

标签对应的 Dockerfile

• https://github.com/LarvataTW/laravel-elite-image/blob/master/8.0/Dockerfile%EF%BC%88%E6%9C%AA%E6%9D%A5%E7%89%88%E6%9C%AC%EF%BC%89
• https://github.com/LarvataTW/laravel-elite-image/blob/master/7.4/Dockerfile%EF%BC%88%E4%B8%BB%E8%A6%81%E7%BB%B4%E6%8A%A4%E7%89%88%E6%9C%AC%EF%BC%89
• https://github.com/LarvataTW/laravel-elite-image/blob/master/7.3/Dockerfile%EF%BC%88%E4%BB%85%E6%8F%90%E4%BE%9B%E5%AE%89%E5%85%A8%E9%97%AE%E9%A2%98%E4%BF%AE%E5%A4%8D%EF%BC%89
• https://github.com/LarvataTW/laravel-elite-image/blob/master/7.2/Dockerfile%EF%BC%88%E5%B7%B2%E5%81%9C%E6%AD%A2%E6%94%AF%E6%8C%81%EF%BC%89
• https://github.com/LarvataTW/laravel-elite-image/blob/master/5.6/Dockerfile%EF%BC%88%E5%B7%B2%E5%81%9C%E6%AD%A2%E6%94%AF%E6%8C%81%EF%BC%89

环境配置文件

配置 Nginx

1. 下载 Nginx 配置文件

bash
# Nginx + PHP-FPM（默认）
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/8.0/config/nginx.conf
# Nginx + Swoole
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/8.0/config/nginx-swoole.conf

2. 配置 Dockerfile

dockerfile
# Nginx + PHP-FPM（默认）
COPY nginx.conf /etc/nginx/nginx.conf
# Nginx + Swoole
COPY nginx-swoole.conf /etc/nginx/nginx-swoole.conf

配置 PHP

1. 下载 PHP 配置文件

bash
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/8.0/config/php.ini

2. 下载 PHP-FPM 配置文件

bash
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/8.0/config/www.conf

3. 配置 Dockerfile

dockerfile
COPY www.conf /usr/local/etc/php-fpm.d/www.conf
COPY php.ini /usr/local/etc/php/conf.d/custom.ini

配置 Supervisord

1. 下载 Supervisord 配置文件

bash
wget https://github.com/LarvataTW/laravel-elite-image/raw/{version}/8.0/config/supervisord.conf

2. 配置 Dockerfile

dockerfile
COPY supervisord.conf /etc/supervisord.conf

自定义 Supervisord 脚本流程

1. 创建 Supervisord 脚本（例如：example.conf）

2. 配置 Dockerfile

dockerfile
COPY example.conf /etc/supervisord.d/example.conf

启动脚本

通过修改 Envoy.blade.php 可配置程序启动流程：

• 建议开发环境使用 Nginx（Port 80）+ PHP-FPM（Port 9000）
• 建议生产环境使用 Nginx（Port 80）+ Swoole（Port 7780）

启动 Nginx（Port 80）+ PHP-FPM（Port 9000）

可通过Nginx 配置文件修改启动端口：

bash
supervisord -c /etc/supervisord.conf
supervisorctl start laravel-php-fpm:*
supervisorctl start laravel-nginx:*

启动 Nginx（Port 80）+ Swoole（Port 7780）

可通过Nginx 配置文件修改启动端口：

bash
supervisord -c /etc/supervisord.conf
supervisorctl start laravel-php-fpm:*
supervisorctl start laravel-swoole:*
supervisorctl start laravel-nginx-swoole:*

启动排程

bash
supervisord -c /etc/supervisord.conf
supervisorctl start laravel-schedule:*

启动队列处理

bash
supervisord -c /etc/supervisord.conf
supervisorctl start laravel-worker:*

Supervisor 脚本

已安装工具

已安装 PHP 扩展

相关支持

• 维护者：https://github.com/LarvataTW

常见问题

Q：环境变量未更改
A：请重新启动

Q：无法连接到网站
A：请确保已配置好 .env 并执行 composer install 后重新启动

Q：No application encryption key has been specified.
A：请设置 APP Key：php artisan key:generate