Implemente una aplicación PHP usando Docker-compose

• Configurando nuestro entorno de trabajo
• Configurar el contenedor PHP
• Configurar el contenedor Nginx
• Configurar el contenedor MySQL
• Construyendo nuestra aplicación
• Conclusión

Las aplicaciones PHP generalmente están compuestas por un servidor web, un sistema de base de datos relacional y el propio intérprete de idiomas. En este tutorial aprovecharemos una pila completa de aplicaciones PHP con Docker. Este es un tutorial en profundidad en el que vamos a construir y orquestar contenedores para Nginx (el servidor web), MySQL (el sistema de base de datos) y PHP.

En aras de este tutorial, escribiremos una aplicación simple que lea una lista de ciudades de una base de datos y la muestre en una página web, de esta manera demostraremos una aplicación PHP básica pero funcional.

Esta guía asume que ya tiene instalado Docker-CE y al menos un conocimiento mínimo de Docker. Para el caso, puede revisar los siguientes tutoriales:

• Instalación de Docker CE en Ubuntu 16.04
• Instalación de Docker CE en CentOS 7
• Cómo usar Docker: Creando tu primer contenedor Docker

Configurando nuestro entorno de trabajo

Una aplicación basada en Docker de la vida real generalmente estará compuesta por varios contenedores. Gestionarlos manualmente puede volverse bastante complicado y engorroso. Ahí es donde entra en juego docker-compose. Le ayuda a administrar varios contenedores a través de un yamlarchivo de configuración simple .

Instalar docker-compose.

curl -L https://github.com/docker/compose/releases/download/1.19.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Cree una carpeta para contener todos los archivos necesarios de este ejemplo y luego cden él. De ahora en adelante, este es nuestro directorio de trabajo y cada comando se ejecutará dentro de esta carpeta y se hará referencia a cada ruta en relación con ella. Esta carpeta puede ser referenciada más tarde como WORKING_DIR.

mkdir ~/docker
cd ~/docker

Ahora crea tres carpetas más.

mkdir php nginx app

La phpcarpeta es donde construiremos nuestra imagen PHP personalizada, la nginxcarpeta contendrá los archivos necesarios para nuestra imagen nginx personalizada y la appcarpeta es donde pondremos el código fuente y la configuración de nuestra aplicación de muestra.

Configurar el contenedor PHP

En este ejemplo, vamos a utilizar php-fpmpara conectarnos al servidor web Nginx. Utilizaremos la imagen base oficial de PHP. Sin embargo, también necesitamos instalar y habilitar algunas extensiones para que podamos acceder a la base de datos. Dentro de la phpcarpeta, cree un archivo llamado Dockerfiley coloque los siguientes contenidos en él.

FROM php:7.1-fpm-alpine3.4
RUN apk update --no-cache \
    && apk add --no-cache $PHPIZE_DEPS \
    && apk add --no-cache mysql-dev \
    && docker-php-ext-install pdo pdo_mysql

Tenga en cuenta que estamos utilizando la versión Alpine de la imagen oficial de PHP. Alpine es una distribución muy pequeña dirigida a contenedores al proporcionar huellas mucho más pequeñas. Además, tenga en cuenta el uso del comando docker-php-ext-install, la imagen oficial de PHP proporciona este comando para facilitar el proceso de instalación y configuración de extensiones PHP.

Ahora, construyamos esta imagen de Docker emitiendo lo siguiente (dentro de nuestro WORKING_DIR):

docker build -t vultr-php php/

El docker-compose.ymlarchivo

Como ya se mencionó, le docker-composepermite administrar una serie de contenedores a través de un archivo de configuración simple. Este archivo de configuración generalmente se denomina docker-compose.yml. Crea este archivo dentro de la appcarpeta.

touch app/docker-compose.yml

Ahora ponga los siguientes contenidos en este archivo.

version: '2'
services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app

Explicaremos esta sintaxis. Primero, observe la primera línea.

version: '2'

Esto especifica la versión del docker-compose.ymlarchivo de configuración utilizado. La siguiente línea especifica los servicios, o en otras palabras, los contenedores que se aprovisionarán.

services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app

Tenga en cuenta que cada servicio tiene una clave específica dentro del servicesbloque. El nombre especificado aquí se utilizará para hacer referencia a este contenedor específico más adelante. También tenga en cuenta que dentro de la phpconfiguración, definimos la imagen utilizada para ejecutar el contenedor (esta es la imagen que creamos anteriormente). También definimos un mapeo de volumen.

volumes:
  - ./:/app

Esto le indica docker-composeque asigne el directorio actual ( ./) al /appdirectorio dentro del contenedor. La última línea establece la /appcarpeta dentro del contenedor como el directorio de trabajo, lo que significa que esta es la carpeta desde la que se ejecutan de forma predeterminada todos los comandos futuros dentro de un contenedor.

Ahora podemos orquestar nuestros contenedores.

cd ~/docker/app
docker-compose up -d

Puede ejecutar el siguiente comando para asegurarse de que se ejecutó el contenedor PHP:

docker ps

Cómo ejecutar comandos dentro de los contenedores

Aún dentro de la appcarpeta, podemos ejecutar cualquier comando dentro de un contenedor de servicios definido con la ayuda del docker-composecomando.

docker-compose exec [service] [command]

El [service]marcador de posición se refiere a la clave de servicio. En nuestro caso, esto fue php. Ejecutemos un comando dentro del contenedor para verificar nuestra versión de PHP.

docker-compose exec php php -v

Verá el siguiente resultado.

PHP 7.1.14 (cli) (built: Feb  7 2018 00:40:45) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2018 Zend Technologies

Configurar el contenedor Nginx

Al igual que el contenedor PHP, necesitamos crear una imagen personalizada para el servidor web. Pero en este caso, solo necesitamos proporcionar una configuración para nuestro virtual host. Asegúrese de estar dentro de nuestro WORKING_DIRy cree un Dockerfiledentro de la nginxcarpeta:

cd ~/docker
touch nginx/Dockerfile

Ahora ponga los siguientes contenidos en esto Dockerfile:

FROM nginx:1.13.8-alpine
COPY ./default.conf /etc/nginx/conf.d/default.conf

Estamos utilizando la imagen predeterminada de Nginx basada en Alpine. En este archivo Docker simplemente copiamos un archivo de configuración en la configuración de nuestra aplicación. Antes de construir esta imagen, cree un archivo de configuración.

touch nginx/default.conf

Ahora rellene con este contenido.

server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

    root /app;
    index index.php;

    #server_name server_domain_or_IP;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $uri /index.php =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Tenga en cuenta que en la fastcgi_pass php:9000línea estamos haciendo referencia al contenedor PHP por su nombre dentro del servicebloque del docker-compose.ymlarchivo de configuración. docker-composeCrea internamente una red y asigna el nombre del servicio como el nombre de host a cada uno de los servicios definidos. Ahora podemos construir la imagen Nginx.

docker build -t vultr-nginx nginx/

Actualización docker-compose.yml

Ahora actualice el app/docker-compose.ymlarchivo.

version: '2'
services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app
  web:
    image: vultr-nginx
    volumes:
      - ./:/app
    depends_on:
      - php
    ports:
      - 80:80

Solo hemos agregado un nuevo servicio. La configuración es casi la misma, excepto por lo siguiente.

depends_on:
  - php
ports:
  - 80:80

Una vez que el contenedor Nginx necesita que el servicio PHP esté completamente inicializado, forzamos este requisito en la depends_onopción. La portsclave de configuración asigna un puerto de host a un puerto de contenedor, aquí asignamos el puerto 80en el host al puerto 80en el contenedor.

Ahora cree un archivo llamado index.phpdentro de la appcarpeta y coloque lo siguiente en él.

<?php phpinfo();

Asegúrese de que el puerto 80sea ​​accesible a través de su firewall y ejecute lo siguiente.

cd ~/docker/app
docker-compose up -d

Una vez más, verifique que el servicio esté activo.

docker ps

Abre un navegador y accede [vultr-instance-ip]. Puede encontrar la dirección IP de su instancia de Vultr ejecutando lo siguiente.

hostname -I

Verá la página de información de PHP.

Configurar el contenedor MySQL

La imagen oficial de MySQL le permite configurar el contenedor a través de variables de entorno simples. Esto se puede hacer con una environmentopción dentro de la definición del bloque de servicio. Actualice el ~/docker/app/docker-compose.ymlarchivo a lo siguiente.

version: '2'
services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app
  web:
    image: vultr-nginx
    volumes:
      - ./:/app
    depends_on:
      - php
    ports:
      - 80:80
  mysql:
    image: mysql:5.7.21
    volumes:
      - ./:/app
      - dbdata:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=world
      - MYSQL_ROOT_PASSWORD=root
    working_dir: /app
volumes:
  dbdata:

Ahora hemos definido un nuevo servicio para la base de datos. Fíjate en la línea dbdata:/var/lib/mysql. Esto monta la ruta en el contenedor /var/lib/mysqla un volumen persistente administrado por Docker, de esta manera los datos de la base de datos persisten después de que se elimina el contenedor. Este volumen debe definirse en un bloque de nivel superior, como puede ver al final del archivo.

Antes de organizar nuestra nueva configuración, descarguemos una base de datos MySQL de muestra. La documentación oficial de MySQL proporciona algunas bases de datos de muestra. Utilizaremos la conocida base de datos mundial. Esta base de datos proporciona una lista de países y ciudades. Para descargar este ejemplo, ejecute lo siguiente dentro de nuestra carpeta de aplicaciones.

curl -L http://downloads.mysql.com/docs/world.sql.gz -o world.sql.gz
gunzip world.sql.gz

Ahora orquestamos nuestros contenedores.

docker-compose up -d

Como ya habrá notado, el docker-compose upcomando inicia solo los contenedores que aún no se han iniciado. Comprueba las diferencias entre su docker-compose.ymlarchivo y la configuración actual de los contenedores en ejecución.

Una vez más, verifique que se haya iniciado el contenedor MySQL.

docker ps

Ahora complete la base de datos mundial.

docker-compose exec -T mysql mysql -uroot -proot world < world.sql

Puede verificar que la base de datos se haya llenado seleccionando datos directamente de la base de datos. Primero acceda al indicador de MySQL dentro del contenedor.

docker-compose exec mysql mysql -uroot -proot world

En el indicador de MySQL, ejecute lo siguiente.

select * from city limit 10;

Verá una lista de ciudades. Ahora salga del indicador de MySQL.

mysql> exit

Construyendo nuestra aplicación

Ahora que todos los contenedores necesarios están en funcionamiento, podemos centrarnos en nuestra aplicación de muestra. Actualice el app/index.phparchivo a lo siguiente.

<?php

$pdo = new PDO('mysql:host=mysql;dbname=world;charset=utf8', 'root', 'root');

$stmt = $pdo->prepare("
    select city.Name, city.District, country.Name as Country, city.Population
    from city
    left join country on city.CountryCode = country.Code
    order by Population desc
    limit 10
");
$stmt->execute();
$cities = $stmt->fetchAll(PDO::FETCH_ASSOC);

?>

<!doctype html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Vultr Rocks!</title>
</head>
<body>
    <h2>Most Populous Cities In The World</h2>
    <table>
    <thead>
        <tr>
            <th>Name</th>
            <th>Country</th>
            <th>District</th>
            <th>Population</th>
        </tr>
    </thead>
    <tbody>
        <?php foreach($cities as $city): ?>
            <tr>
                <td><?=$city['Name']?></td>
                <td><?=$city['Country']?></td>
                <td><?=$city['District']?></td>
                <td><?=number_format($city['Population'], 0)?></td>
            </tr>
        <?php endforeach ?>
    </tbody>
    </table>
</body>
</html>

Si accede [vultr-instance-ip]en un navegador web, verá una lista de las ciudades más pobladas del mundo. Felicitaciones, ha implementado una aplicación PHP totalmente funcional con Docker.

Conclusión

En este tutorial, he demostrado paso a paso cómo configurar una aplicación PHP completamente funcional. Creamos imágenes personalizadas para PHP y Nginx, y configuramos docker-compose para orquestar nuestros contenedores. A pesar de ser muy básico y simple, esta configuración refleja un escenario de la vida real.

En esta guía, hemos creado y etiquetado nuestras imágenes localmente. Para una configuración más flexible, puede insertar estas imágenes en un registro acoplable . Puede ingresar al registro oficial de docker o incluso configurar su propio registro de docker. En cualquier caso, esto le permitirá construir sus imágenes en un host y usarlas en otro.

Para un uso más detallado de docker-compose, debe consultar la documentación oficial .

Dependiendo de los requisitos de su aplicación y el marco PHP que use, es posible que desee agregar más extensiones. Esto se puede hacer fácilmente modificando el Dockerfileusado para construir nuestra imagen PHP personalizada. Sin embargo, algunas extensiones necesitan dependencias adicionales para instalarse en el contenedor. Debe consultar la lista de extensiones en la documentación oficial de PHP para revisar los requisitos básicos de cada extensión.