979mao/php-oci8 repository overview

⁠PHP Multi-Version + Nginx + OCI8 Docker Image

Imagen Docker con PHP (7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4) FPM, Nginx, Oracle OCI8, PostgreSQL, MySQL/MariaDB y Supervisor.

⁠🚀 Características

• PHP Multi-Version (7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4)
• Nginx como servidor web
• Oracle OCI8 (Instant Client 23.4)
• PostgreSQL (pgsql, pdo_pgsql)
• MySQL/MariaDB (mysqli, pdo_mysql)
• Supervisor para gestión de procesos
• Cron para tareas programadas
• Composer (última versión)
• NPM/Node.js para compilación de assets
• Extensiones PHP:
  • oci8, mysqli, pgsql, pdo, pdo_mysql, pdo_pgsql
  • gd (con JPEG, PNG, WebP, FreeType)
  • zip, intl, opcache, bcmath, exif, pcntl, sockets
• OPcache optimizado para producción
• Healthcheck integrado
• Timezone: America/Bogota (configurable)
• Entrypoint automático para proyectos Laravel

⁠📦 Versiones Disponibles

⁠🏃 Uso Rápido

⁠Usando Docker Run

# Ejecutar contenedor
docker run -d \
  --name php-app \
  -p 8080:80 \
  -v $(pwd)/app:/var/www/html \
  979mao/php-oci8:latest

# Ver logs
docker logs -f php-app

# Entrar al contenedor
docker exec -it php-app bash

⁠Usando Docker Compose

# Crear carpeta para tu código
mkdir -p app

# Crear archivo de prueba
echo "<?php phpinfo(); ?>" > app/index.php

# Iniciar servicios
docker-compose up -d

# Ver logs
docker-compose logs -f

# Acceder a: http://localhost:8080

# Detener servicios
docker-compose down

⁠⚙️ Variables de Entorno

⁠Ejemplo con variables personalizadas

docker run -d \
  -e TZ=America/New_York \
  -e PHP_MEMORY_LIMIT=1024M \
  -e PHP_UPLOAD_MAX_FILESIZE=100M \
  -p 8080:80 \
  -v $(pwd)/app:/var/www/html \
  979mao/php-oci8:latest

⁠🔌 Configuración de Oracle

Para conectar a una base de datos Oracle:

<?php
// Ejemplo de conexión OCI8
$conn = oci_connect('username', 'password', 'localhost/XE');

if (!$conn) {
    $e = oci_error();
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}

echo "Conectado a Oracle Database!";

oci_close($conn);
?>

⁠🐛 Debug y Troubleshooting

⁠Ver información de PHP

docker exec php-app php -v
docker exec php-app php -m
docker exec php-app php -i

⁠Verificar extensiones instaladas

docker exec php-app php -m | grep -E 'oci8|pgsql|mysqli'

⁠🔒 Seguridad

• PHP-FPM corre como usuario www-data (no root)
• expose_php está deshabilitado
• OPcache habilitado para mejor rendimiento
• Healthcheck configurado
• Headers de seguridad en Nginx

⁠📊 Performance

• Tamaño imagen: ~450MB
• Tiempo de inicio: ~3-5 segundos
• OPcache: Habilitado (256MB)

⁠💡 Para Proyectos Laravel

Esta imagen incluye un entrypoint automático que:

• ✅ Instala dependencias (composer, npm)
• ✅ Configura permisos automáticamente
• ✅ Ejecuta migraciones en desarrollo
• ✅ Optimiza cachés de Laravel

Ejemplo rápido:

services:
  app:
    image: 979mao/php-oci8:latest
    environment:
      COMPOSER_UPDATE: "true"    # composer update
      NPM_BUILD: "true"          # npm run build
      RUN_MIGRATIONS: "true"     # php artisan migrate
      CHOWN_PROJECT: "true"      # fix permissions
    volumes:
      - ./:/var/www/html
    ports:
      - "8080:80"

⁠👤 Autor

979mao