convenia/php-full

Convenia PHP Full 镜像

镜像概述和主要用途

该镜像由Convenia团队构建，旨在以最简单的方式运行PHP应用程序，同时支持生产和开发环境使用。

核心功能和特性

• 多环境支持：适用于生产和开发环境
• 灵活配置：可自定义用户/组ID、Nginx配置
• 安全保障：每周自动构建确保软件更新，Docker Hub扫描保障无漏洞
• 默认优化：预配置Nginx和PHP-FPM，默认使用用户"app"（ID/组1000）运行应用

使用场景和适用范围

• 需要快速部署PHP应用的开发环境
• 生产环境中的PHP应用部署
• 需要自定义用户权限或Nginx配置的PHP项目

使用方法和配置说明

基本使用

在项目根目录创建docker-compose.yml文件，示例配置如下：

yml
version: '3.3'
services:
  app:
    image: convenia/php-full:latest
    container_name: application
    volumes:
      - .:/var/www/app
    ports:
      - 80:80

容器默认尝试从"public"目录提供应用服务。如果应用没有public目录，可通过修改Nginx配置指定正确路径。

更改用户和组

应用默认以用户"app"运行，该用户ID和组ID均为1000。如需修改，可在自定义Dockerfile中执行以下命令：

Dockerfile
RUN addgroup -S -g 2000 newone && adduser -u 2000 -G newone -D newone && \
    sed -i 's/app/newone/g' /usr/local/etc/php-fpm.d/www.conf && \
    chown -R newone:newone /var/www/app

上述命令将创建指定ID的新用户和组，更新php-fpm配置以使用新用户，并修改应用目录权限。

安全性

• 每周自动构建镜像，确保所有软件组件保持最新
• 通过Docker Hub扫描确保镜像无安全漏洞

重要提示：务必阻止9000端口以避免暴露fpm入口点。fpm仅监听容器本地请求，但仍需在防火墙中阻止9000端口，且严禁使用Docker的"host"网络驱动！

修改Nginx配置

默认Nginx配置文件可参考https://github.com/convenia/php-full-8.1-image/blob/main/docker/nginx/default.conf%E3%80%82%E9%80%9A%E5%B8%B8%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E6%96%B9%E5%BC%8F%E8%A6%86%E7%9B%96%E9%85%8D%E7%BD%AE%EF%BC%9A

构建时覆盖

Dockerfile
FROM convenia/php-full:latest

COPY ./local-path-to-config/new-default.conf /etc/nginx/http.d/default.conf

挂载时覆盖

yml
version: '3.3'
services:
  app:
    image: convenia/php-full
    container_name: application
    volumes:
      - ./local-path-to-config/new-default.conf:/etc/nginx/http.d/default.conf
    ports:
      - 80:80

错误反馈和建议

如有任何建议或发现bug，请通过以下方式联系：

• 在GitHub上https://github.com/convenia/php-full-8.1-image
• 发送推文至@convenia