This commit is contained in:
Alexander M. Turek
2002-05-15 17:56:26 +00:00
parent 0f9e805777
commit 5e14fbb78c
2 changed files with 191 additions and 191 deletions

View File

@@ -307,7 +307,7 @@
</li> </li>
<li> <li>
Then each of the <i>true</i> users should be granted of a set of Then each of the <i>true</i> users should be granted of a set of
privileges on a set of perticular databases but shouldn't have any privileges on a set of particular databases but shouldn't have any
global privileges. For example, to grant the user <i>real_user</i> with global privileges. For example, to grant the user <i>real_user</i> with
all privileges on the database <i>user_base</i>:<br /> all privileges on the database <i>user_base</i>:<br />
&nbsp;&nbsp;&nbsp;<tt>GRANT ALL PRIVILEGES ON user_base.* TO 'real_user'@localhost IDENTIFIED BY 'real_password';</tt> &nbsp;&nbsp;&nbsp;<tt>GRANT ALL PRIVILEGES ON user_base.* TO 'real_user'@localhost IDENTIFIED BY 'real_password';</tt>
@@ -592,7 +592,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
</li> </li>
<li> <li>
display in an optional tooltip the &quot;display field&quot; display in an optional tooltip the &quot;display field&quot;
when browsing the master table, if when browsing the master table, if
you move the mouse to a column containing a foreign key; you move the mouse to a column containing a foreign key;
</li> </li>
<li> <li>
@@ -646,8 +646,8 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE src_column master_field VARCHAR(32) NOT NULL<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE src_column master_field VARCHAR(32) NOT NULL<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE dest_table foreign_table VARCHAR(32) NOT NULL<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE dest_table foreign_table VARCHAR(32) NOT NULL<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE dest_column foreign_field VARCHAR(32) NOT NULL<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE dest_column foreign_field VARCHAR(32) NOT NULL<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `foreign_display_field` VARCHAR(32) NOT NULL;<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `foreign_display_field` VARCHAR(32) NOT NULL;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `pdf_page_number` int(11) NOT NULL;<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `pdf_page_number` int(11) NOT NULL;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD INDEX(`pdf_page_number`);<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD INDEX(`pdf_page_number`);<br />
</tt><br /> </tt><br />
</dd> </dd>
@@ -659,11 +659,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
Since release 2.3.0 you can describe, in a special 'pdf_table_position' Since release 2.3.0 you can describe, in a special 'pdf_table_position'
table, the coordinates where each table will be placed on a PDF schema table, the coordinates where each table will be placed on a PDF schema
output. This configuration variable will hold the name of this special output. This configuration variable will hold the name of this special
table. table.
<br /><br /> <br /><br />
This feature is supported under PHP4, and you must be using also This feature is supported under PHP4, and you must be using also
the 'relation' feature. the 'relation' feature.
<br /><br /> <br /><br />
To use this functionality you have to: To use this functionality you have to:
<ul> <ul>
<li> <li>
@@ -1676,14 +1676,14 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
<p> <p>
<b>How can I produce a PDF schema of my database?</b> <b>How can I produce a PDF schema of my database?</b>
<br /> <br />
First you have to fill the 'relation' and 'pdf_table_position' First you have to fill the 'relation' and 'pdf_table_position'
configuration variables. configuration variables.
<br /><br /> <br /><br />
Then, think about your schema layout: which tables will go on which Then, think about your schema layout: which tables will go on which
pages. You have to fill in the 'relation' table the page number for pages. You have to fill in the 'relation' table the page number for
each master-foreign link. each master-foreign link.
<br /><br /> <br /><br />
Then manually fill the pdf_table_position table with the coordinates, Then manually fill the pdf_table_position table with the coordinates,
x being the width and y the height, and (0,0) at the upper left corner. x being the width and y the height, and (0,0) at the upper left corner.
For example, x=100 and y=200 means that the table will be at 200 mm For example, x=100 and y=200 means that the table will be at 200 mm
down and 100 mm right from the upper left corner. down and 100 mm right from the upper left corner.
@@ -1871,55 +1871,55 @@ CREDITS, in chronological order
------------------------------- -------------------------------
[tr] - Tobias Ratschiller &lt;tobias_at_phpwizard.net&gt; [tr] - Tobias Ratschiller &lt;tobias_at_phpwizard.net&gt;
* creator of the phpmyadmin project * creator of the phpmyadmin project
* maintainer from 1998 to summer 2000 * maintainer from 1998 to summer 2000
[md] - Marc Delisle &lt;DelislMa_at_CollegeSherbrooke.qc.ca&gt; [md] - Marc Delisle &lt;DelislMa_at_CollegeSherbrooke.qc.ca&gt;
* multi-language version * multi-language version
* various fixes and improvements * various fixes and improvements
[om] - Olivier M<>ller &lt;om_at_omnis.ch&gt; [om] - Olivier M<>ller &lt;om_at_omnis.ch&gt;
* started SourceForge phpMyAdmin project in March 2001 * started SourceForge phpMyAdmin project in March 2001
* sync'ed different existing CVS trees with new features and bugfixes * sync'ed different existing CVS trees with new features and bugfixes
* multi-language improvements, dynamic language selection * multi-language improvements, dynamic language selection
* current project maintainer, with Marc and Loic * current project maintainer, with Marc and Loic
[lc] - Lo<4C>c Chapeaux &lt;lolo_at_phpheaven.net&gt; [lc] - Lo<4C>c Chapeaux &lt;lolo_at_phpheaven.net&gt;
* rewrote and optimized javascript, DHTML and DOM stuff * rewrote and optimized javascript, DHTML and DOM stuff
* rewrote the scripts so they fit the PEAR coding standards and * rewrote the scripts so they fit the PEAR coding standards and
generate XHTML1.0 and CSS2 compliant codes generate XHTML1.0 and CSS2 compliant codes
* improved the language detection system * improved the language detection system
* many bugfixes and improvements * many bugfixes and improvements
[rj] - Robin Johnson &lt;robbat2_at_users.sourceforge.net&gt; [rj] - Robin Johnson &lt;robbat2_at_users.sourceforge.net&gt;
* database maintence controls * database maintence controls
* table type code * table type code
[af] - Armel Fauveau &lt;armel.fauveau_at_globalis-ms.com&gt; [af] - Armel Fauveau &lt;armel.fauveau_at_globalis-ms.com&gt;
* bookmarks feature * bookmarks feature
* multiple dump feature * multiple dump feature
* gzip dump feature * gzip dump feature
* zip dump feature * zip dump feature
[gl] - Geert Lund &lt;glund_at_silversoft.dk&gt; [gl] - Geert Lund &lt;glund_at_silversoft.dk&gt;
* various fixes * various fixes
* moderator of the phpMyAdmin users forum at phpwizard.net * moderator of the phpMyAdmin users forum at phpwizard.net
[kc] - Korakot Chaovavanich &lt;korakot_at_iname.com&gt; [kc] - Korakot Chaovavanich &lt;korakot_at_iname.com&gt;
* &quot;insert as new row&quot; feature * &quot;insert as new row&quot; feature
[pk] - Pete Kelly &lt;webmaster_at_trafficg.com&gt; [pk] - Pete Kelly &lt;webmaster_at_trafficg.com&gt;
* rewrote and fix dump code * rewrote and fix dump code
* bugfixes * bugfixes
[sa] - Steve Alberty &lt;alberty_at_neptunlabs.de&gt; [sa] - Steve Alberty &lt;alberty_at_neptunlabs.de&gt;
* rewrote dump code for PHP4 * rewrote dump code for PHP4
* mySQL table statistics * mySQL table statistics
* bugfixes * bugfixes
[bg] - Benjamin Gandon &lt;gandon_at_isia.cma.fr&gt; [bg] - Benjamin Gandon &lt;gandon_at_isia.cma.fr&gt;
* main author of the version 2.1.0.1 * main author of the version 2.1.0.1
* bugfixes * bugfixes
[at] - Alexander M. Turek &lt;rabus_at_bugfixes.info&gt; [at] - Alexander M. Turek &lt;rabus_at_bugfixes.info&gt;
* various small features and fixes * various small features and fixes
@@ -1943,7 +1943,7 @@ code since version 2.1.0:
relation-links feature. relation-links feature.
- Mike Beck &lt;mike.beck at ibmiller.de&gt; for his work on the Relation table - Mike Beck &lt;mike.beck at ibmiller.de&gt; for his work on the Relation table
feature: automatic joint in QBE, links column in printview, Relation view. feature: automatic joint in QBE, links column in printview, Relation view.
- Maxime Delorme &lt;delorme.maxime at free.fr&gt; for the PDF schema output; - Maxime Delorme &lt;delorme.maxime at free.fr&gt; for the PDF schema output;
thanks also to Olivier Plathey for the fpdf library (www.fpdf.org). thanks also to Olivier Plathey for the fpdf library (www.fpdf.org).
And also to the following people who have contributed minor changes, And also to the following people who have contributed minor changes,

View File

@@ -1,6 +1,6 @@
phpMyAdmin 2.3.0-dev Documentation phpMyAdmin 2.3.0-dev Documentation
* [1]Sourceforge phpMyAdmin project page [ * [1]Sourceforge phpMyAdmin project page [
http://www.phpmyadmin.net/ ] http://www.phpmyadmin.net/ ]
* Local documents: * Local documents:
@@ -10,11 +10,11 @@
* Documentation version: $Id: Documentation.html,v 1.220 2002/05/01 * Documentation version: $Id: Documentation.html,v 1.220 2002/05/01
18:29:43 lem9 Exp $ 18:29:43 lem9 Exp $
______________________________________________________________________ ______________________________________________________________________
[5]Top - [6]Requirements - [7]Introduction - [8]Installation - [5]Top - [6]Requirements - [7]Introduction - [8]Installation -
[9]Configuration - [10]FAQ - [11]Developers - [12]Credits [9]Configuration - [10]FAQ - [11]Developers - [12]Credits
______________________________________________________________________ ______________________________________________________________________
Requirements Requirements
* PHP3 or PHP4: phpMyAdmin widely uses the 'str_replace()' php * PHP3 or PHP4: phpMyAdmin widely uses the 'str_replace()' php
@@ -24,11 +24,11 @@ Requirements
* MySQL (tested with 3.21.x, 3.22.x, 3.23.x and 4.0.x); * MySQL (tested with 3.21.x, 3.22.x, 3.23.x and 4.0.x);
* a web-browser (doh!). * a web-browser (doh!).
______________________________________________________________________ ______________________________________________________________________
[13]Top - [14]Requirements - [15]Introduction - [16]Installation [13]Top - [14]Requirements - [15]Introduction - [16]Installation
- [17]Configuration - [18]FAQ - [19]Developers - [20]Credits - [17]Configuration - [18]FAQ - [19]Developers - [20]Credits
______________________________________________________________________ ______________________________________________________________________
Introduction Introduction
phpMyAdmin can manage a whole MySQL-server (needs a super-user) but phpMyAdmin can manage a whole MySQL-server (needs a super-user) but
@@ -47,31 +47,31 @@ Introduction
* administer multiple servers and single databases * administer multiple servers and single databases
* check referential integrity * check referential integrity
* communicate in more than 38 different languages * communicate in more than 38 different languages
(*) phpMyAdmin can compress (Zip, GZip -RFC 1952- or Bzip2 formats) (*) phpMyAdmin can compress (Zip, GZip -RFC 1952- or Bzip2 formats)
dumps and CSV exports if you use PHP4 >= 4.0.4 with Zlib support dumps and CSV exports if you use PHP4 >= 4.0.4 with Zlib support
(--with-zlib) and/or Bzip2 support (--with-bz2). (--with-zlib) and/or Bzip2 support (--with-bz2).
______________________________________________________________________ ______________________________________________________________________
[21]Top - [22]Requirements - [23]Introduction - [24]Installation [21]Top - [22]Requirements - [23]Introduction - [24]Installation
- [25]Configuration - [26]FAQ - [27]Developers - [28]Credits - [25]Configuration - [26]FAQ - [27]Developers - [28]Credits
______________________________________________________________________ ______________________________________________________________________
Installation Installation
NOTE: phpMyAdmin does not apply any special security methods to the NOTE: phpMyAdmin does not apply any special security methods to the
MySQL database server. It is still the sysadmin's job to grant MySQL database server. It is still the sysadmin's job to grant
permissions on the MySQL databases properly. permissions on the MySQL databases properly.
Warning for Mac users: php seems not to like Mac end of lines Warning for Mac users: php seems not to like Mac end of lines
character ("\r") and Stuffit unstuffs with Mac formats, of course. character ("\r") and Stuffit unstuffs with Mac formats, of course.
So you'll have to resave as in Bbedit to unix style ALL phpMyAdmin So you'll have to resave as in Bbedit to unix style ALL phpMyAdmin
scripts before uploading them to your server. scripts before uploading them to your server.
Documentation warning: when you see in this document a .php3 file Documentation warning: when you see in this document a .php3 file
extension, please transpose to .php if you are using a kit with files extension, please transpose to .php if you are using a kit with files
having this extension. having this extension.
Quick Install: Quick Install:
1. Use a distribution kit with the files having the extension (.php3 1. Use a distribution kit with the files having the extension (.php3
or .php) depending on the way your web/PHP server interprets those or .php) depending on the way your web/PHP server interprets those
@@ -93,13 +93,13 @@ Installation
your browser. phpMyAdmin should now display a welcome screen and your browser. phpMyAdmin should now display a welcome screen and
your databases, or a login dialog if using http or cookie your databases, or a login dialog if using http or cookie
authentication mode. authentication mode.
Upgrading from an older version: Upgrading from an older version:
* Please do not copy your older config.inc.php3 over the new one: it * Please do not copy your older config.inc.php3 over the new one: it
may offer new configuration variables, and the new version may may offer new configuration variables, and the new version may
depend on these for normal behavior. It is suggested instead to depend on these for normal behavior. It is suggested instead to
insert your site values in the new one. insert your site values in the new one.
Using authentication modes: Using authentication modes:
* Http and cookie authentication modes are recommended in a * Http and cookie authentication modes are recommended in a
multi-user environment where you want to give users access to multi-user environment where you want to give users access to
@@ -122,7 +122,7 @@ Installation
$cfg['Servers'][$i]['controlpass'] settings. $cfg['Servers'][$i]['controlpass'] settings.
This example assumes you want to use pma as the controluser and This example assumes you want to use pma as the controluser and
pmapass as the controlpass: pmapass as the controlpass:
GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY
'pmapass'; 'pmapass';
GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv, GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv,
@@ -136,7 +136,7 @@ Installation
GRANT SELECT, INSERT, DELETE ON <bookmark_db>.<bookmark_table> TO GRANT SELECT, INSERT, DELETE ON <bookmark_db>.<bookmark_table> TO
'pma'@'localhost'; 'pma'@'localhost';
* Then each of the true users should be granted of a set of * Then each of the true users should be granted of a set of
privileges on a set of perticular databases but shouldn't have any privileges on a set of particular databases but shouldn't have any
global privileges. For example, to grant the user real_user with global privileges. For example, to grant the user real_user with
all privileges on the database user_base: all privileges on the database user_base:
GRANT ALL PRIVILEGES ON user_base.* TO 'real_user'@localhost GRANT ALL PRIVILEGES ON user_base.* TO 'real_user'@localhost
@@ -145,21 +145,21 @@ Installation
management system. management system.
With http or cookie auth mode, you don't need to fill the With http or cookie auth mode, you don't need to fill the
user/password fields inside the $cfg['Servers'] array. user/password fields inside the $cfg['Servers'] array.
'http' authentication mode: 'http' authentication mode:
* Was called 'advanced' in versions before 2.2.3. * Was called 'advanced' in versions before 2.2.3.
* Introduced in 1.3.0, it uses Basic HTTP authentication method and * Introduced in 1.3.0, it uses Basic HTTP authentication method and
allows you to login as any valid MySQL user. allows you to login as any valid MySQL user.
* Is only supported with PHP running as an Apache module, not with * Is only supported with PHP running as an Apache module, not with
cgi. cgi.
'cookie' authentication mode: 'cookie' authentication mode:
* You can use this method as a replacement for the http * You can use this method as a replacement for the http
authentication (for example, if you're running IIS). authentication (for example, if you're running IIS).
* Obviously, the user must enable cookies in the browser. * Obviously, the user must enable cookies in the browser.
* With this mode, the use can truly logout of phpMyAdmin and login * With this mode, the use can truly logout of phpMyAdmin and login
back with the same username. back with the same username.
'config' authentication mode: 'config' authentication mode:
* This mode is the less secure one because it requires you to fill * This mode is the less secure one because it requires you to fill
the $cfg['Servers'][$i]['user'] and the $cfg['Servers'][$i]['user'] and
@@ -169,20 +169,20 @@ Installation
In the ISP FAQ section, there is an entry explaining how to In the ISP FAQ section, there is an entry explaining how to
protect your configuration file. protect your configuration file.
______________________________________________________________________ ______________________________________________________________________
[31]Top - [32]Requirements - [33]Introduction - [34]Installation [31]Top - [32]Requirements - [33]Introduction - [34]Installation
- [35]Configuration - [36]FAQ - [37]Developers - [38]Credits - [35]Configuration - [36]FAQ - [37]Developers - [38]Credits
______________________________________________________________________ ______________________________________________________________________
Configuration Configuration
Warning for Mac users: php seems not to like Mac end of lines Warning for Mac users: php seems not to like Mac end of lines
character ("\r"). So ensure you choose the option that allows to use character ("\r"). So ensure you choose the option that allows to use
the *nix end of line character ("\n") in your text editor before the *nix end of line character ("\n") in your text editor before
registering a script you have modified. registering a script you have modified.
All configurable data is placed in config.inc.php3. All configurable data is placed in config.inc.php3.
$cfg['PmaAbsoluteUri'] string $cfg['PmaAbsoluteUri'] string
Sets here the complete url (with full path) to your phpMyAdmin Sets here the complete url (with full path) to your phpMyAdmin
version. E.g. version. E.g.
@@ -192,7 +192,7 @@ Configuration
servers, the path is case-sensitive. servers, the path is case-sensitive.
This setting can be dynamically completed. For example, you can This setting can be dynamically completed. For example, you can
try to use such a kind of code: try to use such a kind of code:
$cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://' $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
. $HTTP_HOST . (!empty($SERVER_PORT) ? ':' . $SERVER_POR . $HTTP_HOST . (!empty($SERVER_PORT) ? ':' . $SERVER_POR
T : '') T : '')
@@ -215,24 +215,24 @@ ORT : '')
$cfg['Servers'][$i]['host'] the hostname of the second server, $cfg['Servers'][$i]['host'] the hostname of the second server,
etc. If you have only one server to administer, simply leave etc. If you have only one server to administer, simply leave
free the hostname of the other $cfg['Server']-entries. free the hostname of the other $cfg['Server']-entries.
$cfg['Servers'][$i]['host'] string $cfg['Servers'][$i]['host'] string
The hostname of your $i-th MySQL-server. E.g. localhost. The hostname of your $i-th MySQL-server. E.g. localhost.
$cfg['Servers'][$i]['port'] string $cfg['Servers'][$i]['port'] string
The port-number of your $i-th MySQL-server. Default is 3306 The port-number of your $i-th MySQL-server. Default is 3306
(leave blank). (leave blank).
$cfg['Servers'][$i]['socket'] string $cfg['Servers'][$i]['socket'] string
The path to the socket to use. Leave blank for default. The path to the socket to use. Leave blank for default.
To use the socket feature you must run php 3.0.10 or more. To use the socket feature you must run php 3.0.10 or more.
$cfg['Servers'][$i]['connect_type'] string $cfg['Servers'][$i]['connect_type'] string
What type connection to use with the MySQL server. Your options What type connection to use with the MySQL server. Your options
are 'socket' & 'tcp'. It defaults to 'tcp' as that is nearly are 'socket' & 'tcp'. It defaults to 'tcp' as that is nearly
guarenteed to be available on all MySQL servers, while sockets guarenteed to be available on all MySQL servers, while sockets
are not supported on some platforms. are not supported on some platforms.
$cfg['Servers'][$i]['controluser'] string $cfg['Servers'][$i]['controluser'] string
$cfg['Servers'][$i]['controlpass'] string $cfg['Servers'][$i]['controlpass'] string
When using http or cookie authentication modes (or 'config' When using http or cookie authentication modes (or 'config'
@@ -249,11 +249,11 @@ ORT : '')
privileges you gave to the "controluser". phpMyAdmin does not privileges you gave to the "controluser". phpMyAdmin does not
support a direct login with the "controluser". support a direct login with the "controluser".
In versions before 2.2.5, those were called "stduser/stdpass". In versions before 2.2.5, those were called "stduser/stdpass".
$cfg['Servers'][$i]['auth_type'] string ['http'|'cookie'|'config'] $cfg['Servers'][$i]['auth_type'] string ['http'|'cookie'|'config']
Whether config or cookie or http authentication should be used Whether config or cookie or http authentication should be used
for this server. for this server.
+ 'config' authentication ($auth_type = 'config') is the plain + 'config' authentication ($auth_type = 'config') is the plain
old way: username and password are stored in config.inc.php3. old way: username and password are stored in config.inc.php3.
+ 'cookie' authentication mode ($auth_type = 'cookie') as + 'cookie' authentication mode ($auth_type = 'cookie') as
@@ -264,16 +264,16 @@ ORT : '')
+ 'http' authentication (was called 'advanced' in older + 'http' authentication (was called 'advanced' in older
versions) ($auth_type = 'http') as introduced in 1.3.0 allows versions) ($auth_type = 'http') as introduced in 1.3.0 allows
you to log in as any valid MySQL user via HTTP-Auth. you to log in as any valid MySQL user via HTTP-Auth.
Please see the install section on "Using authentication modes" Please see the install section on "Using authentication modes"
for more information. for more information.
$cfg['Servers'][$i]['user'] string $cfg['Servers'][$i]['user'] string
$cfg['Servers'][$i]['password'] string $cfg['Servers'][$i]['password'] string
The user/password-pair which phpMyAdmin will use to connect to The user/password-pair which phpMyAdmin will use to connect to
this MySQL-server. This user/password pair is not needed when this MySQL-server. This user/password pair is not needed when
http or cookie authentication is used, and should be empty. http or cookie authentication is used, and should be empty.
$cfg['Servers'][$i]['only_db'] string or array $cfg['Servers'][$i]['only_db'] string or array
If set to a(an array of) database name(s), only this(these) If set to a(an array of) database name(s), only this(these)
database(s) will be shown to the user. Since phpMyAdmin 2.2.1, database(s) will be shown to the user. Since phpMyAdmin 2.2.1,
@@ -287,20 +287,20 @@ ORT : '')
privileges rules of the MySQL database server. If set, it just privileges rules of the MySQL database server. If set, it just
means only these databases will be displayed but not at all means only these databases will be displayed but not at all
other databases can't be used. other databases can't be used.
$cfg['Servers'][$i]['verbose'] string $cfg['Servers'][$i]['verbose'] string
Only useful when using phpMyAdmin with multiple server entries. Only useful when using phpMyAdmin with multiple server entries.
If set, this string will be displayed instead of the hostname If set, this string will be displayed instead of the hostname
in the pulldown menu on the main page. This can be useful if in the pulldown menu on the main page. This can be useful if
you want to show only certain databases on your system, for you want to show only certain databases on your system, for
example. example.
$cfg['Servers'][$i]['bookmarkdb'] string $cfg['Servers'][$i]['bookmarkdb'] string
$cfg['Servers'][$i]['bookmarktable'] string $cfg['Servers'][$i]['bookmarktable'] string
Since release 2.2.0 phpMyAdmin allows to bookmark queries. This Since release 2.2.0 phpMyAdmin allows to bookmark queries. This
can be useful for queries you often run. can be useful for queries you often run.
To use this functionality you have to: To use this functionality you have to:
+ create a table following this scheme: + create a table following this scheme:
CREATE TABLE bookmark ( CREATE TABLE bookmark (
id int(11) DEFAULT '0' NOT NULL auto_increment, id int(11) DEFAULT '0' NOT NULL auto_increment,
@@ -315,18 +315,18 @@ ORT : '')
$cfg['Servers'][$i]['bookmarktable'] with the database and $cfg['Servers'][$i]['bookmarktable'] with the database and
table names you've choosen so phpMyAdmin will be able to find table names you've choosen so phpMyAdmin will be able to find
the bookmarks. the bookmarks.
Note that controluser must have SELECT, INSERT and DELETE Note that controluser must have SELECT, INSERT and DELETE
privileges on the bookmark table. Here is a query to set up privileges on the bookmark table. Here is a query to set up
those privileges (using "pma" as the controluser: those privileges (using "pma" as the controluser:
GRANT SELECT,INSERT,DELETE ON <bookmarkdb>.<bookmarktable> to GRANT SELECT,INSERT,DELETE ON <bookmarkdb>.<bookmarktable> to
'pma'@localhost; 'pma'@localhost;
$cfg['Servers'][$i]['relation'] string $cfg['Servers'][$i]['relation'] string
Since release 2.2.4 you can describe, in a special 'relation' Since release 2.2.4 you can describe, in a special 'relation'
table, which field is a key in another table (a foreign key). table, which field is a key in another table (a foreign key).
phpMyAdmin currently uses this to phpMyAdmin currently uses this to
+ make clickable, when you browse the master table, the data + make clickable, when you browse the master table, the data
values that point to the foreign table; values that point to the foreign table;
+ display links on the table properties page, to check + display links on the table properties page, to check
@@ -334,10 +334,10 @@ ORT : '')
described key; described key;
+ in query-by-example, create automatic joints (see an example + in query-by-example, create automatic joints (see an example
in the FAQ, section "Using phpMyAdmin"). in the FAQ, section "Using phpMyAdmin").
The keys can be numeric or character. The keys can be numeric or character.
To use this functionality you have to: To use this functionality you have to:
+ create in the same database a table (for example 'relation') + create in the same database a table (for example 'relation')
following this scheme: following this scheme:
CREATE TABLE `relation` ( CREATE TABLE `relation` (
@@ -351,7 +351,7 @@ ORT : '')
$cfg['Servers'][$i]['relation'] $cfg['Servers'][$i]['relation']
+ then manually fill the relation table with information about + then manually fill the relation table with information about
the keys. the keys.
If you created a relation table before release 2.3.0, you can If you created a relation table before release 2.3.0, you can
upgrade it with those commands, assuming your table name is upgrade it with those commands, assuming your table name is
"relation": "relation":
@@ -363,7 +363,7 @@ ORT : '')
VARCHAR(32) NOT NULL VARCHAR(32) NOT NULL
ALTER TABLE relation CHANGE dest_column foreign_field ALTER TABLE relation CHANGE dest_column foreign_field
VARCHAR(32) NOT NULL VARCHAR(32) NOT NULL
$cfg['ServerDefault'] integer $cfg['ServerDefault'] integer
If you have more than one server configured, you can set If you have more than one server configured, you can set
$cfg['ServerDefault'] to any one of them to autoconnect to that $cfg['ServerDefault'] to any one of them to autoconnect to that
@@ -371,48 +371,48 @@ ORT : '')
list of servers without logging in. list of servers without logging in.
If you have only one server configured, $cfg['ServerDefault'] If you have only one server configured, $cfg['ServerDefault']
MUST be set to that server. MUST be set to that server.
$cfg['OBGzip'] boolean $cfg['OBGzip'] boolean
Defines whether to use gzip output buffering for increased Defines whether to use gzip output buffering for increased
speed in HTTP transfers. speed in HTTP transfers.
$cfg['PersistentConnections'] boolean $cfg['PersistentConnections'] boolean
Whether persistent connections should be used or not Whether persistent connections should be used or not
(mysql_connect or mysql_pconnect). (mysql_connect or mysql_pconnect).
$cfg['ExecTimeLimit'] integer [number of seconds] $cfg['ExecTimeLimit'] integer [number of seconds]
Set the number of seconds a script is allowed to run. If Set the number of seconds a script is allowed to run. If
seconds is set to zero, no time limit is imposed. seconds is set to zero, no time limit is imposed.
This setting is used while importing/exporting dump files but This setting is used while importing/exporting dump files but
has no effect when PHP is running in safe mode. has no effect when PHP is running in safe mode.
$cfg['SkipLockedTables'] boolean $cfg['SkipLockedTables'] boolean
Mark used tables and make it possible to show databases with Mark used tables and make it possible to show databases with
locked tables (since 3.23.30). locked tables (since 3.23.30).
$cfg['ShowSQL'] boolean $cfg['ShowSQL'] boolean
Defines whether sql-queries generated by phpMyAdmin should be Defines whether sql-queries generated by phpMyAdmin should be
displayed or not. displayed or not.
$cfg['AllowUserDropDatabase'] boolean $cfg['AllowUserDropDatabase'] boolean
Defines whether normal users (non-administrator) are allowed to Defines whether normal users (non-administrator) are allowed to
delete their own database or not. If set as FALSE, the link delete their own database or not. If set as FALSE, the link
"Drop Database" will not be shown, and even a "DROP DATABASE "Drop Database" will not be shown, and even a "DROP DATABASE
mydatabase" will be rejected. Quite practical for ISP's with mydatabase" will be rejected. Quite practical for ISP's with
many customers. many customers.
$cfg['Confirm'] boolean $cfg['Confirm'] boolean
Whether a warning ("Are your really sure..") should be Whether a warning ("Are your really sure..") should be
displayed when you're about to loose data. displayed when you're about to loose data.
$cfg['ShowTooltip'] boolean $cfg['ShowTooltip'] boolean
Defines whether to display table comment as tooltip in left Defines whether to display table comment as tooltip in left
frame or not. frame or not.
$cfg['LeftFrameLight'] boolean $cfg['LeftFrameLight'] boolean
Defines whether to use select-based menu and display only the Defines whether to use select-based menu and display only the
current tables in the left frame (smaller page). current tables in the left frame (smaller page).
$cfg['ShowMysqlInfo'] boolean $cfg['ShowMysqlInfo'] boolean
$cfg['ShowMysqlVars'] boolean $cfg['ShowMysqlVars'] boolean
$cfg['ShowPhpInfo'] boolean $cfg['ShowPhpInfo'] boolean
@@ -429,41 +429,41 @@ ORT : '')
effect with "config" authentication mode: because of the hard effect with "config" authentication mode: because of the hard
coded password value in the configuration file, end users can't coded password value in the configuration file, end users can't
be allowed to change their passwords. be allowed to change their passwords.
$cfg['LoginCookieRecall'] boolean $cfg['LoginCookieRecall'] boolean
Define whether the previous login should be recalled or not in Define whether the previous login should be recalled or not in
cookie authentication mode. cookie authentication mode.
$cfg['ShowStats'] boolean $cfg['ShowStats'] boolean
Defines whether to display space usage and statistics about Defines whether to display space usage and statistics about
databases and tables or not. databases and tables or not.
Note that statistics requires at least MySQL 3.23.3 and that, Note that statistics requires at least MySQL 3.23.3 and that,
at this date, MySQL doesn't return such information for at this date, MySQL doesn't return such information for
Berkeley DB tables. Berkeley DB tables.
$cfg['ShowBlob'] boolean $cfg['ShowBlob'] boolean
Defines whether BLOB fields are shown when browsing a table's Defines whether BLOB fields are shown when browsing a table's
content or not. content or not.
$cfg['NavigationBarIconic'] boolean $cfg['NavigationBarIconic'] boolean
Defines whether navigation bar buttons contain text or symbols Defines whether navigation bar buttons contain text or symbols
only. only.
$cfg['ShowAll'] boolean $cfg['ShowAll'] boolean
Defines whether an user should be displayed a "show all Defines whether an user should be displayed a "show all
(records)" button in browse mode or not. (records)" button in browse mode or not.
$cfg['MaxRows'] integer $cfg['MaxRows'] integer
Number of rows displayed when browsing a resultset. If the Number of rows displayed when browsing a resultset. If the
resultset contains more rows, Previous/Next links will be resultset contains more rows, Previous/Next links will be
shown. shown.
$cfg['Order'] string [DESC|ASC|SMART] $cfg['Order'] string [DESC|ASC|SMART]
Defines whether fields are displayed in ascending (ASC) order, Defines whether fields are displayed in ascending (ASC) order,
in descending (DESC) order or in a "smart" (SMART) order -ie in descending (DESC) order or in a "smart" (SMART) order -ie
descending order for fields of type TIME, DATE, DATETIME & descending order for fields of type TIME, DATE, DATETIME &
TIMESTAMP, ascending order else- by default. TIMESTAMP, ascending order else- by default.
$cfg['ProtectBinary'] boolean or string $cfg['ProtectBinary'] boolean or string
Defines whether BLOB or BINARY fields are protected from Defines whether BLOB or BINARY fields are protected from
edition when browsing a table's content or not. Valid values edition when browsing a table's content or not. Valid values
@@ -471,54 +471,54 @@ ORT : '')
- FALSE to allow edition of all fields; - FALSE to allow edition of all fields;
- blob to allow edition of all fields except BLOBS; - blob to allow edition of all fields except BLOBS;
- all to disallow edition of all BINARY or BLOB fields. - all to disallow edition of all BINARY or BLOB fields.
$cfg['ShowFunctionFields'] boolean $cfg['ShowFunctionFields'] boolean
Defines whether MySQL functions fields should be displayed or Defines whether MySQL functions fields should be displayed or
not in edit/insert mode. not in edit/insert mode.
$cfg['ZipDump'] boolean $cfg['ZipDump'] boolean
$cfg['GZipDump'] boolean $cfg['GZipDump'] boolean
$cfg['BZipDump'] boolean $cfg['BZipDump'] boolean
Defines whether to allow the use of zip/gzip/bzip compression Defines whether to allow the use of zip/gzip/bzip compression
when creating a dump file or not. when creating a dump file or not.
$cfg['ManualBaseShort'] string $cfg['ManualBaseShort'] string
If set to an URL which points to the MySQL documentation (on If set to an URL which points to the MySQL documentation (on
short pages), appropriate help links are generated. short pages), appropriate help links are generated.
$cfg['DefaultLang'] string $cfg['DefaultLang'] string
Defines the default language to use, if not browser-defined or Defines the default language to use, if not browser-defined or
user-defined. user-defined.
See the select_lang.inc.php3 script to know the valid values See the select_lang.inc.php3 script to know the valid values
for this setting. for this setting.
$cfg['Lang'] string $cfg['Lang'] string
Force: always use this language (must be defined in the Force: always use this language (must be defined in the
select_lang.inc.php3 script). select_lang.inc.php3 script).
$cfg['LeftWidth'] integer $cfg['LeftWidth'] integer
Left frame width in pixel. Left frame width in pixel.
$cfg['LeftBgColor'] string [HTML color] $cfg['LeftBgColor'] string [HTML color]
$cfg['RightBgColor'] string [HTML color] $cfg['RightBgColor'] string [HTML color]
The background colors (HTML) used for both the frames. The background colors (HTML) used for both the frames.
$cfg['LeftPointerColor'] string [HTML color] $cfg['LeftPointerColor'] string [HTML color]
The color (HTML) used for the pointer in the left frame (does The color (HTML) used for the pointer in the left frame (does
not work with NS4). not work with NS4).
$cfg['Border'] integer $cfg['Border'] integer
The size of a table's border. The size of a table's border.
$cfg['ThBgcolor'] string [HTML color] $cfg['ThBgcolor'] string [HTML color]
The color (HTML) used for table headers. The color (HTML) used for table headers.
$cfg['BgcolorOne'] string [HTML color] $cfg['BgcolorOne'] string [HTML color]
The color (HTML) #1 for table rows. The color (HTML) #1 for table rows.
$cfg['BgcolorTwo'] string [HTML color] $cfg['BgcolorTwo'] string [HTML color]
The color (HTML) #2 for table rows. The color (HTML) #2 for table rows.
$cfg['BrowsePointerColor'] string [HTML color] $cfg['BrowsePointerColor'] string [HTML color]
$cfg['BrowseMarkerColor'] string [HTML color] $cfg['BrowseMarkerColor'] string [HTML color]
The colors (HTML) uses for the pointer and the marker in browse The colors (HTML) uses for the pointer and the marker in browse
@@ -528,55 +528,55 @@ ORT : '')
clicking on them. clicking on them.
You can disable both of these features by emptying the You can disable both of these features by emptying the
respective directive. respective directive.
$cfg['TextareaCols'] integer $cfg['TextareaCols'] integer
$cfg['TextareaRows'] integer $cfg['TextareaRows'] integer
Number of columns and rows for the textareas. Number of columns and rows for the textareas.
This value will be emphasized (*2) for sql query textareas. This value will be emphasized (*2) for sql query textareas.
$cfg['LimitChars'] integer $cfg['LimitChars'] integer
Maximal number of Chars showed in a TEXT OR a BLOB field on Maximal number of Chars showed in a TEXT OR a BLOB field on
browse view. Can be turned off by a toggle button on the browse browse view. Can be turned off by a toggle button on the browse
page. page.
$cfg['ModifyDeleteAtLeft'] boolean $cfg['ModifyDeleteAtLeft'] boolean
$cfg['ModifyDeleteAtRight'] boolean $cfg['ModifyDeleteAtRight'] boolean
Defines the place where modify and delete links would be put Defines the place where modify and delete links would be put
when tables contents are displayed (you may have them displayed when tables contents are displayed (you may have them displayed
both at the left and at the right). "Left" and "right" are both at the left and at the right). "Left" and "right" are
parsed as "top" and "bottom" with vertical display mode. parsed as "top" and "bottom" with vertical display mode.
$cfg['DefaultDisplay'] string $cfg['DefaultDisplay'] string
There are 2 display modes: horizontal and vertical. Define There are 2 display modes: horizontal and vertical. Define
which one is displayed by default. which one is displayed by default.
$cfg['RepeatCells'] integer $cfg['RepeatCells'] integer
Repeat the headers every X cells, or 0 to deactivate. Repeat the headers every X cells, or 0 to deactivate.
$cfg['ColumnTypes'] array $cfg['ColumnTypes'] array
All possible types of a MySQL column. In most cases you don't All possible types of a MySQL column. In most cases you don't
need to edit this. need to edit this.
$cfg['AttributeTypes'] array $cfg['AttributeTypes'] array
Possible attributes for fields. In most cases you don't need to Possible attributes for fields. In most cases you don't need to
edit this. edit this.
$cfg['Functions'] array $cfg['Functions'] array
A list of functions MySQL supports. In most cases you don't A list of functions MySQL supports. In most cases you don't
need to edit this. need to edit this.
______________________________________________________________________ ______________________________________________________________________
[40]Top - [41]Requirements - [42]Introduction - [43]Installation [40]Top - [41]Requirements - [42]Introduction - [43]Installation
- [44]Configuration - [45]FAQ - [46]Developers - [47]Credits - [44]Configuration - [45]FAQ - [46]Developers - [47]Credits
______________________________________________________________________ ______________________________________________________________________
FAQ - Frequently Asked Questions FAQ - Frequently Asked Questions
[48]Server - [49]Configuration - [50]Limitations - [48]Server - [49]Configuration - [50]Limitations -
[51]Multi-user - [52]Browsers - [53]Usage tips - [54]Project [51]Multi-user - [52]Browsers - [53]Usage tips - [54]Project
[Server] [Server]
I'm running php 4+ and my server is crashing each time a specific I'm running php 4+ and my server is crashing each time a specific
action is required or phpMyAdmin sends a blank page or a page full of action is required or phpMyAdmin sends a blank page or a page full of
cryptic characters to my browser, what can I do? cryptic characters to my browser, what can I do?
@@ -588,21 +588,21 @@ FAQ - Frequently Asked Questions
candidates of php 4.2.0 (tested with php 4.2.0 RC1 to RC4) together candidates of php 4.2.0 (tested with php 4.2.0 RC1 to RC4) together
with MS Internet Explorer. Please upgrade to the release version php with MS Internet Explorer. Please upgrade to the release version php
4.2.0. 4.2.0.
My Apache server crashes when using phpMyAdmin. My Apache server crashes when using phpMyAdmin.
You should first try the latest versions of Apache (and possibly You should first try the latest versions of Apache (and possibly
MySQL). MySQL).
See also the other FAQ entry about php bugs with output buffering. See also the other FAQ entry about php bugs with output buffering.
If your server keeps crashing, please ask for help in the various If your server keeps crashing, please ask for help in the various
Apache support groups. Apache support groups.
Using phpMyAdmin on IIS, I'm displayed the error message: "The Using phpMyAdmin on IIS, I'm displayed the error message: "The
specified CGI application misbehaved by not returning a complete set specified CGI application misbehaved by not returning a complete set
of HTTP headers...." of HTTP headers...."
You just forgot to read the install.txt file from the php You just forgot to read the install.txt file from the php
distribution. Have a look at the last message in this [55]bug report distribution. Have a look at the last message in this [55]bug report
from the official php bug database. from the official php bug database.
Using phpMyAdmin on IIS, I'm facing crashes and/or many error messages Using phpMyAdmin on IIS, I'm facing crashes and/or many error messages
with the http or advanced authentication mode. with the http or advanced authentication mode.
This is a known problem with the php ISAPI filter: it's not so stable. This is a known problem with the php ISAPI filter: it's not so stable.
@@ -610,13 +610,13 @@ FAQ - Frequently Asked Questions
posted by Andr<64> B. aka "djdeluxe76" in [56]this thread from the posted by Andr<64> B. aka "djdeluxe76" in [56]this thread from the
phpWizard forum. phpWizard forum.
Please use instead the cookie authentication mode. Please use instead the cookie authentication mode.
I can't use phpMyAdmin on PWS: nothing is displayed! I can't use phpMyAdmin on PWS: nothing is displayed!
This seems to be a PWS bug. Filippo Simoncini found a workaroud (at This seems to be a PWS bug. Filippo Simoncini found a workaroud (at
this time there is no better fix): remove or comment the DOCTYPE this time there is no better fix): remove or comment the DOCTYPE
declarations (3 lines) from the scripts header.inc.php3, index.php3, declarations (3 lines) from the scripts header.inc.php3, index.php3,
left.php3 and libraries/common.lib.php3. left.php3 and libraries/common.lib.php3.
How can I GZip or Bzip a dump or a CSV export. It seems to not work? How can I GZip or Bzip a dump or a CSV export. It seems to not work?
These features are based on the gzencode() and bzcompress() php These features are based on the gzencode() and bzcompress() php
functions to be more independent of the platform (Unix/Windows, Safe functions to be more independent of the platform (Unix/Windows, Safe
@@ -625,7 +625,7 @@ FAQ - Frequently Asked Questions
We faced php crashes when trying to download a dump with MS Internet We faced php crashes when trying to download a dump with MS Internet
Explorer when phpMyAdmin is run with a release candidate of php 4.2.0. Explorer when phpMyAdmin is run with a release candidate of php 4.2.0.
In this case you should switch to the release version of php 4.2.0. In this case you should switch to the release version of php 4.2.0.
I cannot insert a text file in a table, and I get an error about safe I cannot insert a text file in a table, and I get an error about safe
mode being in effect. mode being in effect.
Your uploaded file is saved by PHP in the "upload dir", as defined in Your uploaded file is saved by PHP in the "upload dir", as defined in
@@ -639,7 +639,7 @@ FAQ - Frequently Asked Questions
* give proper permission: chmod 600 /tmp/php * give proper permission: chmod 600 /tmp/php
* put upload_tmp_dir = /tmp/php in php.ini * put upload_tmp_dir = /tmp/php in php.ini
* restart Apache * restart Apache
I'm having troubles when uploading files. In general file uploads I'm having troubles when uploading files. In general file uploads
don't work on my system and uploaded files have a Content-Type: header don't work on my system and uploaded files have a Content-Type: header
in the first line. in the first line.
@@ -654,7 +654,7 @@ FAQ - Frequently Asked Questions
So please download [59]the fixed package (4.0.4pl1-9) and the problem So please download [59]the fixed package (4.0.4pl1-9) and the problem
should go away. should go away.
And that fixes the \r\n problem with file uploads! And that fixes the \r\n problem with file uploads!
I'm having troubles when uploading files with phpMyAdmin running on a I'm having troubles when uploading files with phpMyAdmin running on a
secure server. My browser is Internet Explorer and I'm using the secure server. My browser is Internet Explorer and I'm using the
Apache server. Apache server.
@@ -662,7 +662,7 @@ FAQ - Frequently Asked Questions
httpd.conf: httpd.conf:
SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown
It seems to clear up many problems between IE and SSL. It seems to clear up many problems between IE and SSL.
I get an 'open_basedir restriction' while uploading a file from the I get an 'open_basedir restriction' while uploading a file from the
query box. query box.
Since version 2.2.4, phpMyAdmin supports servers with open_basedir Since version 2.2.4, phpMyAdmin supports servers with open_basedir
@@ -672,31 +672,31 @@ FAQ - Frequently Asked Questions
and the same owner as the owner of your phpMyAdmin directory. The and the same owner as the owner of your phpMyAdmin directory. The
uploaded files will be moved there, and after execution of your SQL uploaded files will be moved there, and after execution of your SQL
commands, removed. commands, removed.
I have lost my MySQL root password, what can I do? I have lost my MySQL root password, what can I do?
The MySql manual explains how to [60]reset the permissions. The MySql manual explains how to [60]reset the permissions.
I get an error 'No SQL query' when trying to execute a bookmark. I get an error 'No SQL query' when trying to execute a bookmark.
If PHP does not have read/write access to its upload_tmp_dir, it If PHP does not have read/write access to its upload_tmp_dir, it
cannot access the uploaded query. cannot access the uploaded query.
I get an error 'No SQL query' when trying to submit a query from the I get an error 'No SQL query' when trying to submit a query from the
convenient text area. convenient text area.
Check the post_max_size directive from your php configuration file and Check the post_max_size directive from your php configuration file and
try to increase it. try to increase it.
I have problems with mysql.user field names. I have problems with mysql.user field names.
In older MySQL versions, the User and Password fields were named user In older MySQL versions, the User and Password fields were named user
and password. Please modify your field names to align with current and password. Please modify your field names to align with current
standards. standards.
I cannot upload big dump files. I cannot upload big dump files.
The first things to check (or ask your host provider to check) are the The first things to check (or ask your host provider to check) are the
values of upload_max_filesize, memory_limit and post_max_size in the values of upload_max_filesize, memory_limit and post_max_size in the
php.ini configuration file. php.ini configuration file.
All of these three settings limit the maximum size of data that can be All of these three settings limit the maximum size of data that can be
submitted and handled by php. submitted and handled by php.
Does phpMyAdmin support MySQL 4? Does phpMyAdmin support MySQL 4?
MySQL 4 is not yet fully supported by phpMyAdmin. MySQL 4 is not yet fully supported by phpMyAdmin.
Because of MySQL 4's backwards compatibility you can use phpMyAdmin Because of MySQL 4's backwards compatibility you can use phpMyAdmin
@@ -707,7 +707,7 @@ FAQ - Frequently Asked Questions
Furthermore, several users reported problems with phpMyAdmin related Furthermore, several users reported problems with phpMyAdmin related
to bugs in MySQL 4. MySQL 4 is still an alpha release and should be to bugs in MySQL 4. MySQL 4 is still an alpha release and should be
used for test purposes only! used for test purposes only!
I'm running MySQL 4.0.1 on a Windows NT machine. Each time I create a I'm running MySQL 4.0.1 on a Windows NT machine. Each time I create a
table the table name is changed to lowercase. table the table name is changed to lowercase.
This seems to be a bug of MySQL 4.0.1 because it also appears when This seems to be a bug of MySQL 4.0.1 because it also appears when
@@ -717,21 +717,21 @@ FAQ - Frequently Asked Questions
If you encounter this bug together with another OS and/or MySQL If you encounter this bug together with another OS and/or MySQL
version or you know how to work around it, please post a message into version or you know how to work around it, please post a message into
[61]our bug tracker at SourceForge. [61]our bug tracker at SourceForge.
[Configuration] [Configuration]
The error message "Warning: Cannot add header information - headers The error message "Warning: Cannot add header information - headers
already sent by ..." is displayed, what's the problem? already sent by ..." is displayed, what's the problem?
Edit your config.inc.php or .php3 file and ensure there is nothing (ie Edit your config.inc.php or .php3 file and ensure there is nothing (ie
no blank lines, no spaces, no characters...) neither before the <?php no blank lines, no spaces, no characters...) neither before the <?php
tag at the beginning, neither after the ?> tag at the end. tag at the beginning, neither after the ?> tag at the end.
phpMyAdmin can't connect to MySQL. What's wrong? phpMyAdmin can't connect to MySQL. What's wrong?
Either there is an error with your PHP setup or your username/password Either there is an error with your PHP setup or your username/password
is wrong. Try to make a small script which uses mysql_connect and see is wrong. Try to make a small script which uses mysql_connect and see
if it works. If it doesn't, it may be you haven't even compiled MySQL if it works. If it doesn't, it may be you haven't even compiled MySQL
support into PHP. support into PHP.
The error message "Warning: MySQL Connection Failed: Can't connect to The error message "Warning: MySQL Connection Failed: Can't connect to
local MySQL server through socket '/tmp/mysql.sock' (111)...") is local MySQL server through socket '/tmp/mysql.sock' (111)...") is
displayed. What can I do? displayed. What can I do?
@@ -755,10 +755,10 @@ FAQ - Frequently Asked Questions
phpMyAdmin, you need to complete the socket information in the phpMyAdmin, you need to complete the socket information in the
config.inc.php3. config.inc.php3.
For example: $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock'; For example: $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock';
Have also a look at the [63]corresponding section of the MySQL Have also a look at the [63]corresponding section of the MySQL
documentation. documentation.
Nothing is displayed by my browser when I try to run phpMyAdmin, what Nothing is displayed by my browser when I try to run phpMyAdmin, what
can I do? can I do?
Try to set the $cfg['OBGZip'] directive to FALSE in the phpMyAdmin Try to set the $cfg['OBGZip'] directive to FALSE in the phpMyAdmin
@@ -766,15 +766,15 @@ FAQ - Frequently Asked Questions
Also have a look at your php version number: if it contains "4.0b..." Also have a look at your php version number: if it contains "4.0b..."
it means you're running a beta version of PHP. That's not a so good it means you're running a beta version of PHP. That's not a so good
idea, please upgrade to a plain revision. idea, please upgrade to a plain revision.
Each time I want to insert or change a record or drop a database or a Each time I want to insert or change a record or drop a database or a
table, an error 404 (page not found) is displayed or, with http or table, an error 404 (page not found) is displayed or, with http or
cookie authentication, I'm asked to login again. What's wrong? cookie authentication, I'm asked to login again. What's wrong?
Check the value you set for the $cfg['PmaAbsoluteUri'] directive in Check the value you set for the $cfg['PmaAbsoluteUri'] directive in
the phpMyAdmin configuration file. the phpMyAdmin configuration file.
[Known limitations] [Known limitations]
When using http authentication, an user who logged out can not relog When using http authentication, an user who logged out can not relog
in with the same nick. in with the same nick.
This is related to the authentication mechanism (protocol) used by This is related to the authentication mechanism (protocol) used by
@@ -782,7 +782,7 @@ FAQ - Frequently Asked Questions
time to do it, but you can bypass this problem: just close all the time to do it, but you can bypass this problem: just close all the
opened browser windows and then go back to phpMyAdmin. You should be opened browser windows and then go back to phpMyAdmin. You should be
able to logs in again. able to logs in again.
When dumping a large table in compressed mode, I get a memory limit When dumping a large table in compressed mode, I get a memory limit
error or a time limit error. error or a time limit error.
As of version 2.2.4, we build the compressed dump in memory, so large As of version 2.2.4, we build the compressed dump in memory, so large
@@ -790,9 +790,9 @@ FAQ - Frequently Asked Questions
system calls to mysqldump then gzip or bzip2) would not be applicable system calls to mysqldump then gzip or bzip2) would not be applicable
in environments where PHP is in safe mode: access to system programs in environments where PHP is in safe mode: access to system programs
is is limited by the system administrator, and time limit is enforced. is is limited by the system administrator, and time limit is enforced.
[ISPs, multi-user installations ] [ISPs, multi-user installations ]
I'm an ISP. Can I setup one central copy of phpMyAdmin or do I need to I'm an ISP. Can I setup one central copy of phpMyAdmin or do I need to
install it for each customer? install it for each customer?
Since version 2.0.3, you can setup a central copy of phpMyAdmin for Since version 2.0.3, you can setup a central copy of phpMyAdmin for
@@ -800,7 +800,7 @@ FAQ - Frequently Asked Questions
by NetCologne GmbH. This requires a properly setup MySQL user by NetCologne GmbH. This requires a properly setup MySQL user
management and phpMyAdmin http authentication. See the install section management and phpMyAdmin http authentication. See the install section
on "Using http authentication". on "Using http authentication".
What's the preferred way of making phpMyAdmin secure against evil What's the preferred way of making phpMyAdmin secure against evil
access? access?
This depends on your system. This depends on your system.
@@ -816,13 +816,13 @@ FAQ - Frequently Asked Questions
the group under which Apache runs. the group under which Apache runs.
* You should use PHP safe mode, to protect from other users that try * You should use PHP safe mode, to protect from other users that try
to include your config.inc.php3 in their scripts. to include your config.inc.php3 in their scripts.
I get errors about not being able to include a file in /lang or in I get errors about not being able to include a file in /lang or in
/libraries. /libraries.
Check php.ini, or ask your sysadmin to check it. The include_path must Check php.ini, or ask your sysadmin to check it. The include_path must
contain "." somewhere in it, and open_basedir, if used, must contain contain "." somewhere in it, and open_basedir, if used, must contain
"." and "./lang" to allow normal operation of phpMyAdmin. "." and "./lang" to allow normal operation of phpMyAdmin.
phpMyAdmin always gives "Access denied" when using http phpMyAdmin always gives "Access denied" when using http
authentication. authentication.
This could happen for several reasons: This could happen for several reasons:
@@ -832,27 +832,27 @@ FAQ - Frequently Asked Questions
* You have already setup a security mechanism for the * You have already setup a security mechanism for the
phpMyAdmin-directory, eg. a .htaccess file. This would interfere phpMyAdmin-directory, eg. a .htaccess file. This would interfere
with phpMyAdmin's authentication, so remove it. with phpMyAdmin's authentication, so remove it.
Is it possible to let users create their own databases? Is it possible to let users create their own databases?
Starting with 2.2.5, in the user management page, you can enter a Starting with 2.2.5, in the user management page, you can enter a
wildcard database name for a user, and put the privileges you want. wildcard database name for a user, and put the privileges you want.
For example, adding SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, For example, adding SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,
INDEX, ALTER would let a user create/manage his/her database(s). INDEX, ALTER would let a user create/manage his/her database(s).
[Browsers or client OS] [Browsers or client OS]
I get an out of memory error, and my controls are non-functional, when I get an out of memory error, and my controls are non-functional, when
trying to create a table with more than 14 fields. trying to create a table with more than 14 fields.
We could reproduce this problem only under Win98/98SE. Testing under We could reproduce this problem only under Win98/98SE. Testing under
WinNT4 or Win2K, we could easily create more than 60 fields. WinNT4 or Win2K, we could easily create more than 60 fields.
A workaround is to create a smaller number of fields, then come back A workaround is to create a smaller number of fields, then come back
to your table properties and add the other fields. to your table properties and add the other fields.
With Xitami 2.5b4, phpMyAdmin won't process form fields. With Xitami 2.5b4, phpMyAdmin won't process form fields.
This is not a phpMyAdmin problem but a Xitami known bug: you'll face This is not a phpMyAdmin problem but a Xitami known bug: you'll face
it with each script/website that use forms. it with each script/website that use forms.
Upgrade or downgrade your Xitami server. Upgrade or downgrade your Xitami server.
I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2) I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2)
With Konqueror 2.1.1: plain dumps, zip and gzip dumps work ok, except With Konqueror 2.1.1: plain dumps, zip and gzip dumps work ok, except
that the proposed file name for the dump is always 'tbl_dump.php'. that the proposed file name for the dump is always 'tbl_dump.php'.
@@ -861,7 +861,7 @@ FAQ - Frequently Asked Questions
user's temporary directory, so they must be moved before closing user's temporary directory, so they must be moved before closing
Konqueror, or else they disappear. Gzip dumps give an error message. Konqueror, or else they disappear. Gzip dumps give an error message.
Testing needs to be done for Konqueror 2.2.2. Testing needs to be done for Konqueror 2.2.2.
I can't use the cookie authentication mode because Internet Explorer I can't use the cookie authentication mode because Internet Explorer
never stores the cookies. never stores the cookies.
MS Internet Explorer seems to be really buggy about cookies, at least MS Internet Explorer seems to be really buggy about cookies, at least
@@ -869,11 +869,11 @@ FAQ - Frequently Asked Questions
4.1.1 bug in this area! 4.1.1 bug in this area!
Then, If you're running php 4.1.1, try to upgrade or downgrade... it Then, If you're running php 4.1.1, try to upgrade or downgrade... it
may works! may works!
In Internet Explorer 5.0, I get Javascript errors when browsing my In Internet Explorer 5.0, I get Javascript errors when browsing my
rows. rows.
Upgrade to at least Internet Explorer 5.5SP2. Upgrade to at least Internet Explorer 5.5SP2.
In Internet Explorer 5.0, 5.5 or 6.0, I get an error when trying to In Internet Explorer 5.0, 5.5 or 6.0, I get an error when trying to
modify a row in a table with many fields, or with a text field. modify a row in a table with many fields, or with a text field.
Your table neither have a primary key nor an unique one, so we must Your table neither have a primary key nor an unique one, so we must
@@ -881,44 +881,44 @@ FAQ - Frequently Asked Questions
the URL in those browsers, and this not happen in Netscape, for the URL in those browsers, and this not happen in Netscape, for
example. The workaround is to create a primary or unique key, or use example. The workaround is to create a primary or unique key, or use
another browser. another browser.
I refresh (reload) my browser, and come back to the welcome page. I refresh (reload) my browser, and come back to the welcome page.
Some browsers support right-clicking into the frame you want to Some browsers support right-clicking into the frame you want to
refresh, just do this in the right frame. refresh, just do this in the right frame.
With Mozilla 0.9.7 I have problems sending a query modified in the With Mozilla 0.9.7 I have problems sending a query modified in the
query box. query box.
Looks like a Mozilla bug: 0.9.6 was ok. We will keep an eye on future Looks like a Mozilla bug: 0.9.6 was ok. We will keep an eye on future
Mozilla versions. Mozilla versions.
With Mozilla 0.9.? to 1.0-RC1 I can't type a whitespace in the With Mozilla 0.9.? to 1.0-RC1 I can't type a whitespace in the
SQL-Query edit area: the page scrolls down. SQL-Query edit area: the page scrolls down.
This is a Mozilla bug (see bug #26882 at [64]Bugzilla). This is a Mozilla bug (see bug #26882 at [64]Bugzilla).
[Using phpMyAdmin] [Using phpMyAdmin]
I can't insert new rows into a table - MySQL brings up a SQL-error. I can't insert new rows into a table - MySQL brings up a SQL-error.
Examine the SQL error with care. I've found that many programmers Examine the SQL error with care. I've found that many programmers
specifying a wrong field-type. specifying a wrong field-type.
Common errors include: Common errors include:
* Using VARCHAR without a size argument * Using VARCHAR without a size argument
* Using TEXT or BLOB with a size argument * Using TEXT or BLOB with a size argument
Also, look at the syntax chapter in the MySQL manual to confirm that Also, look at the syntax chapter in the MySQL manual to confirm that
your syntax is correct. your syntax is correct.
When I create a table, I click the Index checkbox for 2 fields and When I create a table, I click the Index checkbox for 2 fields and
phpMyAdmin generates only one index with those 2 fields. phpMyAdmin generates only one index with those 2 fields.
In phpMyAdmin 2.2.0 and 2.2.1, this is the way to create a In phpMyAdmin 2.2.0 and 2.2.1, this is the way to create a
multi-fields index. If you want two indexes, create the first one when multi-fields index. If you want two indexes, create the first one when
creating the table, save, then display the table properties and click creating the table, save, then display the table properties and click
the Index link to create the other index. the Index link to create the other index.
How can I insert a null value into my table? How can I insert a null value into my table?
Since version 2.2.3, you have a checkbox for each field that can be Since version 2.2.3, you have a checkbox for each field that can be
null. Before 2.2.3, you had to enter "null", without the quotes, as null. Before 2.2.3, you had to enter "null", without the quotes, as
the field's value. the field's value.
How can I backup my database or table? How can I backup my database or table?
Click on a database or table name in the left frame, the properties Click on a database or table name in the left frame, the properties
will be displayed. Then go to the Dump section, you can dump the will be displayed. Then go to the Dump section, you can dump the
@@ -930,14 +930,14 @@ FAQ - Frequently Asked Questions
$cfg['ExecTimeLimit'] configuration variable. $cfg['ExecTimeLimit'] configuration variable.
For additional help on this subject, look for the word "dump" in this For additional help on this subject, look for the word "dump" in this
document. document.
How can I restore (upload) my database or table using a dump? How can I restore (upload) my database or table using a dump?
Click on a database name in the left frame, the properties will be Click on a database name in the left frame, the properties will be
displayed. Then in the "Run SQL query" section, type in your local displayed. Then in the "Run SQL query" section, type in your local
dump filename, or use the Browse button. Then click Go. dump filename, or use the Browse button. Then click Go.
For additional help on this subject, look for the word "upload" in For additional help on this subject, look for the word "upload" in
this document. this document.
How can I use the relation table in Query-by-example? How can I use the relation table in Query-by-example?
Here is an example with the tables persons, towns and countries. Start Here is an example with the tables persons, towns and countries. Start
by creating this: by creating this:
@@ -986,16 +986,16 @@ FAQ - Frequently Asked Questions
* Click "Update query" and you will see in the query box that the * Click "Update query" and you will see in the query box that the
correct joints have been generated correct joints have been generated
* Click "Submit query" * Click "Submit query"
[phpMyAdmin project] [phpMyAdmin project]
I have found a bug. How do I inform developers? I have found a bug. How do I inform developers?
Our Bug Tracker is located at Our Bug Tracker is located at
[65]http://sourceforge.net/projects/phpmyadmin/ under the Bugs [65]http://sourceforge.net/projects/phpmyadmin/ under the Bugs
section. section.
But please first discuss your bug with other users: But please first discuss your bug with other users:
[66]http://sourceforge.net/projects/phpmyadmin/ (and choose Forums) [66]http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
I want to translate the messages to a new language or upgrade an I want to translate the messages to a new language or upgrade an
existing language, where do I start? existing language, where do I start?
Always use the current cvs version of your language file. For a new Always use the current cvs version of your language file. For a new
@@ -1006,7 +1006,7 @@ FAQ - Frequently Asked Questions
It would be a good idea to subscribe to the phpmyadmin-translators It would be a good idea to subscribe to the phpmyadmin-translators
mailing list, because this is where we ask for translations of new mailing list, because this is where we ask for translations of new
messages. messages.
I would like to help out with the development of phpMyAdmin. How I would like to help out with the development of phpMyAdmin. How
should I proceed? should I proceed?
The following method is preferred for new developers: The following method is preferred for new developers:
@@ -1022,22 +1022,22 @@ FAQ - Frequently Asked Questions
* add your stuff * add your stuff
* put the modified files (tar'ed and gzip'ed) inside the patch * put the modified files (tar'ed and gzip'ed) inside the patch
tracker of the [67]phpMyAdmin SourceForge account. tracker of the [67]phpMyAdmin SourceForge account.
Write access to the CVS tree is granted only to experienced developers Write access to the CVS tree is granted only to experienced developers
who have already contributed something useful to phpMyAdmin. who have already contributed something useful to phpMyAdmin.
Also, have a look at the [68]Developers section. Also, have a look at the [68]Developers section.
______________________________________________________________________ ______________________________________________________________________
[69]Top - [70]Requirements - [71]Introduction - [72]Installation [69]Top - [70]Requirements - [71]Introduction - [72]Installation
- [73]Configuration - [74]FAQ - [75]Developers - [76]Credits - [73]Configuration - [74]FAQ - [75]Developers - [76]Credits
______________________________________________________________________ ______________________________________________________________________
Developers Information Developers Information
phpMyAdmin is Open Source, so you're invited to contribute to it. Many phpMyAdmin is Open Source, so you're invited to contribute to it. Many
great features have been written by other people and you too can help great features have been written by other people and you too can help
to make phpMyAdmin a useful tool. to make phpMyAdmin a useful tool.
If you're planning to contribute source, please read the following If you're planning to contribute source, please read the following
information: information:
* All files include header.inc.php3 (layout), * All files include header.inc.php3 (layout),
@@ -1059,7 +1059,7 @@ Developers Information
string (at least) to english.inc.php3 and print() it out. string (at least) to english.inc.php3 and print() it out.
* If you want to be really helpful, write an entry for the * If you want to be really helpful, write an entry for the
ChangeLog. ChangeLog.
IMPORTANT: With 1.4.1, development has switched to CVS. The following IMPORTANT: With 1.4.1, development has switched to CVS. The following
method is preferred for new developers: method is preferred for new developers:
* fetch the current CVS tree over anonymous CVS: * fetch the current CVS tree over anonymous CVS:
@@ -1075,17 +1075,17 @@ Developers Information
* put the modified files (tar'ed and gzip'ed) inside the patch * put the modified files (tar'ed and gzip'ed) inside the patch
tracker of the phpMyAdmin SourceForge account tracker of the phpMyAdmin SourceForge account
([78]http://sourceforge.net/projects/phpmyadmin/) ([78]http://sourceforge.net/projects/phpmyadmin/)
Write access to the CVS tree is granted only to developers who have Write access to the CVS tree is granted only to developers who have
already contributed something useful to phpMyAdmin. If you're already contributed something useful to phpMyAdmin. If you're
interested in that, please contact us using the phpmyadmin-devel interested in that, please contact us using the phpmyadmin-devel
mailing list. mailing list.
______________________________________________________________________ ______________________________________________________________________
[79]Top - [80]Requirements - [81]Introduction - [82]Installation [79]Top - [80]Requirements - [81]Introduction - [82]Installation
- [83]Configuration - [84]FAQ - [85]Developers - [86]Credits - [83]Configuration - [84]FAQ - [85]Developers - [86]Credits
______________________________________________________________________ ______________________________________________________________________
Credits Credits
@@ -1221,12 +1221,12 @@ Original Credits of Version 2.1.0
And thanks to everyone else who sent me email with suggestions, bug-reports And thanks to everyone else who sent me email with suggestions, bug-reports
and or just some feedback. and or just some feedback.
______________________________________________________________________ ______________________________________________________________________
[87]Top - [88]Requirements - [89]Introduction - [90]Installation [87]Top - [88]Requirements - [89]Introduction - [90]Installation
- [91]Configuration - [92]FAQ - [93]Developers - [94]Credits - [91]Configuration - [92]FAQ - [93]Developers - [94]Credits
______________________________________________________________________ ______________________________________________________________________
[95]Valid XHTML 1.0! [96]Valid CSS! [95]Valid XHTML 1.0! [96]Valid CSS!
References References