Docker-lumen项目部署

[Lumen](https://lumen.golaravel.com/) 是一个基于 [Laravel](https://laravel.com/) 组件构建的微框架

**相关链接：**
---
- PHPDocker.io(PHP Docker部署在线生成配置)
	- 在线生成配置文件：https://phpdocker.io/
	- GitHub：https://github.com/phpdocker-io/phpdocker.io
	- Docker 镜像集：https://hub.docker.com/u/phpdockerio

## Docker 多容器化部署
采用 `Nginx+PHP+MySQL+Redis` 每个项目独立容器以提供功能，使用起来更加灵活
其中 php-fpm 可能还需要安装很多扩展，正式上线可以考虑重新构建一个包含所需扩展的镜像，利于快速部署，测试阶段则进容器内进行安装即可
```
version: '3.1'
services:
  webserver:  # Nginx
    image: 'nginx'
    # container_name: nginx
    ports:
      - 80:80
      - 443:443
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./www:/var/www  # 设置网站目录
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf  # Nginx配置文件
    restart: always  # 重启策略(always 自动重启)

php:  # PHP(注意,很多扩展都需要额外安装,如果安装过多建议重新构建镜像)
    image: 'php:7.3-fpm'  # 指定版本,也可使用phpdockerio的镜像(如果使用build自行编译,这个可以禁用)
    # build: php-fpm  # 使用build自行编译(自行编译image可以禁用)
    # container_name: php
    volumes:
      - ./www:/var/www  # 设置网站目录(要和Nginx一致)
    restart: always  # 重启策略(always 自动重启)

mysql:  # MySQL
    image: 'mysql:5.7'  # 指定版本
    # container_name: mysql
    ports:
      # - 3306:3306  # 设置MySQL端口(生产环境最好别开放)
    environment:
      - MYSQL_DATABASE=test  # 设置默认数据库
      - MYSQL_ROOT_PASSWORD=123456  # 设置MySQL root用户密码
      - MYSQL_USER=test  # 设置默认用户
      - MYSQL_PASSWORD=123456  # 设置默认用户密码
    volumes:
      - ./mysql/db/:/var/lib/mysql  # MySQL数据目录
      - ./mysql/conf/:/etc/mysql/conf.d  # MySQL配置文件目录
    restart: always  # 重启策略(always 自动重启)

redis:  # Redis
    image: 'redis:alpine'
    # container_name: redis
    # ports:
    #   - '6379:6379'  # 设置Redis端口(生产环境最好别开放)
    environment:
      # - REDIS_PASSWORD=YNUkH7GWbrQ1VaO  # 设置Redis密码(默认无密码,项目.env的REDIS_PASSWORD=null)
      - REDIS_DISABLE_COMMANDS=FLUSHDB,FLUSHALL  # 禁用危险命令(生产环境最好禁用)
    # volumes:
    #   - './redis:/bitnami/redis/data'
    restart: always  # 重启策略(always 自动重启)
```

### Nginx 配置
`nginx\nginx.conf`
```bash
user nginx;  # 设置 Nginx 运行的用户为 'nginx'
worker_processes auto;  # 根据可用的 CPU 核心数量自动设置 worker 进程的数量
error_log /var/log/nginx/error.log;  # 定义错误日志的路径
pid /run/nginx.pid;  # 定义 Nginx 主进程的 PID 文件路径
# 定义事件模块的配置，主要设置 worker 进程的最大连接数
events {
    worker_connections 1024;
}

# 定义 HTTP 模块的配置
http {
    charset UTF-8;  # 设置字符集为 UTF-8
    # Server 模块的配置
    server {
        listen 80;  # 定义 IPv4 的端口
        listen [::]:80;  # 定义 IPv6 的端口
        server_name localhost;  # 定义服务器名称

location / {
            root /var/www/public;  # 定义网站的根目录(Lumen 项目的 public 目录)
            index index.html index.htm index.php;  # 定义默认的首页文件名( index.html,index.htm,index.php)
            try_files $uri $uri/ /index.php?$query_string;  # 定义请求的 URI 匹配规则
        }
        location = /favicon.ico {  # 定义 favicon.ico 文件的路径
            access_log off;  # 关闭访问日志
            log_not_found off;  # 关闭日志记录
        }
        location /resources/ {  # 定义资源文件的路径
            root /var/www/;  # 定义资源文件的根目录(Lumen 项目的 resources 目录,会自动涵盖子路径链接)
        }
        # php 请求处理
        location ~ \.php$ {  # 定义 PHP 请求的匹配规则(所有以 .php 结尾的请求)
            root /var/www/public;  # 定义 PHP 文件的根目录(Lumen 项目的 public 目录)
            fastcgi_pass php:9000;  # 定义 FastCGI 服务器()的地址和端口
            fastcgi_index index.php;  # 定义默认的 PHP 文件名(index.php)
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  # 定义 SCRIPT_FILENAME 参数的值
            fastcgi_param environment 'develop';  # 定义环境变量(指定 .env文件 的环境变量)
            include fastcgi_params;  # 引入 FastCGI 参数的配置文件
        }
    }
}
```

### PHP 扩展安装
以下所有操作均在 php-fpm 容器内执行，测试阶段直接容器内安装即可，生产阶段最好重新构建一个包含所需扩展的容器，方便快速部署
```bash
apt update && apt install -y libwebp-dev libjpeg-dev libpng-dev libfreetype6-dev  # 安装扩展前先安装好各类库

# 相关拓展安装
# #############################################################
docker-php-ext-install pdo pdo_mysql  # 安装各类扩展(不需要的删除)

pecl install redis  # 安装 Redis
  # 安装时会询问是否启用其他压缩类的,不需要就直接回车即可
  docker-php-ext-enable redis  # 启用 Redis(docker-php 专用)
  # 也可手动在 php.ini 中添加 extension=redis.so

# 安装 Gd(直接使用 docker-php-ext-install gd 安装好像会不完整)
docker-php-source extract && cd /usr/src/php/ext/gd  # 解压源码并进入gd源码目录
docker-php-ext-configure gd --with-webp-dir=/usr/include/webp --with-jpeg-dir=/usr/include --with-png-dir=/usr/include --with-freetype-dir=/usr/include/freetype2 && docker-php-ext-install gd  # 准备编译+编译安装

# 其他操作
# #############################################################
php --ini  # 查看 PHP配置 文件位置(一般在 /usr/local/etc/php/php.ini)
  cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini  # 从示例创建
php -m  # 查看启用的扩展

docker-php-ext-install {扩展包名}  # 安装扩展
docker-php-ext-enable {扩展包名}  # 启用扩展(也可手动修改 php.ini 启用)
```

#### PHP Dockerfile
自行构建镜像，生产环境使用，方便快速迁移
`docker-compose.yml` 启用自行编译，禁用镜像
```bash
  php:
    # image: 'php:7.3-fpm'  # 禁用使用的镜像
    build: php-fpm  # 使用build自行编译(使用 php-fpm 文件夹下的 Dockerfile 进行构建)
    # 其他省略......
```
`php-fpm/Dockerfile` 镜像构建的配置文件
```bash
# 示例，根据实际需求更改
# 使用的底层镜像
FROM php:7.3-fpm
# 工作目录
WORKDIR "/var/www/"

# 安装所需的软件包以及扩展
RUN apt update && apt install -y libwebp-dev libjpeg-dev libpng-dev libfreetype6-dev \
    && docker-php-ext-install pdo pdo_mysql \
    && printf "\n\n\n\n\n\n" | pecl install redis && docker-php-ext-enable redis \
    && docker-php-source extract && cd /usr/src/php/ext/gd && docker-php-ext-configure gd --with-webp-dir=/usr/include/webp --with-jpeg-dir=/usr/include --with-png-dir=/usr/include --with-freetype-dir=/usr/include/freetype2 && docker-php-ext-install gd \
    && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*
```

### 数据库迁移(从项目导入)
```bash
# 进入到项目根目录
php artisan migrate:install  # 设置数据库迁移(会创建migrations表追踪已执行迁移，确保每个迁移只运行一次)
php artisan migrate  # 运行数据库迁移
php artisan db:seed  # 填充数据库
```
>d 如果执行时提示 `mkdir(): No such file or directory`
> 错误代码所在为：mkdir($tmp_storage);
> 那么检查所使用的 `.env` 配置文件，查看 `STORAGE_PATH=/var/www/storage` 是否改为项目下的storage路径

### 其他说明
一般 Limen项目会有多个 `.env` 配置文件，如：env.product、env.develop、env.test
使用的 `.env` 中配置要根据实际需求更改，可在 Nginx 中添加 `fastcgi_param environment 'develop';` 来指定使用的 .env文件

**相关教程：**
[docker部署lumen环境项目（一） 环境搭建](https://blog.csdn.net/qq_45347159/article/details/119352583)
[linux环境下composer的安装与使用](https://www.cnblogs.com/dyj--php/p/11611983.html)
[Linux环境下安装Composer及使用](https://www.jianshu.com/p/2db933f19458)
[docker安装php扩展gd库](https://www.cnblogs.com/xusx2014/p/12181916.html)