falki141/frankenphp-hardened

FrankenPHP Hardened 镜像文档

镜像概述

FrankenPHP Hardened 是一个基于FrankenPHP构建的精简Docker镜像，从原始镜像优化为scratch基础镜像，旨在提供轻量、安全的PHP运行环境。该镜像预装了多种常用PHP扩展，可直接用于部署各类PHP应用。

核心功能与特性

预装PHP扩展

• dom：文档对象模型处理
• ctype：字符类型检测
• exif：图像元数据处理
• gd：图像处理库
• intl：国际化支持
• opcache：PHP字节码缓存
• pdo：数据库抽象层
• pdo_mysql：MySQL数据库驱动
• session：会话管理
• xml：XML解析支持
• gmp：任意精度数学运算
• bcmath：高精度数学函数
• fileinfo：文件信息检测
• simplexml：简单XML解析
• sockets：网络套接字支持
• zip：ZIP压缩文件处理
• redis：Redis数据库扩展

镜像特性

• 基于scratch基础镜像，体积精简
• 保留FrankenPHP核心功能，兼顾性能与安全性
• 即开即用，无需额外安装常用扩展

使用场景

• 部署需要上述PHP扩展的Web应用
• 构建轻量级PHP服务或API
• 开发环境与生产环境的一致性保障
• 需要精简镜像体积的容器化部署场景

使用方法

基本使用流程

1. 将PHP应用文件复制到容器内的/app目录，或通过挂载方式提供应用代码
2. 启动容器，FrankenPHP会自动运行/app目录下的应用

部署示例

Docker Run 命令

bash
docker run -d \
  --name=frankenphp-app \
  -p 8080:8080 \
  -v /path/to/your/app:/app \
  falki141/frankenphp-hardened:8.5

参数说明：

• -d：后台运行容器
• --name=frankenphp-app：指定容器名称
• -p 8080:8080：端口映射（主机端口:容器端口）
• -v /path/to/your/app:/app：挂载本地应用目录到容器内/app目录
• falki141/frankenphp-hardened:8.5：镜像名称及标签（8.5为PHP版本）

应用部署方式

• 本地文件复制：通过Dockerfile将应用复制到/app目录

  dockerfile
  FROM falki141/frankenphp-hardened:8.5
  COPY ./your-app /app
  

• 目录挂载：如上述docker run命令所示，通过-v参数实时挂载应用目录，适合开发环境

注意事项

• 确保应用入口文件符合FrankenPHP的默认配置（通常为public/index.php）
• 如需自定义FrankenPHP配置，可通过挂载配置文件到相应目录
• 镜像标签中的版本号（如8.5）对应PHP版本，选择与应用兼容的版本
• 生产环境建议使用固定标签，避免因镜像更新导致兼容性问题