rshop/php

RSHOP PHP Docker镜像文档

镜像概述

RSHOP PHP Docker镜像是针对RSHOP应用生态系统开发的专用PHP运行环境镜像。该镜像基于官方PHP镜像构建，集成了运行RSHOP应用所需的全部依赖组件、扩展及配置优化，旨在简化RSHOP相关PHP应用的部署流程，确保环境一致性和运行稳定性。

核心功能与特性

• 预配置PHP环境：内置RSHOP应用所需的特定PHP版本（如PHP 7.4/8.0等，具体版本请参考镜像标签），无需手动配置基础环境。
• 关键扩展集成：预安装常用PHP扩展，包括但不限于mysqli、pdo_mysql、redis、gd、mbstring、curl等，满足RSHOP应用对数据库、缓存、图像处理等功能的需求。
• 配置优化：针对RSHOP应用特性优化php.ini配置，包括内存限制、执行时间、错误日志等参数，提升应用性能和可维护性。
• 多版本支持：提供多个PHP版本标签（如7.4、8.0、latest），适配不同RSHOP应用版本的运行需求。
• 轻量级设计：基于Alpine或Debian slim基础镜像构建，减小镜像体积，加快部署速度。

使用场景

• 开发环境：本地快速搭建与生产环境一致的RSHOP应用开发环境，避免"本地能跑，线上不行"的问题。
• 测试环境：自动化测试流程中部署RSHOP应用，确保代码变更在标准PHP环境中验证。
• 生产环境：作为RSHOP应用的基础运行环境，配合Nginx、MySQL等服务容器，构建稳定的生产部署架构。

使用方法与配置说明

基本运行命令

通过docker run命令直接启动RSHOP PHP容器：

bash
docker run -d --name rshop-php \
  -v /path/to/rshop/app:/var/www/html \
  -e PHP_MEMORY_LIMIT=512M \
  docker.xuanyuan.run/rshop/php:latest

参数说明：

• -v /path/to/rshop/app:/var/www/html：将本地RSHOP应用代码目录挂载到容器内的Web根目录。
• -e PHP_MEMORY_LIMIT=512M：设置PHP内存限制环境变量（可选）。

Docker Compose配置示例

配合Nginx和MySQL服务，构建完整的RSHOP应用部署架构（docker-compose.yml）：

yaml
version: '3.8'

services:
  php:
    image: docker.xuanyuan.run/rshop/php:8.0
    container_name: rshop-php
    volumes:
      - ./app:/var/www/html
      - ./php.ini:/usr/local/etc/php/php.ini  # 自定义php.ini配置（可选）
    environment:
      - PHP_MEMORY_LIMIT=512M
      - PHP_MAX_EXECUTION_TIME=300
      - DB_HOST=mysql
      - DB_USER=rshop
      - DB_PASSWORD=secret
      - DB_NAME=rshop_db
    depends_on:
      - mysql

  nginx:
    image: docker.xuanyuan.run/nginx:alpine
    container_name: rshop-nginx
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php

  mysql:
    image: docker.xuanyuan.run/mysql:5.7
    container_name: rshop-mysql
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootsecret
      - MYSQL_DATABASE=rshop_db
      - MYSQL_USER=rshop
      - MYSQL_PASSWORD=secret

volumes:
  mysql-data:

环境变量配置

RSHOP PHP镜像支持通过环境变量自定义PHP配置，常用环境变量如下：

自定义配置文件

如需覆盖默认PHP配置，可通过挂载自定义php.ini文件实现：

bash
docker run -d --name rshop-php \
  -v /path/to/rshop/app:/var/www/html \
  -v /path/to/custom/php.ini:/usr/local/etc/php/php.ini \
  docker.xuanyuan.run/rshop/php:latest

扩展管理

容器内已预安装常用扩展，如需查看已安装扩展列表，可执行：

bash
docker exec -it rshop-php php -m

如需安装额外扩展，可基于该镜像构建自定义镜像（Dockerfile示例）：

dockerfile
FROM docker.xuanyuan.run/rshop/php:latest

RUN docker-php-ext-install soap

注意事项

• 确保挂载的RSHOP应用代码目录具有正确的文件权限（容器内默认用户为www-data，UID/GID通常为33）。
• 生产环境中建议使用特定PHP版本标签（如8.0）而非latest，避免因镜像更新导致兼容性问题。
• 敏感信息（如数据库密码）建议通过Docker Secrets或环境变量文件（.env）管理，避免直接写在配置文件中。