This commit is contained in:
Marc Delisle
2002-03-07 14:00:56 +00:00
parent 34d84b0334
commit 72779a1495

View File

@@ -1,5 +1,5 @@
phpMyAdmin 2.2.4 Documentation
phpMyAdmin 2.2.5-dev Documentation
* Official phpMyAdmin project homepage [
http://www.phpwizard.net/projects/phpMyAdmin/ ]
@@ -9,8 +9,8 @@
+ Version history: ChangeLog
+ General notes: README
+ License: LICENSE
* Documentation version: $Id: Documentation.html,v 1.151 2002/02/19
23:30:45 lem9 Exp $
* Documentation version: $Id: Documentation.html,v 1.160 2002/03/07
13:33:03 lem9 Exp $
______________________________________________________________________
Top - Requirements - Introduction - Installation -
@@ -69,21 +69,28 @@ Installation
So you'll have to resave as in Bbedit to unix style ALL phpMyAdmin
scripts before uploading them to your server.
Documentation warning: when you see in this document a .php3 file
extension, please transpose to .php if you are using a kit with files
having this extension.
Quick Install:
1. Untar or unzip the distribution (be sure to unzip the
1. Use a distribution kit with the files having the extension (.php3
or .php) depending on the way your web/PHP server interprets those
extensions.
2. Untar or unzip the distribution (be sure to unzip the
subdirectories): tar xzvf phpMyAdmin_x.x.x.tar.gz in your
webserver's document root.
2. Open the file config.inc.php3 in your favourite editor and change
3. Open the file config.inc.php3 in your favourite editor and change
the values for host, user, password and authentication mode to fit
your environment. Also insert the correct value for
$cfgPmaAbsoluteUri. Have a look at Configuration section for an
explanation of all values.
3. It is recommended that you protect the directory in which you
4. It is recommended that you protect the directory in which you
installed phpMyAdmin (unless it's on a closed intranet, or you
wish to use http or cookie authentication), for example with
HTTP-AUTH (in a .htaccess file). See the FAQ section for
additional information.
4. Open the file <www.your-host.com>/<your-install-dir>/index.php3 in
5. Open the file <www.your-host.com>/<your-install-dir>/index.php3 in
your browser. phpMyAdmin should now display a welcome screen and
your databases, or a login dialog if using http or cookie
authentication mode.
@@ -100,32 +107,32 @@ Installation
their own database and don't want them to play around with others.
* Http and cookie authentication modes are secure: the MySQL
password does not need to be set in the phpMyAdmin configuration
file. (except for the "standard user" -see the Configuration
file. (except for the "controluser" -see the Configuration
section-).
In cookie mode, we send the password in a temporary cookie, so
most browsers should not store the password in their cookie file.
* For 'http' and 'cookie' modes, phpMyAdmin needs a stduser that has
only the SELECT privilege on the mysql.user (all columns except
"Password"), mysql.db (all columns) & mysql.tables_priv (all
columns except "Grantor" & "Timestamp") tables.
You must specify the details for the stduser in the
config.inc.php3 file under the $cfgServers[n]['stduser'] &
$cfgServers[n]['stdpass'] settings.
To create the control account (<stduser> and <stdpass> have to be
replaced by your own values, of course):
* For 'http' and 'cookie' modes, phpMyAdmin needs a controluser that
has only the SELECT privilege on the mysql.user (all columns
except "Password"), mysql.db (all columns) & mysql.tables_priv
(all columns except "Grantor" & "Timestamp") tables.
You must specify the details for the controluser in the
config.inc.php3 file under the $cfgServers[n]['controluser'] &
$cfgServers[n]['controlpass'] settings.
This example assumes you want to use pma as the controluser and
pmapass as the controlpass:
GRANT USAGE ON mysql.* TO '<stduser>'@'localhost' IDENTIFIED BY
'<stdpass>';
GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY
'pmapass';
GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv,
Delete_priv, Create_priv, Drop_priv, Reload_priv, Shutdown_priv,
Process_priv, File_priv, Grant_priv, References_priv, Index_priv,
Alter_priv) ON mysql.user TO '<stduser>'@'localhost';
GRANT SELECT ON mysql.db TO '<stduser>'@'localhost';
Alter_priv) ON mysql.user TO 'pma'@'localhost';
GRANT SELECT ON mysql.db TO 'pma'@'localhost';
GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv) ON
mysql.tables_priv TO '<stduser>'@'localhost';
mysql.tables_priv TO 'pma'@'localhost';
... and if you want to use the bookmark feature:
GRANT SELECT, INSERT, DELETE ON <bookmark_db>.<bookmark_table> TO
'<stduser>'@'localhost';
'pma'@'localhost';
* 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
global privileges. For example, to grant the user real_user with
@@ -154,8 +161,8 @@ Installation
'config' authentication mode:
* This mode is the less secure one because it requires you to fill
the $cfgServers[n]['user'] and $cfgServers[n]['password'] fields.
But usually you don't need to setup a "standard user" here: using
the $cfgServers[n]['only_db'] might be enough.
But you don't need to setup a "controluser" here: using the
$cfgServers[n]['only_db'] might be enough.
In the ISP FAQ section, there is an entry explaining how to
protect your configuration file.
______________________________________________________________________
@@ -205,8 +212,8 @@ Configuration
guarenteed to be available on all MySQL servers, while sockets
are not supported on some platforms.
$cfgServers[n]['stduser'] string
$cfgServers[n]['stdpass'] string
$cfgServers[n]['controluser'] string
$cfgServers[n]['controlpass'] string
When using http or cookie authentication modes (or 'config'
authentication mode since phpMyAdmin 2.2.1), you need to supply
the details of a MySQL account that has SELECT privilege on the
@@ -216,10 +223,11 @@ Configuration
databases the user will see at login.
Please see the install section on "Using http authentication"
for more information.
Note that if you try login to phpMyAdmin with this "stduser",
you could get some errors, depending the exact privileges you
gave to the "stduser". phpMyAdmin does not support a direct
login with the "stduser".
Note that if you try login to phpMyAdmin with this
"controluser", you could get some errors, depending the exact
privileges you gave to the "controluser". phpMyAdmin does not
support a direct login with the "controluser".
In versions before 2.2.5, those were called stduser/stdpass.
$cfgServers[n]['auth_type'] string ['http'|'cookie'|'config']
Whether config or cookie or http authentication should be used
@@ -242,8 +250,8 @@ Configuration
$cfgServers[n]['user'] string
$cfgServers[n]['password'] string
The user/password-pair which phpMyAdmin will use to connect to
this MySQL-server. The password is not needed when http or
cookie authentication is used, and should be empty.
this MySQL-server. This user/password pair is not needed when
http or cookie authentication is used, and should be empty.
$cfgServers[n]['only_db'] string or array
If set to a(an array of) database name(s), only this(these)
@@ -286,18 +294,17 @@ Configuration
table names you've choosen so phpMyAdmin will be able to find
the bookmarks.
Note that stduser 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
those privileges:
those privileges (using "pma" as the controluser:
GRANT SELECT,INSERT,DELETE ON <bookmarkdb>.<bookmarktable> to
'stduser'@localhost;
'pma'@localhost;
$cfgServers[n]['relation'] string
Since release 2.2.4 you can describe in a relation table which
field is a key in another table. phpMyAdmin currently uses this
to make clickable the data values that point to another table.
Currently, the keys must be numeric, and you must be running
PHP 4.
Currently, the keys must be numeric.
To use this functionality you have to:
+ create in the same database a table (for example 'relation')
@@ -344,8 +351,8 @@ Configuration
displayed or not.
$cfgAllowUserDropDatabase boolean
Defines whether standard users (non administrator) are allowed
to delete their own database or not. If set as FALSE, the link
Defines whether normal users (non-administrator) are allowed to
delete their own database or not. If set as FALSE, the link
"Drop Database" will not be shown, and even a "DROP DATABASE
mydatabase" will be rejected. Quite practical for ISP's with
many customers.
@@ -611,6 +618,11 @@ FAQ - Frequently Asked Questions
If PHP does not have read/write access to its upload_tmp_dir, it
cannot access the uploaded query.
I have problems with mysql.user field names.
In older MySQL versions, the User and Password fields were named user
and password. Please modify your field names to align with current
standards.
[Configuration]
The error message "Warning: Cannot add header information - headers
@@ -677,7 +689,7 @@ FAQ - Frequently Asked Questions
in environments where PHP is in safe mode: access to system programs
is is limited by the system administrator, and time limit is enforced.
[ISPs]
[ISPs, multi-user installations ]
I'm an ISP. Can I setup one central copy of phpMyAdmin or do I need to
install it for each customer?
@@ -711,13 +723,21 @@ FAQ - Frequently Asked Questions
phpMyAdmin always gives "Access denied" when using http
authentication.
This could happen for several reasons:
* $cfgServers[n]['stduser'] and/or $cfgServers[n]['stdpass'] are
wrong.
* $cfgServers[n]['controluser'] and/or $cfgServers[n]['controlpass']
are wrong.
* The username/password you specify in the login-dialog are invalid.
* You have already setup a security mechanism for the
phpMyAdmin-directory, eg. a .htaccess file. This would interfere
with phpMyAdmin's authentication, so remove it.
Is it possible to let users create their own databases?
Yes, but currently (phpMyAdmin 2.2.4) there is no visual way to do
this in our user management page. For example, let's say users should
be able to create databases with a name starting like their username,
type this in a query box:
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER
ON `username%`.* TO 'username'@localhost;
[Browsers or client OS]
I get an out of memory error, and my controls are non-functional, when
@@ -955,6 +975,8 @@ code since version 2.1.0:
for multiple table printviews.
- Garvin Hicking <hicking at faktor-e.de> who builds the patch for
vertical display of table rows.
- Yukihiro Kawada <kawada at den.fujifilm.co.jp> for the japanese kanji
encoding conversion feature.
- Piotr Roszatycki <d3xter at users.sourceforge.net> and Dan Wilson, for
the Cookie authentication mode.
- Axel Sander <n8falke at users.sourceforge.net> for the table
@@ -967,9 +989,8 @@ P
Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner, Martin Marconcini,
Girish Nair, David Nordenberg, Bernard M. Piller, Laurent Haas,
"Sakamoto", Yuval Sarna, www.securereality.com.au,
Peter Svec, Michael Tacelosky,
Daniel Villanueva, Vinay, Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk,
Thomas Michael Winningham.
Peter Svec, Michael Tacelosky, Daniel Villanueva, Vinay,
Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk, Thomas Michael Winningham.
Original Credits of Version 2.1.0