umex/php8.2-fullstack

镜像概述

umex/php8.2-fullstack是一个集成常用扩展和额外工具的全栈PHP8.2镜像，支持Laravel Octane（基于Roadrunner）高性能模式与传统FPM模式，满足PHP应用从开发到生产的全场景需求。

核心功能

• 内置PHP8.2及常用扩展（如PDO、Redis、GD等）
• 支持Laravel Octane（Roadrunner）模式，提升应用性能
• 支持FPM模式，兼容传统PHP应用部署
• 提供配套Nginx配置示例，简化部署流程

使用场景

• Laravel应用的本地开发与调试
• 生产环境中PHP应用的高性能部署（Octane模式）
• 需要快速搭建全栈PHP环境的项目

配置说明

Roadrunner-Alpine模式（Laravel Octane）

依赖要求

需在Laravel项目中安装Octane包：composer require laravel/octane

Nginx配置示例

conf
location / {
   try_files $uri $uri/ @octane;
}

location @octane {
    proxy_pass http://php:8000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto https;
    client_max_body_size 50M;
}

启动Octane Worker

sh
if [[ "$APP_ENV" = "local" ]]; then
   exec php artisan octane:start --host=0.0.0.0 --watch --workers=1 &
else
   exec php artisan octane:start --host=0.0.0.0 --workers=8 &
fi

FPM-Alpine模式

Nginx配置示例

conf
location / {
    try_files $uri /index.php$is_args$args;
}

location ~ \.php$ {
    fastcgi_index  index.php;
    fastcgi_pass   php:9000;
    include        fastcgi_params;
    fastcgi_param   PATH_INFO          $fastcgi_path_info;
    fastcgi_param   SCRIPT_FILENAME    $document_root$fastcgi_script_name;
    fastcgi_param   SCRIPT_NAME        $fastcgi_script_name;

    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_buffers 8 16k;
    fastcgi_buffer_size 32k;
    client_body_buffer_size 128k;
}

Docker Compose部署示例

yaml
version: '3.8'
services:
  php:
    image: umex/php8.2-fullstack
    volumes:
      - ./your-laravel-app:/var/www/html
    environment:
      - APP_ENV=local
    command: sh -c "if [[ \"\$APP_ENV\" = \"local\" ]]; then php artisan octane:start --host=0.0.0.0 --watch --workers=1; else php artisan octane:start --host=0.0.0.0 --workers=8; fi"
  
  nginx:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./your-laravel-app:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # 替换为对应模式的Nginx配置
    depends_on:
      - php