stickee/magpie-php

Magpie基础PHP镜像

镜像概述和主要用途

Magpie基础PHP镜像是专为Magpie应用设计的PHP运行环境基础镜像。该镜像提供了Magpie应用运行所需的PHP运行时环境、核心扩展及基础依赖，旨在简化Magpie应用的部署流程，确保开发、测试和生产环境的一致性，作为Magpie应用构建和运行的基础组件。

核心功能和特性

• 稳定的PHP运行环境：基于官方PHP镜像构建，确保PHP版本的稳定性和安全性。
• Magpie必需扩展：预安装Magpie应用运行所需的核心PHP扩展（如mbstring、PDO、JSON、ctype等），无需额外配置即可运行基础Magpie应用。
• 精简镜像体积：采用多阶段构建优化，减少镜像大小，提升部署效率。
• 多架构支持：支持amd64、arm64等主流架构，适配不同硬件环境。
• 环境一致性：统一的基础环境配置，避免因环境差异导致的应用运行问题。
• 易于扩展：支持通过Dockerfile或配置文件自定义添加额外PHP扩展或系统依赖。

使用场景和适用范围

• Magpie应用开发环境：为开发者提供本地一致的PHP环境，减少"在我电脑上能运行"的问题。
• Magpie应用测试环境：作为自动化测试的基础环境，确保测试结果的可靠性。
• Magpie应用生产部署：作为生产环境的基础镜像，配合Magpie应用代码构建最终运行镜像。
• Magpie衍生项目：适用于基于Magpie框架开发的各类应用或服务。

使用方法和配置说明

基本使用

通过docker run命令可快速启动该基础镜像：

bash
docker run --rm -it magpie/php-base:latest php -v

上述命令将输出当前镜像中PHP的版本信息，验证环境是否正常。

作为基础镜像构建Magpie应用

在Magpie应用的Dockerfile中，可将该镜像作为基础镜像：

dockerfile
FROM magpie/php-base:latest

# 复制Magpie应用代码
COPY . /app

# 设置工作目录
WORKDIR /app

# 安装Magpie依赖（如使用composer）
RUN composer install --no-dev --optimize-autoloader

# 暴露应用端口（根据Magpie应用需求调整）
EXPOSE 8080

# 启动命令
CMD ["php", "artisan", "serve", "--host=0.0.0.0", "--port=8080"]

环境变量配置

该镜像支持通过环境变量调整PHP配置，常用环境变量如下：

例如，启动时设置内存限制：

bash
docker run --rm -it -e PHP_MEMORY_LIMIT=256M magpie/php-base:latest php -i | grep memory_limit

Docker Compose配置示例

在Magpie应用的docker-compose.yml中使用该镜像：

yaml
version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile  # Dockerfile中FROM magpie/php-base:latest
    ports:
      - "8080:8080"
    environment:
      - PHP_MEMORY_LIMIT=256M
      - PHP_DISPLAY_ERRORS=On  # 开发环境使用
    volumes:
      - ./:/app  # 本地代码挂载，便于开发调试

自定义PHP扩展

如需添加额外PHP扩展，可在基于该镜像的Dockerfile中使用docker-php-ext-install命令：

dockerfile
FROM magpie/php-base:latest

# 安装额外PHP扩展（如gd）
RUN apt-get update && apt-get install -y \
    libfreetype6-dev \
    libjpeg62-turbo-dev \
    libpng-dev \
  && docker-php-ext-configure gd --with-freetype --with-jpeg \
  && docker-php-ext-install -j$(nproc) gd \
  && rm -rf /var/lib/apt/lists/*