Documentation phpMyAdmin 2.9.0-dev
Prérequis
- PHP
- Vous devez utiliser PHP 4.1.0 ou ultérieur avec la gestion de session (*)
- Vous avez besoin du module GD2 dans PHP pour afficher des vignettes intégrées de fichiers JPEG
(« image/jpeg:inline ») avec le rapport
hauteur / largeur original.
- Vous avez besoin de PHP 4.3.0 ou ultérieur pour utiliser la transformation MIME
« text/plain:external ».
- MySQL 3.23.32 ou ultérieur (détails);
-
Ce n'est pas vraiment un prérequis mais une forte suggestion :
si vous utilisez le mode d'authentification par 'cookie', avoir l'extension PHP mcrypt
sur votre serveur Web accélère non seulement la phase de login
mais aussi toute autre action que vous ferez dans phpMyAdmin.
- un navigateur avec les cookies activés.
Introduction
phpMyAdmin peut gérer un serveur MySQL (cela
nécessite un compte super-utilisateur) aussi bien qu'une seule
base de données. Pour pouvoir administrer une seule base de
données, il est nécessaire d'avoir un droit de lecture /
écriture sur la base de données concernée. Il vous
appartient de consulter la section appropriée dans le manuel de
MySQL.
Actuellement phpMyAdmin sait :
- parcourir et supprimer bases de données, tables, vues, champs et index;
- créer, copier, supprimer, renommer et modifier bases de données, tables, , vues, champs et index;
- maintenir serveur, bases de données et tables en proposant une configuration serveur;
- supprimer, modifier et ajouter des champs;
- exécuter, modifier et créer un signet pour toute requête
SQL, même les
requêtes par lot;
- créer1 et lire des fichiers d'exportation (dumps) de
tables;
- exporter1 des données dans divers formats :
CSV,
XML,
PDF,
ISO/IEC 26300 - texte et feuille de calcul OpenDocument,
Word,
Excel et LATEX ;
- administrer plusieurs serveurs;
- gérer les utilisateurs MySQL et les privilèges;
- vérifier l'intégrité référentielle des tables MyISAM;
- utiliser Query-by-example (QBE), créer des requêtes complexes se connectant automatiquement aux tables concernées;
- créer des graphiques PDF du schéma de votre base de données;
- faire des recherches dans une base de données entière ou dans une partie seulement;
- convertir des données stockées en n'importe quel
format en utilisant un ensemble de fonctions prédéfinies,
comme par exemple l'affichage de données stockées en
format BLOB en tant qu'image ou les liens de
téléchargement;
- gérer les tables InnoDB et les clés
étrangères (voir FAQ 3.6);
- gérer mysqli, l'extension améliorée de MySQL (voir FAQ 1.17);
- communiquer dans 50 langues
différentes.
Installation
- Installation rapide
- Script d'installation
- Infrastructure de tables liées
- Mise à jour
- Modes d'authentification
phpMyAdmin n'applique pas de
méthodes de sécurité spéciales au serveur
de données MySQL. Il appartient toujours à
l'administrateur système d'accorder les autorisations
adéquates sur les bases de données MySQL. La page
« Privilèges » de phpMyAdmin peut être
utilisée pour cela.
À l'attention des utilisateurs Mac :
Si vous utilisez une version Mac OS antérieure à
la version OS X, StuffIt se débrouille avec les formats Mac.
Vous devrez donc convertir, tout comme dans BBEdit, au format Unix TOUS
les scripts phpMyAdmin avant de les transférer sur votre
serveur, car PHP ne semble pas apprécier les caractères de fin de ligne au
format Mac (« \r »).
Installation rapide
- « Détarrez » (.tar) ou
« dézippez » (.zip) la distribution (assurez-vous de
conserver l'arborescence des sous-répertoires). Exécutez
ensuite la commande suivante : tar -xzvf phpMyAdmin_x.x.x.tar.gz
dans le répertoire document racine de votre serveur web. Si vous
n'avez pas d'accès direct à votre répertoire
racine document, mettez les fichiers dans un répertoire de votre
ordinateur local, et,
après l'étape 3, transférez le répertoire
sur votre serveur web en utilisant, par exemple, le protocole ftp.
- Assurez-vous que tous les scripts ont le propriétaire adéquat (si PHP
fonctionne en mode sécurisé, avoir des scripts avec un propriétaire
différent de celui des autres posera un problème).
Voir la section FAQ 4.2 et FAQ 1.26 pour des suggestions.
- Créez le fichier config.inc.php dans le répertoire principal (celui contenant
index.php). Vous pouvez utiliser le script d'installation
fourni dans scripts/setup.php pour créer
les paramètres basiques du fichier de configuration, ce qui est suffisant
pour la plupart des utilisateurs. Consultez le chapitre
Script d'installation pour les détails. si vous n'aimez pas le
script d'installation ou si vous voulez ajuster finement la configuration, ouvrez (ou créez si vous partez de rien)
le fichier config.inc.php dans votre éditeur
favori et renseignez les valeurs du serveur hôte, de l'utilisateur,
du mot de passe et du mode d'authentification pour vous ajuster
à votre environnement. Consultez le fichier libraries/config.default.php pour savoir
comment ces champs doivent être définis. Ici, « hôte » signifie le
serveur MySQL. Veuillez consulter la section Configuration pour
une explication de ces valeurs. Veuillez également lire la suite de cette section
Installation pour des informations sur les modes d'authentification et sur l'infrastructure
des tables liées.
- Si vous utilisez la configuration auth_type, nous vous recommandons de protéger
le répertoire dans lequel vous installez phpMyAdmin, car cette configuration ne nécessite
pas que l'utilisateur donne un mot de passe pour accéder au répertoire d'installation de
phpMyAdmin. Nous vous recommandons d'utiliser une méthode d'authentification alternative comme
par exemple avec HTTP–AUTH dans un fichier .htaccess ou utilisez la
méthode d'authentification par cookie ou http.
Consultez la sous-section
multi-utilisateurs de cette FAQ pour des informations supplémentaires et
particulièrement la partie FAQ 4.4.
- Ouvrir le fichier <www.votre-hôte.com>/<votre-répertoire-d'installation>/index.php
dans votre navigateur. phpMyAdmin devrait maintenant afficher un
écran de bienvenue et vos bases de données, ou une
boîte de dialogue de connexion si vous utilisez le mode HTTP ou
le mode authentification par cookie.
- Vous devrez interdire l'accès au sous-répertoire libraries
de votre serveur Web. Pour Apache, vous pouvez utiliser le fichier .htaccess fourni
dans ce dossier, pour les autres serveurs Web, vous devrez le configurer vous-même.
Une telle configuration empêche de possibles vulnérabilités de
« path exposure » et de « cross side scripting »
qui pourraient être découvertes dans le code.
Script d'installation
Depuis la version 2.8.0 de phpMyAdmin, un script d'installation est fourni qui peut
vous aider pour créer votre configuration. Ce script est situé dans le dossier scripts :
scripts/setup.php. Son utilisation est très simple.
Vous suivez les dialogues et le script prépare en mémoire les directives de configuration.
Vous avez alors deux possibilités pour enregistrer le fichier de configuration :
- Téléchargez-le sur votre ordinateur, puis copiez-le (par exemple avec
ftp) dans votre répertoire principal phpMyAdmin. Dans ce cas, vous n'avez pas besoin de
préparer un répertoire config spécial et aucune
autre action n'est nécessaire.
- Enregistrez le fichier sur votre serveur Web dans le répertoire config.
Pour enregistrer le fichier sur votre serveur Web ou pour charger une configuration
précédente, vous devez créer le répertoire config à la racine du répertoire
d'installation de phpMyAdmin et le rendre accessible en écriture pour le serveur Web. Pour charger une configuration
précédente, placez-le là (et assurez-vous que le serveur Web ait les droits d'écriture sur celui-ci).
Sur un serveur GNU/Linux ou Unix, vous pouvez utiliser les commandes suivantes :
cd phpMyAdmin
mkdir config # crée un répertoire pour l'enregistrement
chmod o+rw config # donne les droits d'écriture à tout le monde
# Si vous voulez modifier une configuration existante :
cp config.inc.php config/ # copie la configuration courante
chmod o+w config/config.inc.php # donne les droits d'écriture à tout le monde
Sur un système Windows, créez un sous-répertoire config dans le répertoire
principal de phpMyAdmin et assurez-vous que votre serveur Web a un accès en lecture/écriture sur celui-ci.
La section FAQ 1.26 peut vous être utile pour cela. Si vous avez déjà un fichier
config.inc.php existant dans votre répertoire principal, copiez-le dans le sous-répertoire
./config que vous venez de créer.
Ensuite, vous pouvez ouvrir le fichier ./scripts/setup.php dans votre navigateur et commencer
l'installation. Après avoir enregistré votre configuration, déplacez-là vers
le répertoire racine et supprimez le répertoire ./config.
N'oubliez pas d'enlever les droits d'écriture pour tout le monde sur le fichier config.inc.php !
chmod o-rw config.inc.php # supprime pour tout le monde (other) les droits
# de lecture et d'écriture
Veuillez noter que le script ne permet pas de tout configurer; vous aurez donc encore
à éditer manuellement le fichier de configuration pour avoir des fonctionnalités
supplémentaires.
Infrastructure des tables liées
Si vous voulez bénéficier de toute une série
de nouveautés (signets, commentaires,
historique SQL, génération de
PDF, transformation des
contenus de champ, etc.), vous devrez créer un ensemble de
tables spéciales. Ces tables peuvent se trouver dans votre propre base de
données, ou dans une base de données centrale pour une installation
multi-utilisateurs (cette base de données serait alors accée par le controluser,
aussi, aucun autre utilisateur ne devrait avoir de droits sur celle-ci).
Veuillez regarder dans votre
répertoire ./scripts/,
où vous devriez trouver un fichier
du nom de create_tables.sql.
(Si vous utilisez un serveur Windows, portez une attention
particulière à la partie FAQ 1.23).
Si la version de votre serveur MySQL est la 4.1.2 ou ultérieure, veuillez plutôt utiliser create_tables_mysql_4_1_2+.sql pour une nouvelle installation.
Si vous avez déjà cette infrastructure et mis à jour vers MySQL 4.1.2
ou ultérieur, veuillez utiliser le fichier upgrade_tables_mysql_4_1_2+.sql.
Vous pouvez d'ores et déjà utiliser phpMyAdmin qui
créera les tables pour vous.
S'il vous plaît, sachez que vous pouvez avoir besoin de
privilèges spéciaux (administrateur) pour créer la
base de données et les tables, et que le script peut avoir besoin de quelques
ajustements en fonction du nom de la base de données.
Après avoir importé le fichier create_tables.sql, vous devrez spécifier le
nom des tables dans votre fichier ./config.inc.php.
Vous trouverez les directives à utiliser pour cela dans la section Configuration.
Vous aurez également besoin d'un controluser avec les droits appropriés pour
ces tables (voir la section Utiliser les modes d'authentification ci-dessous).
Mise à jour :
Copiez seulement le fichier config.inc.php
de votre installation précédente dans votre nouvelle installation.
Si votre précédente version de phpMyAdmin était une version 2.3.0 ou
supérieure, quelques ajustements peuvent être nécessaires car, à
partir de la version 2.7.0, l'utilisation de ces vieux fichiers config n'est plus
supportée.
Vous ne devez pas copier libraries/config.default.php
par dessus config.inc.php car le fichier de configuration par défaut est
spécifique à chaque version.
Utiliser les modes d'authentification :
- Les modes d'authentification HTTP et par cookie sont
conseillés dans un environnement multi-utilisateurs
où vous ne voulez donner l'accès aux utilisateurs
qu'à leur propre base de données et où vous ne
voulez pas qu'ils jouent avec les autres bases.
Néanmoins, sachez que MS Internet Explorer paraît
être vraiment bogué en ce qui concerne les cookies, au
moins jusqu'à la version 6, et PHP 4.1.1 est également un
peu bogué dans ce domaine!
Même dans un environnement
mono-utilisateur, vous pourriez opter pour les modes HTTP
ou par cookie de sorte que votre paire utilisateur/mot de passe ne soit
pas écrite en clair dans le fichier de configuration.
- Les modes d'authentification HTTP et par cookie sont plus
sécurisés : les informations de connexion de MySQL n'ont pas besoin
d'être défini dans le fichier de configuration de
phpMyAdmin (excepté pour l'utilisateur de contrôle
« controluser » - voir la section controluser).
Quoi qu'il en soit, gardez à l'esprit que le mot de passe
transite en clair, à moins d'utiliser le protocole HTTPS.
En mode cookie, le mot de passe est stocké et chiffré
avec l'algorithme blowfish, dans un cookie temporaire.
- Note : À partir de la version 2.6.1 de phpMyAdmin, cette section ne s'applique qu'aux
serveurs MySQL supérieurs à la version 4.1.2 ou exécutés avec l'option
--skip-show-database.
Pour les modes HTTP et cookie, phpMyAdmin a besoin d'un
utilisateur de contrôle - « controluser » - ayant
seulement le privilège SELECT
sur les tables mysql.user
(toutes les colonnes sauf « Password »), mysql.db
(toutes les colonnes), mysql.host (toutes les colonnes)
et mysql.tables_priv (toutes les colonnes sauf « Grantor » et « Timestamp »).
Vous devez spécifier les détails pour le controluser dans le fichier config.inc.php dans la section paramètre $cfg['Servers'][$i]['controluser'] et $cfg['Servers'][$i]['controlpass'].
L'exemple suivant suppose que vous voulez utiliser « pma »
comme utilisateur de contrôle et « pmapass »
comme mot de passe, mais il ne s'agit que d'un exemple : utilisez
autre chose pour votre fichier ! Saisissez ces déclarations dans
une fenêtre de requête de phpMyAdmin ou en ligne de commande mysql.
Bien sûr, vous devrez remplacer localhost par le nom
d'hôte de votre serveur web si celui-ci n'est pas le même
que votre serveur 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 vous utilisez une ancienne version de MySQL (antérieure
à 4.0.2), veuillez remplacer la première requête
par celle-ci :
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
)
ON mysql.user TO 'pma'@'localhost';
… et si vous voulez utiliser les toutes nouvelles
caractéristiques de relation et de signets :
GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
(ceci nécessite bien sûr que votre infrastructure de tables liées soit définie).
Évidemment, les requêtes ci-dessus ne fonctionnent que si
votre version de MySQL utilise la commande GRANT. C'est le cas depuis
la version 3.22.11.
- Ensuite, un ensemble de privilèges doit être
accordé à chaque utilisateur réel sur un
ensemble de bases définies. Normalement, vous ne devriez pas
donner de privilèges globaux à un utilisateur ordinaire,
à moins que vous ne sachiez ce que vous faites (par exemple, si
vous créez un super-utilisateur).
Par exemple, pour accorder à l'utilisateur utilisateur_réel
tous les privilèges sur la base base_utilisateur :
GRANT ALL PRIVILEGES ON base_utilisateur.* TO 'utilisateur_réel'@localhost IDENTIFIED BY 'vrai_mot_de_passe';
Ce que peut faire maintenant l'utilisateur est entièrement
contrôlé par le système de gestion d'utilisateurs
de MySQL.
Avec les modes d'authentification HTTP ou par cookie, vous n'avez pas
besoin de renseigner les champs utilisateur/mot de passe dans la partie $cfg['Servers'].
Mode d'authentification 'HTTP'
- Il utilise la méthode
d'authentification de base HTTP et vous autorise à vous
connecter en tant que n'importe quel utilisateur MySQL valide.
- Il est géré par la plupart des configurations PHP.
Pour la gestion IIS
(ISAPI) utilisant
PHP CGI, voir la section FAQ 1.32, pour utiliser
Apache CGI voir la section FAQ 1.35.
- Voir également la section FAQ 4.4
sur le fait de ne pas utiliser le mécanisme d'authentification .htaccess
en même temps que le mode d'authentification 'HTTP'.
Mode d'authentification 'cookie' :
- Vous pouvez utiliser cette méthode à la place de
l'authentification HTTP (par exemple si vous utiliser IIS).
- Bien sûr, l'utilisateur doit activer les cookies dans son
navigateur, mais c'est maintenant un prérequis pour tous les modes d'authentification.
- Avec ce mode, l'utilisateur peut
réellement se déconnecter de phpMyAdmin et se reconnecter
avec le même nom d'utilisateur.
- Si vous voulez vous connecter à un serveur arbitraire,
voir la directive $cfg['AllowArbitraryServer'].
- Comme il est indiqué dans la section Prérequis, l'extension
mycrypt accélère considérablement l'accès, mais il n'est pas obligatoire
de l'installer.
Mode d'authentification 'config'
- Ce mode est le moins sécurisé car il requiert de
remplir les champs $cfg['Servers'][$i]['user'] et
$cfg['Servers'][$i]['password']
(et par conséquent, quicoonque peut lire votre fichier config.inc.php peut
découvrir votre nom d'utilisateur et votre mot de passe.
Mais vous n'avez pas besoin de définir un utilisateur de
contrôle - « controluser » - ici :
l'utilisation de $cfg['Servers'][$i]['only_db'] s'avère
suffisante.
- Dans la section FAI de la FAQ, il y a un point expliquant comment protéger votre fichier de configuration.
- Pour une sécurité supplémentaire dans ce
mode, vous devriez considérer les directives de configuration de
l'authentification hôte $cfg['Servers'][$i]['AllowDeny']['order']
et $cfg['Servers'][$i]['AllowDeny']['rules'].
- Contrairement aux méthodes par cookie et http, il ne nécessite pas que l'utilisateur
s'authentifie lors du premier chargement du site phpMyAdmin. C'est prévu ainsi, mais cela
pourrait permettre à tout utilisateur d'accéder à votre installation.
L'utilisation d'une méthode de restriction est recommandée, peut-être avec
un fichier .htaccess avec la directive
HTTP-AUTH directive ou en interdisant les requêtes HTTP entrantes sur
le routeur ou le pare-feu suffisent (ces deux suggestions n'entrent pas dans les sujets abordés
dans ce manuel mais vous pouvez facilement trouver des informations sur ces sujets
avec Google).
Configuration
À l'attention des utilisateurs Mac :
PHP ne semble pas apprécier les caractères de fin de
ligne Mac (« \r »). Aussi, assurez-vous de choisir
l'option qui autorise l'utilisation des caractères de fin de
ligne *nix (« \n ») dans votre éditeur de
texte avant d'enregistrer un script que vous avez modifié.
Note sur la configuration :
Presque toutes les données de configuration sont placées dans config.inc.php.
Si ce fichier n'existe pas, veuillez vous rapporter à la section Installation rapide
pour en créer un. Ce fichier ne nécessite de contenir que les paramètres dont vous
voudriez changer la valeur par défaut dans le fichier libraries/config.default.php.
Les paramètres relatifs à la conception (comme les couleurs), se trouvent dans
themes/themename/layout.inc.php.
Vous pouvez également créer les fichiers config.footer.inc.php et
config.header.inc.php pour ajouter à votre site du code spécifique à
inclure en en-tête et en pied de chaque page.
- $cfg['PmaAbsoluteUri'] chaîne
- Définissez ici l'URL complète (avec le chemin
d'accès complet) du répertoire d'installation de votre phpMyAdmin.
C'est-à-dire http://www.votre_site.net/chemin_d_acces_avotre_repertoire_phpMyAdmin/.
Veuillez noter également que l'URL
sur certains serveurs Web est sensible à la casse.
N'oubliez pas le slash (« / ») final pour votre URL.
À partir de la version 2.3.0, il est conseillé d'essayer de laisser ce
paramètre à blanc. Dans la plupart des cas, phpMyAdmin détecte automatiquement
le paramètre approprié. Les utilisateurs de « port forwarding »
devront définir PmaAbsoluteUri
(plus de renseignements ici).
Un bon test est de naviguer dans une table, d'éditer une ligne et de l'enregistrer. Vous devriez
obtenir un message d'erreur si phpMyAdmin rencontre des problèmes pour détecter automatiquement
la bonne valeur. Si vous obtenez une erreur indiquant que ce paramètre doit être défini
ou que le code d'auto-détection échoue à trouver le chemin d'accès,
veuillez poster un rapport de bogue sur notre traqueur de bogues pour que nous
améliorions le code.
- $cfg['PmaNoRelation_DisableWarning'] booléen
- À partir de la version 2.3.0 phpMyAdmin offre beaucoup de
fonctionnalités pour travailler avec les tables maîtres /
de référence (voir $cfg['Servers'][$i]['pmadb']).
Si vous essayez de le paramétrer et qu'il ne fonctionne pas pour
vous, regardez la page « Structure » d'une base de
données
où vous voudriez l'utiliser.
Vous trouverez alors un lien qui analysera pourquoi ces
fonctionnalités ont été désactivées.
Si vous ne voulez pas utiliser ces fonctionnalités, mettez cette
variable à TRUE pour empêcher ce message d'apparaître.
- $cfg['blowfish_secret'] chaîne
- La méthode
d'authentification par « cookie » utilise l'algorithme blowfish pour
chiffrer le mot de passe.
Si vous utilisez la méthode d'authentification par 'cookie',
entrez ici une phrase aléatoire de votre choix.
Elle sera utilisée de manière interne par l'algorithme blowfish :
cette phrase mot de passe ne vous sera pas demandée. Le nombre
maximum de caractères pour ce paramètre semble être 46.
- $cfg['Servers'] tableau
- Depuis la version 1.4.2, phpMyAdmin gère l'administration
de plusieurs serveurs MySQL. Par conséquent, un tableau
$cfg['Servers'] a été ajouté qui contient les
informations de connexions pour les différents serveurs.
Le premier $cfg['Servers'][$i]['host'] contient le nom
d'hôte du premier serveur, le second $cfg['Servers'][$i]['host']
le nom d'hôte du second serveur, etc.
Dans le fichier libraries/config.default.php, il n'y a qu'une section pour la définition
du serveur, cependant vous pouvez en mettre autant que vous le voulez dans le fichier
config.inc.php; copier ce bloc ou d'autres parties nécessaires (il n'est pas utile
de définir tous les paramètres, seulement ceux que vous avez besoin de changer).
- $cfg['Servers'][$i]['host'] chaîne
- Le nom d'hôte ou l'adresse IP de votre $i-ème
serveur MySQL. C'est-à-dire localhost.
- $cfg['Servers'][$i]['port'] chaîne
- Le numéro de port de votre $i-ème serveur MySQL.
Par défaut : 3306
(laissez à blanc pour utiliser la valeur par défaut). Si
vous utilisez « localhost » comme nom d'hôte, MySQL
ignore ce numéro de port et se connecte avec le socket, donc, si
vous voulez vous connecter avec un port différent de celui par
défaut, utilisez « 127.0.0.1 » ou le nom d'hôte réel
dans $cfg['Servers'][$i]['host'].
- $cfg['Servers'][$i]['socket'] chaîne
- Le chemin d'accès vers le socket à utiliser.
Laissez à blanc pour utiliser la valeur par défaut.
Pour déterminer le bon socket, vérifiez votre configuration MySQL ou, en utilisant la
ligne de commande mysql, utilisez la commande status.
Parmi les informations affichées se trouvera le socket utilisé.
- $cfg['Servers'][$i]['connect_type'] chaîne
- Quel type de connexion utiliser avec le serveur MySQL. Vos choix
sont 'socket' et 'tcp'. Par défaut, c'est
'tcp' parce qu'il est pratiquement sûr qu'il est disponible sur
tous les serveurs MySQL, alors que les sockets ne sont pas
gérés sur certaines plateformes.
Pour utiliser le mode socket, votre serveur MySQL doit être sur
la même machine que le serveur Web.
- $cfg['Servers'][$i]['extension'] chaîne
- Définit l'extension php MySQL utilisée pour la connexion. Les
options autorisées sont :
mysql : L'extension MySQL classique.
C'est l'option recommandée et par défaut à ce
jour.
mysqli : L'extension MySQL
améliorée.
Cette extension devient disponible avec php version 5.0.0, et
recommandée pour se connecter sur un serveur exécutant
MySQL version 4.1.x.
- $cfg['Servers'][$i]['compress'] booléen
- Pour utiliser ou non un protocole compressé pour la
connexion au serveur MySQL (expérimental).
Cette fonctionnalité requiert PHP version 4.3.0 ou ultérieure.
-
$cfg['Servers'][$i]['controluser'] chaîne
$cfg['Servers'][$i]['controlpass'] chaîne
- Ce compte spécial est utilisé pour deux propos
distincts : rendre possible toutes les fonctionnalités relationnelles
(voir $cfg['Servers'][$i]['pmadb']) et, pour un serveur
MySQL de version supérieure à 4.1.2 ou exécuté avec l'option
--skip-show-database, permettre une installation multi-utilisateurs (mode
d'authentification HTTP ou par cookie).
Si vous utilisez les modes d'authentification HTTP ou par cookie (ou le
mode d'authentification 'config' depuis phpMyAdmin 2.2.1), vous devez
fournir des informations sur un compte MySQL qui a un privilège SELECT
sur les tables mysql.user
(toutes les colonnes sauf « Password »), mysql.db
(toutes les colonnes)
et mysql.tables_priv (toutes les colonnes sauf
« Grantor » et « Timestamp »). Ce compte est
utilisé pour vérifier quelles bases de données
l'utilisateur pourra voir à la connexion.
Veuillez consulter la section Installation sur
« Utiliser les modes d'authentification » pour plus de
renseignements.
Dans les versions de phpMyAdmin antérieures à la version 2.2.5, ils
étaient appelés « stduser/stdpass ».
- $cfg['Servers'][$i]['auth_type'] chaîne
['HTTP'|'cookie'|'config']
- Définit le mode d'authentification config, cookie ou HTTP
qui sera utilisé sur le serveur.
- l'authentification 'config' ($auth_type = 'config')
est la bonne vieille méthode : nom d'utilisateur et mot de passe
sont stockés dans config.inc.php.
- le mode d'authentification 'cookie' ($auth_type = 'cookie')
tel qu'introduit dans la version 2.2.3 vous permet de vous connecter
comme n'importe quel utilisateur MySQL valide à l'aide de
cookies. Les nom et mot de passe de connexion sont stockés dans
des cookies pendant la session et le mot de passe est effacé
à la fin de la session. Ceci vous permet également de
vous connecter à un serveur arbitraire si $cfg['AllowArbitraryServer']
est activé.
- le mode authentification 'HTTP' ( appelé
« avancé » dans les précédentes versions)
($auth_type = 'HTTP')
tel qu'introduit dans la version 1.3.0 vous permet de vous connecter
comme n'importe utilisateur MySQL valide via HTTP-Auth.
Veuillez consulter la section Installation sur
« Utiliser les modes d'authentification » pour plus de renseignements.
-
$cfg['Servers'][$i]['user'] chaîne
$cfg['Servers'][$i]['password'] chaîne
- En utilisant auth_type = 'config', c'est la paire utilisateur/mot de passe qu'utilisera phpMyAdmin pour se
connecter au serveur MySQL. Cette paire utilisateur/mot de passe
n'est pas nécessaire quand les modes d'authentification
HTTP ou cookie sont utilisés, et doit rester vide.
-
$cfg['Servers'][$i]['nopassword'] boolean
- Permet d'essayer de se connecter sans mot de passe quand la connexion avec mot de passe a
échoué. Ceci peut être utilisé en conjonction avec l'authentification
HTTP, quand l'authentification est faite par d'autres
moyens et que phpMyAdmin obtient le nom d'utilisateur à partir de
auth et utilise un mot de passe « vide » pour se connecter à MySQL. La connexion
par mot de passe est d'abord essayée, mais ensuite, en moyen de secours, aucune méthode par mot
de passe n'est essayée.
-
$cfg['Servers'][$i]['only_db'] chaîne ou tableau
- S'il est indiqué un nom de base de données (ou un
tableau de noms de bases de données) , seule(s) cette (ces) base(s)
sera (seront) affichée(s) à l'utilisateur. Depuis la
version 2.2.1 de phpMyAdmin,
ce(s) nom(s) de base(s) de données peuvent contenir des
méta-caractères MySQL (« _ » et
« % ») : si vous voulez utiliser des instances
littérales de ces caractères, utilisez des
séquences d'échappement (c'est-à-dire
écrivez 'ma\_bdd' et pas 'ma_bdd').
Ce paramétrage est un moyen efficace de diminuer la charge du
serveur puisque ce dernier n'a pas besoin d'envoyer des requêtes
MySQL pour construire la liste des bases de données disponibles.
Mais cela ne remplacera pas les règles de privilèges sur
le serveur de base de données MySQL.
S'il est utilisé, cela signifie seulement que seules ces bases
de données seront affichées, mais pas que toutes les
autres bases de données ne pourront pas être
utilisées.
Un exemple d'utilisation de plus d'une base de données : $cfg['Servers'][$i]['only_db']
= array('bdd1', 'bdd2');
Comme dans phpMyAdmin 2.5.5, l'ordre à l'intérieur du
tableau est utilisé pour trier les bases de données dans
le cadre de gauche, de la sorte, vous pouvez ordonner vos bases de
données comme bon vous semble.
Si vous voulez avoir certaines bases de données en haut de page,
et que peu importe l'ordre des autres bases, vous n'avez pas besoin de
spécifier toutes les autres bases. Utilisez : $cfg['Servers'][$i]['only_db']
= array('bdd3', 'bdd4', '*'); plutôt que de dire à
phpMyAdmin qu'il doit afficher bdd3 et bdd4 en haut, et le reste en
ordre alphabétique.
- $cfg['Servers'][$i]['hide_db'] chaîne
- Expression régulière pour masquer certaines bases. Ceci ne les masque que pour le listage,
l'utilisateur est toujours capable d'y accéder (en utilisant par exemple
la zone de requête SQL). Pour limiter l'accès, utiliser le système de
privilège de MySQL.
Par exemple, pour masquer toutes les bases de données commençant par la lettre
« a », utilisez
$cfg['Servers'][$i]['hide_db'] = '^a';
et pour masquer les bases de données « db1 » et
« db2 », utilisez
$cfg['Servers'][$i]['hide_db'] = '(db1|db2)';
Vous pourrez trouver plus d'informations sur les expressions régulières dans la
section
syntaxe de motif PCRE dans le manuel de référence de PHP.
- $cfg['Servers'][$i]['verbose'] chaîne
- Seulement utile si vous utilisez phpMyAdmin avec plusieurs
entrées de serveurs.
Si elle est définie, cette chaîne sera affichée
à la place du nom d'hôte dans le menu déroulant de
la page principale. Cela peut être utile si vous ne voulez
montrer que certaines bases de données sur votre système,par exemple.
-
$cfg['Servers'][$i]['pmadb'] chaîne
- Définit le nom de la base de données contenant l'infrastructure
des tables liées.
Voir la section Infrastructure des tables liées
dans ce document pour voir les avantages de cette infrastructure,
ainsi qu'une manière rapide de créer cette base de données et les tables nécessaires.
Si vous êtes le seul utilisateur de cette installation
phpMyAdmin, vous pouvez utiliser votre base de données courante
pour stocker ces tables spéciales; dans ce cas, mettez juste le
nom de votre base de données dans $cfg['Servers'][$i]['pmadb'].
Pour une installation multi-utilisateurs, renseigner ce paramètre
avec le nom de votre base de données centrale contenant l'infrastructure
des tables liées.
-
$cfg['Servers'][$i]['bookmarktable'] chaîne
- Depuis la version 2.2.0, phpMyAdmin permet aux utilisateurs la mise en signets
(favoris) des requêtes. Cela peut être utile
pour les requêtes que vous utilisez souvent.
Pour pouvoir utiliser cette fonctionnalité :
- définir pmadb et l'infrastructure des tables liées
- saisir le nom de la table dans $cfg['Servers'][$i]['bookmarktable']
-
$cfg['Servers'][$i]['relation'] chaîne
- Depuis la version 2.2.4, vous pouvez décrire, dans une
table spéciale « relation », quel champ est une clé pour
une autre table (une clé étrangère).
phpMyAdmin utilise actuellement cela pour :
- rendre cliquable, quand vous affichez la table maître,
les valeurs des données qui pointent vers une table
étrangère;
- afficher dans une info-bulle le champ d'affichage
(« display field ») en affichant la table maître, si
vous déplacez la souris dans une colonne contenant une
clé étrangère (utilise également la table
'table_info');
(voir la section FAQ 6.7)
- en mode modification/insertion, afficher une liste
déroulante des clés étrangères disponibles
(la valeur de la clé et le champ d'affichage sont
indiqués)
(voir la section FAQ 6.21)
- afficher les liens dans la page de propriétés
de la table, pour vérifier l'intégrité
référentielle (affiche les clés
étrangères manquantes) pour chaque clé
décrite;
- dans Query-by-example, créer des jointures
automatiques (voir la section FAQ 6.6)
- vous permettre d'obtenir un schéma PDF de votre base
de données (utilise également la table table_coords).
Les clés peuvent être numériques ou
alphanumériques.
Pour permettre l'utilisation de cette fonctionnalité :
- pmadb et l'infrastructure des tables liées
- mettre le nom de la table de relation dans $cfg['Servers'][$i]['relation']
- puis, en tant qu'utilisateur normal, ouvrir phpMyAdmin et
pour chacune de vos tables où vous voulez voir apparaître
cette fonctionnalité, cliquer sur « Structure/Gestion des
relations/ » et choisir les champs étrangers.
Veuillez noter que dans la version actuelle, master_db
doit être identique à foreign_db. Ces champs ont
été prévus pour le développement futur de
relations inter-bases.
-
$cfg['Servers'][$i]['table_info'] chaîne
- Depuis la version 2.3.0, vous pouvez décrire dans une
table spéciale « table_info », quel champ doit être
affiché comme info-bulle en déplaçant le curseur
sur la clé correspondante.
Cette variable de configuration détient le nom de cette table
spéciale.
Pour pouvoir utiliser cette fonctionnalité :
- pmadb et l'infrastructure des tables liées
- mettre le nom de la table dans $cfg['Servers'][$i]['table_info']
- ensuite, pour chaque table pour laquelle vous voulez utiliser
cette fonctionnalité,
cliquer sur « Structure/Gestion des relations/Champ à
afficher » pour choisir le champ.
Astuce d'utilisation : Champ à afficher.
-
$cfg['Servers'][$i]['table_coords'] chaîne
$cfg['Servers'][$i]['pdf_pages'] chaîne
- Depuis la version 2.3.0, phpMyAdmin peut créer des pages
PDF montrant les relations entre vos tables. Pour ce faire, il a besoin
de deux tables « pdf_pages » (qui stocke les informations sur
les pages PDF disponibles)
et « table_coords » (qui stocke les coordonnées
où chaque table sera placée sur le schéma PDF
réalisé).
Vous devez utiliser la fonctionnalité « relation ».
Pour pouvoir utiliser cette fonctionnalité :
- pmadb et l'infrastructure des tables liées
- mettre les noms corrects de tables dans $cfg['Servers'][$i]['table_coords']
et $cfg['Servers'][$i]['pdf_pages']
Astuce d'utilisation : Réalisation de PDF.
-
$cfg['Servers'][$i]['column_info'] chaîne
- Depuis la version
2.3.0, vous pouvez stocker des commentaires pour décrire chaque
colonne de chaque table. Ils seront alors visibles dans
« Version imprimable ».
À partir de la version 2.5.0, les commentaires sont par
conséquent utilisés dans les pages de
propriété de table et dans la vue afficher la table,
apparaissant sous forme d'info-bulle au-dessus du nom de colonne (page
propriétés) ou intégrés dans
l'en-tête de la vue parcours de table. Ils peuvent aussi
être vus dans un fichier d'exportation de table. Veuillez
consulter les directives de configuration adéquates plus loin.
Une autre nouveauté de la version 2.5.0 est le système de
conversion MIME qui est également fondé sur la structure
de table suivante. Voir la section Transformations
pour plus de renseignements. Pour utiliser le système de
conversion MIME, votre table column_info doit contenir les trois
nouveaux champs 'mimetype', 'transformation', 'transformation_options'.
Pour autoriser l'utilisation de cette fonctionnalité :
-
$cfg['Servers'][$i]['history'] chaîne
- Depuis la version 2.5.0, vous pouvez stocker votre historique
SQL, ce qui signifie toutes les requêtes que vous saisissez
manuellement dans l'interface de phpMyAdmin. Si vous ne voulez pas
utiliser un historique stocké dans une table, vous pouvez
choisir un historique utilisant JavaScript. En utilisant JavaScript,
toutes les entrées de votre historique seront perdues en fermant
la fenêtre.
En utilisant $cfg['QueryHistoryMax'], vous pouvez
spécifier le nombre d'entrées de l'historique que vous
voulez conserver. À chaque connexion, cette liste est
réduite au nombre maximum d'entrées.
La requête historique n'est disponible que si JavaScript est activé dans votre navigateur.
Pour autoriser l'utilisation de cette fonctionnalité :
- pmadb et l'infrastructure des tables liées
- mettre le nom de la table dans $cfg['Servers'][$i]['history']
- $cfg['Servers'][$i]['verbose_check'] booléen
- La version 2.5.0 introduisant la nouvelle gestion de la
conversion MIME, la colonne column_info recense maintenant trois
nouveaux champs. Si cette variable est définie à TRUE
(par défaut) phpMyAdmin vérifiera si vous disposez de la
dernière structure disponible de la table. Si ce n'est pas le
cas, il enverra un avertissement au super-utilisateur.
Vous pouvez désactiver cette fonctionalité en
positionnant la variable à FALSE, ce qui améliorerait les performances.
Il est recommandé de la positionner à FALSE, quand vous
êtes sûr que votre structure est à jour.
- $cfg['Servers'][$i]['AllowRoot'] booléen
- Autoriser ou non un accès à la racine. Il s'agit seulement d'une simplification des règles ci-dessous.
-
$cfg['Servers'][$i]['AllowDeny']['order'] chaîne
- Si votre règle « order » est vide, alors
l'authentification IP est désactivée.
Si votre règle « order » est définie à 'deny,allow'
alors le système applique toutes les règles
« deny » puis les règles « allow ».
L'accès est autorisé par défaut. Tout client qui
ne répondrait pas à une commande « deny » ou
« allow » sera autorisé à accéder
au serveur.
Si votre règle « order » est définie à 'allow,deny'
alors le système applique toutes les règles
« allow » puis les règles « deny ».
L'accès est refusé par défaut. Tout client qui ne
répondrait pas à une directive « allow » ou
« deny » se verra refuser l'accès au serveur.
Si votre règle « order » est définie à
'explicit', l'authentification est réalisée de
manière similaire à la règle 'deny,allow', avec en
plus la restriction que la combinaison de votre hôte/nom
d'utilisateur doit être présente dans les
règles « allow », et pas dans les règles « deny ».
C'est le moyen le plus
sûr d'utiliser les règles allow/deny,
et qui est employé pour Apache pour spécifier les
règles allow et deny sans définir d'ordres.
-
$cfg['Servers'][$i]['AllowDeny']['rules'] tableau de chaînes
- Le format général des règles est le suivant :
<'allow' | 'deny'><username> ['from'] <ipmask>
Si vous voulez que cela concerne tous les utilisateurs, il est possible
d'utiliser un symbole '%'
comme méta-caractère dans le champ username.
Il y a quelques raccourcis que vous pouvez utiliser pour le champ ipmask
(veuillez noter que les adressages ADDRESSE_SERVER pourraient ne pas être disponibles
sur tous les serveurs Web) :
'Tout' -> 0.0.0.0/0
'Hôte local' -> 127.0.0.1/8
'Réseau local de classe A' -> ADDRESSE_SERVER/8
'Réseau local de classe B' -> ADDRESSE_SERVER/16
'Réseau local de classe C' -> ADDRESSE_SERVER/24
Avoir une liste de règles vide est équivalent à
l'utilisation de 'allow %
from all' si l'ordre de votre règle est définie
à 'deny,allow' ou 'deny
% from all' si l'ordre de votre règle est définie
à 'allow,deny' ou 'explicit'.
Pour le système de concordance IP, ce qui suit fonctionne :
xxx.xxx.xxx.xxx (une adresse IP exacte)
xxx.xxx.xxx.['yyy-zzz'] (une plage d'adresses IP)
xxx.xxx.xxx.xxx/nn (CIDR, adresses IP de type Classless
Inter-Domain Routing -- routage inter-domaine sans classe)
Mais ce qui suit ne fonctionne pas :
xxx.xxx.xxx.xx['yyy-zzz'] (plage partielle d'adresses IP )
- $cfg['ServerDefault'] entier
- Si vous avez plus d'un serveur, vous pouvez définir $cfg['ServerDefault']
sur n'importe lequel d'entre eux pour s'auto-connecter sur celui-ci
quand phpMyAdmin est démarré, ou le définir
à 0 sur tous les serveurs pour avoir une liste de serveurs
auxquels se connecter.
Si vous n'avez qu'un seul serveur, $cfg['ServerDefault']
DOIT être défini sur ce serveur.
- $cfg['OBGzip'] chaîne/booléen
- Définit si l'on utilise la mise en cache des sorties
(output buffering) GZip
pour accroître la vitesse des transferts HTTP.
Mettre à true/false pour activer/désactiver. Quand
défini sur 'auto' (chaîne),
phpMyAdmin essaie d'activer la mise en cache des sorties et la
désactivera automatiquement si votre navigateur a des
problèmes avec la mise en cache. IE6, avec un certain correctif,
est connu pour provoquer une corruption de données en ayant la
mise en cache activée.
- $cfg['PersistentConnections'] booléen
- Définit si les connexions persistantes doivent être
utilisées (mysql_connect ou mysql_pconnect).
- $cfg['ForceSSL'] booléen
- Pour forcer ou pas l'utilisation de https lors de l'accès à phpMyAdmin.
- $cfg['ExecTimeLimit'] entier ['nombre de secondes']
- Définit le nombre de secondes allouées à un
script pour s'exécuter. Si le nombre de secondes est
défini à zéro, aucune limite de temps n'est
imposée.
Ce paramètre est utilisé lors de
l'importation/exportation de fichiers de base mais n'a pas d'effet
quand PHP est exécuté en mode sécurisé.
- $cfg['MemoryLimit'] entier ['nombre d'octets']
- Définit le nombre d'octets q'un script est autorisé à allouer. Si ce nombre
est défini à zéro, aucune limite n'est imposée.
Ce paramètre est utilisé lors de l'importation/exportation de fichiers dump mais n'a aucun
effet lorsque PHP est exécuté en mode sécurisé.
Vous pouvez aussi utiliser une chaîne comme dans le fichier php.ini, par ex. '16M'.
- $cfg['SkipLockedTables'] booléen
- Marque les tables utilisées et permet de montrer les bases
de données avec des tables verrouillées (depuis la version MySQL 3.23.30).
- $cfg['ShowSQL'] booléen
- Définit si les requêtes SQL
générées par phpMyAdmin doivent être affichées.
- $cfg['AllowUserDropDatabase'] booléen
- Définit si les utilisateurs lamda (non administrateur)
sont autorisés à supprimer leur propre base de
données. S'il est défini à FALSE, le lien
« Supprimer la base … » ne sera pas visible,
et même la commande « DROP DATABASE
ma_base_de_donnees » sera rejetée. Très pratique
pour un FAI avec beaucoup de clients.
Veuillez noter que cette limitation des requêtes SQL
n'est pas aussi stricte en utilisant les privilèges MySQL. Cela est dû à la nature
des requêtes SQL qui peuvent être très
compliquées. Aussi, ce choix doit être vu comme une aide pour éviter une suppression
accidentelle plutôt qu'une limitation de privilèges stricte.
- $cfg['Confirm'] booléen
- Définit si un avertissement (« Êtes-vous
vraiment sûr… ») doit être affiché quand vous
êtes sur le point de perdre des données.
- $cfg['LoginCookieRecall'] booléen
- Définit si le compte de connexion précédent
doit être rappelé en mode d'authentification par cookie.
- $cfg['LoginCookieValidity'] entier ['nombre de secondes']
- Définit la durée de validité d'un cookie de connexion.
- $cfg['LoginCookieStore'] entier ['nombre de secondes']
- Définit la durée de stockage d'un cookie de connexion dans votre navigateur.
Par défaut, 0 signifie qu'il sera conservé pour la session en cours. Ceci est
recommandé pour les environnements non sécurisés.
- $cfg['LoginCookieDeleteAll'] booléen
- Si activé (par défaut), la déconnexion supprime les cookies
pour tous les serveurs, sinon seulement pour le serveur en cours. Définir ce paramètre
à false permet d'oublier plus facilement de se déconnecter des autres
des autres serveurs quand vous en utilisez plusieurs.
- $cfg['UseDbSearch'] booléen
- Définit si « rechercher une chaîne dans la base
de données » est activé.
- $cfg['IgnoreMultiSubmitErrors'] booléen
- Définit si phpMyAdmin continuera à exécuter
une requête multiple si l'une d'elles échoue. Par
défaut, l'exécution de la requête multiple sera
arrêtée.
- $cfg['VerboseMultiSubmit'] booléen
- Définit si phpMyAdmin affichera les résultats de
chaque requête d'une requête multiple
intégrés dans le fichier journal SQL en tant que
commentaires insérés. Défini par défaut
à TRUE.
-
$cfg['AllowArbitraryServer'] booléen
- Si ce paramètre est activé, il vous permet de vous connecter à des serveurs arbitraires en utilisant
l'authentification par cookie.
REMARQUE : Veuillez utiliser ce paramètre avec
précaution, car il peut permettre aux utilisateurs d'accéder aux
serveurs MySQL placés derrière votre pare-feu où votre
serveur HTTP est situé.
- $cfg['LeftFrameLight'] booléen
- Définit si on utilise un menu construit par
sélection et si on affiche seulement les tables en cours dans le
cadre de gauche (page plus réduite). Vous ne pouvez utiliser la
fonctionnalité d'affichage des dossiers imbriqués en
utilisant $cfg['LeftFrameTableSeparator']
qu'en mode non allégé.
- $cfg['LeftFrameDBTree'] booléen
- En mode allégé, définit si l'affichage des noms de bases de données (dans le
sélecteur) se fait en utilisant un arbre, voir également
$cfg['LeftFrameDBSeparator'].
- $cfg['LeftFrameDBSeparator'] chaîne
- La chaîne est utilisée pour séparer les parties du nom de
la base de données lors de leur affichage dans un arbre.
- $cfg['LeftFrameTableSeparator'] chaîne
- Définit une chaîne à utiliser pour les
espaces de table imbriquée. Défini par défaut
à '__'. Ceci signifie que si vous avez des tables telles que
'première__seconde__troisième' elles seront
affichées comme une hiérarchie à trois niveaux
telle que : premier > seconde >
troisième. Si défini à FALSE ou vide, la
fonctionnalité est désactivée. REMARQUE : vous ne
devez pas utiliser ce séparateur dans un nom de table
comme préfixe ou suffixe, ou plusieurs fois
consécutivement à l'intérieur du nom de la table.
- $cfg['LeftFrameTableLevel'] chaîne
- Définit le nombre de sous-niveaux qui doivent être
affichés quand les tables sont subdivisées par le
séparateur ci-dessus.
- $cfg['ShowTooltip'] booléen
- Définit si un commentaire de table est affiché
comme info-bulle dans le cadre de gauche.
- $cfg['ShowTooltipAliasDB'] booléen
- Si les info-bulles sont activées et qu'un commentaire de
base de données est défini, cela affichera le commentaire
et le nom réel de la table. Cela signifie que si vous avez une
table appelée 'user0001' et que vous y ajoutiez le commentaire 'MonNom', vous verrez
donc le nom 'MonNom' utilisé dans le cadre de gauche et l'info-bulle
affichera le vrai nom de la base de données.
- $cfg['ShowTooltipAliasTB'] booléen
- Identique à $cfg['ShowTooltipAliasDB'],
sauf qu'il fonctionne pour les noms de tables.
Quand il est défini à 'nested', l'alias du nom de table est seulement utilisé
pour diviser/imbriquer les tables selon la directive
$cfg['LeftFrameTableSeparator'].
Donc, seul le dossier est appelé comme l'alias, le nom de la table elle-même
demeure le vrai nom de la table.
- $cfg['LeftDisplayLogo'] booléen
- Définit si le logo de phpMyAdmin est affiché
en haut, dans le cadre de gauche. Défini par défaut à TRUE.
- $cfg['LeftLogoLink'] chaîne
- Saisissez l'URL vers laquelle le logo du panneau de gauche pointera. À utiliser notamment
pour les thèmes personnalisés qui changent cela.
- $cfg['LeftDisplayServers'] booléen
- Définit si un choix de serveur est proposé
en haut, dans le cadre de gauche. Défini par défaut à FALSE.
- $cfg['DisplayServersList'] booléen
- Définit si ce choix de serveur est affiché sous forme de liens ou de liste déroulante.
Défini par défaut à FALSE (liste déroulante).
- $cfg['ShowStats'] booléen
- Définit si on affiche l'espace disque utilisé
et les statistiques sur les bases de données et les tables.
Les statistiques nécessitent au moins la version 3.23.3 de MySQL
3.23.3 et, à ce jour, MySQL ne fournit pas de telles
informations pour les tables de base de données Berkeley.
- $cfg['ShowPhpInfo'] booléen
$cfg['ShowChgPassword'] booléen
$cfg['ShowCreateDb'] booléen
- Définit si on affiche les liens « Afficher les informations relatives à PHP » et
« Modifier le mot de passe » ou le formulaire de crétion de base de données
dans le cadre principal (de droite) de
démarrage. Ce paramètre ne vérifie pas les commandes MySQL entrées directement.
Veuillez noter que pour empêcher l'utilisation de phpinfo() dans
les scripts, vous devez mettre ceci dans votre fichier
php.ini :
disable_functions = phpinfo()
Veuillez également noter qu'activer le lien « Modifier le
mot de passe » n'a pas d'effet utilisé avec le mode
d'authentification « config »: parce que le mot de passe est
codé dans le fichier de configuration, les utilisateurs finaux
ne sont pas autorisés à changer leur mot de passe.
- $cfg['SuggestDBName'] booléen
- Définit si un nom de base de données doit
être suggéré dans le formulaire « Créer
une base de données » ou si le champ est laissé vide.
- $cfg['ShowBlob'] booléen
- Définit si les champs BLOB sont affichés
en naviguant dans le contenu d'une base.
- $cfg['NavigationBarIconic'] chaîne
- Définit si les boutons de la barre de navigation et le menu supérieur du panneau de droite affichent
le texte ou les icônes seulement. La valeur TRUE affiche les icônes, FALSE affiche seulement le texte et 'both'
affiche le texte et les icônes.
- $cfg['ShowAll'] booléen
- Définit si un utilisateur peut avoir un bouton
« Tout afficher » en mode « Afficher ».
- $cfg['MaxRows'] entier
- Nombre de colonnes affichées lors de la navigation sur un
ensemble de résultats. Si le nombre des colonnes est
supérieur, des liens « Suivant » et « Précédent »
seront affichés.
- $cfg['Order'] chaîne ['DESC|ASC|SMART']
- Définit si les champs sont affichés en ordre
croissant (ASC), décroissant (DESC) ou en ordre
« intelligent » (SMART) - c'est-à-dire en
ordre décroissant pour les champs de type TIME, DATE, DATETIME
& TIMESTAMP et croissant pour les autres - par défaut.
- $cfg['ProtectBinary'] booléen ou chaîne
- Définit si les champs BLOB ou BINARY
sont protégés lors de l'affichage du contenu d'une
table. Les valeurs permises sont :
- FALSE pour permettre la modification de tous les champs;
- blob pour permettre la modification de tous les champs sauf les champs BLOBS;
- all pour interdire la modification des champs BINARY ou BLOB.
- $cfg['ShowFunctionFields'] booléen
- Définit si les champs des fonctions MySQL doivent
être affichés en mode modification/insertion.
- $cfg['CharEditing'] chaîne
- Définit quels types de contrôles d'édition
doivent être utilisés pour les champs CHAR et VARCHAR. Les
valeurs permises sont :
- input - ceci permet de limiter la taille du texte en
fonction de la taille du champ dans MySQL, mais il y a des
problèmes avec les caractères « newline » dans
les champs
- textarea - aucun problème avec les caractères
« newline », mais ne permet pas de limitation de taille
Par défaut, l'ancien comportement est utilisé, c'est-à-dire input.
- $cfg['InsertRows'] entier
- Définit le nombre maximum d'entrées simultanées pour la page Insertion.
- $cfg['ForeignKeyMaxLimit'] entier
- S'il y a moins d'éléments que ce nombre dans le jeu de clés étrangères, alors un
menu déroulant des clés étrangères est proposé, avec le style décrit
dans le paramètre $cfg['ForeignKeyDropdownOrder'].
- $cfg['ForeignKeyDropdownOrder'] tableau
- Il y a plusieurs méthodes d'affichage pour les champs du menu déroulant des clés étrangères,
proposant la clé et sa valeur. Le tableau doit contenir une ou les deux valeurs suivantes :
'content-id', 'id-content'.
- $cfg['ZipDump'] booléen
$cfg['GZipDump'] booléen
$cfg['BZipDump'] booléen
- Définit si on utilise la compression zip/GZip/BZip2 lors
de la création de fichiers d'exportation.
- $cfg['CompressOnFly'] booléen
- Définit si on autorise la compression à la
volée pour des exportations au formats GZip/BZip2. Ceci
n'affecte pas les plus petites exportations et permet aux utilisateurs d'en créer
de plus grandes, qui sans cela, ne tiendraient pas en mémoire,
à cause de la limitation mémoire de php. Produit des
fichiers contenant plus d'en-têtes GZip/BZip2, mais tous les
programmes courants les manipulent correctement.
- $cfg['LightTabs'] chaîne
- Si défini à TRUE, utilise des onglets graphiquement
moins consommateurs pour l'unité centrale.
- $cfg['PropertiesIconic'] chaîne
- Si défini à TRUE, affichera des icônes au
lieu d'un texte pour les liens de propriétés des bases de
données et des tables (comme 'Afficher', 'Sélectionner',
'Insérer', …).
Peut être paramétré à 'both' si vous voulez
les icônes et le texte.
Quand il est défini à FALSE, n'affiche que le texte.
- $cfg['PropertiesNumColumns'] entier
- Définit le nombre de colonnes qui seront utilisées
pour afficher les tables dans la vue propriété de la base
de données. Par défaut, une colonne. En
définissant cette variable à une valeur supérieure
à un, le type de la base de données sera omis pour offrir
plus de place pour l'affichage.
- $cfg['DefaultTabServer'] chaîne
- Définit l'onglet affiché par défaut dans la
vue serveur. Les valeurs autorisées sont :
« main.php » (recommandé pour les configurations
multi-utilisateurs),
« server_databases.php », « server_status.php »,
« server_variables.php »,
« server_privileges.php » ou
« server_processlist.php ».
- $cfg['DefaultTabDatabase'] chaîne
- Définit l'onglet affiché par défaut pour la
vue base de données. Les valeurs autorisées sont :
« db_details_structure.php », « db_details.php » ou « db_search.php ».
- $cfg['DefaultTabTable'] chaîne
- Définit l'onglet affiché par défaut dans la
vue table. Les valeurs autorisées sont :
« tbl_properties_structure.php »,
« tbl_properties.php », « tbl_select.php »,
« tbl_change.php » ou « sql.php ».
- $cfg['MySQLManualBase'] chaîne
- Si défini sur une URL qui pointe vers la documentation de
MySQL (le type dépend de $cfg['MySQLManualType']), les liens d'aide
appropriés sont générés.
Voir la Page de documentation MySQL pour plus de renseignements sur les manuels
de MySQL et leurs types.
- $cfg['MySQLManualType'] chaîne
- Type de documentation MySQL :
- viewable - « consultable en ligne », utilisé actuellement sur le site Web de MySQL
- searchable - « Recherche, avec commentaires des utilisateurs »
- chapters - « HTML, une page par chapitre »
- big - « HTML, tout dans une seule page »
- none - ne montre pas les liens de documentation
- $cfg['DefaultLang'] chaîne
- Définit la langue par défaut à utiliser, si
ce n'est pas le cas, la configuration du navigateur ou celle de
l'utilisateur sera utilisée.
Voir le script select_lang.lib.php pour connaître les
valeurs autorisées pour ce paramètre.
- $cfg['DefaultConnectionCollation'] chaîne
- Définit la connexion par défaut à utiliser si elle n'est pas définie par l'utilisateur.
Consultez la documentation MySQL
pour obtenir une liste des valeurs possibles.
- $cfg['Lang'] chaîne
- Force : toujours utiliser cette langue (doit être
défini dans le script select_lang.lib.php).
- $cfg['FilterLanguages'] chaîne
- Limite la liste des langues disponibles à celle concordant
à une expression régulière donnée.
Par exemple, si vous ne voulez que le tchèque et l'anglais, vous devrez
définir le filtre suivant :
'^(cs|en)'.
- $cfg['DefaultCharset'] chaîne
- Page de code utilisée pour le recodage des requêtes
MySQL. Ceci doit être activé et est décrit par
l'option $cfg['AllowAnywhereRecoding'].
Vous pouvez donner ici n'importe quelle page de code se trouvant dans
le tableau $cfg['AvailableCharsets'] et il s'agit seulement
du choix par défaut, l'utilisateur peut choisir n'importe laquelle d'entre elles.
- $cfg['AllowAnywhereRecoding'] booléen
- Permet le recodage de la page de code des requêtes MySQL.
Vous avez besoin de la prise en charge de recode ou iconv
(compilés ou en tant que modules) dans PHP pour permettre le
recodage des requêtes MySQL et le fichier de langue
utilisée doit avoir cette option activée (par
défaut, seulement celles qui sont en Unicode, pour
éviter de perdre des caractères).
En définissant cette valeur à TRUE, cela active également un menu déroulant
dans la page « Export », pour choisir le jeu de caractères utilisé pour l'export d'un fichier.
- $cfg['RecodingEngine'] chaîne
- Pour pouvez choisir ici quelles fonctions seront utilisées
pour la conversion de page de code. Les valeurs autorisées sont :
- auto - utilise automatiquement une fonction disponible (la
première testée est iconv, puis recode),
- iconv - utilise les fonctions iconv ou libiconv,
- recode - utilise la fonction recode_string.
Par défaut à auto.
- Spécifie des paramètres pour iconv utilisés dans la conversion de page de code.
Voir la documentation
iconv pour plus de renseignements. Par défaut
//TRANSLIT est utilisé de sorte
que les caractères invalides soient substitués.
- $cfg['AvailableCharsets'] tableau
- Pages de code disponibles pour la conversion MySQL. Vous pouvez
ajouter la vôtre (n'importe laquelle prise en charge par
recode/iconv) ou supprimer celle dont vous ne vous servez pas. Les
pages de code seront affichées dans le même ordre que
celui défini ici; aussi, si vous en utilisez fréquemment
quelques-unes, faites les figurer en début de tableau.
- $cfg['GD2Available'] chaîne
- Spécifie si GD est disponible en version 2 ou
ultérieure. Si c'est le cas, il peut être utilisé
pour les transformations MIME.
Les valeurs autorisées sont :
- auto - détection automatique, qui est une
opération consommatrice pour les versions de php
antérieures à la 4.3.0; aussi, il est
préférable de changer ce paramètre en fonction des
possibilités réelles de votre serveur,
- yes - les fonctions GD 2 peuvent être utilisées,
- no - les fonctions GD 2 ne peuvent pas être utilisées.
Par défaut à auto.
- $cfg['LeftWidth'] entier
- Largeur du cadre de gauche en pixels. Voir themes/themename/layout.inc.php.
- $cfg['LeftBgColor'] chaîne ['couleur HTML']
$cfg['RightBgColor'] chaîne ['couleur HTML']
- Les couleurs d'arrière-plan (HTML) utilisées pour
les deux cadres. Voir themes/themename/layout.inc.php.
- $cfg['RightBgImage'] chaîne
- L'URI de l'image de fond utilisée pour le cadre de droite.
Elle doit être absolue. Voir themes/themename/layout.inc.php.
- $cfg['LeftPointerColor'] chaîne ['couleur HTML']
- La couleur (HTML) utilisée pour le pointeur dans le cadre
de gauche (ne fonctionne pas avec Netscape 4). Voir themes/themename/layout.inc.php.
- $cfg['LeftPointerEnable'] booléen
- Une valeur à TRUE active le pointeur de gauche (quand LeftFrameLight est à FALSE).
- $cfg['Border'] entier
- Taille de la bordure d'une table. Voir themes/themename/layout.inc.php.
- $cfg['ThBgcolor'] chaîne ['couleur HTML']
- La couleur (HTML) utilisée pour les en-têtes de
table. Voir themes/themename/layout.inc.php.
- $cfg['BgcolorOne'] chaîne ['couleur HTML']
- La couleur (HTML) numéro 1 pour les premiers enregistrements de table.
Voir themes/themename/layout.inc.php.
- $cfg['BgcolorTwo'] chaîne ['couleur HTML']
- La couleur (HTML) numéro 2 pour les seconds enregistrements de table.
Voir themes/themename/layout.inc.php.
- $cfg['BrowsePointerColor'] chaîne ['couleur HTML']
$cfg['BrowseMarkerColor'] chaîne ['couleur HTML']
- Les couleurs (HTML) utilisées pour le pointeur et le
marqueur en mode affichage (ne fonctionne pas avec Netscape 4).
La première met en surbrillance l'enregistrement sur lequel
passe votre souris et la dernière vous permet de
marquer/démarquer les enregistrements en cliquant dessus.
Vous pouvez désactiver ces deux fonctionnalités en
laissant vides leurs directives respectives.
Voir themes/themename/layout.inc.php.
- $cfg['BrowsePointerEnable'] booléen
- Activation ou désactivation du pointeur de navigation.
- $cfg['BrowseMarkerEnable'] booléen
- Activation ou désactivation du marqueur de navigation.
- $cfg['TextareaCols'] entier
$cfg['TextareaRows'] entier
$cfg['CharTextareaCols'] entier
$cfg['CharTextareaRows'] entier
- Nombre de colonnes et d'enregsitrements pour les zones de texte.
Cette valeur sera multipliée par 2 pour les zones de texte de
requête SQL et par 1,25 pour les zones de texte
SQL à
l'intérieur de la fenêtre de requête.
Les valeurs Char* sont utilisées pour l'édition de CHAR
et VARCHAR (si configurées dans $cfg['CharEditing']).
- $cfg['LongtextDoubleTextarea'] booléen
- Définit si la zone de texte pour les champs LONGTEXT doit avoir une taille double.
- $cfg['TextareaAutoSelect'] booléen
- Définit si toute la surface de la zone de texte de la boîte de requête sera
sélectionnée en cliquant dessus.
-
$cfg['CtrlArrowsMoving'] booléen
- Permet le déplacement entre les champs à l'aide de
Ctrl + flèches de direction (Option + flèches de direction dans Safari) lors de l'édition.
- $cfg['LimitChars'] entier
- Nombre maximum affiché de caractères dans tout
champ non numérique en mode Afficher. Peut être
désactivé par un bouton radio dans la page en cours.
- $cfg['ModifyDeleteAtLeft'] booléen
$cfg['ModifyDeleteAtRight'] booléen
- Définit l'endroit où les liens modifier et
supprimer seront affichés quand le contenu des tables est
affichée (vous pouvez les voir affichés à la fois
à gauche et à droite). « Gauche » et
« droite » sont traduits par « haut » et
« bas » en mode d'affichage vertical.
- $cfg['DefaultDisplay'] chaîne
chaîne
- Il existe trois modes d'affichage : 'horizontal', 'horizontalflipped' et
'vertical'. Définit lequel est affiché par défaut.
Le premier mode affiche chaque enregistrement sur une ligne horizontale, le
second fait pivoter les en-têtes de 90 degrés, de la
sorte vous pouvez utiliser des en-têtes descriptifs même si
les champs contiennent de petites valeurs et les imprimer. Le mode
vertical trie chaque enregistrement verticalement.
Le paramètre HeaderFlipType peut être défini
à 'css' ou 'faked'. En utilisant 'css' la rotation de
l'en-tête dans le mode 'horizontalflipped' est faite par la
feuille de style (CSS). S'il est défini à 'faked ', PHP
fait la transformation pour vous, mais bien sûr, ce ne sera pas
aussi beau qu'avec la feuille de style.
- $cfg['DefaultPropDisplay'] chaîne
- En modifiant/créant de nouvelles colonnes dans une table, tous les champs sont normalement
alignés sur une ligne. (par défaut : 'horizontal'). Si
vous le définissez à 'vertical', vous aurez chaque champ
aligné verticalement. Vous pouvez économiser beaucoup de
place dans le sens horizontal, sans avoir à scroller.
- En définissant la variable correspondante à TRUE,
vous pouvez afficher les commentaires de colonnes en mode Navigation ou
Propriétés. En mode navigation, les commentaires sont
affichés à l'intérieur de l'en-tête. En mode propriétés,
les commentaires sont affichés en utilisant une feuille de style
qui met une ligne de tirets sous le nom du champ. Le commentaire est
montré en tant qu'info-bulle pour ce champ.
- $cfg['UploadDir'] chaîne
- Le nom du répertoire où les fichiers SQL ont
été transférés autrement qu'avec phpMyAdmin
(ftp, par exemple). Ces fichiers sont disponibles sous forme d'une liste
déroulante quand vous cliquez sur le nom d'une base de
données, puis l'onglet SQL.
Si vous voulez un répertoire différent pour chaque utilisateur,
%u sera remplacé par le nom d'utilisateur.
Veuillez noter que le nom des fichiers doit avoir le suffixe
« .sql » (ou « .sql.bz2 » ou « .sql.gz »
si la gestion des formats compressés est activée).
Cette fonctionnalité est utile quand votre fichier est trop gros
pour être transféré en HTTP, ou quand les
transferts de fichiers sont désactivés dans PHP.
Veuillez noter également que si PHP est exécuté en
mode sécurisé, ce répertoire doit appartenir au
même utilisateur que le propriétaire des scripts.
Voir aussi la section
FAQ 1.16 pour des alternatives.
- $cfg['docSQLDir'] chaîne
- Le nom du répertoire où les fichiers docSQL peuvent être transférés
pour être importés dans phpMyAdmin.
Veuillez noter que si PHP est exécuté en mode sécurisé, ce répertoire doit appartenir au même utilisateur que le propriétaire des scripts.
- $cfg['SaveDir'] chaîne
- Le nom du répertoire où les fichiers d'exportation
peuvent être sauvegardés.
Si vous voulez un répertoire différent pour chaque utilisateur,
%u sera remplacé par le nom d'utilisateur.
Veuillez noter que le répertoire doit être accessible en
écriture à l'utilisateur du serveur Web.
Veuillez noter également que si PHP est exécuté en mode
sécurisé, ce répertoire doit appartenir au même utilisateur que le
propriétaire des scripts.
- $cfg['TempDir'] chaîne
- Le nom du répertoire où les fichiers temporaires peuvent être stockés.
Ceci est nécessaire pour l'exportation au format natif MS Excel, voir la section FAQ 6.23
- $cfg['Export'] tableau
- Dans ce tableau sont définis les paramètres par
défaut pour les fichiers d'exportation; les noms des items sont
similaires aux textes vus dans la page d'exportation, de la sorte vous
pouvez facilement identifier ce qu'ils signifient.
- $cfg['Import'] tableau
- Dans ce tableau sont définis les paramètres par défaut pour l'importation. Les noms des
éléments sont similaires aux textes affichés dans la page d'importation, de sorte que vous pouvez
facilement identifier ce qu'ils signifient.
- $cfg['RepeatCells'] entier
- Répète les en-têtes toutes les X cellules, ou 0 pour désactiver.
- $cfg['EditInWindows'] booléen
$cfg['QueryWindowWidth'] entier
$cfg['QueryWindowHeight'] entier
$cfg['QueryHistoryDB'] booléen
$cfg['QueryWindowDefTab'] chaîne
$cfg['QueryHistoryMax'] entier
- Toutes ces variables affectent la nouvelle fenêtre/cadre de requête. Quand
Un lien ou une icône SQL est toujours affiché dans le panneau de gauche.
Si JavaScript est activé dans votre navigateur, cliquer dessus provoque l'ouverture de
la boîte de requête, une interface directe pour saisir les requêtes SQL.
La taille de la fenêtre de requête peut être personnalisée avec
$cfg['QueryWindowWidth'] et $cfg['QueryWindowHeight'] - les deux paramètres sont des entiers
exprimant la taille en pixels.
Veuillez noter que normalement, ces paramètres seront modifiés dans layout.inc.php
pour le thème que vous utilisez.
Si $cfg['EditInWindows'] est défini à TRUE, cliquer sur ['Modifier']
à partir de la page des résultats (dans la section « Affichage des enregistrements »)
ouvre la fenêtre de requête et y met la requête en cours. S'il est défini à
FALSE, cliquer sur le lien met la requête SQL dans la boîte de requête du panneau droit.
L'utilisation, de la fenêtre de requête JavaScript est
recommandée si vous avez un navigateur gérant le
JavaScript. Les fonctions de bases sont utilisées pour
échanger quelques variables, aussi, la plupart des navigateurs
de 4ème génération doivent être capables
d'utiliser cette fonctionnalité. Actuellement, cela a
été seulement testé avec Internet Explorer 6
et Mozilla 1.x.
Si $cfg['QueryHistoryDB'] est défini à TRUE, toutes vos
requêtes sont journalisées dans une table, que vous devez
créer (voir $cfg['Servers'][$i]['history']).
Si il est défini à FALSE, toutes vos requêtes
seront ajoutées au formulaire, mais elles seront
sauvegardées seulement tant que votre fenêtre est ouverte.
En utilisant la fenêtre de requête basée sur
JavaScript, elle sera toujours mise à jour quand vous cliquez
sur une nouvelle table/base de données à afficher et se
réduira si vous cliquez sur « Modifier SQL »
après avoir utilisé une requête. Vous pouvez
supprimer la mise à jour de la fenêtre de requête en
cochant la case « Ne pas écraser cette requête depuis
une autre fenêtre » sous la zone de texte de requête.
Alors vous pouvez afficher des tables/bases de données en
arrière-plan sans perdre le contenu de la zone de texte, ce qui
est particulièrement pratique quand vous faites des
requêtes sur des tables dont vous devez d'abord regarder le
contenu. La case sera automatiquement cochée chaque fois que
vous changez le contenu de la zone de texte. Décochez cette case
si jamais vous vouliez que la fenêtre de requêtes soit
toujours mise à jour, même si vous avez fait des
modifications.
Si $cfg['QueryHistoryDB'] est défini à TRUE, vous pouvez
spécifier le nombre d'entrées dans l'historique en
utilisant $cfg['QueryHistoryMax'].
La fenêtre de requêtes a également des onglets pour
regrouper les fonctionnalités.
En utilisant la variable $cfg['QueryWindowDefTab'] vous pouvez
spécifier l'onglet par défaut à utiliser à
l'ouverture de la fenêtre de requêtes. Elle peut être
définie à 'sql', 'files', 'history' ou 'full'.
- $cfg['BrowseMIME'] booléen
- Active les Transformations MIME.
- $cfg['MaxExactCount'] entier
- Pour les tables InnoDB, détermine pour quelle taille de tables phpMyAdmin doit
obtenir le nombre de lignes exact avec
SELECT COUNT. Si
le compte approximatif de lignes renvoyé par SHOW TABLE STATUS est inférieur à cette
valeur, SELECT COUNT sera utilisé, sinon, la valeur approximative sera utilisée.
- Pour VIEW, puisqu'obtenir le compte exact pourrait avoir un impact sur les performances, cette valeur est la valeur
maximum à afficher
-
$cfg['WYSIWYG-PDF'] booléen
- Utilise un contrôle d'édition WYSIWYG pour placer
facilement les éléments d'une page PDF. En cliquant sur
le bouton 'Éditeur visuel' dans la page sur laquelle vous
éditez les coordonnées x/y de ces éléments,
vous pouvez activer un éditeur visuel où tous vos
éléments sont placés. En cliquant sur un
élément, vous pouvez le déplacer dans la zone
prédéfinie et les coordonnées x/y
seront mises à jour dynamiquement. De même, si vous entrez
directement une nouvelle position dans le champ de saisie, la nouvelle
position dans l'éditeur visuel change après que vos
curseurs aient quitté le champ de saisie.
Vous devez cliquer sur le bouton 'OK' en-dessous des tables pour
sauvegarder les nouvelles positions. Si vous voulez placer un nouvel
élément, ajoutez-le d'abord à la table des
éléments et alors vous pourrez déplacer ce nouvel
élément.
En changeant la taille du papier et l'orientation, vous changez
également la taille de l'éditeur visuel. Vous pouvez le
faire en changeant seulement le champ déroulant au-dessous, et
l'éditeur visuel se réajustera automatiquement,
sans interférer avec les positions des éléments en
cours.
Si un élément sortait du champ, vous pouvez soit agrandir
la taille du papier, soit cliquer sur le bouton 'Réinitialiser
les valeurs' pour placer tous les éléments les uns
en-dessous des autres.
REMARQUE : Vous devez utiliser un navigateur récent
comme IE6 ou Mozilla pour que ce contrôle puisse fonctionner. La fonctionnalité
de script Drag&Drop a été empruntée
à www.youngpup.net et sa licence sous-jacente si spécifique.
- $cfg['NaturalOrder'] booléen
- Trie les noms des bases de données en ordre naturel (par exemple,
t1, t2, t10). Actuellement mis en oeuvre dans le panneau de gauche (Mode allégé)
et dans la vue Base de données, pour la liste des tables.
- $cfg['TitleTable'] chaîne
- $cfg['TitleDatabase'] chaîne
- $cfg['TitleServer'] chaîne
- $cfg['TitleDefault'] chaîne
- Vous permet d'indiquer le titre de la fenêtre. Les chaînes suivantes peuvent être
utilisées pour obtenir des valeurs spéciales :
@HTTP_HOST@
- Hôte HTTP exécutant phpMyAdmin
@SERVER@
- Nom du serveur MySQL
@VERBOSE@
- Nom complet du serveur MySQL tel qu'indiqué dans la configuration serveur
@VSERVER@
- Nom complet du serveur MySQL si défini, sinon normal
@DATABASE@
- Base de données actuellement ouverte
@TABLE@
- Table actuellement ouverte
@PHPMYADMIN@
- Version de phpMyAdmin
- $cfg['ErrorIconic'] booléen
- Utilise des icônes pour les avertissements, les erreurs et les informations.
- $cfg['MainPageIconic'] booléen
- Utilise des icônes pour les listes de la page principale et les onglets de menus.
- $cfg['ReplaceHelpImg'] booléen
- Affiche un bouton d'aide plutôt que le message « Documentation ».
- $cfg['ThemePath'] chaîne
- Si le gestionnaire de thèmes est actif, utilise ceci comme le chemin du sous-répertoire
contenant les tous les thèmes.
- $cfg['ThemeManager'] booléen
- Active la sélection par l'utilisateur des thèmes. Voir
FAQ 2.7.
- $cfg['ThemeDefault'] string
- Le thème par défaut (un sous-répertoire de cfg['ThemePath']).
- $cfg['ThemePerServer'] booléen
- Autorise ou non un thème différent pour chaque serveur.
- $cfg['DefaultQueryTable'] chaîne
$cfg['DefaultQueryDatabase'] chaîne
- Requête par défaut qui sera affichée dans les
boîtes de requêtes, quand l'utilisateur n'en spécifie aucune. Utilisez %d pour le nom de base de
données et %t pour le nom de table et %f pour une liste de noms de champs séparés par des virgules.
Notez que %t et %f sont seulement applicables pour $cfg['DefaultQueryTable'].
- $cfg['SQP']['fmtType'] chaîne ['html|none']
- L'utilisation principale du nouvel analyseur syntaxique SQL est
de permettre un affichage de requêtes SQL plus clair. Par
défaut, nous utilisons HTML pour mettre en page la
requête, mais vous pouvez désactiver ce paramètre
en définissant cette variable à 'none'.
- $cfg['SQP']['fmtInd'] flottant
$cfg['SQP']['fmtIndUnit'] chaîne
[em|px|pt|ex]
- Pour un affichage plus clair des requêtes SQL, dans
certains cas, la partie d'une requête à l'intérieur
de parenthèses est indentée. En changeant $cfg['SQP']['fmtInd']
vous pouvez modifier l'importance de cette indentation.
Dans le même ordre d'idée, $cfg['SQP']['fmtIndUnit']
spécifie les unités de la valeur de l'indentation que
vous avez spécifié. Ceci est utilisé pour les
feuilles de style.
- $cfg['SQP']['fmtColor'] tableau de tuples chaîne
- Ce tableau est utilisé pour définir les couleurs
pour chaque type d'élément de requêtes SQL afin de
les lire plus facilement. Le format du tuple est :
classe => ['code couleur HTML | chaîne
vide']
Si vous spécifiez une chaîne vide pour la couleur d'une
classe, elle est ignorée lors de la création de la
feuille de style. Vous ne devez pas modifier les noms de classes,
seulement les chaînes couleur.
Clé pour le nom de classe :
- comment s'applique à toutes les sous-classes de commentaires
- comment_mysql commentaires tels que « #…\n »
- comment_ansi commentaires tels que « --…\n" »
- comment_c commentaires tels que « /*…*/ »
- digit s'applique à toutes les sous-classes nombre
- digit_hex nombres hexadécimaux
- digit_integer nombres entiers
- digit_float nombres à virgule flottante
- punct s'applique à toutes les sous classes ponctuation
- punct_bracket_open_round parenthèses ouvrantes « ( »
- punct_bracket_close_round parenthèses fermantes « ) »
- punct_listsep séparateur de liste « , »
- punct_qualifier qualificateur de table/colonne « . »
- punct_queryend marqueur de fin de requête « ; »
- alpha s'applique à toutes les sous-classes alphabétiques
- alpha_columnType identifiants correspondant à un type de colonne
- alpha_columnAttrib identifiants correspondant à un attribut de base de données/table/colonne
- alpha_functionName identifiants correspondant à un nom de fonction MySQL
- alpha_reservedWord identifiants correspondant à tout autre mot réservé
- alpha_variable identifiants correspondant à une variable SQL « @foo »
- alpha_identifier tout autre identifiant
- quote s'applique à toutes les sous-classes de marques de citation
- quote_double guillemets anglais "
- quote_single apostrophes '
- quote_backtick apostrophes inversées `
- $cfg['SQLValidator'] booléean
- $cfg['SQLValidator']['use'] booléean
- phpMyAdmin gère maintenant l'utilisation du service Mimer
SQL Validator, tel qu'il a été publié sur
Slashdot.
Pour trouver de l'aide sur le paramétrage de votre
système pour utiliser ce service, voir la section FAQ 6.14.
- $cfg['SQLValidator']['username'] chaîne
$cfg['SQLValidator']['password'] chaîne
- Le service SOAP vous permet de vous connecter avec anonymous
et n'importe quel mot de passe, aussi nous les utilisons par
défaut. Par contre, si vous avez un compte de connexion, vous
pouvez mettre ici vos détails de connexion, et ils seront
utilisés à la place de la connexion anonyme.
- $cfg['DBG']['enable'] booléen
- DÉVELOPPEURS SEULEMENT !
Active l'extension DBG pour le débogage phpMyAdmin.
Nécessaire pour analyser le code.
Pour l'aide dans le paramétrage de votre système avec
cette fonctionnalité, voir la section Développeurs.
- $cfg['DBG']['profile']['enable'] booléen
- DÉVELOPPEURS SEULEMENT !
Active la gestion de l'analyse pour phpMyAdmin. Ceci ajoutera un gros
paquet de données à la fin de chaque page affichée
dans la fenêtre principale avec les statistiques d'analyse pour
cette page.
Vous aurez peut-être besoin d'augmenter le temps maximum
d'exécution pour que cela fonctionne correctement.
- $cfg['DBG']['profile']['threshold'] flottant (unités en millisecondes)
- DÉVELOPPEURS SEULEMENT !
Quand un audit de données est affiché, cette variable
contrôle le seuil d'affichage pour chaque audit de
données, fondé sur le temps moyen que chacun a pris. S'il
est supérieur au seuil, il est affiché, sinon il n'est
pas affiché. Ceci prend une valeur en millisecondes. Dans la
plupart des cas, vous n'avez pas besoin de modifier ce paramètre.
- $cfg['ColumnTypes'] tableau
- Tous les types possibles de colonnes MySQL. Dans la plupart des
cas, vous n'avez pas besoin de modifier ce paramètre.
- $cfg['AttributeTypes'] tableau
- Attributs autorisés pour les champs. Dans la plupart des
cas, vous n'avez pas besoin de modifier ce paramètre.
- $cfg['Functions'] tableau
- Une liste de fonctions que gère MySQL. Dans la plupart des
cas, vous n'avez pas besoin de modifier ce paramètre.
- $cfg['RestrictColumnTypes'] tableau
- Mappage de types de colonnes utilisées pour l'affichage
des fonctions favorites. Dans la plupart des cas, vous n'avez pas
besoin de modifier ce paramètre.
- $cfg['RestrictFunctions'] tableau
- Les fonctions favorites pour la colonne méta-types comme
définies dans $cfg['RestrictColumnTypes'].
Dans la plupart des cas, vous n'avez pas besoin de modifier ce paramètre.
- $cfg['DefaultFunctions'] tableau
- Fonctions sélectionnées par défaut pour insérer/modifier un enregistrement.
Les fonctions sont définies pour les méta-types de
$cfg['RestrictColumnTypes']
et pour
first_timestamp, qui est utilisé pour la
première colonne d'horodatage dans une table.
- $cfg['NumOperators'] tableau
- Opérateurs disponibles pour les opérations de recherche sur les champs numériques et les champs date.
- $cfg['TextOperators'] tableau
- Opérateurs disponibles pour les opérations de recherche sur les champs caractères.
Veuillez noter que nous avons mis
LIKE par défaut plutôt que
LIKE %…%, pour éviter des problèmes imprévus dans le cas de très grandes tables.
- $cfg['EnumOperators'] tableau
- Opérateurs disponibles pour les opérations de recherche sur les champs « enum ».
- $cfg['NullOperators'] tableau
- Opérateurs supplémentaires disponibles pour les opérations de recherche quand
le champ peut avoir la valeur « null ».
- Introduction
- Utilisation
- Structure de fichier
Pour permettre les transformations, vous devez paramétrer la
table column_info et les directives appropriées. Veuillez
consulter la section Configuration
sur la manière de faire.
Vous pouvez appliquer différentes transformations au contenu
de chaque champ. La transformation prendra le contenu de chaque champ
et le transformera en fonction des règles définies dans
la transformation sélectionnée.
Imaginons que vous ayez un champ 'nom_de_fichier' qui contient un
nom de fichier. Normalement, vous ne verriez dans phpMyAdmin que ce nom
de fichier. En utilisant les transformations, vous pouvez transformer
ce nom de fichier en lien HTML, et ainsi cliquer sur la structure de
phpMyAdmin sur le lien du champ et voir le fichier affiché dans
une nouvelle fenêtre de navigateur. En utilisant les options de
transformation, vous pouvez également spécifier des
chaînes pour préfixer ou suffixer des chaînes ou
d'autres formats pour lesquels vous voulez voir le résultat avec
ces transformations.
Pour un aperçu général sur les transformations
et leurs options, vous pouvez consulter la page <www.votre-hote.com>/<votre-repertoire-installation>/transformations/overview.php
de votre installation.
Pour un tutoriel sur la façon d'utiliser efficacement les
transformations, voir notre section Links
sur la page d'accueil officielle de phpMyAdmin.
Consultez votre page tbl_properties.inc.php
(c'est-à-dire,
atteindre la page en cliquant le lien 'Structure' d'une
table). Cliquez alors sur « Modifier » (ou l'icône
Modifier) et alors vous verrez trois nouveaux champs à la fin de
la ligne qui sont : 'Type MIME', 'Transformation' et 'Options de
transformation'.
- Le champ 'Type MIME' est un champ déroulant. Vous avez le
choix de laisser le champ vide ou d'utiliser 'auto' ['cette
fonctionalité n'est pas encore disponible']. Veuillez noter que
les transformations sont inactives tant qu'aucun type MIME n'est
sélectionné.
- Le champ 'Transformation' est un champ déroulant. Vous
pouvez choisir parmi un choix grandissant de transformations
prédéfinies. Voir ci-dessous la façon de
construire votre propre transformation.
Il y a des transformations globales et des transformations de type mime
lié.
Les transformations
globales peuvent être utilisées pour tout type mime. Elles
prendront en considération, si nécessaire , le type mime.
Les transformations de type mime lié fonctionnent habituellement
avec certain type mime. Il y a des transformations qui opèrent
sur le type mime principal (comme 'image'),
qui prendront vraisemblablement en compte le sous-type, et celles qui
n'opèrent que sur un sous-type spécifique (comme
'image/jpeg').
Vous pouvez utiliser des transformations sur les types mime pour
lesquels la fonction n'a pas été définie. Il n'y a
pas de contrôle pour vérifier que vous avez choisi la
bonne transformation, aussi, faites attention au format de votre
résultat.
- Le champ 'Options de transformation' est un champ texte libre.
Vous devez entrer ici des options spécifiques de fonction de
transformation. Généralement, les transformations
fonctionnent avec les options par défaut, mais il est
conseillé de regarder l'aperçu pour voir quelles options
sont nécessaires.
Tout comme les champs ENUM/SET, vous devrez séparer plusieurs
options en utilisant le format
'a','b','c',…(REMARQUEZ QU'IL N'Y A PAS D'ESPACE). Car en interne,
les options seront analysées comme un tableau, en prenant la
première valeur comme le premier élément du
tableau, et ainsi de suite.
Si vous voulez spécifier un jeu de caractères MIME, vous
pouvez le définir dans transformation_options.
Vous devez mettre cela hors des options prédéfinies d'une
transformation mime spécifique,
comme dernière valeur du jeu. Utilisez le format « ';
charset=XXX' ». Si vous utilisez une transformation,
pour laquelle vous pouvez spécifier deux options et que vous
voulez ajouter un jeu de caractères, entrez « 'premier
paramètre','second paramètre','charset=us-ascii' ».
Vous pouvez cependant, utiliser les paramètres par défaut
: « '','','charset=us-ascii' ».
Tous les types mime et leurs transformations sont définis
dans des fichiers dans le répertoire 'libraries/transformations/'.
Ils sont emmagasinés dans des fichiers pour faciliter la
personnalisation et l'ajout aisé de nouvelles transformations.
Parce que l'utilisateur ne peut pas mettre ses propres types mime,
on garde l'assurance que les transformations fonctionnent toujours.
Cela n'a pas de sens d'appliquer une transformation à un type
mime, que la fonction de transformation ne sait pas manipuler.
On peut, cependant, utiliser des types mime vides et des
transformations
globales qui fonctionnent pour beaucoup de types mime. Vous pouvez
aussi utiliser des transformations sur des types mime différents
de ceux pour lesquels elles ont été construites, mais
faites attention aux options d'utilisation tout comme à l'action
qu'aura la transformation sur votre champ.
Il y a un fichier de base appelé 'global.inc.php'. Cette
fonction peut être incluse dans n'importe quelle autre
transformation et fournit des fonctions de base.
Il y a cinq noms de fichiers possibles :
- Une transformation typemime+soustype :
['typemime']_['soustype']__['transformation'].inc.php
Veuillez noter que typemime et soustype sont séparés par
'_', qui ne doit pas être contenu dans leurs noms. La
transformation fonction/nomfichier ne doit contenir que des
caractères qui ne posent pas de problème pour le
système de fichier et pour la convention de nommage de fonction
de PHP.
La fonction de transformation sera appelée 'transformation_PMA_['typemime']_['soustype']__['transformation']()'.
Exemple :
text_html__formatted.inc.php
PMA_transform_text_html__formatted()
- Une transformation de type mime (sans sous-type) :
['typemime']__['transformation'].inc.php
Veuillez noter qu'il n'y a pas de caractère '_' isolé. La
transformation fonction/nomfichier doit contenir seulement des
caractères qui ne posent pas de problème pour le
système de fichier et pour la convention de nommage de PHP.
La fonction de transformation sera appelée
'transformation_PMA_['typemime']__['transformation']()'.
Exemple :
text__formatted.inc.php
transformation_PMA_text__formatted()
- Une transformation typemime+soustype sans fonction de
transformation spécifique
['typemime']_['soustype'].inc.php
Veuillez noter qu'il n'y a pas de caractère '_' dans le fichier.
N'utilisez pas de caractères spéciaux dans le nom de
fichier posant des problèmes avec le système de fichiers.
Aucune fonction de transformation n'est définie dans le fichier lui-même.
Exemple :
text_plain.inc.php
(Pas de fonction)
- Une transformation de type mime (sans sous-type) sans fonction de
transformation spécifique
['typemime'].inc.php
Veuillez noter qu'il n'y a pas de caractère '_' dans le nom de
fichier. N'utilisez pas de caractères spéciaux dans le
nom de fichier posant des problèmes avec le système de
fichiers.
Aucune fonction de transformation n'est définie dans le fichier lui-même.
Exemple :
text.inc.php
(Pas de fonction)
- Une fonction de transformation globale sans type mime spécifique
global__['transform'].inc.php
La fonction de transformation sera appelée
'transformation_PMA_global__['transform']()'.
Exemple :
global__formatted
transformation_PMA_global__formatted()
Utilisez donc généralement '_' pour
séparer le type mime du sous-type, et '__' pour annoncer la
fonction de transformation.
Tous les fichiers ne contenant pas '__' ne sont pas affichés
en tant que fonctions de transformation valides dans la liste
déroulante.
Veuillez consulter le fichier libraries/transformations/TEMPLATE
pour ajouter votre propre fonction de transformation. Veuillez
consulter le fichier libraries/transformations/TEMPLATE_MIMETYPE
pour ajouter un type mime sans fonction de transformation. Veuillez
également prendre en compte l'introduction à la
description de fonction dans les fichiers de langue. Pour chaque
fonction une variable $strTransformation_['nomfichier sans .inc.php']
doit exister.
Vous pouvez utiliser le générateur de modèles
pour créer de nouvelles fonctions et des entrées dans le
fichier de langue.
Pour créer une nouvelle fonction de transformation, veuillez
consulter libraries/transformations/template_generator.sh.
Pour créer un nouveau type mime vide, veuillez consulter
libraries/transformations/template_generator_mimetype.sh.
Une fonction de transformation a toujours besoin de trois variables :
- $buffer - contient le text