markpriddy/base-a Docker 镜像 - 轩辕镜像

Ubuntu + Nginx + PHP 8 Docker镜像文档

镜像概述

本镜像基于Ubuntu操作系统，预安装并配置了Nginx Web服务器和PHP 8运行环境，旨在提供一个开箱即用的Web应用部署环境。通过整合Ubuntu的稳定性、Nginx的高性能及PHP 8的新特性，实现快速搭建PHP Web应用的开发、测试与生产环境，减少环境配置时间。

核心功能与特性

基础环境

• 操作系统：基于Ubuntu最新稳定版，提供可靠的系统基础
• Web服务器：Nginx最新稳定版，支持HTTP/HTTPS，具备高性能和低资源消耗特性
• PHP环境：PHP 8.x运行环境，包含常用扩展（如mysqli、pdo_mysql、gd、curl、json等）

集成特性

• 预配置Nginx与PHP-FPM通信，无需手动配置FastCGI参数
• 支持自定义网站根目录和Nginx虚拟主机配置
• 轻量级设计，镜像体积优化，适合快速部署
• 兼容Docker Compose，支持多容器协同部署

使用场景与适用范围

• 开发环境：本地快速搭建PHP应用开发环境，避免环境差异问题
• 测试环境：PHP应用功能测试、兼容性测试（针对PHP 8特性）
• 小型Web应用部署：个人博客、企业官网、小型CMS系统等轻量级PHP应用
• 教学与演示：PHP 8新特性学习、Web服务器配置教学环境

使用方法

1. 拉取镜像

假设镜像名称为ubuntu-nginx-php8（实际使用时需替换为具体镜像名称）：

bash
docker pull ubuntu-nginx-php8

2. 基本运行示例

快速启动（默认配置）

bash
docker run -d -p 80:80 --name php-webapp ubuntu-nginx-php8

• -d：后台运行容器
• -p 80:80：将容器的80端口映射到主机的80端口
• --name php-webapp：指定容器名称为php-webapp

启动后，访问http://localhost即可看到默认欢迎页面（或容器内/var/www/html目录下的内容）。

挂载自定义网站目录

将本地网站代码目录挂载到容器的网站根目录（默认/var/www/html）：

bash
docker run -d -p 80:80 \
  -v /path/to/local/webroot:/var/www/html \
  --name php-webapp ubuntu-nginx-php8

• -v /path/to/local/webroot:/var/www/html：本地网站目录与容器内网站根目录挂载

3. Docker Compose配置示例

创建docker-compose.yml文件，实现更灵活的配置：

yaml
version: '3'
services:
  web:
    image: ubuntu-nginx-php8
    container_name: php-webapp
    ports:
      - "80:80"
      - "443:443"  # 如需HTTPS，映射443端口
    volumes:
      - ./webroot:/var/www/html  # 网站代码目录
      - ./nginx/conf.d:/etc/nginx/conf.d  # 自定义Nginx配置
      - ./php/php.ini:/etc/php/8.0/fpm/php.ini  # 自定义PHP配置
      - ./logs:/var/log/nginx  # Nginx日志目录
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

配置说明

核心配置路径

自定义配置方法

修改Nginx配置

1. 本地创建Nginx配置文件（如my-site.conf），定义虚拟主机规则
2. 通过-v参数挂载到容器的/etc/nginx/conf.d/目录：

   bash
   docker run -d -p 80:80 \
     -v /path/to/my-site.conf:/etc/nginx/conf.d/my-site.conf \
     --name php-webapp ubuntu-nginx-php8
   

3. 重启容器使配置生效：docker restart php-webapp

修改PHP配置

1. 本地创建或修改php.ini文件，调整PHP参数（如memory_limit、upload_max_filesize等）
2. 挂载到容器的PHP配置路径：

   bash
   docker run -d -p 80:80 \
     -v /path/to/custom-php.ini:/etc/php/8.0/fpm/php.ini \
     --name php-webapp ubuntu-nginx-php8
   

3. 重启容器或重载PHP-FPM：docker exec php-webapp service php8.0-fpm reload

环境变量（可选）

如镜像支持，可通过环境变量调整基础配置（具体以镜像实际支持为准）：

• PHP_MEMORY_LIMIT：PHP内存限制，默认128M
• NGINX_PORT：Nginx监听端口，默认80
• WEB_ROOT：自定义网站根目录，默认/var/www/html

使用示例：

bash
docker run -d -p 8080:8080 \
  -e PHP_MEMORY_LIMIT=256M \
  -e NGINX_PORT=8080 \
  --name php-webapp ubuntu-nginx-ph8

日志与管理

• 查看Nginx访问日志：docker exec php-webapp cat /var/log/nginx/access.log
• 查看Nginx错误日志：docker exec php-webapp cat /var/log/nginx/error.log
• 进入容器终端：docker exec -it php-webapp /bin/bash
• 重启Nginx服务：docker exec php-webapp service nginx restart
• 重启PHP-FPM服务：docker exec php-webapp service php8.0-fpm restart