phpmyadmin.md

phpMyAdmin

Nota: Las palabras en mayúsculas deben ser reemplazas por los valores adecuados en cada caso

Instalación desde cero

Obtener la última versión

emerge -av phpmyadmin

Averigual el número de versión

webapp-config --lui

Instalar el vhost

Por ejemplo para instalarlo dentro del vhost example.com en la carpeta phpMyAdmin (ruta absoluta /var/www/example.com/htdocs/phpMyAdmin/)

webapp-config -I -h example.com -d phpMyAdmin phpmyadmin VERSION_DEL_PASO_ANTERIOR

Asegurando la instalación

Si instalaste con la USE="setup" borra el directorio setup.

Configura tu servidor web para que no se pueda acceder al directorio libraries. Si usas Apache se incluye un archivo .htaccess pero debes asegurarte de que Apache está configurado para que dicho archivo tenga efecto. Algo así debería bastar

<Directory /var/www/example.com/htdocs/phpMyAdmin/libraries>
	AllowOverride Limit
</Directory>

Si usas nginx

location ~ /phpMyAdmin/libraries) {
	deny all;
	return 404;
}

Crear el archivo de configuración

Creamos el fichero /var/www/example.com/htdocs/phpMyAdmin/config.inc.php con el siguiente contenido:

<?php

$cfg['blowfish_secret'] = 'PONER_AQUI_UNA_FRASE_ALEATORIA_DE_HASTA_46_CARACTERES_QUE_SE_USARA_PARA_CIFRAR_LA_CONTRASENA_DE_LA_COOKIE';

// F.I.R.S.T. S.E.R.V.E.R. (conectar via socket)
$cfg['Servers'][1] = [

	// Connection/Authentication
	'verbose' => 'Servidor example.com',
	'auth_type' => 'cookie',
	'connect_type' => 'socket',
	'hide_db' => '(information_schema|mysql|performance_schema|phpmyadmin|sys)',

	// PMA advanced features DB settings
	'controluser' => 'pma',
	'controlpass' => 'FOOBAR',
	'pmadb' => 'phpmyadmin',

	// PMA advanced features DB tables
	'bookmarktable' => 'pma__bookmark',
	'central_columns' => 'pma__central_columns',
	'column_info' => 'pma__column_info',
	'designer_coords' => 'pma__designer_coords',
	'designer_settings' => 'pma__designer_settings',
	'export_templates' => 'pma__export_templates',
	'favorite' => 'pma__favorite',
	'history' => 'pma__history',
	'navigationhiding' => 'pma__navigationhiding',
	'pdf_pages' => 'pma__pdf_pages',
	'recent' => 'pma__recent',
	'relation' => 'pma__relation',
	'savedsearches' => 'pma__savedsearches',
	'table_coords' => 'pma__table_coords',
	'table_info' => 'pma__table_info',
	'table_uiprefs' => 'pma__table_uiprefs',
	'tracking' => 'pma__tracking',
	'userconfig' => 'pma__userconfig',
	'usergroups' => 'pma__usergroups',
	'users' => 'pma__users',
];

// S.E.C.O.N.D. S.E.R.V.E.R. (conectar via TCP)
$cfg['Servers'][2] = [
	'verbose' => 'Otro servidor example2.com',
	'connect_type' => 'tcp',
	'host' => 'example2.com',
	// ...
];

Nota: Tras hacer cambios en este fichero es necesario desconectarse de phpMyAdmin y volver a inicar sesión para que los cambios tengan efecto. Nota: Estos son los métodos de autenticación más comunes de phpMyAdmin y su configuración:

//CONFIG (user/password stored in config file)
$cfg['Servers'][$i]['auth_type'] = 'config';
$cfg['Servers'][$i]['user'] = 'foo';
$cfg['Servers'][$i]['password'] = 'bar';

//COOKIE (a fancy HTML login form)
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['blowfish_secret'] = 'very_long_secret_sentence_up_to_46_characters';

//HTTP (HTTP Basic authentication. The browser promts for user/password)
$cfg['Servers'][$i]['auth_type'] = 'http';

Crear el usario y la base de datos para guardar la configuración de phpmyadmin y tener opciones avanzadas

FOOBAR es la contraseña que hemos indicado antes en la variable controlpass del archivo config.inc.php

mysql -p
source /var/www/example.com/htdocs/phpMyAdmin/examples/create_tables.sql
GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY 'FOOBAR';
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';
GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma'@'localhost';
flush privileges;
quit

Actualización

Obtener la última versión

emerge -uav phpmyadmin

Averigual el número de la nueva versión

webapp-config --lui

Actualizar la instalacion

webapp-config -U -h example.com -d phpMyAdmin phpmyadmin VERSION_DEL_PASO_ANTERIOR

Actualizar los archivos de configuración

CONFIG_PROTECT="/var/www/example.com/htdocs/phpMyAdmin/libraries" etc-update

Desinstalar versión antigua

emerge --prune -a  phpmyadmin