SaaS Labs PHP基础镜像文档

1. 镜像概述

SaaS Labs PHP基础镜像是由SaaS Labs提供的PHP运行环境基础镜像，基于官方PHP镜像构建并优化，旨在为各类PHP应用提供稳定、高效的基础运行环境。该镜像包含PHP运行时、常用扩展及优化配置，简化PHP应用的构建、测试和部署流程，适用于开发、测试及生产环境。

2. 核心功能与特性

• 多版本支持：基于官方PHP稳定版本构建，支持PHP 7.4+及8.x系列版本，满足不同应用的版本需求。
• 优化配置：内置生产级优化的php.ini配置，包括内存限制、执行时间、错误处理等参数调优，平衡性能与安全性。
• 常用扩展预装：包含PHP核心扩展（如mysqli、pdo_mysql、curl、json等）及常用工具，减少额外配置工作。
• 轻量级设计：基于Alpine或Debian slim版本构建（根据标签区分），镜像体积小，资源占用低。
• 多架构兼容：支持amd64、arm64等主流架构，适配不同硬件环境。
• 安全强化：默认禁用危险函数，启用安全相关配置（如open_basedir限制），降低安全风险。

3. 使用场景与适用范围

• PHP应用开发：作为本地开发环境基础，提供一致的PHP运行时，避免环境差异导致的问题。
• 生产环境部署：适用于各类PHP应用的生产环境部署，如CMS系统（WordPress、Drupal）、电商平台、API服务等。
• 微服务架构：作为微服务架构中PHP服务的基础镜像，与其他服务（如数据库、缓存）协同工作。
• CI/CD流水线：集成到持续集成/部署流程，用于自动化构建、测试PHP应用。
• 容器化迁移：帮助传统PHP应用快速容器化，简化部署和运维流程。

4. 使用方法与配置说明

4.1 获取镜像

通过Docker Hub或SaaS Labs官方仓库拉取镜像（具体仓库地址请参考SaaS Labs官方文档）：

# 格式：docker pull [仓库地址]/saaslabs/php-base:[版本标签]
# 示例（假设仓库为Docker Hub）：
docker pull saaslabs/php-base:8.2-fpm-alpine

版本标签说明：标签格式为[PHP版本]-[类型]-[基础系统]，如8.1-cli（CLI模式，Debian基础）、7.4-fpm-alpine（FPM模式，Alpine基础）。

4.2 基础使用示例

4.2.1 运行PHP CLI命令

快速执行PHP脚本或查看版本：

# 查看PHP版本
docker run --rm saaslabs/php-base:8.2-cli php -v

# 运行本地PHP脚本
docker run --rm -v $(pwd):/app saaslabs/php-base:8.2-cli php /app/script.php

4.2.2 部署PHP-FPM服务（配合Web服务器）

作为FPM服务运行，供Nginx等Web服务器反向代理：

# 启动FPM服务
docker run -d \
  --name php-fpm-service \
  -v $(pwd)/app:/var/www/html \  # 挂载应用代码
  -p 9000:9000 \                 # 暴露FPM端口
  saaslabs/php-base:8.2-fpm

4.2.3 通过Dockerfile构建自定义应用

创建Dockerfile扩展基础镜像：

# 选择基础镜像版本
FROM saaslabs/php-base:8.2-fpm-alpine

# 复制应用代码到容器
COPY ./src /var/www/html

# 安装额外扩展（如需）
RUN docker-php-ext-install bcmath

# 设置目录权限
RUN chown -R www-data:www-data /var/www/html

构建并运行：

docker build -t my-php-app .
docker run -d -p 9000:9000 my-php-app

4.3 配置参数与环境变量

4.3.1 环境变量调整

通过环境变量动态调整PHP配置，常用变量如下：

示例：调整内存限制和执行时间

docker run -d \
  -e PHP_MEMORY_LIMIT=512M \
  -e PHP_MAX_EXECUTION_TIME=120 \
  saaslabs/php-base:8.2-fpm

4.3.2 自定义配置文件

如需更复杂的配置，可挂载自定义php.ini配置文件到容器的PHP配置目录：

# 挂载本地配置文件覆盖默认配置
docker run -d \
  -v $(pwd)/custom-php.ini:/usr/local/etc/php/conf.d/99-custom.ini \
  saaslabs/php-base:8.2-fpm

4.4 扩展管理

基础镜像已预装核心扩展，如需添加额外扩展，可通过以下方式：

4.4.1 官方扩展安装

使用docker-php-ext-install命令安装PHP官方扩展：

FROM saaslabs/php-base:8.2-fpm

# 安装zip扩展
RUN docker-php-ext-install zip

4.4.2 PECL扩展安装

通过pecl安装第三方扩展（需先安装pecl工具，Alpine版本可能需额外依赖）：

FROM saaslabs/php-base:8.2-fpm-alpine

# 安装redis扩展
RUN apk add --no-cache $PHPIZE_DEPS \
    && pecl install redis \
    && docker-php-ext-enable redis \
    && rm -rf /tmp/pear

5. 注意事项

• 版本选择：生产环境建议使用具体版本标签（如8.2-fpm），避免使用latest标签，确保版本稳定性。
• 用户权限：镜像默认使用非root用户（如www-data）运行，挂载宿主机目录时需确保权限匹配，避免权限错误。
• 日志管理：默认日志输出到标准输出或指定文件，建议结合容器编排工具（如Docker Compose、Kubernetes）进行日志收集。
• 安全更新：定期拉取最新镜像以获取安全补丁和版本更新。
• 扩展兼容性：安装额外扩展时，需确保与PHP版本兼容（参考PHP官方扩展文档）。

6. 参考与反馈

• 完整版本标签列表及扩展详情，请参考SaaS Labs官方仓库文档。
• 如有问题或功能需求，可通过SaaS Labs官方渠道提交反馈。