ronaldschouw/hello-openshift

Hello Openshift Docker镜像文档

镜像概述和主要用途

该镜像为基于Alpine Linux构建的PHP-FPM 7.3与Nginx 1.18组合环境，镜像大小仅约35MB。主要用于快速部署PHP应用，提供轻量级、高性能的Web服务环境，适合开发、测试及小型生产场景。

核心功能和特性

• 基于轻量级且安全的Alpine Linux发行版构建
• 极小的Docker镜像体积（约35MB）
• 使用PHP 7.3版本，提供更好的性能、更低的CPU使用率和内存占用
• 优化支持100个并发用户
• 采用PHP-FPM的按需进程管理（on-demand PM），仅在有流量时使用资源
• Nginx、PHP-FPM和supervisord服务均以非特权用户（nobody）运行，增强安全性
• 所有服务日志重定向至Docker容器输出（可通过docker logs -f <容器名称>查看）
• 遵循KISS原则（保持简单），便于理解和调整以满足自定义需求

!https://img.shields.io/docker/pulls/ronaldschouw/hello-openshift.svg !https://images.microbadger.com/badges/image/ronaldschouw/hello-openshift.svg !https://img.shields.io/badge/nginx-1.18-brightgreen.svg !https://img.shields.io/badge/php-7.3-brightgreen.svg !https://img.shields.io/badge/license-MIT-blue.svg

使用场景和适用范围

• 开发环境：快速搭建PHP开发环境，支持本地代码挂载
• 测试环境：轻量级部署用于应用功能测试和性能验证
• 小型生产环境：适用于流量适中的PHP应用部署，资源占用低

详细使用方法和配置说明

基本使用

启动Docker容器：

bash
docker run -p 80:8080 docker.xuanyuan.run/ronaldschouw/hello-openshift

访问 http://localhost 查看PHP信息，或访问 http://localhost/test.html 查看静态HTML页面。

挂载自定义代码

挂载本地代码库以由PHP-FPM和Nginx提供服务：

bash
docker run -p 80:8080 -v ~/my-codebase:/var/www/html docker.xuanyuan.run/ronaldschouw/hello-openshift

配置自定义

默认配置文件位于镜像的config/目录下，包含Nginx、PHP和PHP-FPM的配置。可通过挂载自定义配置文件进行扩展或修改：

Nginx配置

bash
docker run -v "`pwd`/nginx-server.conf:/etc/nginx/conf.d/server.conf" docker.xuanyuan.run/ronaldschouw/hello-openshift

PHP配置

bash
docker run -v "`pwd`/php-setting.ini:/etc/php7/conf.d/settings.ini" docker.xuanyuan.run/ronaldschouw/hello-openshift

PHP-FPM配置

bash
docker run -v "`pwd`/php-fpm-settings.conf:/etc/php7/php-fpm.d/server.conf" docker.xuanyuan.run/ronaldschouw/hello-openshift

注意：-v参数需要绝对路径，示例中使用pwd获取当前目录的绝对路径。

添加Composer

如需在项目中使用https://getcomposer.org/%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E6%96%B9%E5%BC%8F%E6%B7%BB%E5%8A%A0%EF%BC%9A

直接安装Composer

dockerfile
FROM docker.xuanyuan.run/ronaldschouw/hello-openshift:latest

# 从官方镜像复制composer
COPY --from=composer /usr/bin/composer /usr/bin/composer

# 运行composer install安装依赖
RUN composer install --optimize-autoloader --no-interaction --no-progress

多阶段构建（不含Composer）

如需构建包含源代码和依赖但不包含Composer本身的镜像，可使用多阶段构建：

dockerfile
FROM composer AS composer

# 复制源代码并安装依赖
COPY <your_directory>/ /app

# 运行composer install安装依赖
RUN composer install \
  --optimize-autoloader \
  --no-interaction \
  --no-progress

# 继续构建并复制源代码及依赖
FROM ronaldschouw/hello-openshift
COPY --chown=nginx --from=composer /app /var/www/html