This commit is contained in:
Marc Delisle
2002-07-28 23:03:21 +00:00
parent 68ef3ba65e
commit 892c6827d7

View File

@@ -1,5 +1,5 @@
phpMyAdmin 2.3.0-rc3 Documentation phpMyAdmin 2.3.0-rc4 Documentation
* Sourceforge phpMyAdmin project page [ http://www.phpmyadmin.net/ * Sourceforge phpMyAdmin project page [ http://www.phpmyadmin.net/
] ]
@@ -7,8 +7,8 @@
+ Version history: ChangeLog + Version history: ChangeLog
+ General notes: README + General notes: README
+ License: LICENSE + License: LICENSE
* Documentation version: $Id: Documentation.html,v 1.282 2002/07/14 * Documentation version: $Id: Documentation.html,v 1.301 2002/07/26
15:04:15 lem9 Exp $ 14:50:47 lem9 Exp $
______________________________________________________________________ ______________________________________________________________________
Top - Requirements - Introduction - Installation - Top - Requirements - Introduction - Installation -
@@ -109,10 +109,12 @@ Installation
Nevertheless be aware that MS Internet Explorer seems to be really Nevertheless be aware that MS Internet Explorer seems to be really
buggy about cookies, at least till version 6. And php 4.1.1 is buggy about cookies, at least till version 6. And php 4.1.1 is
also a bit buggy in this area! also a bit buggy in this area!
* Http and cookie authentication modes are secure: the MySQL * Http and cookie authentication modes are more secure: the MySQL
password does not need to be set in the phpMyAdmin configuration password does not need to be set in the phpMyAdmin configuration
file. (except for the "controluser" -see the Configuration file. (except for the "controluser" -see the Configuration
section-). section-).
However, keep in mind that the password travels in plain text,
unless you are using the https protocol.
In cookie mode, we send the password in a temporary cookie, so In cookie mode, we send the password in a temporary cookie, so
most browsers should not store the password in their cookie file. most browsers should not store the password in their cookie file.
* For 'http' and 'cookie' modes, phpMyAdmin needs a controluser that * For 'http' and 'cookie' modes, phpMyAdmin needs a controluser that
@@ -222,6 +224,19 @@ CRIPT_NAME'], '/')+1);
PHP < 4.1.0. Try to replace $_SERVER by $HTTP_SERVER_VARS or PHP < 4.1.0. Try to replace $_SERVER by $HTTP_SERVER_VARS or
$GLOBALS in this case. $GLOBALS in this case.
$cfg['PmaNoRelation_DisableWarning'] boolean
Starting with version 2.3.0 phpMyAdmin offers a lot of features
to work with master / foreign - tables. These features require
the PMA administrator to set up a special database for PMA (see
$cfg['Servers'][$i]['pmadb']). Its contents and use will be
explained further down.
If you tried to set this up and it does not work for you have a
look on the "Structure" page of one database where you would
like to use it. You will find a link that will analyze why
those features have been disabled.
If you do not want to use those features set this variable to
TRUE to stop this message from appearing.
$cfg['Servers'] array $cfg['Servers'] array
Since version 1.4.2, phpMyAdmin supports the administration of Since version 1.4.2, phpMyAdmin supports the administration of
multiple MySQL servers. Therefore, a $cfg['Servers']-array has multiple MySQL servers. Therefore, a $cfg['Servers']-array has
@@ -320,9 +335,11 @@ CRIPT_NAME'], '/')+1);
+ create a new database for phpmyadmin: + create a new database for phpmyadmin:
CREATE DATABASE phpmyadmin; CREATE DATABASE phpmyadmin;
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 this database. Here is a query to set up those
those privileges (using "pma" as the controluser): privileges (using "phpmyadmin" as the database name, and
GRANT SELECT,INSERT,DELETE ON <pmadb> to 'pma'@localhost; "pma" as the controluser):
GRANT SELECT,INSERT,DELETE ON phpmyadmin.* to
'pma'@localhost;
do not give any other user rights on this database. do not give any other user rights on this database.
+ enter the databasename in $cfg['Servers'][$i]['pmadb'] + enter the databasename in $cfg['Servers'][$i]['pmadb']
@@ -750,36 +767,6 @@ CRIPT_NAME'], '/')+1);
$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['UseSyntaxColoring'] boolean
Introduced in 2.3.0, phpMyAdmin is now able to show SQL in
syntax coloring.
To use this feature set this value to TRUE (the default). If
not everything you want is colored or to influence where a
newline is inserted see the configuration arrays
$cfg['keywords'] and $cfg['additional'].
Note: for version 2.3.0, syntax coloring is non functional.
$cfg['colorFunctions'] string [HTML color]
If you use syntax coloring then this defines the color of
function names. e.g. all that are found in $cfg['Functions'].
$cfg['colorKeywords'] string [HTML color]
If you use syntax coloring then this defines the color of
keywords. e.g. all that are found in $cfg['keywords'].
$cfg['colorStrings'] string [HTML color]
If you use syntax coloring then this defines the color of
strings. e.g. all that are between ' or "
$cfg['colorColType'] string [HTML color]
If you use syntax coloring then this defines the color of
column types. e.g. all that are found in $cfg['ColumnTypes'].
$cfg['colorAdd'] string [HTML color]
If you use syntax coloring then this defines the color of
additional keywords that do not get a newline. e.g. all that
are found in $cfg['additional'].
$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.
@@ -797,12 +784,6 @@ CRIPT_NAME'], '/')+1);
keywords that are in this list will also get a new line before keywords that are in this list will also get a new line before
them. them.
Usually you won't need to change those. Usually you won't need to change those.
$cfg['additional'] array
A list of additional keywords that is used for syntax coloring.
All keywords that are in this list will not get a new line
before them.
Usually you won't need to change those.
______________________________________________________________________ ______________________________________________________________________
Top - Requirements - Introduction - Installation - Top - Requirements - Introduction - Installation -
@@ -814,11 +795,11 @@ FAQ - Frequently Asked Questions
Server - Configuration - Limitations - Multi-user - Browsers Server - Configuration - Limitations - Multi-user - Browsers
- Usage tips - Project - Usage tips - Project
[Server] [1. Server]
I'm running php 4+ and my server is crashing each time a specific [1.1] I'm running php 4+ and my server is crashing each time a
action is required or phpMyAdmin sends a blank page or a page full of specific action is required or phpMyAdmin sends a blank page or a page
cryptic characters to my browser, what can I do? full of cryptic characters to my browser, what can I do?
There are some known php bugs with output buffering and compression. There are some known php bugs with output buffering and compression.
Try to set the $cfg['OBGzip'] directive to FALSE in your Try to set the $cfg['OBGzip'] directive to FALSE in your
config.inc.php or .php3 file and the zlib.output_compression directive config.inc.php or .php3 file and the zlib.output_compression directive
@@ -828,42 +809,43 @@ FAQ - Frequently Asked Questions
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. [1.2] 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.
I'm running phpMyAdmin with "cookie" authentication mode under PHP [1.3] I'm running phpMyAdmin with "cookie" authentication mode under
4.2.0 or 4.2.1 loaded as an Apache 2+ module but can't enter the PHP 4.2.0 or 4.2.1 loaded as an Apache 2+ module but can't enter the
script: I'm always displayed the login screen. script: I'm always displayed the login screen.
This is a kown PHP bug (see this bug report) from the official php bug This is a kown PHP bug (see this bug report) from the official php bug
database. It means there is and won't be any phpMyAdmin fix against it database. It means there is and won't be any phpMyAdmin fix against it
because there is no way to code a fix. because there is no way to code a fix.
Using phpMyAdmin on IIS, I'm displayed the error message: "The [1.4] 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 bug report from distribution. Have a look at the last message in this bug report from
the official php bug database. the official php bug database.
Using phpMyAdmin on IIS, I'm facing crashes and/or many error messages [1.5] Using phpMyAdmin on IIS, I'm facing crashes and/or many error
with the http or advanced authentication mode. messages 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.
For some more information and complete testings see the messages For some more information and complete testings see the messages
posted by Andr<64> B. aka "djdeluxe76" in this thread from the phpWizard posted by Andr<64> B. aka "djdeluxe76" in this thread from the phpWizard
forum. 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! [1.6] 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? [1.7] 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
Mode or not, and so on). So, you must have PHP4 >= 4.0.4 and Mode or not, and so on). So, you must have PHP4 >= 4.0.4 and
@@ -872,8 +854,8 @@ FAQ - Frequently Asked Questions
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 [1.8] I cannot insert a text file in a table, and I get an error about
mode being in effect. safe 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
php.ini by the variable upload_tmp_dir (usually the system default is php.ini by the variable upload_tmp_dir (usually the system default is
/tmp). /tmp).
@@ -886,9 +868,9 @@ FAQ - Frequently Asked Questions
* 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 [1.9] I'm having troubles when uploading files. In general file
don't work on my system and uploaded files have a Content-Type: header uploads don't work on my system and uploaded files have a
in the first line. Content-Type: header in the first line.
It's not really phpMyAdmin related but RedHat 7.0. You have a RedHat It's not really phpMyAdmin related but RedHat 7.0. You have a RedHat
7.0 and you updated your php rpm to php-4.0.4pl1-3.i386.rpm, didn't 7.0 and you updated your php rpm to php-4.0.4pl1-3.i386.rpm, didn't
you? you?
@@ -901,16 +883,16 @@ FAQ - Frequently Asked Questions
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 [1.10] I'm having troubles when uploading files with phpMyAdmin
secure server. My browser is Internet Explorer and I'm using the running on a secure server. My browser is Internet Explorer and I'm
Apache server. using the Apache server.
As suggested by "Rob M" in the phpWizard forum, add this line to your As suggested by "Rob M" in the phpWizard forum, add this line to your
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 [1.11] I get an 'open_basedir restriction' while uploading a file from
query box. the query box.
Since version 2.2.4, phpMyAdmin supports servers with open_basedir Since version 2.2.4, phpMyAdmin supports servers with open_basedir
restrictions. Assuming that the restriction allows you to open files restrictions. Assuming that the restriction allows you to open files
in the current directory ('.'), all you have to do is create a 'tmp' in the current directory ('.'), all you have to do is create a 'tmp'
@@ -919,31 +901,33 @@ FAQ - Frequently Asked Questions
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? [1.12] I have lost my MySQL root password, what can I do?
The MySql manual explains how to reset the permissions. The MySql manual explains how to reset the permissions.
I get an error 'No SQL query' when trying to execute a bookmark. [1.13] 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 [1.14] I get an error 'No SQL query' when trying to submit a query
convenient text area. from the 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. [1.15] 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. [1.16] 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. One user also said that post_max_size
and memory_limit need to be larger than upload_max_filesize.
Does phpMyAdmin support MySQL 4? [1.17] 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
for administering MySQL 4 servers, but phpMyAdmin does not yet support for administering MySQL 4 servers, but phpMyAdmin does not yet support
@@ -954,36 +938,46 @@ FAQ - Frequently Asked Questions
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 having lower_case_table_names set to 1. If [1.18] I'm running MySQL <= 4.0.1 having lower_case_table_names set to
I create a new table with a capital letter in its name it is changed 1. If I create a new table with a capital letter in its name it is
to lowercase as it should. But if I try to DROP this table MySQL is changed to lowercase as it should. But if I try to DROP this table
unable to find the corresponding file. MySQL is unable to find the corresponding file.
This is a bug of MySQL <= 4.0.1. Please upgrade to at least This is a bug of MySQL <= 4.0.1. Please upgrade to at least
MySQL 4.0.2 or turn off your lower_case_table_names directive. MySQL 4.0.2 or turn off your lower_case_table_names directive.
I can't run the "display relations" feature because the script seems [1.19] I can't run the "display relations" feature because the script
not to know the font face I'm using! seems not to know the font face I'm using!
The "FPDF" library we're using for this feature requires some special The "FPDF" library we're using for this feature requires some special
files to use font faces. files to use font faces.
Please refers to the FPDF manual to build these files. Please refers to the FPDF manual to build these files.
[Configuration] [1.20] I receive the error "cannot load MySQL extension, please check
PHP Configuration".
To connect to a MySQL server, PHP needs a set of MySQL functions
called "MySQL extension". This extension may be part of the PHP server
(compiled-in), otherwise it needs to be loaded dynamically. Its name
is probably mysql.so or mysql.dll. phpMyAdmin tried to load the
extension but failed.
Usually, the problem is solved by installing a software package called
"PHP-MySQL" or something similar.
[2. Configuration]
The error message "Warning: Cannot add header information - headers [2.1] The error message "Warning: Cannot add header information -
already sent by ..." is displayed, what's the problem? headers 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? [2.2] 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 [2.3] The error message "Warning: MySQL Connection Failed: Can't
local MySQL server through socket '/tmp/mysql.sock' (111)...") is connect to local MySQL server through socket '/tmp/mysql.sock'
displayed. What can I do? (111)...") is displayed. What can I do?
For RedHat users, Harald Legner suggests this on the mailing list: For RedHat users, Harald Legner suggests this on the mailing list:
On my RedHat-Box the socket of mysql is /var/lib/mysql/mysql.sock. In On my RedHat-Box the socket of mysql is /var/lib/mysql/mysql.sock. In
your php.ini you will find a line your php.ini you will find a line
@@ -1008,50 +1002,55 @@ FAQ - Frequently Asked Questions
Have also a look at the corresponding section of the MySQL Have also a look at the corresponding section of the MySQL
documentation. documentation.
Nothing is displayed by my browser when I try to run phpMyAdmin, what [2.4] Nothing is displayed by my browser when I try to run phpMyAdmin,
can I do? what 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
configuration file. It helps sometime. configuration file. It helps sometime.
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 [2.5] Each time I want to insert or change a record or drop a database
table, an error 404 (page not found) is displayed or, with http or or a table, an error 404 (page not found) is displayed or, with http
cookie authentication, I'm asked to login again. What's wrong? or 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] [3. Known limitations]
When using http authentication, an user who logged out can not relog [3.1] When using http authentication, an user who logged out can not
in with the same nick. relog 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
phpMyAdmin. We plan to change it as soon as we may find enough free phpMyAdmin. We plan to change it as soon as we may find enough free
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 [3.2] When dumping a large table in compressed mode, I get a memory
error or a time limit error. limit 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
tables dumps may hang. The only alternative we can think about (using tables dumps may hang. The only alternative we can think about (using
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 ] [3.3] With InnoDB tables, I lose foreign key relationships when I
rename or alter a table.
This seems to be a InnoDB bug (fixed in MySQL 3.23.50?). However, keep
in mind that phpMyAdmin as of version 2.3.0 does not support InnoDB.
[4. ISPs, multi-user installations ]
I'm an ISP. Can I setup one central copy of phpMyAdmin or do I need to [4.1] I'm an ISP. Can I setup one central copy of phpMyAdmin or do I
install it for each customer? need to 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
all your users. The development of this feature was kindly sponsored all your users. The development of this feature was kindly sponsored
by NetCologne GmbH. This requires a properly setup MySQL user by NetCologne GmbH. This requires a properly setup MySQL user
management and phpMyAdmin http or cookie authentication. See the management and phpMyAdmin http or cookie authentication. See the
install section on "Using http authentication". install section on "Using http authentication".
What's the preferred way of making phpMyAdmin secure against evil [4.2] What's the preferred way of making phpMyAdmin secure against
access? evil access?
This depends on your system. This depends on your system.
If you're running a server which cannot be accessed by other people, If you're running a server which cannot be accessed by other people,
it's sufficient to use the directory protection bundled with your it's sufficient to use the directory protection bundled with your
@@ -1066,13 +1065,13 @@ FAQ - Frequently Asked Questions
* 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 [4.3] I get errors about not being able to include a file in /lang or
/libraries. in /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 [4.4] phpMyAdmin always gives "Access denied" when using http
authentication. authentication.
This could happen for several reasons: This could happen for several reasons:
* $cfg['Servers'][$i]['controluser'] and/or * $cfg['Servers'][$i]['controluser'] and/or
@@ -1082,13 +1081,13 @@ FAQ - Frequently Asked Questions
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? [4.5] 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).
How can I use the Host-based authentication additions? [4.6] How can I use the Host-based authentication additions?
If you have existing rules from an old .htaccess file, you can take If you have existing rules from an old .htaccess file, you can take
them and add a username between the 'deny'/'allow' and 'from' strings. them and add a username between the 'deny'/'allow' and 'from' strings.
Using the username wildcard of '%' would be a major benefit here if Using the username wildcard of '%' would be a major benefit here if
@@ -1108,21 +1107,22 @@ FAQ - Frequently Asked Questions
'allow root from 172.16.0.0/12', 'allow root from 172.16.0.0/12',
); );
[Browsers or client OS] [5. Browsers or client OS]
I get an out of memory error, and my controls are non-functional, when [5.1] I get an out of memory error, and my controls are
trying to create a table with more than 14 fields. non-functional, when 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. [5.2] 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) [5.3] 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'.
Bzip2 dumps don't seem to work. Bzip2 dumps don't seem to work.
@@ -1131,48 +1131,50 @@ FAQ - Frequently Asked Questions
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 [5.4] I can't use the cookie authentication mode because Internet
never stores the cookies. Explorer 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
till version 6. And thanks to Andrew Zivolup we've traced also a php till version 6. And thanks to Andrew Zivolup we've traced also a php
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 work! may work!
In Internet Explorer 5.0, I get Javascript errors when browsing my [5.5] In Internet Explorer 5.0, I get Javascript errors when browsing
rows. my 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 [5.6] In Internet Explorer 5.0, 5.5 or 6.0, I get an error when trying
modify a row in a table with many fields, or with a text field. to 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
use a long URL to identify this row. There is a limit on the lenght of use a long URL to identify this row. There is a limit on the lenght of
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. [5.7] 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 [5.8] With Mozilla 0.9.7 I have problems sending a query modified in
query box. the 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 and Netscape 7.0-PR1 I can't type a [5.9] With Mozilla 0.9.? to 1.0 and Netscape 7.0-PR1 I can't type a
whitespace in the SQL-Query edit area: the page scrolls down. whitespace in the SQL-Query edit area: the page scrolls down.
This is a Mozilla bug (see bug #26882 at Bugzilla). This is a Mozilla bug (see bug #26882 at Bugzilla).
With Netscape 4.75 I get empty rows between each row of data in a CSV [5.10] With Netscape 4.75 I get empty rows between each row of data in
exported file. a CSV exported file.
This is a known Netscape 4.75 bug: it adds some line feeds when This is a known Netscape 4.75 bug: it adds some line feeds when
exporting data in octet-stream mode. Since we can't detect the exporting data in octet-stream mode. Since we can't detect the
specific Netscape version, we cannot workaround this bug. specific Netscape version, we cannot workaround this bug.
[Using phpMyAdmin] [6. Using phpMyAdmin]
I can't insert new rows into a table - MySQL brings up a SQL-error. [6.1] 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:
@@ -1182,21 +1184,21 @@ FAQ - Frequently Asked Questions
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 [6.2] When I create a table, I click the Index checkbox for 2 fields
phpMyAdmin generates only one index with those 2 fields. and 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? [6.3] 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? [6.4] 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 on the menu, click "Export", you can dump the
structure, the data, or both. This will generate standard SQL structure, the data, or both. This will generate standard SQL
statements that can be used to recreate your database/table. statements that can be used to recreate your database/table.
You will need to choose "Save as file", so that phpMyAdmin can You will need to choose "Save as file", so that phpMyAdmin can
@@ -1206,14 +1208,14 @@ FAQ - Frequently Asked Questions
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? [6.5] 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? [6.6] How can I use the relation table in Query-by-example?
Here is an example with the tables persons, towns and countries, all Here is an example with the tables persons, towns and countries, all
located in the database mydb. If you don't have a PMA_relation table, located in the database mydb. If you don't have a PMA_relation table,
create it as explained in the configuration section. Then create the create it as explained in the configuration section. Then create the
@@ -1257,12 +1259,12 @@ FAQ - Frequently Asked Questions
correct joins have been generated correct joins have been generated
* Click "Submit query" * Click "Submit query"
How can I use the "display field" feature? [6.7] How can I use the "display field" feature?
Starting from the previous example, create the PMA_table_info as Starting from the previous example, create the PMA_table_info as
explained in the configuration section, then browse your persons explained in the configuration section, then browse your persons
table, and move the mouse over a town code or country code. table, and move the mouse over a town code or country code.
How can I produce a PDF schema of my database? [6.8] How can I produce a PDF schema of my database?
First you have to fill the "relation", "table_coords" and "pdf_pages" First you have to fill the "relation", "table_coords" and "pdf_pages"
configuration variables. configuration variables.
Then, think about your schema layout: which tables will go on which Then, think about your schema layout: which tables will go on which
@@ -1282,7 +1284,7 @@ FAQ - Frequently Asked Questions
For example, x=100 and y=200 means that the table will be at 200 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. mm down and 100 mm right from the upper left corner.
Actually if you have a width of more than 300 or a height of more Actually if you have a width of more than 300 or a height of more
than 100 than it will automatically be scaled but 300*100 is a than 200 than it will automatically be scaled but 300*100 is a
good start to have an idea of what coordinates to use. good start to have an idea of what coordinates to use.
* After every table you submitted you will have the possibility to * After every table you submitted you will have the possibility to
submit more tables submit more tables
@@ -1299,27 +1301,10 @@ FAQ - Frequently Asked Questions
extension ".pdf", under other OSes you should be fine just saving extension ".pdf", under other OSes you should be fine just saving
the file under the name it offers). the file under the name it offers).
I don't like the way syntax coloring displays my query! [6.9] phpMyAdmin is changing the type of one of my columns!
There is two things about the way how the syntax coloring works that
you can easily change yourself:
* number of newlines within your statement
All words that are in $cfg['keywords'] will get a newline in front
of them, all words in $cfg['additional'] won't. So say you don't
like to have a newline in front of every WHERE, you need to remove
it from the $cfg['keywords'] array and enter it in the
$cfg['additional'] array instead.
* colors
The colors are easily changed using the variables
+ $cfg['colorFunctions']
+ $cfg['colorKeywords']
+ $cfg['colorStrings']
+ $cfg['colorColType']
+ $cfg['colorAdd']
phpMyAdmin is changing the type of one of my columns!
No, it's MySQL that is doing silent column type changing. No, it's MySQL that is doing silent column type changing.
My database has an underscore in it's name, and when I grant [6.10] My database has an underscore in it's name, and when I grant
privileges to a user for this database, a backslash is added before privileges to a user for this database, a backslash is added before
the underscore. the underscore.
This is normal and means that the grant is done only for this This is normal and means that the grant is done only for this
@@ -1330,10 +1315,10 @@ FAQ - Frequently Asked Questions
If you really want to grant using a wildcard, there is a dialog box " If you really want to grant using a wildcard, there is a dialog box "
Database (wildcards allowed)" for this. Database (wildcards allowed)" for this.
What is the curious symbol <20> in the table statistics? [6.11] What is the curious symbol <20> in the table statistics?
It means "average". It means "average".
I want to understand some Export options. [6.12] I want to understand some Export options.
"Complete inserts" adds the column names on every INSERT command, for "Complete inserts" adds the column names on every INSERT command, for
better documentation (but resulting file is bigger). better documentation (but resulting file is bigger).
"Extended inserts" provides a shorter dump file by using only once the "Extended inserts" provides a shorter dump file by using only once the
@@ -1341,19 +1326,19 @@ FAQ - Frequently Asked Questions
"Enclose table and field names with backquotes" ensures that field and "Enclose table and field names with backquotes" ensures that field and
table names formed with special characters are protected. table names formed with special characters are protected.
[phpMyAdmin project] [7. phpMyAdmin project]
I have found a bug. How do I inform developers? [7.1] I have found a bug. How do I inform developers?
Our Bug Tracker is located at Our Bug Tracker is located at
http://sourceforge.net/projects/phpmyadmin/ under the Bugs section. http://sourceforge.net/projects/phpmyadmin/ under the Bugs section.
But please first discuss your bug with other users: But please first discuss your bug with other users:
http://sourceforge.net/projects/phpmyadmin/ (and choose Forums) http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
I want to translate the messages to a new language or upgrade an [7.2] 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
language, start from english.inc.php3. If you don't know how to get language, start from english-iso-8859-1.inc.php3. If you don't know
the cvs version, please ask one of the developers. how to get the cvs version, please ask one of the developers.
Please note that we try not to use html entities like &eacute; in the Please note that we try not to use html entities like &eacute; in the
translations, since we define the right character set in the file. translations, since we define the right character set in the file.
With html entities, the text on buttons would not display correctly. With html entities, the text on buttons would not display correctly.
@@ -1363,7 +1348,7 @@ FAQ - Frequently Asked Questions
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 [7.3] 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:
* fetch the current CVS tree over anonymous CVS: * fetch the current CVS tree over anonymous CVS:
@@ -1412,7 +1397,8 @@ Developers Information
* Please try to keep up the file-naming conventions. Table-related * Please try to keep up the file-naming conventions. Table-related
stuff goes to tbl_*.php3, db-related code to db_*.php3 and so on. stuff goes to tbl_*.php3, db-related code to db_*.php3 and so on.
* Please don't use verbose strings in your code, instead add the * Please don't use verbose strings in your code, instead add the
string (at least) to english.inc.php3 and print() it out. string (at least) to english-iso-8859-1.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.
@@ -1517,6 +1503,7 @@ CREDITS, in chronological order
Thanks to these guys who have sent us some major improvements to merge into the Thanks to these guys who have sent us some major improvements to merge into the
code since version 2.1.0: code since version 2.1.0:
- Michal Cihar <nijel at users.sourceforge.net> who implemented the - Michal Cihar <nijel at users.sourceforge.net> who implemented the
enhanced index creation/display feature, and the mecanism to display enhanced index creation/display feature, and the mecanism to display
a character set in MySQL different than the one in HTML. a character set in MySQL different than the one in HTML.
@@ -1538,15 +1525,16 @@ code since version 2.1.0:
And also to the following people who have contributed minor changes, And also to the following people who have contributed minor changes,
enhancements, bugfixes or support for a new language since version 2.1.0: enhancements, bugfixes or support for a new language since version 2.1.0:
Bora Alioglu, Ricardo ?, Sven-Erik Andersen, Alessandro Astarita, Bora Alioglu, Ricardo ?, Sven-Erik Andersen, Alessandro Astarita,
P<EFBFBD>ter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow, Laurent Dhima, P<EFBFBD>ter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow, Laurent Dhima,
Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner, Martin Marconcini, Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner, Martin Marconcini,
Girish Nair, David Nordenberg, Bernard M. Piller, Laurent Haas, Girish Nair, David Nordenberg, Bernard M. Piller, Laurent Haas,
"Sakamoto", Yuval Sarna, www.securereality.com.au, "Sakamoto", Yuval Sarna, www.securereality.com.au,
Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky, Rachim Tamsjadi, Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky, Rachim Tamsjadi,
Lu<EFBFBD>s V., Martijn W. van der Lee, Algis Vainauskas, Daniel Villanueva, Vinay, Kositer Uros, Lu<EFBFBD>s V., Martijn W. van der Lee, Algis Vainauskas,
Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk, Thomas Michael Winningham, Daniel Villanueva, Vinay, Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk,
Vilius Zigmantas. Thomas Michael Winningham, Vilius Zigmantas.
Original Credits of Version 2.1.0 Original Credits of Version 2.1.0