cybernetsoft/php-nginx

PHP 8.2 + Nginx + PHP-FPM 集成镜像

镜像概述和主要用途

该镜像是基于Alpine Linux的轻量级集成镜像，包含PHP 8.2、Nginx Web服务器和PHP-FPM进程管理器，旨在为PHP Web应用提供快速部署环境。通过预配置Nginx与PHP-FPM的通信机制及必要PHP扩展，简化PHP应用的部署流程，适合对镜像大小和部署效率有要求的场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 组件集成：集成Nginx Web服务器和PHP-FPM，无需单独配置两者通信
• 默认配置：
  • PHP-FPM默认socket路径：/run/php-fpm.sock
  • 已预装mysqli扩展，支持MySQL数据库连接
  • 默认网站根目录：/var/www/html
  • 内置Nginx默认配置，支持PHP文件解析及URL重写

使用场景和适用范围

适用于需要快速部署的PHP Web应用场景，包括但不限于：

• 小型PHP网站或Web应用
• CMS系统（如WordPress、Drupal等）
• 自定义PHP应用程序
• 对镜像体积有严格要求的轻量化部署环境

使用方法和配置说明

Dockerfile构建示例

基于该镜像构建自定义应用镜像，可复制自定义Nginx配置并安装额外PHP扩展：

dockerfile
FROM cybernetsoft/php-nginx:8.2
# 复制自定义Nginx配置（替换默认配置）
COPY nginx.conf /etc/nginx/http.d/default.conf
# 安装额外PHP扩展（示例：安装gd扩展）
RUN install-php-extensions mysqli gd

Nginx配置示例

默认Nginx配置位于/etc/nginx/http.d/default.conf，内容如下，支持PHP解析和URL重写：

nginx
server {
    listen 80 default_server;
    server_name _;
    root /var/www/html;
    # URL重写配置，支持单页应用路由
    location / {
        try_files $uri $uri/ /index.php?$args;
    }
    # PHP文件解析配置
    location ~ \.php$ {
        include fastcgi.conf;
        fastcgi_pass unix:/run/php-fpm.sock;
    }
}

核心配置说明

• PHP-FPM通信：通过Unix socket /run/php-fpm.sock 实现Nginx与PHP-FPM通信，性能优于TCP连接
• 文档根目录：应用代码需放置于/var/www/html目录，或通过Nginx配置修改root路径
• 扩展安装：使用install-php-extensions命令安装额外PHP扩展（如示例中的gd）