noviembre, 2008:

Llevo usando phpMyAdmin durante varios años y recién me entero que en el paquete hay un asistente de instalación/configuración.

Los que trabajamos desarrollando aplicaciones web y usamos MySQL como base de datos alguna vez habremos usado phpMyAdmin, si es que no lo usamos ahora, y sabemos la potente pieza de software que es.

Para los que se están iniciando esta dedicado este tutorial.

PhpMyAdmin es un sistema de gestión de bases de datos MySQL. Un sistema de gestión sirve de interfaz entre el servidor y el usuario. Recibe ordenes del usuario y las ejecuta en el servidor, asimismo entrega al usuario la respuesta generada por el servidor y se la muestra en un formato en que él lo pueda entender. Puedes encontrar mas información sobre el tema en Wikipedia – Sistema de gestión de base de datos.

Para empezar, necesitas una base donde phpMyAdmin deba correr. PMA (phpMyAdmin) no es mas que un conjunto de scripts PHP que deben ser interpretados por PHP que a su vez esta instalado sobre un servidor web como Apache o IIS. (Apache es el más recomendado)

Entonces, primero necesitas tener corriendo un servidor web.

Ve a la página de PMA: www.phpmyadmin.net y descarga la última versión estable del software. La versión cuando se escribe este tuto es la 3.0.1. Hay varios formato para descargarlo, si usas Windows, te recomiendo bajarlo en .zip o 7z (que puedes abrirlo con WinRAR).

Una vez descargado descomprimes el directorio en su interior en la raiz donde se encuentran tus archivos web. Una vez hecho eso ingresa vía browser al directorio creado. De seguro verás un mensaje de error detallando que no se puede conectar a la base de datos “Localhost” usando el usuario “root” y sin contraseña.  A menos que tu base de datos tenga el usuario “root” sin clave, entonces no necesitaras configurar nada, pero ese caso es raro.

Primer inicio de phpMyAdmin

En en ese error busca el link Setup Script y dale un click para ir al asistente de configuración. Una vez alli verás unos mensajes de advertencia. Uno de ellos dice que debes crear un folder llamado “config” en la raíz de tu instalación de PMA y este folder debe tener permisos de escritura. Si usas un servidor Windows, simplemente crea un directorio llamado “config” dentro de tu instalación de PMA. Si usas Linux, la cosas es mas complicada. No solo debes crearlo, debes asignarle el permiso 777 también. Esto lo puedes hacer desde tu gestor FTP o SSH. Prueba creando el directorio y luego dándole un click secundario buscando la opción “Cambiar permisos” o algo similar. PMA te pide esto porque va a crear un archivo de configuración y necesita tener el permiso del sistema operativo para hacerlo.

Una vez creado el directorio refresca el asistente de configuración (simplemente presiona la tecla F5). Si la alerta de crear el folder desaparece, entonces lo hiciste bien.

Ya no aparece el aviso de que falta crear el directorio "config"

Lo primero que debes hacer es decirle a PMA cual o cuales serán tus servidores de bases de datos. Para esto dale un clic en el primero botón Add para empezar a registrar el primer servidor.

Registrando un servidor de BD en PMA

Fíjate en la configuración que he elegido:

Nombre del host: localhost (si los archivos de PMA están alojados a su vez en el servidor de BD)
Extensión PHP a usar: mysql
Tipo de autenticación: cookie (hará que cada vez que ingreses a PMA te pregunte el nombre y clave para conectarse a la BD)

Si deseas que se quede almacenado (para cualquier usuario) el nombre de usuario y clave de la BD eliges config como tipo de autenticación y luego escribes estos datos en los dos campos siguientes.

Una vez terminas le das en el botón verde Add que te mandara a la pantalla de inicio pero mostrándote el resumen de el nuevo servidor registrado.

Si deseas puedes probar con otros botones y ver que mas puedes configurar. Una vez que termines presiona en Save para generar y almacenar el archivo de configuración.

Guardando la configuración usando el asistente de PMA

Una vez guardado verás el mensaje de confirmación. Aún falta un paso más.

Lo que este asistente hace es generar un archivo de configuración y almacenarlo dentro del directorio “config” creado anteriormente. Verás ahora que este directorio contiene ahora el archivo config.inc.php . Pero este archivo allí donde se encuentra no sirve de nada. Debes copiarlo a la raíz de tu instalación de PMA.

Ahora que ya colocaste config.inc.php en su lugar, prueba entrando a la raíz de tu instalación de PHP vía browser.

Si elegiste cookie como método de autenticación entonces verás la siguiente imagen.

Entrando a mi PMA

Espero que sepas un nombre de usuario y clave válido para entrar a tu servidor de BD. Si lo haces y los datos son correctos (al igual que tu configuración) verás la página de inicio de PMA.

Pantalla de inicio de PMA

La pantalla de inicio puede variar dependiendo de los permisos que tenga la cuenta que has usado para conectarte a la BD. En la imagen, use el usuario root que cuenta con todos los permisos disponibles.

Ahora ya tenemos PMA configurado con lo básico necesario para trabajar. Pero si deseas un poco más, hay algunas opciones adicionales de PMA que son fáciles de activar pero requieren el uso de unas tablas para almacenar sus datos. Algunas de estas ventajas adicionales son:

• Historia de sentencias SQL ejecutadas
• Tener una biblioteca de sentencias pre-almacenadas
• Creación y edición de la estructura de nuestras bases de datos usando un modelo gráfico (recomendado)
• Guardar y mostrar cierta información adicional sobre las tablas y sus columnas.
• Habilidad de crear documentos PDF con información personalizada sobre nuestra BD.
• Almacenar relaciones entre los campos de nuestra base de datos (muy útil cuando usamos MyISAM, si usamos InnoDB lo podemos simplemente no usar)

Si crees que vale la pena dedicarle algo de tiempo para aprovechar estas ventajas, entonces sigue leyendo.

Crear la BD con las tablas necesarias para que PMA las pueda usar es algo simple. En los archivos de PMA hay un directorio llamado scripts ubicado en la raíz del paquete. En este directorio (que es donde se encuentra también el asistente de configuración) hay un archivo llamado “create_tables.sql” . Este archivo contiene todas las instrucciones (en lenguaje SQL) para crear la base de datos “phpmyadmin” y sus respectivas tablas. Para ejecutarlo hacemos lo siguiente:

Una vez estemos en la pantalla principal de PMA da un clic en la Ficha Importar. Una vez ahi, presiona en Examinar y ubica el archivo “create_tables.sql” que esta dentro del directorio “scripts” en la raíz de tu instalación de PMA. Una vez elegido dale un clic sobre el boton Continuar.

Si todo sale correctamente veras la confirmación de que todo salió bien y la nueva base de datos “phpmyadmin” en la barra lateral izquierda.

Bien, ahora que las tablas ya estan listas necesitas decirle a PMA que las use. Para eso volvemos al asistente para crear nuevamente un archivo “config.inc.php” con los cambios hechos.

Nos dirigimos al asistente. Como ya sabes, el asistente es un archivo PHP y se ubica en el directorio “scripts” en la raíz del PMA. Escribe la ruta completa en la barra de dirección de tu navegador.
Debe quedar algo así: http://localhost/phpMyAdmin/scripts/setup.php

Ahora hay que volver a registrar nuestro(s) servidor(es) de base de datos, igual que a primera vez con la ligera diferencia en que además esta vez debemos decirle cual es el nombre de la base de datos donde se encuentran las tablas especiales.

Herramientas adicionales en PMA

Los parámetros adicionales son:

• Usuario y clave de una cuenta que tenga acceso a la nueva base de datos que contiene las tablas para extender la funcionalidad de PMA: Esto es obligatorio puesto que PMA usará estas tablas independientemente de la base de datos que uses.
• Nombre de la base de datos que usará PMA: Nombre de la base de datos que contiene las tablas que PMA necesita. Creo que no hacia falta explicarlo.

Una vez hecho esto hacemos un click en Add para registrar nuestro servidor de BD y luego en Save para volver a generar y guardar nuestro archivo “config.inc.php” en el directorio “config”. Luego copias este archivo a la raíz de los archivos de PMA reemplazando el que creaste anteriormente.

Cuando vuelvas a entrar a entrar PMA verás que nuevos botones han haparecido.

Por ejemplo, cuando ves el resumen de las tablas de una base de datos notarás una ficha llamada “Diseño” que hace esto:

Vista Diseño de una BD usando PMA

E incluso puedes relacionar las claves primarias y foraneas desde esta vista.

La historia de sentencias SQL’s ejecutadas:

Historial de sentencias SQL ejecutadas de PMA

Ejecución de sentencias pre-almacenadas

Y si no te gustan los colores puedes elegir otro tema que te guste. Puedes encontrar pieles para PMA en el siguiente enlace: http://www.phpmyadmin.net/home_page/downloads.php?themes

Espero este tuto te haya servido.