jkaninda/nginx-php-fpm

Docker镜像：Nginx PHP-FPM

一个即用型容器，用于运行PHP应用（包括Laravel微服务），集成Nginx和PHP-FPM，提供内置扩展和配置支持，为项目提供稳健基础。

https://github.com/jkaninda/nginx-php-fpm/actions/workflows/build.yml/badge.svg](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/build.yml) https://github.com/jkaninda/nginx-php-fpm/actions/workflows/tests.yml/badge.svg](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/tests.yml) !Docker Image Size (latest by date) !Docker Pulls

核心功能

• PHP应用支持：优化运行Laravel及各类PHP应用
• 集成扩展：
  • 数据库：MySQL、PostgreSQL
  • 缓存：Redis、Memcached
  • 消息：Kafka（事件驱动架构支持）
  • 任务调度：Laravel Scheduler及Cron任务支持
• 自定义配置：预设合理默认值，支持无缝定制
• 事件处理：支持高级事件驱动流程
• 微服务优化：针对现代PHP微服务设计

适合需要精简、高性能解决方案的开发者，已集成部署PHP应用所需的必要工具。

链接

• https://hub.docker.com/r/jkaninda/nginx-php-fpm
• https://github.com/jkaninda/nginx-php-fpm

支持的PHP版本

• 8.4
• 8.3
• 8.2
• 8.1
• 8.0
• 7.4
• 7.2

规格说明

该Docker镜像预装以下组件：

• PHP扩展：

  • Composer
  • OpenSSL
  • XML
  • PDO
  • Rdkafka
  • Redis
  • Mbstring
  • PCNTL
  • ZIP
  • GD
  • BCMath
  • Memcached

• 额外功能：

  • Laravel Cron任务及调度器
  • Supervisord
  • Node.js & NPM

Docker Compose基础使用

示例docker-compose.yml

yaml
services:
  app:
    image: jkaninda/nginx-php-fpm:8.3
    container_name: app
    restart: unless-stopped
    user: www-data # 生产环境可选
    volumes:
      # 项目根目录
      - ./src:/var/www/html
    ports:
      - "80:80"
    networks:
      - default

命令

启动服务：

sh
docker compose up -d

创建新Laravel项目：

sh
docker compose exec app composer create-project --prefer-dist laravel/laravel .

生成应用密钥：

sh
docker compose exec app php artisan key:generate

创建存储符号链接：

sh
docker compose exec app php artisan storage:link

修复存储和缓存权限：

sh
docker compose exec app chmod -R 777 storage bootstrap/cache

运行Laravel迁移：

sh
docker compose exec app php artisan migrate

进入容器shell：

sh
docker exec -it app bash

Nginx PHP-FPM高级配置

扩展docker-compose.yml示例

yaml
version: '3'
services:
  app:
    image: jkaninda/nginx-php-fpm
    container_name: app
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      # 项目根目录
      - ./:/var/www/html
      - ~/.ssh:/root/.ssh # 如需使用私有代码仓库
      # 可选自定义PHP配置
      # - ./php.ini:/usr/local/etc/php/conf.d/php.ini
    environment:
      - APP_ENV=development # 或production
      - LARAVEL_PROCS_NUMBER=2 # 可选：队列工作进程数
      # - CLIENT_MAX_BODY_SIZE=20M # 可选
      # - DOMAIN=example.com # 可选
      - DOCUMENT_ROOT=/var/www/html # 可选

默认Web根目录

/var/www/html

自定义构建示例

Dockerfile

Dockerfile
FROM jkaninda/nginx-php-fpm:8.3
# 复制Laravel项目文件
COPY . /var/www/html
# 存储卷
VOLUME /var/www/html/storage

WORKDIR /var/www/html

# 修复权限
RUN chown -R www-data:www-data /var/www/html

USER www-data

自定义Nginx配置

如需自定义Nginx配置，可使用以下文件：

• /var/www/html/conf/nginx/nginx.conf
• /var/www/html/conf/nginx/nginx-site.conf

Supervisord集成

Supervisord可用于管理容器内的任务或进程。

Kafka消费者配置示例

conf
[program:kafkaconsume-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/artisan kafka:consumer
autostart=true
autorestart=true
numprocs=1
user=www-data
redirect_stderr=true
stdout_logfile=/var/www/html/storage/logs/kafka.log

修复存储权限

若遇到存储权限问题，执行以下命令：

sh
docker compose exec php-fpm /bin/bash

然后在容器内执行：

sh
chown -R www-data:www-data /var/www/html/
chmod -R 775 /var/www/html/storage

探索其他项目：Goma Gateway

正在构建微服务架构？
需要强大且轻量的API网关或高性能反向代理来轻松保护和管理服务？

查看我的另一个项目——**https://github.com/jkaninda/goma-gateway**%E3%80%82

Goma Gateway是一个高性能、声明式API网关，专为现代微服务设计。内置丰富中间件，包括：

• 基础认证、JWT、OAuth2、LDAP和ForwardAuth认证
• 缓存和限流
• 机器人检测
• 内置负载均衡
• 配置简单，开销极小
• ...及更多！

协议支持：REST、GraphQL、gRPC、TCP和UDP

安全性：通过Let's Encrypt自动HTTPS或使用自有TLS证书

无论管理内部API还是暴露公共端点，Goma Gateway都能帮助你高效、安全且低复杂度地实现目标。

⭐️ 支持项目

如果本项目对你有帮助，请不吝点赞。感谢支持！