arm32v6/php

PHP脚本语言设计用于Web开发，同时具备通用目的使用能力。

4 收藏0 次下载activearm32v6镜像

arm32v6/php 镜像文档

镜像概述和主要用途

arm32v6/php 是针对 ARM32v6 架构构建的 PHP *** Docker 镜像，基于 PHP ***镜像的特定架构版本。PHP 是一种服务器端脚本语言，主要设计用于 Web 开发，同时也可作为通用编程语言使用。该镜像适用于在 ARM32v6 架构设备（如嵌入式系统、树莓派等）上部署 PHP 应用，提供了灵活的扩展安装、配置管理和多种运行模式支持。

核心功能和特性

多扩展支持：提供 docker-php-ext-configure、docker-php-ext-install、docker-php-ext-enable 等工具，简化 PHP 核心扩展、PECL 扩展及第三方扩展的安装与配置。
架构适配：专为 ARM32v6 架构优化，兼容该架构的硬件设备。
灵活配置：内置 php.ini-development 和 php.ini-production 配置文件，支持通过 $PHP_INI_DIR/conf.d/ 目录自定义配置。
多变体镜像：提供 CLI（命令行）、FPM（FastCGI 进程管理器）、Alpine（轻量级）等多种变体，满足不同场景需求。
安全性：支持以非特权用户运行，降低容器运行风险。

使用场景和适用范围

命令行脚本：通过 cli 变体运行 PHP 命令行工具或脚本（如定时任务、数据处理脚本）。
Web 应用后端：通过 fpm 变体作为 Web 服务器（如 Nginx、Apache）的 FastCGI 后端，处理 PHP 动态请求。
资源受限环境：使用 alpine 变体在对镜像体积敏感的场景中部署（如嵌入式设备、低资源服务器）。
ARM32v6 设备开发：在树莓派等 ARM32v6 架构硬件上构建和测试 PHP 应用。

详细使用方法和配置说明

基础使用方法

1. 通过 Dockerfile 构建项目

创建 Dockerfile 定义 PHP 应用环境：

dockerfile
FROM arm32v6/php:8.2-cli
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
CMD ["php", "./your-script.php"]

构建并运行镜像：

console
$ docker build -t my-php-app .
$ docker run -it --rm --name my-running-app my-php-app

2. 直接运行单个 PHP 脚本

无需编写 Dockerfile，直接挂载脚本文件并运行：

console
$ docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/myapp \
  -w /usr/src/myapp \
  arm32v6/php:8.2-cli \
  php your-script.php

安装 PHP 扩展

核心扩展安装

通过 docker-php-ext-install 安装 PHP 核心扩展，需先安装依赖库。例如安装 gd 扩展：

dockerfile
FROM arm32v6/php:8.2-fpm
RUN apt-get update && apt-get install -y \
    libfreetype-dev \
    libjpeg62-turbo-dev \
    libpng-dev \
  && docker-php-ext-configure gd --with-freetype --with-jpeg \
  && docker-php-ext-install -j$(nproc) gd

PECL 扩展安装

通过 pecl install 安装 PECL 扩展，再用 docker-php-ext-enable 启用。例如安装 redis 和 xdebug：

dockerfile
FROM arm32v6/php:8.2-cli
RUN pecl install redis-5.3.7 \
  && pecl install xdebug-3.2.1 \
  && docker-php-ext-enable redis xdebug

第三方扩展安装

对于非核心或非 PECL 扩展，可通过源码编译安装。例如：

dockerfile
FROM arm32v6/php:8.2-cli
RUN curl -fsSL "[扩展源码URL]" -o module-name.tar.gz \
  && mkdir -p /tmp/module-name \
  && tar -xf module-name.tar.gz -C /tmp/module-name --strip-components=1 \
  && rm module-name.tar.gz \
  && docker-php-ext-configure /tmp/module-name --enable-module-name \
  && docker-php-ext-install /tmp/module-name \
  && rm -r /tmp/module-name

配置管理

默认配置文件

镜像内置两种配置文件：

php.ini-development：开发环境配置（默认启用）
php.ini-production：生产环境配置（推荐生产环境使用）

切换至生产配置示例：

dockerfile
FROM arm32v6/php:8.2-fpm-alpine
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"

自定义配置

通过挂载或复制配置文件到 $PHP_INI_DIR/conf.d/ 目录来自定义 PHP 配置。例如创建 custom.ini：

ini
upload_max_filesize = 20M
post_max_size = 20M

在 Dockerfile 中复制到容器：

dockerfile
FROM arm32v6/php:8.2-cli
COPY custom.ini $PHP_INI_DIR/conf.d/

以非特权用户运行

FPM 变体

直接通过 --user 参数指定 UID/GID 或用户名运行：

console
$ docker run -it --rm --name my-php-fpm --user 1000:1000 arm32v6/php:8.2-fpm

Apache 变体

内核版本 ≥4.11：添加 --sysctl net.ipv4.ip_unprivileged_port_start=0 允许非特权用户绑定低端口：

console
$ docker run -it --rm --name my-php-apache --sysctl net.ipv4.ip_unprivileged_port_start=0 --user 1000:1000 arm32v6/php:8.2-apache

低版本内核：修改 Apache 配置使用 ≥1024 的端口，再指定非特权用户运行。

镜像变体

`arm32v6/php:<version>-cli`

包含 PHP CLI（命令行接口）工具，适用于运行命令行脚本或作为基础镜像构建应用。默认不包含 Web 服务器，仅提供 PHP 解释器。所有 PHP 镜像变体均包含此 CLI 工具（路径 /usr/local/bin/php）。

`arm32v6/php:<version>-alpine`

基于 Alpine Linux 构建，镜像体积极小（约 5MB 基础镜像），适合资源受限环境。使用 musl 标准库（替代 glibc），需注意部分依赖 glibc 的扩展可能兼容性问题。

`arm32v6/php:<version>-fpm`

包含 PHP-FPM（FastCGI 进程管理器），作为 Web 服务器的后端处理 PHP 请求。需配合 Nginx、Apache 等支持 FastCGI 的 Web 服务器使用，禁止直接暴露 FPM 端口到公网（FastCGI 协议本身不提供安全防护）。

支持的标签和架构

标签列表：完整标签及对应 Dockerfile 链接参见 PHP ***文档（因 Hub 长度限制，本页面标签列表已截断）。
支持架构：除 ARM32v6 外，PHP ***镜像还支持 amd64、arm32v5、arm32v7、arm64v8、i386 等架构，详见 ***文档。