Professional Documents
Culture Documents
Publicacin 4.2.0-dev
The phpMyAdmin devel team
21 de March de 2014
ndice general
I
II
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Contenidos:
ndice general 1
phpMyAdmin Documentation, Publicacin 4.2.0-dev
2 ndice general
CAPTULO 1
Introduccin
phpMyAdmin puede administrar un servidor MySQL entero (necesita un superusuario) o una base de datos sencilla.
Para realizar esto ltimo, es necesario tener un usuario MySQL debidamente congurado que pueda leer o escribir
solamente en la base de datos deseada. Para ello, Ud. debe buscar en la seccin apropiada del manual de MySQL.
1.1 Funcionalidades includas
En la actualidad, phpMyAdmin puede:
visualizar y borrar bases de datos, tablas, vistas, campos e ndices
mostrar mltiples resultados a travs de procedimientos almacenados o consultas
crear, copiar, borrar, renombrar y alterar bases de datos, tablas, campos e ndices
realizar labores de mantenimiento de servidor, bases de datos y tablas, dando consejos acerca de la conguracin
del servidor
ejecutar, editar y marcar cualquier expresin SQL, incluyendo consultas en lote
carga tablas con el contenido de cheros de texto
crea
1
y lee volcados de tablas
exporta [f#1]_ datos a varios formatos: CSV, XML, PDF, ISO/IEC 26300 - OpenDocument Text and Spreads-
heet, Microsoft Word 2000 y LATEX
importar datos y estructuras MySQL de planillas OpenDocument as como tambin archivos XML, CSV y SQL
administrar mltiples servidores
gestionar privilegios y usuarios de MySQL
comprobar la integridad referencial en las tablas MyISAM
mediante Query-by-example (QBE), crear consultas complejas conectando automticamente las tablas necesa-
rias
crear grcos PDF del diseo de su base de datos
buscar globalmente o solamente en una parte de una base de datos
transformar los datos almacenados a cualquier formato usando un conjunto de funciones predenidas, como
mostrar objetos binarios (BLOBs) como imgenes o enlaces de descarga
1
phpMyAdmin puede comprimir (formatos Zip, GZip o RFC 1952) volcados y exportaciones CSV si utiliza PHP con capacidades Zlib
(--with-zlib). Estos capcidades pueden necesitar cambios el archivo php.ini.
3
phpMyAdmin Documentation, Publicacin 4.2.0-dev
visualizar cambios en bases de datos, tablas y vistas
capacidad de trabajar con tablas InnoDB y claves forneas (revise 3.6 Qu no est soportado actualmente en
phpMyAdmin sobre InnoDB?)
capacidad de utilizar mysqli, la extensin MySQL mejorada (revise 1.17 Qu versiones de servidor MySQL
son compatibles con phpMyAdmin?)
crear, editar, ejecutar y eliminar funciones y procedimientos almacenados (stored procedures)
crear, editar, exportar y eliminar eventos y disparadores
comunicarse en 62 idiomas distintos
1.2 Unas palabras sobre los usuarios
A muchas personas les es difcil entender el concepto de gestin de usuarios de phpMyAdmin. Cuando un usuario
entra en phpMyAdmin, su nombre de usuario y contrasea se pasan directamente a MySQL. phpMyAdmin no realiza
la gestin de usuarios directamente (salvo el permitirle a uno manipular la informacin de usuario de MySQL); todos
los usuarios deben ser usuarios vlidos de MySQL.
Notas al pie
4 Captulo 1. Introduccin
CAPTULO 2
Requisitos
2.1 Servidor web
Ya que la interfaz de phpMyAdmin est basada ntegramente en su navegador, necesitar un servidor web (como
Apache o IIS) en el que instalar los archivos de phpMyAdmin.
2.2 PHP
Necesita PHP versin 5.3.0 o posterior, compatible con sesiones (session), la biblioteca estndar PGP
(SPL), JSON y las extensiones mbstring y ctype.
Para subir archivos ZIP, necesita la extensin zip de PHP.
Necesita el mdulo GD2 de PHP para mostrar las miniaturas de JPEGs (image/jpeg: inline) conservando su
relacin de aspecto original.
Cuando utiliza mtodo de autenticacin por cookie (el predeterminado), se sugiere encarecidamente la exten-
sin mcrypt para la mayora de los usuarios y es obligatoria para equipos de 64 bits. No utilizar mcrypt har
que phpMyAdmin cargue las pginas sensiblemente ms lento.
Para poder utilizar barras de progreso al subir archivos, revise 2.9 Viendo una barra de progreso al subir archi-
vos.
Para poder importar XML y Hojas de Clculo con formato de documento abierto, necesitar PHP con la exten-
sin libxml.
Consejo de rendimiento: instale la extensin ctype.
Ver tambin:
1.31 es phpMyAdmin compatible con PHP 5?, Uso de los mtodos de autenticacin
2.3 Base de datos
phpMyAdmin puede trabajar con bases de datos compatibles con MySQL.
MySQL 5.5 o posterior
MariaDB 5.5 o posterior
Drizzle
5
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Ver tambin:
1.17 Qu versiones de servidor MySQL son compatibles con phpMyAdmin?
2.4 Navegador web
Para acceder a phpMyAdmin necesitar un navegador web con cookies y javascript activado.
6 Captulo 2. Requisitos
CAPTULO 3
Instalacin
phpMyAdmin no aade ninguna medida de seguridad al servidor de base de datos MySQL. El administrador de sistema
es an el responsable de otorgar adecuadamente los permisos sobre las bases de datos de MySQL. Se puede utilizar
para ello la pgina de phpMyAdmin Usuarios.
Advertencia: Los usuarios Mac deben saber que si utilizan una versin anterior a Mac OS X, StuffIt modica el
formato Mac. Por lo tanto, tendr que volver a guardar con estilo Unix todos los archivos de script de phpMyAdmin
(utilizando BBEdit por ejemplo) antes de subirlos a su servidor, dado que a PHP no le suele gustar el estilo de n
de lnea de Mac (\r).
3.1 Distribuciones de Linux
PhpMyAdmin esa includo en la mayoria de las distribuciones Linux. Se recomienda que utilice los paquetes de la
distribucin cuando fuera posible - generalmente se integran con su distribucin y recibir automticamente actuali-
zaciones de seguridad desde su distribucin.
3.1.1 Debian
Los repositorios de paquetes de Debian incluyen un paquete de phpMyAdmin, pero sepa que la conguracin se
encuentra en /etc/phpmyadmin y puede diferir de la documentacin ocial de phpMyAdmin.
3.1.2 OpenSUSE
OpenSUSE ya viene con el paquete phpMyAdmin, simplemente instale los paquetes desde el openSUSE Build
Service.
3.1.3 Ubuntu
Ubuntu contiene el paquete phpMyAdmin, sin embargo si desea la versin mas actual puede usar los paquetes del PPA
de Michal
Cihar.
3.1.4 Gentoo
Gentoo provee el paquete phpMyAdmin, tanto con una conguracin casi predeterminada como tambin con una
conguracin para aplicacin web (webapp-config). Utilice emerge dev-db/phpmyadmin para instalarlo.
7
phpMyAdmin Documentation, Publicacin 4.2.0-dev
3.1.5 Mandriva
Mandriva provee el paquete de phpMyAdmin en su rama contrib y puede instalarlo de la forma usual con el Centro
de control.
3.1.6 Fedora
Fedora provee el paquete de phpMyAdmin, pero sepa que el archivo de conguracin se encuentra en
/etc/phpMyAdmin/ y puede tener diferencias con la documentacin ocial de phpMyAdmin.
3.1.7 Red Hat Enterprise Linux
Tanto Red Hat Enterprise Linux como sus derivados, como CentOS, no proveen phpMyAdmin, pero el repositorio
de Fedora Extra Packages for Enterprise Linux (EPEL) s lo hace cuando est activado. Sepa que el archivo de
conguracin se encuentra en /etc/phpMyAdmin/ y puede diferir de la documentacin ocial de phpMyAdmin.
3.2 Instalacin en Windows
La forma ms sencilla de obtener phpMyAdmin en Windows es utilizar productos de terceros que incluyen phpM-
yAdmin junto con un servidor de base de datos y un servidor web como XAMPP.
Puede encontrar ms opciones similares en Wikipedia.
3.3 Instalacin rpida
1. Elija el paquete adecuado de la pgina de descargas de phpmyadmin.net. Algunos paquetes slo contienen los
mensajes en ingls, otros contienen todos los idiomas en. Asumiremos que ha elegido un paquete con un nombre
parecido a phpMyAdmin-x.x.x-all-languages.tar.gz.
2. Descomprima el paquete con tar o unzip (asegrese de descomprimir tambin los subdirectorios): tar -xzvf
phpMyAdmin_x.x.x-all-languages.tar.gz en el directorio principal de documentos de su servidor
web. Si no tiene acceso a dicho directorio raz, copie los archivos en un directorio de su equipo local y, despus
del paso 4, transera dicho directorio a su servidor web usando, por ejemplo, ftp.
3. Asegrese que todos los scripts tengan el dueo adecuado (si PHP est siendo ejecutado en modo seguro, tener
algunos scripts con un dueo distinto al del de los dems scripts puede ser un problema. Revise 4.2 Cul es la
forma preferida para asegurar phpMyAdmin contra accesos maliciosos? y 1.26 Acabo de instalar phpMyAdmin
en la raz de documentos de IIS pero obtengo el error No se especic archivo de entrada al tratar de ejecutar
phpMyAdmin. por sugerencias.
4. Ahora debe congurar su instalacin. Hay dos formas. Tradicionalmente, deba modicar a mano el archivo
config.inc.php, pero ahora se suministra un archivo de conguracin automtico para aquellos que pree-
ran la instalacin grca. Crear config.inc.php sigue siendo una manera rpida de empezar y es necesaria
para algunas opciones avanzadas.
3.3.1 Creando el archivo en forma manual
Para crear el archivo a mano simplemente utilice un editor de texto y cree el archivo config.inc.php (puede copiar
config.sample.inc.php para empezar desde un archivo de conguracin mnimo) en el directorio principal de
phpMyAdmin (el que contiene index.php). phpMyAdmin carga primero libraries/config.default.php
8 Captulo 3. Instalacin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
y despus sobreescribe dichos valores con los que se encuentran en config.inc.php. Si el valor predeterminado
para una opcin particular es adecuado, no es necesario incluirla en config.inc.php. Probablemente necesitar
unas pocas directivas para empezar; una conguracin simple podra verse de la siguiente forma:
<?php
$cfg[blowfish_secret] = ba17c1ec07d65003; // use here a value of your choice
$i=0;
$i++;
$cfg[Servers][$i][auth_type] = cookie;
?>
O si preere no ser preguntado cada vez que quiera entrar:
<?php
$i=0;
$i++;
$cfg[Servers][$i][user] = root;
$cfg[Servers][$i][password] = cbb74bc; // use here your password
$cfg[Servers][$i][auth_type] = config;
?>
Si necesita conocer todos los valores de conguracin disponibles, revise Conguracin en este documento.
3.3.2 Utilizando el script de conguracin
En lugar de editar manualmente config.inc.php, puede emplear el script de conguracin. Primero, debe crear
un directorio llamado config en el directorio de phpMyAdmin. Esto constituye una medida de seguridad. En un
sistema Linux/Unix, puede usar las siguientes rdenes:
cd phpMyAdmin
mkdir config # create directory for saving
chmod o+rw config # give it world writable permissions
Y para editar una conguracin existente, sobreescrbala primero:
cp config.inc.php config/ # copy current configuration for editing
chmod o+w config/config.inc.php # give it world writable permissions
En otras plataformas, simplemente cree el directorio y cercirese que su servidor tiene acceso de lectura y escritura
en l. 1.26 Acabo de instalar phpMyAdmin en la raz de documentos de IIS pero obtengo el error No se especic
archivo de entrada al tratar de ejecutar phpMyAdmin. puede serle de utilidad.
A continuacin, abra setup/ en su navegador. Si posee una conguracin existente, utilice el botn Cargar para
ingresar su contenido al panel de conguracin. Tenga en cuenta que los cambios no se guardan a disco hasta que
elija explcitamente Guardar en la seccin de Conguracin de la pantalla. Normalmente el script guarda el
nuevo config.inc.php en el directorio config/, pero si el servidor web no dispone de los permisos necesarios
ver el error No se puede cargar o guardar la conguracin. Asegrese que el directorio config/ existe y tiene
los permisos adecuados o utilice el enlace Descarga para guardar el archivo de conguracin localmente y sbalo
despus (mediante FTP o algn medio similar) a la ubicacin correcta.
Una vez guardado el archivo, debe sacarlo del directorio config/ y, nuevamente como medida de seguridad, reini-
cializar los permisos:
mv config/config.inc.php . # move file to current directory
chmod o-rw config.inc.php # remove world read and write permissions
rm -rf config # remove not needed directory
3.3. Instalacin rpida 9
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Ahora ya se puede usar el archivo. Puede revisar o editarlo con su editor favorito si es que necesita ajustar alguna
opcin avanzada que el script de conguracin no provee.
1. Si est utilizando el mtodo de autenticacin cong es preferible que proteja el directorio de instalacin
de phpMyAdmin porque el uso de este mtodo no requiere que el usuario escriba su contrasea para acceder
a la instalacin de phpMyAdmin. Se recomienda el uso de mtodos de autenticacin alternativos, como por
ejemplo un HTTPAUTH en un archivo .htaccess o bien usar una autenticacin http o por cookie. Revise
ISPs, instalaciones multiusuario para obtener informacin adicional, especialmente 4.4 phpMyAdmin siempre
devuelve Acceso denegado al utilizar autenticacin HTTP..
2. Abra el directorio principal de phpMyAdmin en su navegador. phpMyAdmin debera mostrar una pantalla de
bienvenida y sus bases de datos o, si est usando el mtodo de autenticacin HTTP o por cookie, un formulario
de inicio de sesin.
3. Debera rechazar el acceso a los subdirectorios ./libraries y ./setup/lib en la conguracin de su
servidor web. Puede utilizar el archivo .htaccess suministrado para Apache en ese directorio. Con otros servi-
dores web deber implementar las conguraciones usted mismo. Esta conguracin evita la exposicin de las
carpetas y las vulnerabilidades de los scripts que puedan existir en dicho cdigo.
4. Suele ser una buena idea proteger la instalacin pblica de phpMyAdmin contra el acceso de los robots, puesto
que generalmente no hacen nada bueno. Puede hacer esto mediante un archivo robots.txt en el directorio
raz de su servidor web o bien limitando el acceso mediante la conguracin del mismo; para ms informacin
revise la 1.42 Cmo puedo evitar que robots accedan a phpMyAdmin?.
3.4 Almacenamiento de conguracin para phpMyAdmin
Para obtener muchas fucionalidades adicionales (favoritos, comentarios, histrico SQL, mecanismo de seguimiento,
generacin de :term:PDFs, transformacin de los campos de contenido, etc.) es necesario crear un conjunto especial
de tablas. Estas tablas pueden residir en la propia base de datos o bien en una base de datos central en instalaciones
multiusuario (en este caso, la base de datos debera ser accesible nicamente por el usuario de control y por nadie
ms).
Dirjase al directorio ./examples/ donde encontrar un archivo llamado create_tables.sql. (Si est utilizando un
servidor Windows preste especial atencin a 1.23 Estoy ejecutando MySQL en un equipo de 32 bits con Windows.
Cada vez que creo una nueva tabla tanto la tabla como sus columnas cambian a minsculas!).
Si ya tena el sistema congurado y actualiz a MySQL versin 4.1.2 o ms reciente, utilice
./examples/upgrade_tables_mysql_4_1_2+.sql y luego cree nuevas tablas importando
./examples/create_tables.sql.
Puede hacer que phpMyAdmin cree automticamente las tablas. Tenga en cuenta que se necesitan privilegios especia-
les (de administrador) para crear la base de datos y las tablas, y que el script puede necesitar algunas modicaciones
dependiendo del nombre de la base de datos.
Despus de importar el archivo examples/create_tables.sql, debera especicar los nombres de las tablas
en su archivo config.inc.php. Las directivas necesarias estn disponibles en Conguracin. Tambin necesitar
tener un usuario de control con los permisos necesarios para acceder a dichas tablas (revise la seccin Uso de los
mtodos de autenticacin ms abajo).
3.5 Actualizando desde una versin ms antigua
Copie directamente el archivo config.inc.php de su antigua instalacin en la nueva recin descomprimida.
Los archivos de conguracin antiguos pueden necesitar algunas modicaciones ya que algunas opciones pue-
den haber sido cambiadas o eliminadas. Por motivos de compatibilidad con PHP 6, elimine todas las sentencias
set_magic_quotes_runtime(0); que pueda encontrar alrededor del nal de su archivo de conguracin.
10 Captulo 3. Instalacin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
No copie libraries/config.default.php sobreescribiendo config.inc.php ya que el archivo con la
conguracin predeterminada es especco a cada versin.
Si ha actualizado el servidor MySQL a una versin 5.x o ms reciente desde una versin anterior a la
4.1.2 y est utilizando almacenamiento de conguracin phpMyAdmin, debera ejecutar el script SQL en
examples/upgrade_tables_mysql_4_1_2+.sql.
3.6 Uso de los mtodos de autenticacin
Los modos de autenticacin HTTP y por cookie son recomendados en un entorno multiusuario donde desee permitir
a los usuarios acceso a sus propias bases de datos pero no a la de los dems. Sin embargo, sepa que MS Internet
Explorer parece tener muchos errores con cookies al menos hasta la versin 6. An en un ** entorno con slo un
usuario**, puede preferir utilizar autenticacin HTTP o por cookie para que su nombre de usuario y contrasea no
aparezcan en texto plano en el archivo de conguracin.
Los mtodos de autenticacin HTTP y por cookie son ms seguros: la informacin de inicio de se-
sin de MySQL no est expuesta en el archivo de conguracin de phpMyAdmin (a excepcin de
$cfg[Servers][$i][controluser]). Sin embargo, tenga en cuenta que la contrasea es transmitida
en texto plano a menos que utilice el protocolo HTTPS. Utilizando autenticacin por cookie, la contrasea es almace-
nada encriptada con el algoritmo blowsh en una cookie temporal.
En los modos HTTP y cookie phpMyAdmin necesita un usuario de control que slo tenga privilegios para
SELECT en las tablas mysql.user (todas las columnas excepto Password), mysql.db (todas las columnas),
mysql.host (todas las columnas) y mysql.tables_priv (todas las columnas excepto Grantor y Timestamp).
Debe especicar los detalles para el usuario de control en el archivo config.inc.php bajo las conguraciones
$cfg[Servers][$i][controluser] y $cfg[Servers][$i][controlpass]. El ejemplo
a continuacin asume que desea utilizar pma como usuario de control y pmapass como contrasea para el mismo,
pero esto es slo un ejemplo: utilice algo distinto en su archivo!. Introduzca estas sentencias en la ventana de
consultas SQL o el cliente de lnea de rdenes mysql. Debe reemplazar localhost con el nombre del servidor web
si no es el mismo que el del servidor MySQL.
GRANT USAGE ON mysql.
*
TO pma@localhost IDENTIFIED BY pmapass;
GRANT SELECT (
Host, User, Select_priv, Insert_priv, Update_priv, Delete_priv,
Create_priv, Drop_priv, Reload_priv, Shutdown_priv, Process_priv,
File_priv, Grant_priv, References_priv, Index_priv, Alter_priv,
Show_db_priv, Super_priv, Create_tmp_table_priv, Lock_tables_priv,
Execute_priv, Repl_slave_priv, Repl_client_priv
) ON mysql.user TO pma@localhost;
GRANT SELECT ON mysql.db TO pma@localhost;
GRANT SELECT ON mysql.host TO pma@localhost;
GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv)
ON mysql.tables_priv TO pma@localhost;
Si desea disponer de las nuevas funcionalidades de relaciones y marcadores:
GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.
*
TO pma@localhost;
(para esto obviamente necesitar congurar Almacenamiento de conguracin para phpMyAdmin).
As, se le debe proporcionar a cada uno de los usuarios reales un conjunto de permisos en un grupo de bases de datos
particular. Normalmente, no debera dar privilegios globales a un usuario normal a no ser que entienda el impacto de
dichos permisos (si por ejemplo, desea crear un superusuario). Por ejemplo, para asigarne al usuario real_user todos
los privilegios en la base de datos user_base:
GRANT ALL PRIVILEGES ON user_base.
*
TO real_user@localhost IDENTIFIED BY real_password;
3.6. Uso de los mtodos de autenticacin 11
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Lo que el usuario pueda hacer a continuacin es controlado exclusivamente por el sistema de administracin de usua-
rios de MySQL. Con los mtodos de autenticacin HTTP o por cookie, no es necesario rellenar los campos usua-
rio/contrasea en $cfg[Servers].
3.6.1 Modo de autenticacin HTTP
Emplea el mtodo bsico de autenticacin HTTP y le permite acceder como cualquier usuario vlido de MySQL.
Es compatible con la mayora de las conguraciones PHP. Para IIS (ISAPI) usando CGI PHP revise 1.32 Puedo
utilizar autenticacin HTTP con IIS?. Para utilizar CGI de Apache, revise 1.35 Puedo utilizar autenticacin
HTTP con Apache CGI?.
Revise tambin 4.4 phpMyAdmin siempre devuelve Acceso denegado al utilizar autenticacin HTTP. acerca
de cmo no usar el mecanismo .htaccess en conjunto con el modo de autenticacin HTTP.
3.6.2 Mtodo de autenticacin por cookie
Puede utilizar este mtodo como reemplazo de la autenticacin HTTP (por ejemplo, si est ejecutando IIS).
Obviamente, el usuario debe de activar las cookies, aunque ya es un requisito para todos los mtodos de auten-
ticacin.
Mediante este modo, el usuario puede salir completamente de phpMyAdmin y despus volver a entrar con el
mismo nombre de usuario.
Si desea permitir que los usuarios ingresen un nombre de equipo al que conectarse (en lugar de slo aquellos
servidores congurados en config.inc.php), revise la directiva $cfg[AllowArbitraryServer].
Tal y como se menciona en la seccin Requisitos, aunque no es obligatoria, emplear la extensin mcrypt
acelerar el acceso considerablemente.
3.6.3 Mtodo de autenticacin signon
Este modo es una manera til de usar las credenciales de otra aplicacin para entrar en phpMyAdmin.
La otra aplicacin tiene que almacenar la informacin de registro en los datos de la sesin.
Ver tambin:
$cfg[Servers][$i][auth_type], $cfg[Servers][$i][SignonSession],
$cfg[Servers][$i][SignonScript], $cfg[Servers][$i][SignonURL]
3.6.4 Mtodo de autenticacin cong
Este mtodo a veces es el ms inseguro dado que necesita que se rellenen los campos
$cfg[Servers][$i][user] y $cfg[Servers][$i][password] (y, por ello, cual-
quiera que pueda leer el archivo config.inc.php podr leer su nombre de usuario y contrasea).
En la seccin ISPs, instalaciones multiusuario, hay una resea que explica cmo proteger su archivo de con-
guracin.
Para incrementar la seguridad en este modo, debera considerar el uso de las directivas
de autenticacin del servidor $cfg[Servers][$i][AllowDeny][order] y
$cfg[Servers][$i][AllowDeny][rules].
12 Captulo 3. Instalacin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
A diferencia de los mtodos cookie y HTTP, no pide al usuario que se autentique al cargar la pgina
phpMyAdmin por primera vez. Esto es as por diseo pero podra permitir a cualquiera entrar en su instalacin.
Debera emplear un mtodo de restriccin, como un archivo .htaccess con la directiva HTTP-AUTH o impedir
las consultas HTTP entrantes a su router o rewall (ambos mtodos estn ms all de la temtica de este manual,
pero son fcilmente localizables con Google).
3.6.5 Modo de autenticacin Swekey
Swekey es una llave de autenticacin USB de bajo costo que puede ser utilizada en aplicaciones web. Cuando se
activa la autenticacin Swekey, phpMyAdmin pide insertar la Swekey del usuario antes de entrar a la pgina de inicio
de sesin (actualmente slo es compatible con el mtodo de autenticacin por cookie). La autenticacin Swekey est
desactivada de forma predeterminada. Para activarla, agregue la siguiente lnea a config.inc.php:
$cfg[Servers][$i][auth_swekey_config] = /etc/swekey.conf;
Luego tiene que crear el archivo swekey.conf que asociar cada usuario con el IDde su llave Swekey. Es importante
mantener el archivo fuera del directorio raz de los documentos del servidor web (en el ejemplo se encuentra en /etc).
Hay un archivo documentado de ejemplo en el directorio examples. Puede utilizarlo con la informacin de sus
usuarios si lo desea. Si desea adquirir una llave Swekey, utilice http://phpmyadmin.net/auth_key ya que este enlace
ayuda nancieramente a phpMyAdmin.
Ver tambin:
$cfg[Servers][$i][auth_swekey_config]
3.7 Asegurando su instalacin de phpMyAdmin
El equipo de phpMyAdmin trabaja muy duro intentando hacer segura la aplicacin, sin embargo siempre puede hacer
su instalacin ms segura:
elimine el directorio setup de phpMyAdmin, probablemente no lo utilice luego de la conguracin inicial
elija el mtodo de autenticacin apropiado - Mtodo de autenticacin por cookie es probablemente la mejor
opcin para servidores compartidos
si no desea que todos los usuarios MySQL accedan a phpMyAdmin, puede utilizar
$cfg[Servers][$i][AllowDeny][rules] para limitarlos
considere esconder phpMyAdmin detrs de un proxy de autenticacin para que los usuarios necesiten algo ms
que las credenciales MySQL para iniciar sesin
Si teme a ataques automticos, tiene la opcin de actuvar Captcha con
$cfg[CaptchaLoginPublicKey] y $cfg[CaptchaLoginPrivateKey].
3.7. Asegurando su instalacin de phpMyAdmin 13
phpMyAdmin Documentation, Publicacin 4.2.0-dev
14 Captulo 3. Instalacin
CAPTULO 4
Conguracin
Casi todos los datos de conguracin se encuentran en config.inc.php. Si no existiese este archivo, revise la
seccin Instalacin para crear uno. Este archivo slo necesita incluir los parmetros que desea modicar con respecto
a los valores predeterminados, presentes en libraries/config.default.php.
Si falta una directiva de su archivo, simplemente puede agregar otra lnea la mismo. Este archivo es para sobreescribir
los valores predeterminados; si desea utilizar el valor predeterminado, no es necesario que agregue una lnea aqu.
Los parmetros relacionados con el diseo (como los colores) estn en
themes/NOMBRE_DEL_TEMA/layout.inc.php. Tambin se podran crear los archivos
config.footer.inc.php y config.header.inc.php para incluir cdigo especco al principio o
al nal de cada pgina.
Nota: Algunas distribuciones (por ejemplo, Debian o Ubuntu) almacenan el archivo config.inc.php en
/etc/phpmyadmin en lugar de junto con el cdigo fuente de phpMyAdmin.
Advertencia: Los usuarios de Mac deben saber que si utilizan una versin anterior a Mac OS X, PHP no se
comporta bien con los caracteres de nal de lnea de Mac (r). Asegrese que emplea la opcin que permite
usar los caracteres de nal de lnea de *nix (n) en su editor de texto antes de guardar cualquier script que haya
modicado.
4.1 Conguraciones bsicas
$cfg[PmaAbsoluteUri]
Type cadena
Default value
Cogure aqu la URL (con la ruta completa) al directorio de instalacin phpMyAdmin. Por ejemplo:
http://www.example.net/ruta_a_la_carpeta_de_phpMyAdmin/. Note tambin que las URL
en la mayora de los servidores son sensibles a maysculas y minsculas. No olvide la barra al nal.
Comenzando con la versin 2.3.0, es recomendable dejar este valor en blanco. En la mayora de los casos phpM-
yAdmin detecta automticamente la conguracin apropiada. Los usuarios que utilicen redireccionamiento de
puertos necesitarn congurar $cfg[PmaAbsoluteUri] (ms informacin).
Una buena prueba es visualizar una tabla, editar una la y guardar el cambio. Debera generar un mensaje de
error si phpMyAdmin tiene problemas para detectar los valores apropiados automticamente. Si se obtiene un
error diciendo que dicho valor es necesario o si falla el cdigo de deteccin automtica de la ruta reporte un
error en nuestro sistema de seguimiento de errores para poder mejorar el cdigo.
15
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Ver tambin:
1.40 La autenticacin por cookie no funciona al acceder a phpMyAdmin mediante un proxy reverso Apache.
$cfg[PmaNoRelation_DisableWarning]
Type booleano
Default value false
Comenzando con la versin 2.3.0 phpMyAdmin ofrece muchas funcionalidades para trabajar con tablas maes-
tro/esclavo (revise $cfg[Servers][$i][pmadb]).
Si ha tratado de congurarlo pero no le funciona, revise la pgina Estructura de cualquier base de datos en la
que quiera emplearlo. Encontrar un enlace que analizar por qu dichas caractersticas se han desabilitado.
Si no quiere utilizar dichas caractersticas, congure esta variable como true para que no vuelva a aparecer
este mensaje.
$cfg[SuhosinDisableWarning]
Type booleano
Default value false
Mostrar advertencia en la pgina principal si se detecta Suhosin.
Puede congurar este parmetro como true para eliminar este mensaje.
$cfg[McryptDisableWarning]
Type booleano
Default value false
Desactivar advertencia predeterminada que se muestra si no se encuentra mcrypt para la cookie de autenticacin.
Puede congurar este parmetro como true para eliminar este mensaje.
$cfg[ServerLibraryDifference_DisableWarning]
Type booleano
Default value false
Aparecer un aviso en la pgina principal si la versin de la biblioteca MySQL en el cliente es diferente a la
versin en el servidor.
Puede congurar este parmetro como true para eliminar este mensaje.
$cfg[ReservedWordDisableWarning]
Type booleano
Default value false
Se muestra esta advertencia en la pgina Estructura de una tabla si el nombre de una o ms columnas coincida
con palabras que estn reservadas en MySQL.
Si desea apagar esta advertencia, puede denirla como true y ya no se mostrar una advertencia.
$cfg[TranslationWarningThreshold]
Type integer
Default value 80
Mostrar advertencias sobre traducciones incompletas bajo cierto nivel.
$cfg[SendErrorReports]
16 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Type cadena
Default value ask
Dene el comportamiento predeterminado para el reporte de errores JavaScript.
Cuando se detecte un error en la ejecucin de JavaScript se podra enviar un reporte de error al equipo de
phpMyAdmin si el usuario lo conrma.
La conguracin predeterminada (ask) le preguntar al usuario cada vez que encuentre un error que reportar.
Sin embargo, puede denir este parmetro como always (siempre) para enviar reportes de error sin pedir
conguracin o como never (nunca) para no enviar informes de error.
Esta directiva est disponible tanto en el archivo de conguracin como en las preferencias de usuario. Si la
persona a cargo de una instalacin multiusuario preere desactivar esta funcionalidad para todos los usuarios,
debe utilizar el valor never y SendErrorReports debe ser uno de los elementos del array de la
directiva $cfg[UserprefsDisallow].
$cfg[AllowThirdPartyFraming]
Type booleano
Default value false
Congurarlo como true incluir phpMyAdmin dentro de un marco y es un riesgo potencial de seguridad puesto
que permite los ataques por scripting o secuestro del cursor a travs de los marcos.
4.2 Conguraciones de conexin al servidor
$cfg[Servers]
Type array
Default value un array de servidores con conguraciones enumeradas a continuacin
Desde la versin 1.4.2, phpMyAdmin es compatible con la administracin de mltiples servidores de MySQL.
Por lo tanto, se agreg un array $cfg[Servers] que contiene la informacin de inicio de sesin para
los diferentes servidores. El primer $cfg[Servers][$i][host] contiene el nombre de sistema del
primer servidor, el segundo $cfg[Servers][$i][host] contiene el nombre de sistema del segundo
servidor, etc. En libraries/config.default.php hay slo una seccin para la denicin de servidores;
sin embargo se pueden agregar tantas como sean necesarias en config.inc.php; copie ese bloque o las
partes necesarias (no hace falta denir todas las conguraciones, slo aquellas que necesitan cambiar).
Nota: El array $cfg[Servers] comienza con $cfg[Servers][1]. No utilice $cfg[Servers][0]. Si desea
ms de un servidor, copie la seccin a continuacin (aumentando $i) varias veces. No necesita denir todo el
array del servidor, slo los valores que desea cambiar.
$cfg[Servers][$i][host]
Type cadena
Default value localhost
El nombre de sistema o direccin IP de su servidor MySQL $i-simo. Por ejemplo: localhost.
Los valores posibles son:
nombre de sistema, localhost o mydb.example.org por ejemplo
direccin IP, 127.0.0.1 o 192.168.10.1 por ejemplo
punto ., es decir: utilizar tuberas con nombre en sistemas Windows
4.2. Conguraciones de conexin al servidor 17
phpMyAdmin Documentation, Publicacin 4.2.0-dev
vaco - desactiva este servidor
Nota:
phpMyAdmin puede conectarse con servidores MySQL a los que slo se puede llegar con IPv6. Para co-
nectarse con un servidor MySQL utilizando IPv6, ingrese su direccin IPv6 en este campo.
$cfg[Servers][$i][port]
Type cadena
Default value
El nmero de puerto de su servidor $i-simo. El valor predeterminado (si est vaco) es 3306.
Nota: Si utiliza localhost como nombre de sistema, MySQL ignora este nmero de puerto y se conecta
mediante zcalo, por lo que si se desea conectar a un puerto diferente al predeterminado utilice 127.0.0.1 o
el nombre de sistema real en $cfg[Servers][$i][host].
$cfg[Servers][$i][socket]
Type cadena
Default value
Para determinar el zcalo correcto revise la conguracin MySQL o utilice el cliente de lnea de rdenes mysql,
ejecute la orden status. Entre la informacin resultante mostrada estar el zcalo a utilizar.
$cfg[Servers][$i][ssl]
Type booleano
Default value false
Si habilitar SSL para la conexin entre phpMyAdmin y el servidor MySQL o no.
Cuando utiliza la extensin mysql, ninguna de las conguraciones ssl... tendrn efecto.
Recomendamos fuertemente que utilice la extensin mysqli cuando utilice esta opcin.
$cfg[Servers][$i][ssl_key]
Type cadena
Default value NULL
Ruta al archivo con la llave a utilizar para el SSL de la conexin con el servidor MySQL.
Por ejemplo:
$cfg[Servers][$i][ssl_key] = /etc/mysql/server-key.pem;
$cfg[Servers][$i][ssl_cert]
Type cadena
Default value NULL
Ruta al archivo con el certicado a utilizar para el SSL de la conexin con el servidor MySQL.
$cfg[Servers][$i][ssl_ca]
Type cadena
Default value NULL
Ruta al archivo de la CA a utilizar para el SSL de la conexin al servidor MySQL.
18 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
$cfg[Servers][$i][ssl_ca_path]
Type cadena
Default value NULL
Directorio que contiene los certicados CA SSL en formato PEM.
$cfg[Servers][$i][ssl_ciphers]
Type cadena
Default value NULL
Lista de algoritmos de cifrado permitidos para el SSL de la conexin al servidor MySQL.
$cfg[Servers][$i][connect_type]
Type cadena
Default value tcp
El tipo de conexin a usar con el servidor MySQL. Las opciones son socket y tcp. El valor predeter-
minado es tcp ya que es casi seguro que estar disponible en todos los servidores MySQL mientras que los
zcalos no son compatibles con algunas plataformas.
$cfg[Servers][$i][compress]
Type booleano
Default value false
Si utilizar un protocolo comprimido para la conexin al servidor MySQL o no (experimental).
$cfg[Servers][$i][controlhost]
Type cadena
Default value
Permite utilizar un servidor alternativo para guardar los datos de almacenamiento de conguracin.
$cfg[Servers][$i][controlport]
Type cadena
Default value
Permite utilizar un puerto alternativo para conectarse al servidor que contiene el almacenamiento de congura-
cin.
$cfg[Servers][$i][controluser]
Type cadena
Default value
$cfg[Servers][$i][controlpass]
Type cadena
Default value
Esta cuenta especial es utilizada para 2 propsitos particulares: hacer posibles todas las funcionalidades re-
lacionales (revise $cfg[Servers][$i][pmadb]) y, en los servidores ejecutando con la opcin
--skip-show-database, y para posibilitar una instalacin multi-usuario (modo de autenticacin HTTP
o cookie).
4.2. Conguraciones de conexin al servidor 19
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Al utilizar los modos de autenticacin HTTP o cookie (o el modo de autenticacin cong desde phpMyAd-
min 2.2.1) necesita proveer los detalles de una cuenta MySQL que tenga privilegios SELECT en las tablas
mysql.user (todas las columnas excepto Password), mysql.db (todas las columnas) y mysql.tables_priv (todas
las columnas excepto Grantor y Timestamp). Esta cuenta es usada para vericar qu bases de datos va a ver
el usuario al iniciar sesin.
Distinto en la versin 2.2.5: se llamaban stduser y stdpass
Ver tambin:
Instalacin, Uso de los mtodos de autenticacin
$cfg[Servers][$i][auth_type]
Type cadena
Default value cookie
Si se debe utilizar autenticacin por conguracin, cookie, HTTP o signon para este servidor.
Autenticacin por conguracin ($auth_type = config) es la forma simple y antigua: el nombre
de usuario y contrasea estn denidos en config.inc.php.
Autenticacin por cookie ($auth_type = cookie), introducido en la versin 2.2.3 permite ini-
ciar sesin como cualquier usuario MySQL vlido con la ayuda de cookies. El nombre de usuario y
la contrasea sern almacenados en cookies durante la sesin y la contrasea ser eliminada al na-
lizar. Esto tambin puede permitir iniciar sesin en un servidor cualquiera si est habilitada la opcin
$cfg[AllowArbitraryServer].
Autenticacin http (llamada conguracin avanzada en versiones anteriores) ($auth_type =
http) introducida en la versin 1.3.0 permite acceder como cualquier usuario MySQL vlido mediante
HTTP-Auth.
Autenticacin signon ($auth_type = signon), introducida en la versin 2.10.0, per-
mite iniciar sesin desde datos preparados en la sesin PHP o utilizando un script PHP. Esto
es til para implementar un inicio de sesin nico desde otra aplicacin. Un modelo de cmo
sembrar los datos en la sesin se puede encontrar en el ejemplo: examples/signon.php.
Tambin existe un ejemplo alternativo utilizando OpenID: examples/openid.php
y ejemplos para soluciones basadas en scripts: examples/signon-script.php.
Necesita congurar $cfg[Servers][$i][SignonSession] o
$cfg[Servers][$i][SignonScript] y $cfg[Servers][$i][SignonURL]
para utilizar este mtodo de autenticacin.
Ver tambin:
Uso de los mtodos de autenticacin
$cfg[Servers][$i][auth_http_realm]
Type cadena
Default value
Al utilizar auth_type = http, este campo permite denir un dominio de autenticacin HTTP perso-
nalizado que ser mostrado al usuario. Si no est denido explcitamente en la conguracin se uti-
lizar una cadena combinando phpMyAdmin y o bien $cfg[Servers][$i][verbose] or
$cfg[Servers][$i][host].
$cfg[Servers][$i][auth_swekey_config]
Type cadena
Default value
20 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
El nombre del archivo que contiene los IDs y nombres de usuario Modo de autenticacin Swekey para auten-
ticacin por hardware. Deje vaco para desactivar esta funcionalidad.
$cfg[Servers][$i][user]
Type cadena
Default value root
$cfg[Servers][$i][password]
Type cadena
Default value
Al utilizar $cfg[Servers][$i][auth_type] congurado como cong, este es el par de nombre
de usuario y contrasea que se utilizarn para conectarse al servidor MySQL. Este par de nombre de usuario
y contrasea no son necesarios cuando se utiliza el modo de autenticacin HTTP o por cookie y deben dejarse
vacos.
$cfg[Servers][$i][nopassword]
Type booleano
Default value false
Permitir el intento de inicio de sesin sin contrasea cuando falla un intento de inicio de sesin con contrasea.
Esto puede ser utilizado en conjunto con autenticacin http; cuando la autenticacin es realizada de otra manera y
phpMyAdmin obtiene el nombre de usuario de la autenticacin y utiliza la una contrasea vaca para conectarse
a MySQL. An se intenta iniciar sesin con contrasea primero, pero como respaldo se intenta el mtodo sin
contrasea.
$cfg[Servers][$i][only_db]
Type cadena o array
Default value
Denido como el (o array de) nombres de base de datos; slo esta(s) base(s) de datos ser(n) mostradas al
usuario. Desde phpMyAdmin 2.2.1 estos nombres de bases de datos pueden contener caracteres comodn (_
y %): si se desea utilizar instancias literales de estos caracteres, deber anteponerles el caracter de escape
(por ejemplo, utilice mi\_bdd en lugar de mi_bdd).
Esta conguracin es una forma eciente de disminuir la carga del servidor ya que ste no necesita enviar
pedidos a MySQL para crear la lista de bases de datos disponibles. Pero no reemplaza las reglas de privilegios
del servidor de base de datos MySQL. Si est congurado, slo estas bases de datos van a ser mostradas pero
otras bases de datos an pueden ser utilizadas.
Un ejemplo utilizando ms de una base de datos:
$cfg[Servers][$i][only_db] = array(db1, db2);
Distinto en la versin 4.0.0: Versiones anteriores permitan especicar el orden en el que se mostraran los
nombres de bases de datos con esta directiva.
$cfg[Servers][$i][hide_db]
Type cadena
Default value
Expresiones regulares para ocultar algunas bases de datos de usuarios sin privilegios. Slo evita que sean lis-
tadas, pero el usuario podr an acceder a ellas (usando por ejemplo el rea de consulta SQL). Para limitar el
acceso, utilice el sistema de privilegios de MySQL. Por ejemplo, para esconder todas las bases de datos que
comiencen con a, utilice
4.2. Conguraciones de conexin al servidor 21
phpMyAdmin Documentation, Publicacin 4.2.0-dev
$cfg[Servers][$i][hide_db] = ^a;
y para ocultar tanto db1 como db2 utilice
$cfg[Servers][$i][hide_db] = ^(db1|db2)$;
Puede encontrar ms informacin sobre expresiones regulares en el manual de referencia de PHP, en la seccin
sobre sintxis de patrones PCRE.
$cfg[Servers][$i][verbose]
Type cadena
Default value
Slo es til al utilizar phpMyAdmin con mltiples servidores MySQL. Si est congurado, esta cadena ser
mostrada en lugar del nombre del sistema en el men desplegable de la pgina principal. Puede ser til si
quieres mostrar ciertas bases de datos en tu sistema. Para autenticacin HTTP, todos los caracteres fuera del
conjunto US-ASCII sern eliminados.
$cfg[Servers][$i][pmadb]
Type cadena
Default value
El nombre de la base de datos contiene la conguracin de almacenamiento de phpMyAdmin.
Revise la seccin Almacenamiento de conguracin para phpMyAdmin en este documento para saber sobre las
ventajas de esta funcionalidad y para una forma fcil de crear esta base de datos y las tablas necesarias.
Si se es el nico usuario de esta instalacin de phpMyAdmin, se puede utilizar la base actual para al-
macenar estas tablas especiales; en este caso, slo agregue el nombre de la base de datos actual en
$cfg[Servers][$i][pmadb]. Para una instalacin multi-usuario, este parmetro debe ser la ba-
se de datos central que contiene el almacenamiento de conguracin phpMyAdmin.
$cfg[Servers][$i][bookmarktable]
Type cadena
Default value
Desde la versin 2.2.0 phpMyAdmin permite a los usuarios que guarden las consultas como favoritas. Esto es
til para consultas que se realizan a menudo. Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
introduzca el nombre de la tabla en $cfg[Servers][$i][bookmarktable]
$cfg[Servers][$i][relation]
Type cadena
Default value
Desde la versin 2.2.4 puedes describir, en una tabla especial relation, qu columna es una clave en otra tabla
(una clave fornea). phpMyAdmin normalmente usa esto para:
poder pulsar sobre los valores que apuntan a esta tabla externa al visualizar la tabla original;
mostrar un texto opcional con la columna a mostrar al visualizar la tabla original si se mueve el mouse
sobre una columna con una clave fornea (tambin utiliza la tabla table_info); (revise 6.7 Cmo puedo
utilizar la funcionalidad columna a mostrar?)
22 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
en el modo de edicin/insercin, mostrar una lista desplegable con las posibles claves forneas (se ver el
valor de la clave y la columna a mostrar) (revise 6.21 En el modo de edicin/insercin cmo puedo ver
una lista de posibles valores para una columna basado en una tabla fornea?)
muestra enlaces en la pgina de propiedades de la tabla para vericar integridad referencia (muestra las
clves forneas ausentes) para cada clave descripta;
en las consultas por ejemplo, crea joins automticamente (revise 6.6 Cmo puedo usar la tabla de rela-
ciones en consultas por ejemplo?)
permite obtener un esquema de la base de datos en PDF (tambin utiliza la tabla table_coords).
Las claves pueden sen numricas o alfabticas.
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
agrega el nombre de la tabla de relacin en $cfg[Servers][$i][relation]
ahora, como un usuario normal, abre phpMyAdmin, pulse en Estructura/Vista de relacin/ y elija las
claves forneas para cada una de las tablas en las que quiera utilizar esta funcionalidad.
Nota: En la versin actual master_db debe de ser igual a foreign_db. Estas columnas fueron agregadas
para futuro desarrollo de relaciones entre bases de datos.
$cfg[Servers][$i][table_info]
Type cadena
Default value
Desde la versin 2.3.0 se puede describir en una tabla especial table_info qu columna mostrar como texto
de ayuda al mover el cursor sobre la clave correspondiente. Esta variable de conguracin tendr el nombre de
esta tabla especial. Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
agregue el nombre de la tabla en $cfg[Servers][$i][table_info] (por ejemplo:
pma__table_info)
luego, para cada tabla en la que quiera utilizar esta funcionalidad, pulse en Estructura/Vista de rela-
cin/Elegir columna a mostrar para elegir la columna.
Ver tambin:
6.7 Cmo puedo utilizar la funcionalidad columna a mostrar?
$cfg[Servers][$i][table_coords]
Type cadena
Default value
$cfg[Servers][$i][pdf_pages]
Type cadena
Default value
Desde la versin 2.3.0 phpMyAdmin puede crear pginas PDF mostrando las relaciones entre sus tablas. Pa-
ra lograrlo, necesitas dos tablas: pdf_pages (con la informacin sobre las pginas PDF disponibles) y ta-
ble_coords (que contiene las coordenadas en las que se ubicar cada tabla en la salida del esquema en PDF).
Debe estar utilizando la funcionalidad relation.
Para permitir el uso de esta funcionalidad:
4.2. Conguraciones de conexin al servidor 23
phpMyAdmin Documentation, Publicacin 4.2.0-dev
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
congura los nombres de tabla apropiados en $cfg[Servers][$i][table_coords] y
$cfg[Servers][$i][pdf_pages]
Ver tambin:
6.8 Cmo puedo producir un esquema PDF de mi base de datos?.
$cfg[Servers][$i][column_info]
Type cadena
Default value
Esta seccin necesita una actualizacin de contentido! Desde la versin 2.3.0 puede almacenar comentarios que
describan cada columna de una tabla. Estos sern mostrados en la vista de impresin.
Desde la versin 2.5.0, los comentarios son tambin utilizados en la pginas de propiedades de la tabla y la vista
de navegacin de tablas, mostrndose como textos de ayuda sobre los nombres de las columnas (en la pgina de
propiedades) o embebidos en las cabeceras de la tabla en la vista de navegacin. Tambin pueden ser mostrados
al volcar la tabla. Revisa las directivas de conguracin ms adelante.
Tambin en la versin 2.5.0 hay un sistema de transformacin MIME basado en la estructura de las tablas
descriptas. Revise Transformaciones para ms informacin. Para utilizar el sistema de transformacin MI-
ME, la tabla column_info tiene que tener 3 nuevas columnas: mimetype, transformation y transfor-
mation_options.
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
dena el nombre de la tabla en $cfg[Servers][$i][column_info] (por ejemplo:
pma__column_info)
para actualizar su tabla column_comments anterior a la versin 2.5.0
utlice esto: y recuerde que la variable en config.inc.php cam-
bi su nombre de $cfg[Servers][$i][column_comments] a
$cfg[Servers][$i][column_info]
ALTER TABLE pma__column_comments
ADD mimetype VARCHAR( 255 ) NOT NULL,
ADD transformation VARCHAR( 255 ) NOT NULL,
ADD transformation_options VARCHAR( 255 ) NOT NULL;
$cfg[Servers][$i][history]
Type cadena
Default value
Desde la versin 2.5.0 puede almacenar el histrico SQL, todas las consultas introducidas manualmente en la
interfaz phpMyAdmin. Si no desea utilizar un histrico basado en tablas puedes utilizar un histrico basado en
JavaScript.
Al utilizarlo, los elementos del histrico son eliminados al cerrar la ventana. Utilizando
$cfg[QueryHistoryMax] puede especicar la mxima cantidad de elementos en el histrico. En
cada inicio de sesin esta lista es recortada a este mximo.
El histrico de consultas slo estar disponible si JavaScript est habilitado en el navegador.
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
24 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
congure el nombre de la tabla en $cfg[Servers][$i][history] (por ejemplo:
pma__history)
$cfg[Servers][$i][recent]
Type cadena
Default value
Desde la versin 3.5.0 se pueden mostrar las tablas recientemente utilizadas en el panel de navega-
cin. Facilita el saltar entre tablas directamente sin tener que seleccionar la base de datos y luego se-
leccionar la tabla. Utilizando $cfg[NumRecentTables] puede congurar la mxima cantidad de
tablas recientes a mostrar. Al seleccionar una tabla de la lista, saltar a la pgina especicada en
$cfg[NavigationTreeDefaultTabTable].
Sin congurar el almacenamiento an se pueden aprovechar las tablas recientemente utilizadas, pero stas des-
aparecern luego de nalizar sesin.
Para permitir el uso de esta funcionalidad de forma persistente:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
congure el nombre de la tabla $cfg[Servers][$i][recent] (por ejemplo pma__recent)
$cfg[Servers][$i][table_uiprefs]
Type cadena
Default value
Desde la versin 3.5.0 phpMyAdmin puede congurarse para recordar varias cosas en la visualizacin de tablas
(como la columna de ordenamiento $cfg[RememberSorting], el orden de las columnas y la visibilidad
de las mismas). Sin congurar el almacenamiento an se pueden utilizar estas funcionalidades pero sus valores
desaparecern al nalizar sesin.
Para permitir el uso de esta funcionalidad de forma persistente:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
agregue el nombre de la tabla en $cfg[Servers][$i][table_uiprefs] (por ejemplo
pma__table_uiprefs)
$cfg[Servers][$i][users]
Type cadena
Default value
$cfg[Servers][$i][usergroups]
Type cadena
Default value
Desde la versin 4.1.0 puede crear diferentes grupos de usuario con elementos de men asociados a los mismos.
Puede asignar usuarios a estos grupos y el usuario que inicie sesin slo ver los elementos del men congu-
rados en el grupo de usuarios al que pertenece. Para lograr esto necesita dos tablas usergroups (que almacena
los elementos del men permitidos para cada grupo) y users (que almacena los usuarios y su asignacin a los
grupos).
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
congure los nombres de tabla apropiados en $cfg[Servers][$i][users] (por ejemplo
pma__users) y $cfg[Servers][$i][usergroups] (por ejemplo pma__usergroups)
4.2. Conguraciones de conexin al servidor 25
phpMyAdmin Documentation, Publicacin 4.2.0-dev
$cfg[Servers][$i][navigationhiding]
Type cadena
Default value
Desde la versin 4.1.0 puede ocultar/mostrar elementos en el rbol de navegacin.
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
dena el nombre de la tabla en $cfg[Servers][$i][navigationhiding] (por ejemplo:
pma__navigationhiding)
$cfg[Servers][$i][tracking]
Type cadena
Default value
Desde la versin 3.3.x, hay un sistema de seguimiento disponible. Permite seguir toda consulta SQL ejecutada
por phpMyAdmin. El mecanismo puede registrar sententencias de denicin y sentencias de manipulacin de
datos. Luego de activarlo puede crear versiones de tablas.
La creacin de una versin tiene dos efectos:
phpMyAdmin guarda una captura de la tabla incluyendo estructura e ndices.
phpMyAdmin registrar todas las rdenes que cambien la estructura o los datos de la tabla y asociar
dichas rdenes con el nmero de versin.
Por supuesto puede visualizar los cambios seguidos. En la pgina de Seguimiento hay disponible un reporte para
toda versin. Para el reporte puede utilizar ltros; por ejemplo, puede obtener una lista de sentencias dentro de
un rango de datos. Cuando desee ltrar nombres de usuarios puede utilizar * para todos los nombres de usuarios
o una lista de nombres separados por ,. Adems, puedes exportar el reporte (ltrado) a un archivo o base de
datos temporal.
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
dena el nombre de la tabla en $cfg[Servers][$i][tracking] (por ejemplo:
pma__tracking)
$cfg[Servers][$i][tracking_version_auto_create]
Type booleano
Default value false
Si el mecanismo de seguimiento crea versiones para tablas y vistas automticamente o no.
En caso de estar activado y creas una tabla o vista con
CREATE TABLE ...
CREATE VIEW ...
y no existe una versin para la misma, el mecanismo crear una versin automticamente.
$cfg[Servers][$i][tracking_default_statements]
Type cadena
Default value CREATE TABLE,ALTER TABLE,DROP TABLE,RENAME TABLE,CREATE
INDEX,DROP INDEX,INSERT,UPDATE,DELETE,TRUNCATE,REPLACE,CREATE
26 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
VIEW,ALTER VIEW,DROP VIEW,CREATE DATABASE,ALTER DATABASE,DROP
DATABASE
Denir la lista de sentencias que la creacin automtica usa para nuevas versiones.
$cfg[Servers][$i][tracking_add_drop_view]
Type booleano
Default value true
Si se incluye la sentencia DROP VIEW IF EXISTS como primera lnea del registro al crear una vista.
$cfg[Servers][$i][tracking_add_drop_table]
Type booleano
Default value true
Si se incluye la sentencia DROP TABLE IF EXISTS como primera lnea del registro al crear una tabla.
$cfg[Servers][$i][tracking_add_drop_database]
Type booleano
Default value true
Si se incluye la sentencia DROP DATABASE IF EXISTS como primera lnea del registro al crear una base de
datos o no.
$cfg[Servers][$i][userconfig]
Type cadena
Default value
Desde la versin 3.4.x phpMyAdmin permite que los usuarios conguren sus preferencias por s mismos y las
almacena en la base de datos.
Si no se permite alamacenar preferencias en $cfg[Servers][$i][pmadb] los usuarios an pue-
den personalizar phpMyAdmin, pero sus conguraciones sern almacenadas en el almacenamiento local del
navegador o, en caso que no est disponible, hasta el nal de la sesin.
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
dena el nombre de la tabla en $cfg[Servers][$i][userconfig]
$cfg[Servers][$i][designer_coords]
Type cadena
Default value
Desde la versin 2.10.0, una interfaz de diseo est disponible que permite manegar relaciones visualmente.
Para permitir el uso de esta funcionalidad:
congure $cfg[Servers][$i][pmadb] y el almacenamiento de conguracin phpMyAdmin
dena el nombre de la tabla en $cfg[Servers][$i][designer_coords] (por ejemplo:
pma__designer_coords)
$cfg[Servers][$i][MaxTableUiprefs]
Type integer
Default value 100
4.2. Conguraciones de conexin al servidor 27
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Cantidad mxima de las almacenadas en la tabla $cfg[Servers][$i][table_uiprefs].
Cuando se elimina o cambia el nombre de una tabla, $cfg[Servers][$i][table_uiprefs] pue-
de llegar a contener datos invlidos (haciendo referencia a tablas que ya no existen). Slo se mantendrn esta
cantidad de las la ms nuevas en $cfg[Servers][$i][table_uiprefs] y las las ms antiguas
sern borradas automticamente.
$cfg[Servers][$i][AllowRoot]
Type booleano
Default value true
Si permitir acceso como root o no. Esto es slo un atajo para
$cfg[Servers][$i][AllowDeny][rules] a continuacin.
$cfg[Servers][$i][AllowNoPassword]
Type booleano
Default value false
Si se permiten inicios de sesin sin contrasea o no. El valor predeterminado es false para prevenir accesos
involuntarios a un servidor MySQL al que le dejaron una contrasea vaca para root o en el que existe un usuario
annimo (en blanco).
$cfg[Servers][$i][AllowDeny][order]
Type cadena
Default value
Si el orden de las reglas est vaco, entonces la autorizacin IP estar desactivada.
Si el orden de las reglas es deny,allow entonces el sistema aplica todas las reglas de negacin y luego
las de autorizacin. El valor predeterminado es permitir el acceso. Se le permitir acceso al servidor a cualquier
cliente que no coincida con una orden de denegacin o que coincida con una orden de autorizacin.
Si el orden de las reglas es allow,deny entonces el sistema aplica todas las reglas de autorizacin y luego
las reglas de negacin. El valor predeterminado es denegar el acceso. No se le permitir el acceso a cualquier
cliente que no coincida con una regla de autorizacin o que coincida con una regla de negacin.
Si el orden de las reglas es explicit la autorizacin es similar a cuando es deny,allow, con la restriccin
adicional que la combinacin antrin/nombre de usuario tiene que estar includo en las reglas allow y no
tiene que aparecer en las reglas deny. Este es el mtodo ms seguro de utilizar las reglas de Allow/Deny y est
disponible en Apache especicando reglas de autorizacin y negacin sin denir un orden.
Revise $cfg[TrustedProxies] para detectar direcciones IPs detrs de proxies.
$cfg[Servers][$i][AllowDeny][rules]
Type array de cadenas
Default value array()
El formato general de las reglas es como sigue:
<allow | deny> <username> [from] <ipmask>
Si desea incluir todos los usuarios, es posible utilizar % como comodn en el campo de username.
Hay una serie de atajos que pueden utilizarse en el campo ipmask tambin (note que aquellos que contengan
SERVER_ADDRESS pueden no estar disponibles en todos los servidores web):
28 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
all -> 0.0.0.0/0
localhost -> 127.0.0.1/8
localnetA -> SERVER_ADDRESS/8
localnetB -> SERVER_ADDRESS/16
localnetC -> SERVER_ADDRESS/24
Tener una lista de reglas vacas es equivalente a utilizar allow% from all si el orden de las reglas
est congurado como deny,allow o equivale a deny% from all si el orden de las reglas es
allow,deny o explicit.
Para el sistema de coincidencias direccin IP, las siguientes funcionan:
xxx.xxx.xxx.xxx (una direccin IP exacta)
xxx.xxx.xxx.[yyy-zzz] (un rango de direccin IP)
xxx.xxx.xxx.xxx/nn (direcciones IP de tipo CIDR - Classless Inter-Domain Routing)
Pero las siguientes no funcionan:
xxx.xxx.xxx.xx[yyy-zzz] (rango parcial de direcciones IP)
Para direcciones IPv6, las siguientes funcionan:
xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx (una direccin IPv6 exacta)
xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:[yyyy-zzzz] (un rango de direcciones IPv6)
xxxx:xxxx:xxxx:xxxx/nn (direcciones IPv6 de tipo CIDR - Classless Inter-Domain Routing)
Pero las siguientes no funcionan:
xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xx[yyy-zzz] (rango parcial de direcciones IPv6)
$cfg[Servers][$i][SignonScript]
Type cadena
Default value
Nombre del script PHP a ser cargado y ejecutado para obtener credenciales de inicio de sesin. Este es un
enfoque alternativo para un inicio de sesin nico basado en sesiones. El script necesita proveer una funcin
get_login_credentials que devuelva una lista de nombres de usuarios y contraseas, aceptando un slo
parmetro: el nombre de usuario actual (puede estar vaco). Revise examples/signon-script.php para
ver un ejemplo.
$cfg[Servers][$i][SignonSession]
Type cadena
Default value
El nombre de la sesin a utilizar para el mtodo de autenticacin signon. Debera de utilizar algo distinto a
phpMyAdmin ya que ese es el nombre de sesin que phpMyAdmin utiliza internamente. Slo tiene efecto si
no est congurado $cfg[Servers][$i][SignonScript].
$cfg[Servers][$i][SignonURL]
Type cadena
Default value
URL donde redirigir al usuario para iniciar sesin en el mtodo de autenticacin signon. Debe ser una URL
absoluta incluyendo el protocolo.
$cfg[Servers][$i][LogoutURL]
4.2. Conguraciones de conexin al servidor 29
phpMyAdmin Documentation, Publicacin 4.2.0-dev
Type cadena
Default value
URL donde el usuario ser redirigido luego de nalizar sesin (no afecta el mtodo de autenticacin cong).
Debe ser una URL absoluta incluyendo el protocolo.
$cfg[Servers][$i][StatusCacheDatabases]
Type array de cadenas
Default value array()
Activa la cach de la salidad de TABLE STATUS para bases de datos especcas en este servi-
dor (en algunos casos TABLE STATUS pueder ser muy lento). Se utiliza APC (si est disponible
la extensin PHP, de lo contrario esta conguracin es ignorada sin aviso). Debe congurar tambin
$cfg[Servers][$i][StatusCacheLifetime].
$cfg[Servers][$i][StatusCacheLifetime]
Type integer
Default value 0
El tiempo de vida en segundos de la cach de TABLE STATUS si se utiliza
$cfg[Servers][$i][StatusCacheDatabases].
4.3 Conguraciones genricas
$cfg[ServerDefault]
Type integer
Default value 1
Si tiene ms de un servidor congurado, puede denir $cfg[ServerDefault] como cualquiera de ellos
para conectarse automticamente a ese servidor al iniciar phpMyAdmin o denirlo como 0 para proveer una
lista de servidores sin iniciar sesin.
Si slo tiene un servidor congurado, $cfg[ServerDefault] TIENE que estar denido como ese ser-
vidor.
$cfg[VersionCheck]
Type booleano
Default value true
Activa el chequeo para las ltimas versiones utilizando javascript en la pgina principal de phpMyAdmin.
Nota: Esta conguracin puede ser ajustada por su proveedor.
$cfg[ProxyUrl]
Type cadena
Default value
La URL del proxy a utilizar cuando phpMyAdmin necesite acceder a la red externa; por ejemplo, para obtener
informacin sobre la ltima versin o enviar reportes de error. Lo necesitar si el servidor en el que est instalado
phpMyAdmin no tiene acceso directo a internet. El formato es: servidor:puerto
30 Captulo 4. Conguracin
phpMyAdmin Documentation, Publicacin 4.2.0-dev
$cfg[ProxyUser]
Type cadena
Default value
El nombre de usuario para autenticar con el proxy. De forma predeterminada, no se realiza autenticacin. Si
provee un nombre de usuario, se realizar una autenticacin bsica. Actualmente no se posee compatibilidad
con otros tipos de autenticacin.
$cfg[ProxyPass]
Type cadena
Default value