Cómo desplegar un servidor con XAMPP (Apache + PHP + MySQL/MariaDB) con persistencia y acceso externo en Docker. Alojamos un sitio web completo en este servidor doquerizado y lo configuramos para acceso a MySQL/MariaDB. Cambiamos la contraseña del usuario root de MySQL/MariaDB de acceso a phpMyAdmin.
- Requisitos para desplegar servidor XAMPP en Docker.
- Desplegar servidor XAMPP Apache + PHP + MySQL en Docker.
- Acceso a phpMyAdmin para administrar el servidor MariaDB/MySQL.
- Acceso SSH al servidor XAMPP en Docker.
- Desarrollar sitio web PHP con acceso a MySQL/MariaDB en servidor XAMPP de Docker.
Requisitos para desplegar servidor XAMPP en Docker
Necesitaremos disponer de un equipo con Docker Desktop, bien en Windows:
O bien en Linux:
Desplegar servidor XAMPP Apache + PHP + MySQL en Docker
Crearemos una carpeta en el equipo anfitrión con Docker Desktop, bien sea Linux o Windows. En dicha carpeta crearemos un fichero llamado compose.yml, con el siguiente contenido:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
services: xampp: image: tomsik68/xampp ports: - "44162:22" - "41063:80" - "41064:3306" volumes: # Sitios web - ./xampp/ajpdsoft:/www/ajpdsoft # Configuración apache - ./xampp/my_apache_conf/:/opt/lampp/apache2/conf.d # Persistencia MySQL - ./xampp/mysql/ajpdsoft:/opt/lampp/var/mysql/ajpdsoft restart: always |
En el fichero compose.yml anterior desplegaremos una imagen Docker con XAMPP (Apache + PHP + MySQL/MariaDB). Cada servicio será accesible externamente por los siguientes puertos:
- SSH: puerto 44162.
- Web: puerto 41063.
- MySQL/MariaDB: puerto 41064.
Tal y como hemos indicando en el fichero compose.yml, crearemos una carpeta persistente en /www/ajpdsoft para alojar el sitio web de ejemplo. Crearemos también una base de datos (catálogo) en MySQL, con el nombre «ajpdsoft». Cambiaremos estos valores (y el resto que consideremos, como los puertos) para adaptarlo a nuestras necesidades.
Una vez creado el fichero compose.yml, desde la carpeta donde lo hayamos creado, ejecutaremos el siguiente comando (es el mismo tanto para Linux como para Windows):
|
1 |
docker compose -f compose.yml up -d |
Desplegará el contenedor e imagen con XAMPP de forma automática:
Comprobaremos que el contenedor e imagen Docker ha quedado desplegado y permanece iniciado, con el comando:
|
1 |
docker ps |
Comprobaremos que, efectivamente, disponemos de acceso al servidor web Apache por defecto. Para ello, desde un navegador del equipo anfitrión (o desde otro equipo de la red), introduciremos la siguiente URL:
http://localhost:41063/dashboard/
Si accedemos desde un equipo de la red, cambiaremos «localhost» por la IP del equipo anfitrión con Docker Desktop. Si hemos cambiado el puerto, en lugar de 41063, introduciremos el puerto elegido para el servicio web (80 en el contenedor).
Si todo es correcto, nos mostrará la página web de bienvenida de XAMPP:
El fichero de configuración general de Apache se encuentra en:
/opt/lampp/etc/httpd.conf
El fichero general de configuración de MySQL/MariaDB se encuentra en:
/opt/lampp/etc/my.cnf
El fichero de configuración general de PHP se encuentra en:
/opt/lampp/etc/php.ini
Si realizamos algún cambio en la configuración de Apache o PHP o MySQL y queremos que se aplique, podremos reiniciar los servicios, ejecutando el siguiente comando (desde la línea de comandos del equipo anfitrión con Docker Desktop):
|
1 |
docker exec xampp-xampp-1 /opt/lampp/lampp restart |
Acceso a phpMyAdmin para administrar el servidor MariaDB/MySQL
Para probar el acceso al servidor MySQL/MariaDB en Docker, usaremos la siguiente URL:
http://localhost:41063/phpmyadmin/
(Cambiaremos el puerto por el establecido para el servicio MySQL 3306 en el fichero compose.yml)
Los datos de acceso a MySQL/MariaDB se han establecido, por defecto, en el fichero config.inc.php, por lo que no nos pedirá usuario y contraseña. Directamente accederemos a la gestión web de MariaDB/MySQL:
Como podemos observar en phpMyAdmin, nos habrá creado un catálogo vacío con el nombre «ajpdsoft». Mediante phpMyAdmin podremos, por ejemplo, cargar un fichero SQL exportado de otra base de datos o bien crear tablas y mostrar tablas existentes. También podremos crear nuevos catálogos (bases de datos), aunque no serán persistentes salvo que lo hayamos indicado en el fichero compose.yml (igual que hemos indicando que sea persistente la base de datos ajpdsoft) y cambiar la contraseña de acceso, que por defecto es insegura (usuario root, sin contraseña). Para cambiar la contraseña de acceso pulsaremos en «Cuentas de usuarios»:
De las cuentas que se crean por defecto, la que nos interesa para el acceso dese phpMyAdmin es «root – localhost». Pulsaremos sobre ella para editarla:
Pulsaremos en «Change password»:
Introduciremos la nueva contraseña (por seguridad se recomienda una contraseña fuerte) y pulsaremos en «Guardar»:
Si ahora intentamos acceder a phpMyAdmin, obtendremos este error:
Con el texto:
Error
MySQL ha dicho:
No se estableció la conexión: los parámetros están incorrectos.
mysqli::real_connect(): (HY000/1045): Access denied for user ‘root’@’localhost’ (using password: YES)
phpMyAdmin intentó conectarse con el servidor MySQL, y el servidor rechazó esta conexión. Deberá revisar el host, nombre de usuario y contraseña en config.inc.php y asegurarse que corresponden con la información provista por el administrador del servidor MySQL.
Esto es debido, como hemos indicando anteriormente, a que este despliegue de XAMPP incluye el usuario y contraseña de phpMyAdmin en el fichero /opt/lampp/phpmyadmin/config.inc.php. Para que el error no se produzca, o bien se comentan las líneas del usuario y la contraseña en este fichero, para que nos solicite estos datos al iniciar sesión o bien establecemos la nueva contraseña. A continuación indicamos cómo modificar este fichero mediante acceso SSH.
Acceso SSH al servidor XAMPP en Docker
Puesto que también hemos configurado el acceso externo mediante SSH al servidor XAMPP en Docker, podremos acceder con PuTTY o cualquier otro cliente SSH. Si accedemos desde el equipo anfitrión con Docker Desktop usaremos como IP «localhost» y como puerto el establecido en el fichero compose.yml, en nuestro caso «44162»:
Conectaremos con el servidor doquerizado. Nos solicitará usuario y contraseña, por defecto será:
- Usuario: root
- Contraseña: root
Y ya tendremos acceso al equipo Linux en Docker con XAMPP:
Como ejemplo, vamos a modificar el fichero:
/opt/lampp/phpmyadmin/config.inc.php
Para que, por seguridad, siempre nos solicite usuario y contraseña para acceder a phpMyAdmin. Para ello, ejecutaremos el siguiente comando:
Y realizamos las siguientes modificaciones en el fichero. Comentamos, añadiendo «//» delante, las siguientes líneas:
|
1 2 3 |
$cfg['Servers'][$i]['auth_type'] = 'config'; $cfg['Servers'][$i]['user'] = 'root'; $cfg['Servers'][$i]['password'] = ''; |
Quedando:
|
1 2 3 |
//$cfg['Servers'][$i]['auth_type'] = 'config'; //$cfg['Servers'][$i]['user'] = 'root'; //$cfg['Servers'][$i]['password'] = ''; |
Y añadimos la siguiente línea:
|
1 |
$cfg['Servers'][$i]['auth_type'] = 'cookie'; |
Guardaremos los cambios pulsando Control + O y cerraremos la edición pulsando Control + X.
De esta forma indicamos a phpMyAdmin que muestre formulario de login al acceder, solicitando usuario y contraseña (es la forma más segura). No es necesario reiniciar Apache. Si intentamos acceder a phpMyAdmin, nos solicitará usuario y contraseña:
Si realizamos algún cambio en la configuración de Apache o PHP y queremos reiniciar los servicios, podemos ejecutar el siguiente comando (desde la línea de comandos del equipo anfitrión con Docker Desktop):
|
1 |
docker exec xampp-xampp-1 /opt/lampp/lampp restart |
(Cambiaremos «xampp-xampp-1» por el nombre que hayamos establecido al contenedor)
Se reiniciarán lo servicios de Apache, MySQL y ProFTPD:
También podremos reiniciar lo servicios desde dentro de la propia máquina (accediendo con SSH) y ejecutando el comando:
|
1 |
/opt/lampp/lampp restart |
Desarrollar sitio web PHP con acceso a MySQL/MariaDB en servidor XAMPP de Docker
Como ejemplo, vamos a crear un sitio web en PHP que accederá al servidor de MariaDB y obtendrá los registros de la tabla «facturas». Para ello, en primer lugar crearemos la tabla facturas, desde phpMyAdmin, en el catálogo «ajpdsoft» (el catálogo persistente indicando en el fichero compose.yml). Ejecutando la siguiente sentencia SQL (o bien desde el modo gráfico):
|
1 2 3 4 5 6 |
CREATE TABLE ajpdsoft.facturas ( codigo INT NOT NULL AUTO_INCREMENT, fecha DATE NOT NULL, cliente VARCHAR(150) NOT NULL, importe DECIMAL(11,2) NOT NULL, PRIMARY KEY (codigo)) ENGINE = InnoDB; |
Insertaremos varios registros a modo de ejemplo, con las siguientes sentencias SQL:
|
1 2 3 4 5 |
INSERT INTO facturas (fecha, cliente, importe) VALUES (now(),"Proyecto A",300.55); INSERT INTO facturas (fecha, cliente, importe) VALUES (now(),"Proyecto AjpdSoft",5000.2); INSERT INTO facturas (fecha, cliente, importe) VALUES (now(),"Proyecto Aj",5500); INSERT INTO facturas (fecha, cliente, importe) VALUES (now(),"Proyecto A",3000); INSERT INTO facturas (fecha, cliente, importe) VALUES (now(),"Proyecto A",50.98); |
Quedando los siguientes registros en la tabla facturas:
Para probar un sitio web PHP con acceso a esa tabla de facturas, accederemos con algún cliente SSH al servidor XAMPP doquerizado, por ejemplo con Filezilla. Usaremos el mismo puerto que el establecido para SSH:
Accederemos a la carpeta:
/www/ajpdsoft
Que estará vacía. Pulsaremos con el botón derecho del ratón y en el menú emergente elegiremos «Crear nuevo archivo»:
Introduciremos el nombre index.php:
Pulsaremos con el botón derecho del ratón sobre el fichero index.php y elegiremos «Ver/Editar»:
Añadiremos el siguiente código PHP para acceder al servidor MySQL/MariaDB, obtener los registros de la tabla facturas y mostrarlos por pantalla en HTML:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 |
<?php function conectarBD ($servidor, $usuario, $contrasena, $bd) { $conexion = @mysqli_connect($servidor, $usuario, $contrasena, $bd); if($conexion) { return $conexion; } else { return false; } } $resultadoConexion = conectarBD("localhost", "root", "ContraseñaRoot", "ajpdsoft"); if ($resultadoConexion) { $SQL = "select * from facturas order by fecha desc"; $resultadoSQL = mysqli_query($resultadoConexion, $SQL); if ($resultadoSQL) { ?> <!DOCTYPE html> <html> <style> table, th, td { border:1px solid black; } </style> <body> <h2>Proyecto A - Facturación Web</h2> <table style="width:100%"> <tr> <th>Código</th> <th>Fecha</th> <th>Cliente</th> <th>Importe</th> </tr> <?php foreach($resultadoSQL as $row) { echo "<tr>"; echo "<td>" . $row["codigo"] . "</td>"; echo "<td>" . $row["fecha"] . "</td>"; echo "<td>" . $row["cliente"] . "</td>"; echo "<td>" . $row["importe"] . "</td>"; echo "</tr>"; } echo "</table></body></html>"; } } ?> |
Guardaremos los cambios en el fichero index.php, en Filezilla nos mostrará un mensaje de confirmación para subir el fichero, pulsaremos en «Sí»:
Una vez creado el fichero index.php, si intentamos acceder a la URL:
http://localhost:41063/www/ajpdsoft/index.php
Veremos que se nos descargará el fichero info.php, como si de un fichero de descarga se tratara, en lugar de ejecutarse como PHP. Para solucionar este problema, crearemos un fichero con el nombre httpd.conf en la carpeta:
/opt/lampp/apache2/conf.d
Con el siguiente contenido:
|
1 2 3 4 5 |
<Directory "/www/ajpdsoft"> Options Indexes FollowSymLinks ExecCGI Includes AllowOverride All Require all granted </Directory> |
Lo crearemos en la carpeta indicada para que sea persistente, dado que es la ubicación que hemos indicado para el volumen correspondiente del contenedor en el fichero compose.yml.
Puesto que hemos aplicado cambios en ficheros de configuración de Apache, reiniciaremos los servicios, ejecutando (desde la línea de comandos del equipo anfitrión con Docker Desktop):
|
1 |
docker exec xampp-xampp-1 /opt/lampp/lampp restart |
Ahora sí podremos ejecutar nuestro sitio web en PHP con acceso a MySQL/MariaDB en Docker:
http://localhost:41063/www/ajpdsoft/index.php
