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.
Contenido
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:
ci4-app/
├── app/
├── docker/
│ └── nginx.conf
├── public/
├── writable/
├── .env
├── Dockerfile
├── docker-compose.yml
└── deploy.shEl 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.
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.
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
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
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}| Variable | Ejemplo | Descripción |
|---|---|---|
CI_ENVIRONMENT | production | Desactiva la barra de depuración y los errores detallados. |
app.baseURL | https://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.
#!/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
El sitio responde en :8080. Para producción, coloca un proxy con TLS delante (lo cubro en SSL automático con Certbot).