Desplegar CodeIgniter 4 con Docker y Nginx

Imagen PHP-FPM ligera, Nginx como servidor web y un script de despliegue de una sola línea para producción.

Rack de servidores iluminado
Contenido
  1. Requisitos
  2. Estructura del proyecto
  3. El Dockerfile
  4. Configurar Nginx
  5. Orquestar con Compose
  6. Variables de entorno
  7. Script de despliegue
  8. Resultado
  9. Repositorio y recursos

Durante años desplegué con FTP y un git pull manual. Funciona… hasta que deja de hacerlo. Esta es la configuración mínima que uso ahora para cualquier proyecto con CodeIgniter 4: reproducible, sin magia y fácil de depurar.

Requisitos

  • Docker Engine 24+ con el plugin compose.
  • Un servidor Linux con acceso SSH (probado en Debian 12 y Ubuntu 24.04).
  • El proyecto en un repositorio Git accesible desde el servidor.

Nota: todo lo de este post vive en el repositorio enlazado al final. Puedes clonarlo y ejecutar docker compose up para probarlo en local.

Estructura del proyecto

Solo se agregan cuatro archivos a la estructura estándar de CodeIgniter:

textotxt
ci4-app/
├── app/
├── docker/
│   └── nginx.conf
├── public/
├── writable/
├── .env
├── Dockerfile
├── docker-compose.yml
└── deploy.sh

El Dockerfile

Parto de php:8.3-fpm-alpine porque la imagen final queda por debajo de 120 MB. Las dependencias de Composer se instalan antes de copiar el código para aprovechar la caché de capas.

Dockerfiledocker
FROM php:8.3-fpm-alpine
# Extensiones que necesita CodeIgniter 4
RUN apk add --no-cache icu-dev libzip-dev \
    && docker-php-ext-install intl mysqli pdo_mysql zip opcache
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
WORKDIR /var/www/app
COPY composer.json composer.lock ./
RUN composer install --no-dev --optimize-autoloader --no-scripts
COPY . .
RUN chown -R www-data:www-data writable/
EXPOSE 9000
CMD ["php-fpm"]

Configurar Nginx

El root apunta a public/; nunca expongas la raíz del proyecto. La regla try_files es la que hace funcionar las URLs amigables.

servidor webnginx
server {
    listen 80;
    server_name _;
    root /var/www/app/public;
    index index.php;
    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }
    location ~ \.php$ {
        fastcgi_pass app:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~ /\. { deny all; }
}

Orquestar con Compose

configuraciónyaml
services:
  app:
    build: .
    env_file: .env
    volumes:
      - ./writable:/var/www/app/writable
    depends_on: [db]
  web:
    image: nginx:1.27-alpine
    ports: ["8080:80"]
    volumes:
      - ./docker/nginx.conf:/etc/nginx/conf.d/default.conf:ro
      - ./public:/var/www/app/public:ro
    depends_on: [app]
  db:
    image: mysql:8.4
    environment:
      MYSQL_DATABASE: ci4
      MYSQL_ROOT_PASSWORD: ${DB_PASS}
    volumes:
      - dbdata:/var/lib/mysql
volumes:
  dbdata:

Un volumen con nombre para la base de datos y un bind mount para writable/: así los logs y la caché sobreviven a cada reconstrucción.

Variables de entorno

configuraciónini
CI_ENVIRONMENT = production
app.baseURL = 'https://klog.dev/'
database.default.hostname = db
database.default.database = ci4
database.default.username = root
database.default.password = ${DB_PASS}
VariableEjemploDescripción
CI_ENVIRONMENTproductionDesactiva la barra de depuración y los errores detallados.
app.baseURLhttps://klog.dev/URL pública con barra final.
DB_PASS—Se define en el servidor, nunca en el repositorio.

Script de despliegue

Un script idempotente: puedes ejecutarlo diez veces seguidas y el resultado es el mismo. Acepta la rama como primer argumento.

terminalbash
#!/usr/bin/env bash
set -euo pipefail
APP_DIR="/srv/ci4-app"
BRANCH="${1:-main}"
echo "→ Actualizando código ($BRANCH)"
cd "$APP_DIR"
git fetch --all --prune
git reset --hard "origin/$BRANCH"
echo "→ Reconstruyendo contenedores"
docker compose build --pull app
docker compose up -d --remove-orphans
echo "→ Ejecutando migraciones"
docker compose exec -T app php spark migrate --all
echo "✓ Despliegue listo: $(git rev-parse --short HEAD)"

Dale permisos con chmod +x deploy.sh y ejecútalo con ./deploy.sh main.

Resultado

Terminal mostrando los contenedores en ejecución
Los tres contenedores corriendo tras el primer despliegue.

El sitio responde en :8080. Para producción, coloca un proxy con TLS delante (lo cubro en SSL automático con Certbot).

Repositorio y recursos

usuario/ci4-docker-starter Plantilla de CodeIgniter 4 lista para Docker, Nginx y MySQL. github.com Ver repo →