cirovmarques/php8.1-oci8-nginx-alpine

PHP 8.1 with OCI8 and Nginx 镜像文档

镜像概述

本镜像基于 php:8.1-fpm-alpine 构建，集成了Oracle Instant Client、OCI8及pdo_oci扩展，同时包含nginx web服务器、Composer包管理器及常用系统工具。适用于需要连接Oracle数据库的PHP应用开发与轻量级部署场景，依托Alpine Linux实现较小镜像体积。

核心功能和特性

基础环境

• PHP版本：8.1（FPM模式）
• 系统基础：Alpine Linux（轻量级、安全）
• Web服务器：Nginx

Oracle数据库支持

• 集成Oracle Instant Client（基础精简版）
• 预安装OCI8扩展（PHP Oracle数据库接口）
• 预安装pdo_oci扩展（PDO风格Oracle数据库接口）
• 配置Oracle环境变量（ORACLE_BASE、LD_LIBRARY_PATH等）

PHP扩展

• 基础扩展：bcmath、bz2、calendar、exif、gd、intl、xsl、zip、sockets
• 数据库扩展：oci8、pdo_oci
• 消息队列扩展：amqp

开发工具

• Composer（PHP包管理器）
• Git、wget、curl、unzip、zip（常用工具）
• 便捷命令别名：sf（快捷执行php bin/console）

使用场景

• 需要连接Oracle数据库的PHP应用开发环境
• 轻量级PHP服务部署（如Symfony、Laravel等框架应用）
• 需同时运行Nginx和PHP-FPM的Web应用场景
• 需通过SSH访问外部资源的PHP应用（支持ssh-agent）

使用方法和配置说明

基本运行命令

bash
docker run -d -p 80:80 -v /path/to/your/app:/app --name php-oci8-nginx your-image-name

环境变量

配置说明

SSH密钥配置

容器启动时会自动启动ssh-agent并加载/root/.ssh/id_rsa密钥，需通过卷挂载提供密钥文件：

bash
docker run -d -v /path/to/your/ssh/id_rsa:/root/.ssh/id_rsa:ro ...

Nginx配置

默认Nginx配置可通过挂载自定义配置文件覆盖：

bash
docker run -d -v /path/to/nginx.conf:/etc/nginx/nginx.conf ...

PHP配置

PHP配置文件（php.ini）可通过以下路径挂载自定义配置：

bash
docker run -d -v /path/to/php.ini:/usr/local/etc/php/php.ini ...

Composer使用

容器已预装Composer，可直接在工作目录（/app）执行命令：

bash
docker exec -it php-oci8-nginx composer install

docker-compose示例

yaml
version: '3'
services:
  php-app:
    image: your-image-name
    ports:
      - "80:80"
    volumes:
      - ./app:/app
      - ./ssh/id_rsa:/root/.ssh/id_rsa:ro
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./php.ini:/usr/local/etc/php/php.ini
    environment:
      - TNS_ADMIN=/app/oracle/tnsnames
    restart: always

启动流程

容器启动时执行以下步骤：

1. 启动ssh-agent并加载/root/.ssh/id_rsa密钥
2. 启动Nginx服务
3. 启动PHP-FPM服务

工作目录为/app，建议将应用代码挂载至此路径。