Entorno de desarrollo para programación web con PHP en Docker.

1. Instalar Docker Desktop para Windows y macOS o Linux.

   Para evitar errores de credenciales al descargar contenedores, hay que registrarse en Docker Hub e iniciar sesión con esa cuenta en Docker Desktop.

2. En Windows, instalar Scoop usando PowerShell:

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   Invoke-Expression (New-Object System.Net.WebClient).DownloadString('https://get.scoop.sh')

   Y después instalar los comandos necesarios:

   scoop install make

3. Añadir las entradas necesarias al fichero hosts del sistema:

   En macOS y Linux:

   sudo bash -c '{
   echo "127.0.0.1    dockerbox.test"
   echo "127.0.0.1    phpmyadmin.dockerbox.test"
   echo "127.0.0.1    phpredisadmin.dockerbox.test"
   echo "127.0.0.1    mailpit.dockerbox.test"
   echo "127.0.0.1    vite.dockerbox.test"
   } >> /etc/hosts'

   En Windows (desde un terminal con privilegios de administrador):

   (
   echo 127.0.0.1    dockerbox.test
   echo 127.0.0.1    phpmyadmin.dockerbox.test
   echo 127.0.0.1    phpredisadmin.dockerbox.test
   echo 127.0.0.1    mailpit.dockerbox.test
   echo 127.0.0.1    vite.dockerbox.test
   ) >> %SystemRoot%\System32\drivers\etc\hosts

   En macOS y Windows se puede modificar la resolución de DNS para que todos los dominios .test se redirijan automáticamente a localhost y no tener que editar a mano el fichero /etc/hosts.

4. Clonar este repositorio:

   git clone https://github.com/ijaureguialzo/dockerbox.git

   Si el comando anterior no funciona, habrá que instalar Git en el sistema.

5. En un terminal, situarse en la carpeta dockerbox (o si se ha renombrado, la que contenga este archivo README.md):

   cd dockerbox

6. Copiar el fichero env-example a .env:

   En macOS y Linux:

   cp env-example .env

   En Windows:

   copy env-example .env

   ⚠️ Es recomendable cambiar las contraseñas por defecto.

7. Arrancar los servicios:

   make start

   ⚠️ La primera vez tardará varios minutos en crear los contenedores y unos 30 segundos en generar los certificados digitales; la web dará error hasta que termine.

• Sitio web
• phpMyAdmin
• phpRedisAdmin
• Mailpit
• Vite

• Acceso mediante shell al contenedor de php:

  make workspace

• Actualizar los contenedores:

  make build

1. Crear una nueva carpeta sites/nuevo_sitio con el contenido del nuevo sitio web.

   El script de arranque busca carpetas dentro del directorio sites y las publica en el servidor web:

   • Si encuentra un subdirectorio nuevo_sitio/public o nuevo_sitio/laravel/public, usará esa carpeta como raíz del sitio web.
   • Si no, publicará la carpeta nuevo_sitio directamente.

   Independientemente de si hay carpeta public o no, el nuevo sitio siempre se llamará nuevo_sitio.dockerbox.test.

2. Editar como root el fichero /etc/hosts (en macOS y Linux) o en Windows y añadir una nueva línea:

   127.0.0.1    nuevo_sitio.dockerbox.test
   

3. Recargar los contenedores web:

   make reload

4. Acceder al nuevo sitio.

1. Instalar la extensión para el navegador y activar la depuración.
2. Habilitar la escucha de conexiones de depuración en PhpStorm haciendo click en el icono:
3. Fijar un breakpoint y cargar la página en el navegador.

En vez de arrancar los contenedores con start usar start-expose-mariadb:

make start-expose-mariadb