Identificamos la capa que falla, revisamos las credenciales y la configuración de PHP y elegimos una actualización compatible con el método de instalación.
Un error en phpMyAdmin puede venir de la conexión con MySQL o MariaDB, de una incompatibilidad con PHP, de la configuración de sesiones o de los límites de una importación. Conviene identificar cuál falla antes de cambiar permisos o sustituir archivos.
En esta guía tomaremos Ubuntu 24.04 como referencia para los comandos del sistema y MySQL 8 para el ejemplo de permisos. En un alojamiento administrado o con panel de control, utiliza su procedimiento de mantenimiento: las rutas, versiones y servicios pueden ser diferentes.
Identificar el error y la instalación
Versiones, origen y registros
Anota la acción que falla y el mensaje completo: inicio de sesión, consulta, importación o carga de una página. Comprueba la versión de phpMyAdmin y si procede de un paquete del sistema, una instalación manual o un panel. Para una instalación de paquetes en Ubuntu:
dpkg-query -W phpmyadmin
apt-cache policy phpmyadmin
php8.3 -v
php8.3 --ini
php8.3 -mLos comandos de PHP muestran el entorno de consola, que puede ser distinto del PHP que atiende phpMyAdmin. Confirma también el controlador y la versión de la web. Que dpkg-query no encuentre un paquete tampoco demuestra que phpMyAdmin no exista: podría haberse desplegado por otra vía.
Si utilizas Apache y PHP-FPM 8.3, estos registros pueden ayudar:
sudo journalctl -u php8.3-fpm -n 50 --no-pager
sudo tail -n 50 /var/log/apache2/error.logAdapta la unidad y el archivo a tu servidor y a su virtual host. Una respuesta 403 o 404 puede proceder de las reglas de acceso o de una ruta incorrecta, antes de que PHP llegue a ejecutarse. No desactives esas restricciones para convertir un fallo de ruta en un acceso público.
Proteger el acceso mientras investigas
Utiliza HTTPS y limita la administración mediante una VPN, un acceso privado o restricciones acordes con tu entorno. Conserva los detalles de errores en registros protegidos, sin mostrarlos al visitante ni publicar contraseñas, consultas con datos o capturas de configuración. Ocultar el nombre de la URL no sustituye un control de acceso.
Resolver la autenticación sin crear un administrador global
Distinguir la cuenta y el método de conexión
En algunas instalaciones de Ubuntu, el administrador de MySQL puede entrar localmente mediante autenticación asociada al usuario del sistema. MariaDB también dispone de autenticación por socket. No significa que todas las instalaciones actuales impidan usar root con contraseña, ni que phpMyAdmin deba ejecutar comandos con sudo.
El proceso PHP de la web normalmente no tiene la identidad del administrador del sistema. Conserva el método de administración que corresponda y utiliza para phpMyAdmin una cuenta de base de datos con los permisos necesarios para la tarea. No cambies la autenticación de root como solución genérica.
Comprueba el servidor, el puerto o socket y la cuenta autorizada. localhost y 127.0.0.1 pueden implicar transportes distintos. El usuario y el host forman parte de la cuenta de MySQL; no sustituyas el host por % para permitir conexiones desde cualquier origen.
Un ejemplo limitado a lectura
Si necesitas consultar una base existente llamada rjwordpress, un administrador autorizado puede crear una cuenta específica como esta. Sustituye la contraseña de ejemplo por un secreto único y no reutilices las credenciales de la aplicación:
CREATE USER 'rj_consulta'@'localhost'
IDENTIFIED BY 'SUSTITUYE_POR_UN_SECRETO_UNICO';
GRANT SELECT ON `rjwordpress`.* TO 'rj_consulta'@'localhost';
SHOW GRANTS FOR 'rj_consulta'@'localhost';Este ejemplo solo concede lectura sobre esa base: no permite modificar tablas, importar una estructura ni administrar cuentas. Si necesitas otras operaciones, acuerda los permisos concretos para ellas. Evita GRANT ALL ON *.* y WITH GRANT OPTION como remedio para un fallo de acceso.
Si la cuenta ya existe, detente y revisa su uso antes de cambiarla. No restablezcas a ciegas la contraseña de una cuenta compartida por otras aplicaciones. En MySQL, las sentencias de gestión de cuentas y permisos no requieren añadir un FLUSH PRIVILEGES rutinario.
Prueba desde la máquina donde se ejecuta phpMyAdmin, con el transporte y las credenciales que correspondan. Para el ejemplo local por socket:
mysql --protocol=SOCKET -u rj_consulta -p -D rjwordpressIntroduce la contraseña cuando se solicite, sin añadirla al comando. Una vez conectado, puedes comprobar la identidad solicitada y la cuenta que el servidor ha aplicado:
SELECT USER(), CURRENT_USER(), VERSION();Si esta conexión funciona y phpMyAdmin no, compara su configuración de servidor y la compatibilidad del cliente PHP con el método de autenticación. Una prueba de consola correcta no demuestra por sí sola que la conexión web sea equivalente.
Revisar PHP, sesiones e importaciones
Avisos y configuración de autenticación
Los antiguos parches por número de línea en sql.lib.php o plugin_interface.lib.php correspondían a versiones concretas. No los apliques a una instalación actual: ocultar un aviso o cambiar un count() no resuelve de forma general una incompatibilidad. Revisa los requisitos de tu versión de phpMyAdmin, PHP y sus extensiones y actualiza por la vía que gestiona la instalación.
La autenticación cookie permite introducir la cuenta de MySQL al iniciar sesión sin guardar esa contraseña como credencial fija en la configuración. Si utilizas este método, revisa el bloque del servidor existente en config.inc.php. En los paquetes Debian y Ubuntu, la configuración suele estar bajo /etc/phpmyadmin y puede tener archivos incluidos por el distribuidor.
Para phpMyAdmin 5.2, este fragmento ilustra dos ajustes y el secreto de cifrado. Genera el secreto una sola vez, de forma local y privada:
php8.3 -r 'echo bin2hex(random_bytes(32)), PHP_EOL;'El resultado son 64 caracteres hexadecimales que representan 32 bytes aleatorios. Sustituye el marcador antes de utilizar el fragmento; no regeneres el secreto en cada petición ni publiques su valor:
// Dentro del bloque del servidor existente: $i debe ser su índice.
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['AllowNoPassword'] = false;
// Genera el secreto una vez y sustituye el texto por sus 64 caracteres hexadecimales.
$cfg['blowfish_secret'] = hex2bin('SUSTITUYE_POR_64_CARACTERES_HEXADECIMALES');No es una configuración completa. Utiliza el índice del servidor que ya existe y respeta los archivos que administra el paquete; no crees un servidor duplicado ni sobrescribas un secreto válido por rutina. Si hay bucles de inicio de sesión, revisa también cookies, almacenamiento de sesiones, permisos y la información HTTPS que recibe PHP detrás de un proxy.
Los avisos sobre almacenamiento de configuración de phpMyAdmin se refieren a sus funciones adicionales, como preferencias o relaciones. Su cuenta de control no es necesariamente la cuenta con la que administras tus datos. Revisa la configuración que corresponda; no le concedas privilegios globales para silenciar el aviso.
Importaciones demasiado grandes o interrumpidas
Comprueba el tamaño admitido por PHP y los límites del servidor web o proxy. Como ejemplo de relación entre directivas, no como receta universal:
upload_max_filesize = 64M
post_max_size = 72M
memory_limit = 256Mpost_max_size debe dejar margen sobre upload_max_filesize para el resto de la petición. El consumo de memoria no equivale al tamaño del SQL y este ejemplo no garantiza poder importar cualquier archivo de 64 MB. Revisa también los tiempos de ejecución, el espacio temporal, la compresión y las restricciones del proveedor.
Aplica cualquier cambio al entorno PHP que realmente ejecuta phpMyAdmin y recarga solo el servicio necesario, comprobando antes la configuración. Para volúmenes grandes, valora una importación controlada por consola o la herramienta del proveedor.
Antes de importar, comprueba la copia de seguridad y el destino. Una importación interrumpida puede dejar cambios parciales: no la repitas sobre producción suponiendo que el primer intento no hizo nada. Prueba primero la restauración sobre una base separada.
Actualizar respetando el método de instalación
Si phpMyAdmin está gestionado por el sistema de paquetes, revisa primero sus actualizaciones y las notas del distribuidor. Una numeración inferior a la descarga oficial no demuestra por sí sola que falten correcciones: las distribuciones pueden incorporar parches sin adoptar todas las novedades.
En Ubuntu puedes actualizar la información de paquetes y simular la actualización del paquete existente:
sudo apt update
sudo apt-get --simulate install --only-upgrade phpmyadminCon una copia de la configuración y una vía de recuperación, revisa dependencias, archivos de configuración y posibles cambios gestionados por el instalador. Si la propuesta es adecuada, ejecuta:
sudo apt-get install --only-upgrade phpmyadminNo copies un archivo descargado sobre /usr/share/phpmyadmin si esa ruta pertenece al paquete. Tampoco modifiques vendor_config.php ni borres su copia anterior como primer paso de la actualización. Si lo administra cPanel u otro panel, utiliza su procedimiento o el soporte del proveedor.
En un despliegue manual, elige una versión estable compatible desde la página oficial, verifica la descarga según sus instrucciones y prepara un directorio nuevo. Traslada solo los ajustes locales necesarios, con rutas temporales y permisos adecuados, y prueba acceso, consultas, exportación e importación en una base de prueba antes de cambiar la ruta publicada. Conserva la versión anterior fuera del acceso web durante la ventana de recuperación.
Antes de dar un problema por resuelto, comprueba la operación que fallaba y que el acceso conserva los permisos adecuados. Que desaparezca un aviso no basta si la solución amplía privilegios o deja una instalación sin mantenimiento.
Referencias: instalación de phpMyAdmin, configuración de phpMyAdmin 5.2, diagnóstico e importaciones, permisos de MySQL y autenticación por socket en MariaDB.
Preguntas y aportaciones
Deja tu comentario
La conversación
4 aportacionesConservamos las conversaciones y sus fechas originales. Algunas se refieren a versiones anteriores; consulta el contenido revisado de la guía antes de aplicar sus indicaciones.
pongo root u otros nombres con o sin contraeñas y no me deja entrar al local el php usando mysql
Hola Darío,
Gracias por participar
Si no puedes acceder desde la consola con sudo mysql -u root, intenta lo siguiente:
1. Para el servicio mysql:
sudo service mysql stop (Ubuntu) o sudo /etc/init.d/mysqld stop (CentOS, Fedora, RedHat)
2. Arranca mysql en modo seguro: sudo mysqld_safe --skip-grant-tables &
3. Ahora deberías poder conectar como root: sudo mysql -u root
4. Crea un nuevo usuario con los privilegios necesarios o cambia las contraseñas de los existentes según tus necesidades
5. Una vez realizadas las modificaciones, para el servicio de nuevo y arráncalo en modo normal.
Deberías poder acceder con normalidad a mysql. No olvides actualizar tus scripts de acceso con las credenciales correctas.
Un saludo
Nota de actualización: La recuperación de acceso con las comprobaciones de permisos desactivadas requiere un procedimiento específico y aislamiento del servidor. No ejecutes estos comandos antiguos como solución general; consulta la guía actual.
Algo si, para sql.lib.php en la linea 614, hay que quitar un paréntesis, si no phpMyAdmin no funcionará.
Hola Kamil,
Tienes razón, hay un error en la solución indicada en el texto.

Además de añadir un paréntesis en la 613 hay que eliminar el que está al final de esa misma línea.
La línea 613 debe quedar así:
|| (count($analyzed_sql_results['select_expr']) == 1De esta forma se mantiene la lógica y no se genera un error de sintaxis de PHP.
Gracias por tu aporte
Rolando
Nota de actualización: Este intercambio se refiere a una versión antigua de phpMyAdmin. La guía revisada explica cómo abordar la compatibilidad sin modificar manualmente sus archivos.