jkaninda/laravel-php-fpm

🐳 Docker镜像：Laravel PHP-FPM

一个即用型容器，专为运行基于PHP的应用程序（包括Laravel微服务）设计。该Docker镜像包含PHP-FPM，为项目提供坚实基础，内置对 essential 扩展和配置的支持。

https://github.com/jkaninda/laravel-php-fpm/actions/workflows/build.yml/badge.svg](https://github.com/jkaninda/laravel-php-fpm/actions/workflows/build.yml) https://github.com/jkaninda/laravel-php-fpm/actions/workflows/tests.yml/badge.svg](https://github.com/jkaninda/laravel-php-fpm/actions/workflows/tests.yml) !Docker镜像大小（按日期最新） !Docker拉取量

https://github.com/jkaninda/laravel-php-fpm

特性

• PHP应用支持：优化用于运行Laravel或任何基于PHP的应用程序。
• 集成扩展：
  • 数据库：MySQL和PostgreSQL。
  • 缓存：Redis和Memcached。
  • 消息传递：Kafka（用于事件驱动架构）。
  • 任务调度：支持Laravel Scheduler和Cron任务。
• 自定义配置：预配置合理默认值，支持无缝定制。
• 事件处理：支持高级事件驱动流程。
• 微服务优化：为现代PHP微服务构建。

该镜像非常适合需要精简、高性能解决方案来部署PHP应用程序的开发者，已集成必要工具。

链接：

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

支持的PHP版本

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

规格

PHP扩展

• Composer
• OpenSSL
• XML
• PDO（MySQL和PostgreSQL）
• Rdkafka
• Redis
• Mbstring
• PCNTL
• ZIP
• GD
• BCMath
• Memcached
• Opcache

额外功能

• Laravel Cron任务
• Laravel Scheduler
• Supervisord
• Node.js和NPM

快速开始

简单Docker-Compose示例

yaml
services:
  php-fpm:
    image: jkaninda/laravel-php-fpm:latest
    container_name: php-fpm
    restart: unless-stopped
    user: www-data # 生产环境使用
    volumes:
      - ./:/var/www/html
    networks:
      - default
  nginx-server:
     image: jkaninda/nginx-fpm:alpine
     container_name: nginx-server
     restart: unless-stopped
     ports:
      - 80:80
     volumes:
      - ./:/var/www/html
     environment:
       - DOCUMENT_ROOT=/var/www/html/public
       - CLIENT_MAX_BODY_SIZE=20M
       - PHP_FPM_HOST=php-fpm:9000 
     networks:
      - default

基本命令

• 启动容器

  sh
  docker compose up -d
  

• 创建Laravel项目

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

• 生成应用密钥

  sh
  docker compose exec php-fpm php artisan key:generate
  

• 创建存储符号链接

  sh
  docker compose exec php-fpm php artisan storage:link
  

• 修复权限

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

• 运行Laravel迁移

  sh
  docker compose exec php-fpm php artisan migrate
  

• 进入容器shell

  sh
  docker exec -it php-fpm bash
  

与Nginx的高级用法

带Nginx的Docker-Compose

使用自定义Nginx配置的示例：

yaml
version: '3'
services:
  php-fpm:
    image: jkaninda/laravel-php-fpm
    container_name: php-fpm
    restart: unless-stopped
    volumes:
      - ./:/var/www/html
    networks:
      - default

  nginx-server:
    image: nginx:alpine
    container_name: nginx-server
    restart: unless-stopped
    ports:
      - 80:80
    volumes:
      - ./:/var/www/html
      - ./default.conf:/etc/nginx/conf.d/default.conf
    environment:
      - DOCUMENT_ROOT=/var/www/html/public
      - CLIENT_MAX_BODY_SIZE=20M
      - PHP_FPM_HOST=php-fpm:9000
    networks:
      - default

Nginx配置（default.conf）

conf
server {
    listen 80;
    index index.php index.html;
    root /var/www/html/public;

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass php-fpm:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
        gzip_static on;
    }

    client_max_body_size 15M;
    server_tokens off;
    fastcgi_hide_header X-Powered-By;
}

自定义构建

Dockerfile示例

Dockerfile
FROM jkaninda/laravel-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

Supervisord集成

添加自定义Supervisor进程

将配置文件放置在 /etc/supervisor/conf.d/。
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

自定义PHP配置

将自定义php.ini文件放置在：

/usr/local/etc/php/conf.d/

存储权限修复

如果遇到权限问题，运行：

sh
docker compose exec php-fpm /bin/bash
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 都能帮助您高效、安全且低复杂度地完成。

⭐️ 支持该项目

如果这个项目对您有帮助，请不要吝啬给它一个星标。谢谢！