Dockerització d'aplicacions PHP amb connexió a BBDD

Requeriments previs

Per seguir bé aquest article cal tenir coneixements de Docker pràctic i Docker Compose i s'ha de tenir instal·lat al sistema docker i docker-compose

Referències

• Tutorial base d'aquest article: Create your first PHP/MySQL application in docker
• Documentació de Docker - https://docs.docker.com/

Desplegament d’aplicació en php i mysql

L'objectiu de l'exemple és mostrar pas a pas el desplegament mitjançant docker d'una aplicació PHP amb connexió a BBDD mysql. A mode il·lustratiu es fa servir una pràctica sobre un banc i clients amb comptes que es podria realitzar al mòdul DAW MP07 Desenvolupament web en entorn servidor.

Preparació d'imatges

Per aquest exemple necessitem dues imatges, una per l'aplicació php i l'altre per la BBDD mysql.

Aplicació PHP

Per l'aplicació una opció pot ser agafar com a base una imatge oficial php sobre un servidor apache php on docker Hub i afegir-li els components necessaris mitjançant el DockerFile:

FROM php:7.4-apache
RUN docker-php-ext-install pdo pdo_mysql mysqli
RUN a2enmod rewrite
COPY src/ /var/www/html/
EXPOSE 80

En aquest exemple s'ha optat per la versió 7.4 de php i s'ha afegit a la imatge extensions com PDO o PDO_MYSQL. També s'ha habilitat el mòdul rewrite de l'apache, s'ha copiat el contingut de codi al directori per defecte i s'ha exposat el port 80.

BBDD MySQL

Per la part de la BBDD s'ha optat per una imatge base de mysql sense modificar per simplicitat (Més tard transferirem la BBDD a la imatge).

Configuració del fitxer docker-compose

D'una banda tenim definida l'aplicació amb el nom app on hem optat per construir la imatge amb build i context. L'alternativa seria carregar la imatge pujada a un repositori remot com Docker Hub (opció típica per a producció). En la directiva ports trobem definit extern:intern. En aquest cas, el port intern és el 80 que és el que apache sol fer servir per http i és el que hem exposat al Dockerfile. El port extern, en canvi, està configurat a 82 per evitar conflictes si la nostra màquina està servint alguna cosa pel port 80 (es pot canviar per un port a conveniència). La directiva environment indica les variables d'entorn que necessita la app. En aquest cas: host, user, password i database per a poder comunicar-se amb la BBDD.

docker-compose.yml

version: '3.3'
services:
  app:
    container_name: app_php
    build:
      context: ./
    ports:
      - 82:80
    environment:
      MYSQL_HOST: mysql
      MYSQL_USER: root
      MYSQL_PASSWORD: root
      MYSQL_DATABASE: bank
    depends_on:
      - mysql
  mysql:
    image: mysql:8.0
    container_name: 'mysql-server-80'
    volumes:
      - mysql-data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: bank
    ports:
      - "8082:3306"
volumes:
  mysql-data:

Pel que fa al servei de BBDD utilitzem la imatge mysql:8.0 del repositori oficial. Definim un volum amb la directiva volumes on enllacem el directori intern de la imatge /var/lib/mysql amb el volum de docker definit més endavant. Definim les variables d'entorn necessàries i definim els ports extern i intern (en aquest cas l'extern es defineix diferent al per defecte per si tenim un servei funcionant en aquest port com en el cas del servei app). Finalment es defineix un volum intern de docker per assegurar la persistència amb volumes mysql-data: (Aquesta directiva ha d'esta al mateix nivell que services i al final del fitxer).

Arrencada dels contenidors

El primer cop hem d'arrencar amb l'argument –build per tal de construir la imatge. Després no caldrà a no ser que fem modificacions a l'aplicació i fos necessari reconstruir la imatge original.

docker-compose up -d --build

Comprovem que els dos contenidors estan arrencats amb docker ps :

docker ps
CONTAINER ID   IMAGE           COMMAND                  CREATED          STATUS         PORTS                                                  NAMES
33cdc1c58ecd   dockerphp_app   "docker-php-entrypoi…"   9 seconds ago    Up 7 seconds   0.0.0.0:82->80/tcp, :::82->80/tcp                      app_php
7e2fbd45531d   mysql:8.0       "docker-entrypoint.s…"   10 seconds ago   Up 8 seconds   33060/tcp, 0.0.0.0:8082->3306/tcp, :::8082->3306/tcp   mysql-server-80

Importar la base de dades

Per importar una base de dades existent hem de copiar un fitxer sql que contingui l'estructura de la BBDD i executar-lo en el contenidor:

docker cp bank.sql mysql-server-80:/bank.sql

docker exec -i mysql-server-80 mysql -u root -proot bank < bank.sql

En el cas d'exemple tenim algunes dades de prova. Podem observar-ho entrant dins del contenidor del servei i consultant la BBDD:

mysql> select * from compte;
+----+--------+-------+--------+
| id | codi   | saldo | client |
+----+--------+-------+--------+
|  1 | BK 100 | 15000 |      1 |
|  2 | BK 101 |   200 |      1 |
|  3 | BK 200 | 18000 |      2 |
+----+--------+-------+--------+
3 rows in set (0.00 sec)

Comprovació de funcionament

Ara podem entrar a l'aplicació mitjançant el navegador (localhost:82) i fer les comprovacions pertinents. Es mostra el llistat dels comptes on s'ha afegit mitjançant l'aplicació un compte nou.

També podem comprovar que si aturem els contenidors i els tornem a arrencar les dades persisteixen gràcies a l'ús de volums.

docker-compose down
Stopping app_php         ... done
Stopping mysql-server-80 ... done
Removing app_php         ... done
Removing mysql-server-80 ... done
Removing network dockerphp_default

docker-compose up -d
Creating network "dockerphp_default" with the default driver
Creating mysql-server-80 ... 
Creating mysql-server-80 ... done
Creating app_php ... 
Creating app_php ... done

select * from compte;
+----+--------+--------+--------+
| id | codi   | saldo  | client |
+----+--------+--------+--------+
|  1 | BK 100 |  15000 |      1 |
|  2 | BK 101 |    200 |      1 |
|  3 | BK 200 |  18000 |      2 |
|  4 | BK 345 | 123456 |      2 |
+----+--------+--------+--------+
4 rows in set (0.00 sec)

REPTE 1

REPTE 2

Dockerització d'aplicacions basades en Frameworks associats a PHP

Si ja estem enfocats a Docker i habituat una possibilitat és que ja desenvolupem els nostres projectes directament amb un framework muntat sobre docker com per exemple de la forma que es descriu en l'article Dockerització d'aplicacions Symfony on tenim un symfony preparat per iniciar el nostre projecte. D'altra banda si el que volem és dockeritzar una aplicació basada en framework que ja tenim desenvolupada en local haurem de fer servir pasos diferents.

Symfony

S'ha de procedir igual que s'ha fet amb l'aplicació php amb mysql però s'ha de transferir al contenidor tot el directori del projecte inclús el directori vendor que sol ocupar més espai. Tot i així seria com si el pujèssim a un servidor tradicional amb un apache i php. Cal tenir en compte dues coses importants:

• S'ha d'exportar la BBDD del nostre projecte a un fitxer sql i copiar-lo al contenidor corresponent.
• La variable d'entorn DATABASE_URL="mysql://[nom_usuari]:[password]@[host]:[port]/[db]" s'ha d'adaptar pel contenidor docker de la base de dades on el host és el nom del servei i no localhost com normalment

Laravel

De la mateixa manera podem dockeritzar una aplicació feta amb Laravel Cal tenir en compte dues coses importants:

• S'ha d'exportar la BBDD del nostre projecte a un fitxer sql i copiar-lo al contenidor corresponent.
• Les variables d'entorn en aquest cas són:

1. DB_CONNECTION=[mysql, postgres,…]
2. DB_HOST=[nom del servei]
3. DB_PORT=[port intern on s'exposa el servei]
4. DB_DATABASE=[nom de la BBDD]
5. DB_USERNAME=[nom d'usuari de la BBDD]
6. DB_PASSWORD=[password de k'usuari de BBDD]

Aquestes variables s'han d'adaptar al contenidor docker del servei de BBDD per tal que coincideixin.

Resum Frameworks

Tant amb Symfony com amb Laravel el més important és definir bé les variables d'entorn que canviaran respecte quan estem en desenvolupament. Es pot fer mitjançant la modificació del fitxer .env o fent servir la directiva environment del fitxer docker-compose.yml. L'altre opció mitxa que podem fer servir és instal·lar php composer en el contenidor de l'aplicació i dins del contenidor executar les actualitzacions i migracions necessaries.

En el Dockerfile caldria afegir les linies necessàries per instal·lar composer

RUN php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
RUN php composer-setup.php --install-dir=. --filename=composer
RUN mv composer /usr/local/bin/