nettika/phpmyadmin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

updated to latest Documentation.html

Browse Source
This commit is contained in:
Robin Johnson
2001-10-23 22:31:15 +00:00
parent 14eb25d385
commit 8d5d0ec520
2 changed files with 236 additions and 402 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
ChangeLog
View File

@@ -7,6 +7,7 @@ $Source$
2001-10-23 Robin Johnson <robbat2@users.sourceforge.net> 2001-10-23 Robin Johnson <robbat2@users.sourceforge.net>
* Documentation.html: Redid documentation of advanced authentication mode. * Documentation.html: Redid documentation of advanced authentication mode.
* Documentation.txt: Updated from latest Documentation.html
2001-10-23 Lo<4C>c Chapeaux <lolo@phpheaven.net> 2001-10-23 Lo<4C>c Chapeaux <lolo@phpheaven.net>
* config.inc.php3, Documentation.html: extended the use of stduser/stdpass * config.inc.php3, Documentation.html: extended the use of stduser/stdpass

629
Documentation.txt
View File

@@ -1,35 +1,35 @@
phpMyAdmin 2.2.1-rc1 Documentation phpMyAdmin 2.2.1-rc1 Documentation
* [1]Official phpMyAdmin project homepage [ * Official phpMyAdmin project homepage [ http://www.phpwizard.net/projects/phpMyAdmin/ ]
http://www.phpwizard.net/projects/phpMyAdmin/ ] * Sourceforge phpMyAdmin download page [ http://phpmyadmin.sourceforge.net/ ]
* [2]Sourceforge phpMyAdmin download page [
http://phpmyadmin.sourceforge.net/ ]
* Local documents: * Local documents:
+ Version history: [3]ChangeLog + Version history: ChangeLog
+ General notes: [4]README + General notes: README
+ License: [5]LICENSE + License: LICENSE
* Documentation version: $Id: Documentation.html,v 1.80 2001/10/19 * Documentation version: $Id$
14:05:30 loic1 Exp $ ____________________________________________________________________________________________________________________________________
______________________________________________________________________
Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - Credits
____________________________________________________________________________________________________________________________________
Requirements Requirements
* PHP3 or PHP4: phpMyAdmin widely uses the 'str_replace()' php * PHP3 or PHP4: phpMyAdmin widely uses the 'str_replace()' php function that was added in PHP 3.0.6, but was buggy up until
function that was added in PHP 3.0.6, but was buggy up until
PHP 3.0.8. Then you should not run this script with PHP3 < 3.0.8. PHP 3.0.8. Then you should not run this script with PHP3 < 3.0.8.
PHP also needs to be compiled with mysql and PCRE support; PHP also needs to be compiled with mysql and PCRE support;
* MySQL (tested with 3.21.x, 3.22.x and 3.23.x); * MySQL (tested with 3.21.x, 3.22.x and 3.23.x);
* a web-browser (doh!). * a web-browser (doh!).
______________________________________________________________________ ____________________________________________________________________________________________________________________________________
Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - Credits
____________________________________________________________________________________________________________________________________
Introduction Introduction
phpMyAdmin can administer a whole MySQL-server (needs a super-user) phpMyAdmin can administer a whole MySQL-server (needs a super-user) but also a single database. To accomplish the latter you'll need
but also a single database. To accomplish the latter you'll need a a properly set up MySQL-user who can read/write only the desired database. It's up to you to look up the appropiate part in the
properly set up MySQL-user who can read/write only the desired MySQL manual. Currently phpMyAdmin can:
database. It's up to you to look up the appropiate part in the MySQL
manual. Currently phpMyAdmin can:
* create and drop databases * create and drop databases
* create, copy, drop and alter tables * create, copy, drop and alter tables
* delete, edit and add fields * delete, edit and add fields
@@ -41,145 +41,109 @@ Introduction
* administer multiple servers and single databases * administer multiple servers and single databases
* communicate in more than 20 different languages * communicate in more than 20 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
dumps and CSV exports if you use PHP4 >= 4.0.4 with Zlib support support (--with-zlib) and/or Bzip2 support (--with-bz2).
(--with-zlib) and/or Bzip2 support (--with-bz2). ____________________________________________________________________________________________________________________________________
______________________________________________________________________
Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - 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 scripts before uploading them to your server.
So you'll have to resave as in Bbedit to unix style ALL phpMyAdmin
scripts before uploading them to your server.
Quick Install: Quick Install:
1. Untar or unzip the distribution (be sure to unzip the 1. Untar or unzip the distribution (be sure to unzip the subdirectories): tar xzvf phpMyAdmin_x.x.x.tar.gz
subdirectories): tar xzvf phpMyAdmin_x.x.x.tar.gz 2. Open the file config.inc.php3 in your favourite editor and change the values for host, user and password to fit your
2. Open the file config.inc.php3 in your favourite editor and change environment. Have a look at Configuration section for an explanation of all values.
the values for host, user and password to fit your environment. 3. It is recommended that you protect the directory in which you installed phpMyAdmin (unless it's on a closed intranet), for
Have a look at Documentation.html for an explanation of all example with HTTP-AUTH (in a .htaccess file). See the FAQ section for additional information.
values. 4. Open the file <www.your-host.com>/<your-install-dir>/index.php3 in your browser. phpMyAdmin should now display a welcome screen
3. It is recommended that you protect the directory in which you and your databases, or a login dialog if using advanced authentication.
installed phpMyAdmin (unless it's on a closed intranet), for
example with HTTP-AUTH (in a .htaccess file). See the [30]FAQ
section for additional information.
4. 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 advanced
authentication.
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 offer new configuration variables, and the new version may may depend on these for normal behavior. It is suggested instead to insert your site values in the new one.
depend on these for normal behavior. It is suggested instead to ____________________________________________________________________________________________________________________________________
insert your site values in the new one.
______________________________________________________________________ Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - 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 registering a script you have modified.
the *nix end of line character ("\n") in your text editor before
registering a script you have modified.
All configurable data is placed in config.inc.php3. All configurable data is placed in config.inc.php3.
$cfgPmaAbsoluteUri string $cfgPmaAbsoluteUri 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.
http://www.your_web.net/path_to_your_phpMyAdmin_directory/. http://www.your_web.net/path_to_your_phpMyAdmin_directory/.
Don't forget the slash at the end of your url. Don't forget the slash at the end of your url.
$cfgServers array $cfgServers 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 $cfgServers-array has
multiple MySQL servers. Therefore, a $cfgServers-array has been been added which contains the login information for the different servers. $cfgServers[1]['host'] contains the hostname of
added which contains the login information for the different the first server, $cfgServers[2]['host'] the hostname of the second server, etc. If you have only one server to administer,
servers. $cfgServers[1]['host'] contains the hostname of the simply leave free the hostname of the other $cfgServer-entries.
first server, $cfgServers[2]['host'] the hostname of the second
server, etc. If you have only one server to administer, simply
leave free the hostname of the other $cfgServer-entries.
$cfgServers[n]['host'] string $cfgServers[n]['host'] string
The hostname of your n-th MySQL-server. E.g. localhost. The hostname of your n-th MySQL-server. E.g. localhost.
$cfgServers[n]['port'] string $cfgServers[n]['port'] string
The port-number of your n-th MySQL-server. Default is 3306 The port-number of your n-th MySQL-server. Default is 3306 (leave blank).
(leave blank).
$cfgServers[n]['socket'] string $cfgServers[n]['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.
$cfgServers[n]['connect_type'] string $cfgServers[n]['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 are not supported on some platforms.
guarenteed to be available on all MySQL servers, while sockets
are not supported on some platforms.
$cfgServers[n]['adv_auth'] boolean
Whether basic or advanced authentication should be used for
this server.
Basic authentication ($adv_auth = false) is the plain old way:
username and password are stored in config.inc.php3. Advanced
authentication ($adv_auth = true) as introduced in 1.3.0 allows
you to log in as any valid MySQL user via HTTP-Auth.
Please note that this authentication mode is only supported
with PHP running as an Apache module, and not with cgi.
Using advanced authentication is recommended:
+ when phpMyAdmin is running in a multi-user environment where
people have shell-access that you don't want to know the
username/password for MySQL.
+ when you want to give users access to their own database and
don't want them to play around with others.
Advanced authentication is secure as the standard user needs
just read-only-access to the mysql database.
All you have to provide in config.inc is a standard user which
can connect to MySQL and read the mysql user/db table (see
$cfgServers[n]['stduser']).
Please also note that if you try a phpMyAdmin login with this
stduser, you could get some errors, depending on the exact
privileges you gave to this stduser. phpMyAdmin does not
support a direct login with the the stduser.
See also the FAQ section for more information about security.
$cfgServers[n]['stduser'] string
$cfgServers[n]['stdpass'] string
A user/password pair used to verify the real user/password pair
when using advanced authentication. This user must be able to
connect to MySQL and read the mysql user table.
Not needed when using basic authentication.
$cfgServers[n]['user'] string $cfgServers[n]['user'] string
$cfgServers[n]['password'] string $cfgServers[n]['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. These are not needed when advanced
this MySQL-server when using basic authentication. authentication is used, and should be empty.
Not needed when using advanced authentication.
$cfgServers[n]['adv_auth'] boolean
Whether basic or advanced authentication should be used for this server.
Basic authentication ($adv_auth = FALSE) is the plain old way: username and password are stored in config.inc.php3. Advanced
authentication ($adv_auth = TRUE) as introduced in 1.3.0 allows you to log in as any valid MySQL user via HTTP-Auth.
Please note that this authentication mode is only supported with PHP running as an Apache module, and not with cgi.
Using advanced authentication is recommended:
+ when phpMyAdmin is running in a multi-user environment where people have shell-access that you don't want to know the
username/password for MySQL.
+ when you want to give users access to their own database and don't want them to play around with others.
Advanced authentication is secure as the MySQL passwords does not need to be set in the phpMyAdmin configuration file.
(except for the standard user -see below-).
Please see the security section in the FAQ for more information.
$cfgServers[n]['stduser'] string
$cfgServers[n]['stdpass'] string
When using advanced authentication mode, you need to supply the details of a MySQL account that has SELECT access on the
mysql.db & mysql.user tables. This account is used to check the privileges user logins. Please see the security section in
the FAQ for more information.
$cfgServers[n]['only_db'] string or array $cfgServers[n]['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.
database(s) will be shown to the user. Warning: this setting does not replace the privileges rules of the MySQL database server. If set, it just means only these
Warning: this setting does not replace the privileges rules of databases will be displayed but not at all other databases can't be used.
the MySQL database server. If set, it just means only these
databases will be displayed but not at all other databases
can't be used.
$cfgServers[n]['verbose'] string $cfgServers[n]['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 you want to show only certain databases on your system, for
in the pulldown menu on the main page. This can be useful if
you want to show only certain databases on your system, for
example. example.
$cfgServers[n]['bookmarkdb'] string $cfgServers[n]['bookmarkdb'] string
$cfgServers[n]['bookmarktable'] string $cfgServers[n]['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:
@@ -191,83 +155,60 @@ Configuration
query text NOT NULL, query text NOT NULL,
PRIMARY KEY (id) PRIMARY KEY (id)
); );
+ then complete the two variables $cfgServers[n]['bookmarkdb'] + then complete the two variables $cfgServers[n]['bookmarkdb'] and $cfgServers[n]['bookmarktable'] so phpMyAdmin will be able
and $cfgServers[n]['bookmarktable'] so phpMyAdmin will be to find the bookmark table.
able to find the bookmark table.
If you are using advanced authentication, stduser must have If you are using advanced authentication, users must have Select_Priv, Insert_Priv and Delete_Priv set to "Y" in mysql.db
Select_Priv, Insert_Priv and Delete_Priv set to "Y" in mysql.db
table for the bookmark database. table for the bookmark database.
$cfgServerDefault integer $cfgServerDefault integer
If you have more than one server configured, you can set If you have more than one server configured, you can set $cfgServerDefault to any one of them to autoconnect to that server
$cfgServerDefault to any one of them to autoconnect to that when phpMyAdmin is started, or set it to 0 to be given a list of servers without logging in.
server when phpMyAdmin is started, or set it to 0 to be given a If you have only one server configured, $cfgServerDefault MUST be set to that server.
list of servers without logging in.
If you have only one server configured, $cfgServerDefault MUST
be set to that server.
$cfgOBGzip boolean $cfgOBGzip 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.
$cfgPersistentConnections boolean $cfgPersistentConnections 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).
$cfgSkipLockedTables boolean $cfgSkipLockedTables 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).
$cfgShowSQL boolean $cfgShowSQL 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.
$cfgAllowUserDropDatabase boolean $cfgAllowUserDropDatabase boolean
Defines whether standard users (non administrator) are allowed Defines whether standard users (non administrator) are allowed to delete their own database or not. If set as FALSE, the link
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
"Drop Database" will not be shown, and even a "DROP DATABASE
mydatabase" will be rejected. Quite practical for ISP's with
many customers. many customers.
$cfgConfirm boolean $cfgConfirm 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.
$cfgShowTooltip boolean $cfgShowTooltip 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.
$cfgShowStats boolean $cfgShowStats 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, at this date, MySQL doesn't return such information for
Note that statistics requires at least MySQL 3.23.3 and that,
at this date, MySQL doesn't return such information for
Berkeley DB tables. Berkeley DB tables.
$cfgShowBlob boolean $cfgShowBlob 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.
$cfgShowAll boolean $cfgShowAll 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.
$cfgMaxRows integer $cfgMaxRows 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 shown.
resultset contains more rows, Previous/Next links will be
shown.
$cfgOrder string [DESC|ASC|SMART] $cfgOrder 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 & TIMESTAMP, ascending order else- by default.
descending order for fields of type TIME, DATE, DATETIME &
TIMESTAMP, ascending order else- by default.
$cfgProtectBinary boolean $cfgProtectBinary boolean
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 are:
edition when browsing a table's content or not. Valid values
are:
- 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.
@@ -275,25 +216,19 @@ Configuration
$cfgZipDump boolean $cfgZipDump boolean
$cfgGZipDump boolean $cfgGZipDump boolean
$cfgBZipDump boolean $cfgBZipDump 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.
$cfgManualBase string $cfgManualBase string
If set to an URL which points to the MySQL documentation, If set to an URL which points to the MySQL documentation, appropriate help links are generated.
appropriate help links are generated.
$cfgDefaultLang string $cfgDefaultLang 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 for this setting.
See the select_lang.inc.php3 script to know the valid values
for this setting.
$cfgLang string $cfgLang 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).
$cfgLeftBgColor string [HTML color] $cfgRightBgColor string [HTML $cfgLeftBgColor string [HTML color] $cfgRightBgColor string [HTML color]
color]
The background colors (HTML) used for both the frames. The background colors (HTML) used for both the frames.
$cfgBorder integer $cfgBorder integer
@@ -313,287 +248,200 @@ Configuration
Number of columns and rows for the textareas. Number of columns and rows for the textareas.
$cfgLimitChars integer $cfgLimitChars 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.
$cfgModifyDeleteAtLeft boolean $cfgModifyDeleteAtLeft boolean
$cfgModifyDeleteAtRight boolean $cfgModifyDeleteAtRight 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). both at the left and at the right).
$cfgLeftWidth integer $cfgLeftWidth integer
Left frame width in pixel. Left frame width in pixel.
$cfgColumnTypes array $cfgColumnTypes 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.
$cfgAttributeTypes array $cfgAttributeTypes 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.
$cfgFunctions array $cfgFunctions 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. ____________________________________________________________________________________________________________________________________
______________________________________________________________________
Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - Credits
____________________________________________________________________________________________________________________________________
FAQ - Frequently Asked Questions FAQ - Frequently Asked Questions
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 send a blank page to my browser,
action is required or phpMyAdmin send a blank page to my browser, what what can I do?
can I do?
There is some known php bugs with output buffering and compression. There is some known php bugs with output buffering and compression.
Try to set the $cfgOBGzip directive to FALSE in your config.inc.php or Try to set the $cfgOBGzip directive to FALSE in your config.inc.php or .php3 file and the zlib.output_compression directive to Off
.php3 file and the zlib.output_compression directive to Off in your in your php configuration file.
php configuration file.
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 no blank lines, no spaces, no characters...) neither before
Edit your config.inc.php or .php3 file and ensure there is nothing (ie the <?php tag at the beginning, neither after the ?> tag at the end.
no blank lines, no spaces, no characters...) neither before the <?php
tag at the beginning, neither after the ?> tag at the end.
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.
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
is wrong. Try to make a small script which uses mysql_connect and see and see if it works. If it doesn't, it may be you haven't even compiled MySQL support into PHP.
if it works. If it doesn't, it may be you haven't even compiled MySQL
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)...")
local MySQL server through socket '/tmp/mysql.sock' (111)...") is is displayed. What can I do?
displayed. What can I do? Here is a fix suggested by Brad Ummer in the phpwizard forum:
Here is a fix suggested by Brad Ummer in the [47]phpwizard forum:
* First, you need to determine what socket is being used by MySQL. * First, you need to determine what socket is being used by MySQL.
To do this, telnet to your server and go to the MySQL bin To do this, telnet to your server and go to the MySQL bin directory. In this directory there should be a file named mysqladmin.
directory. In this directory there should be a file named Type ./mysqladmin variables, and this should give you a bunch of info about your MySQL server, including the socket
mysqladmin. Type ./mysqladmin variables, and this should give you
a bunch of info about your MySQL server, including the socket
(/tmp/mysql.sock, for example). (/tmp/mysql.sock, for example).
* Then, you need to tell PHP to use this socket. * Then, you need to tell PHP to use this socket.
Assuming you are using PHP 3.0.10 or better, you can specify the Assuming you are using PHP 3.0.10 or better, you can specify the socket to use when you open the connection. To do this in
socket to use when you open the connection. To do this in phpMyAdmin, you need to complete the socket information in the config.inc.php3.
phpMyAdmin, you need to complete the socket information in the
config.inc.php3.
For example: $cfgServers[n]['socket'] = '/tmp/mysql.sock'; For example: $cfgServers[n]['socket'] = '/tmp/mysql.sock';
Have also a look at the [48]corresponding section of the MySQL Have also a look at the corresponding section of the MySQL documentation.
documentation.
phpMyAdmin always gives "Access denied" when using advanced phpMyAdmin always gives "Access denied" when using advanced authentication.
authentication. This could happen for several reasons:
This could happen for some reasons: * $cfgServers[n]['stduser'] and/or $cfgServers[n]['stdpass'] are wrong.
* $stduser/$stdpassword is wrong. Try to turn off $adv_auth and use * The username/password you specify in the login-dialog are invalid.
this username and password to connect to MySQL. * You have already setup a security mechanism for the phpMyAdmin-directory, eg. a .htaccess file. This would interfere with
* The username/password your specify in the login-dialog is wrong. phpMyAdmin's authentication, so remove it.
Try the same as above and see if it works.
* 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.
When using advanced authentication, an user who logged out can not When using advanced authentication, an user who logged out can not relogs in with the same nick.
relogs in with the same nick. This is related to the authentication mechanism (protocol) used by phpMyAdmin. We plan to change it as soon as we may find enough
This is related to the authentication mechanism (protocol) used by free time to do it, but you can bypass this problem: just close all the opened browser windows and then go back to phpMyAdmin. You
phpMyAdmin. We plan to change it as soon as we may find enough free should be able to logs in again.
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
able to logs in again.
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:
* fetch the current CVS tree over anonymous CVS: * fetch the current CVS tree over anonymous CVS:
cvs cvs -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin login
-d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy
admin login
[Password: simply press the Enter key] [Password: simply press the Enter key]
cvs -z3 cvs -z3 -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin checkout phpMyAdmin
-d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy
admin checkout phpMyAdmin
[This will create a new sub-directory named phpMyAdmin] [This will create a new sub-directory named phpMyAdmin]
* 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 phpMyAdmin SourceForge account.
tracker of the [49]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 Developers section.
Also, have a look at the [50]Developers section.
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.
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
it's sufficient to use the directory protection bundled with your your webserver (with Apache you can use .htaccess files, for example).
webserver (with Apache you can use .htaccess files, for example). If other people have telnet access to your server, you should use phpMyAdmin's advanced authentication feature.
If other people have telnet access to your server, you should use
phpMyAdmin's advanced authentication feature.
Suggestions: Suggestions:
* Your config.inc.php3 file should be chmod 660. * Your config.inc.php3 file should be chmod 660.
* All your phpMyAdmin files should be chown phpmy.apache, where * All your phpMyAdmin files should be chown phpmy.apache, where phpmy is a user whose password is only known to you, and apache is
phpmy is a user whose password is only known to you, and apache is
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.
How can I insert a null value into my table? How can I insert a null value into my table?
Enter "null", without the quotes, as the field's value. This is Enter "null", without the quotes, as the field's value. This is especially useful for Timestamp or AutoIncrement fields.
especially useful for Timestamp or AutoIncrement fields.
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 all your users. The development of this feature was kindly
Since version 2.0.3, you can setup a central copy of phpMyAdmin for sponsored by NetCologne GmbH. This requires a properly setup MySQL user management and phpMyAdmin advanced authentication.
all your users. The development of this feature was kindly sponsored
by NetCologne GmbH.
This requires a properly setup MySQL user management and phpMyAdmin's
advanced authentication. phpMyAdmin performs these steps, when
authenticating a user:
1. Select all entries from the mysql.user table where the
username/password matches the challenging user. If no rows are
returned, the authentication has failed. Otherwise, phpMyAdmin
continues with step 2.
2. If the user's global Select_Priv is "N" (ie the user is not
allowed to access all databases), phpMyAdmin searches the mysql.db
table for entries with Select_Priv = "Y" belonging to the user. If
no entries are found, the authentication has failed. Otherwise,
phpMyAdmin shows all databases the user is allowed to view.
If the user's global Select_Priv is "Y", all databases in the
system are shown.
This means that you need to add a user to the mysql database as phpMyAdmin needs a control account that has only the SELECT privilege on the mysql.db & mysql.user tables. You specify the details
following: for this account in the config.inc.php3 file under the $cfgServers[n]['stduser'] & $cfgServers[n]['stdpass'] settings. To create the
INSERT INTO user (Host, User, Password, Select_priv, Insert_priv, control account:
Update_priv, Delete_priv, Create_priv, Drop_priv, Reload_priv, REVOKE ALL ON *.* FROM 'user'@localhost;
Shutdown_priv, Process_priv, File_priv, Grant_priv, References_priv, GRANT USAGE ON *.* TO 'user'@localhost IDENTIFIED BY 'password';
Index_priv, Alter_priv) VALUES ('localhost', 'foo', PASSWORD('bar'), GRANT SELECT ON mysql.db TO 'user'@localhost;
'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N') GRANT SELECT ON mysql.user TO 'user'@localhost;
INSERT INTO db (Host, Db, User, Select_priv, Insert_priv, Update_priv,
Delete_priv, Create_priv, Drop_priv, Grant_priv, References_priv, What the user may now do is controlled entirely by the MySQL user management system.
Index_priv, Alter_priv) VALUES ('localhost', 'foo_db', 'foo', 'Y',
'Y', 'Y', 'Y', 'Y', 'Y', '', '', '', '')
Then only the "foo_db" database will be displayed to user "foo".
How can I GZip or Bzip a dump or a CSV export. It seem to not work? How can I GZip or Bzip a dump or a CSV export. It seem 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 Zlib/Bzip2 support (--with-zlib and --with-bz2).
Mode or not, and so on). So, you must have PHP4 >= 4.0.4 and
Zlib/Bzip2 support (--with-zlib and --with-bz2).
I try to insert a text file in a table, and I get: I try to insert a text file in a table, and I get:
Error MySQL said: The file '/tmp/phpkvpp60' must be in the database Error MySQL said: The file '/tmp/phpkvpp60' must be in the database directory or be readable by all
directory or be readable by all 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
Your uploaded file is saved by PHP in the "upload dir", as defined in default is /tmp). If this directory is not readable by all, the MySQL server (which must be running on the same machine) cannot open
php.ini by the variable upload_tmp_dir (usually the system default is the file (except if running as root, which is not recommended).
/tmp). If this directory is not readable by all, the MySQL server The system administrator can do a "chmod 777 /tmp": then the MySQL server will accept to read it. Also, the user must have File
(which must be running on the same machine) cannot open the file
(except if running as root, which is not recommended).
The system administrator can do a "chmod 777 /tmp": then the MySQL
server will accept to read it. Also, the user must have File
privilege. privilege.
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:
don't work on my system and uploaded files have a Content-Type: header header in the first line.
in the first line. 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,
It's not really phpMyAdmin related but RedHat 7.0. You have a RedHat didn't you?
7.0 and you updated your php rpm to php-4.0.4pl1-3.i386.rpm, didn't So the problem is that this package has a serious bug that was corrected ages ago in php (2001-01-28: see php's bug tracking system
you? for more details). The problem is that the bugged package is still available though it was corrected (see redhat's bugzilla for more
So the problem is that this package has a serious bug that was details).
corrected ages ago in php (2001-01-28: see [51]php's bug tracking So please download the fixed package and the problem should go away.
system for more details). The problem is that the bugged package is
still available though it was corrected (see [52]redhat's bugzilla for
more details).
So please download [53]the fixed package and the problem should go
away.
And that fixes the \r\n problem with file uploads! And that fixes the \r\n problem with file uploads!
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, this is the way to create a multi-fields index. If you want two indexes, create the first one when creating the
In phpMyAdmin 2.2.0, this is the way to create a multi-fields index. table, save, then display the table properties and click the Index link to create the other index.
If you want two indexes, create the first one when creating the table,
save, then display the table properties and click the Index link to
create the other index.
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 WinNT4 or Win2K, we could easily create more than 60 fields.
We could reproduce this problem only under Win98/98SE. Testing under A workaround is to create a smaller number of fields, then come back to your table properties and add the other 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
to your table properties and add the other fields.
I get errors about not being able to include a file in /lang I get errors about not being able to include a file in /lang
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 "." somewhere in it, and open_basedir, if used, must contain contain "." and "./lang" to allow normal operation of phpMyAdmin.
"." and "./lang" to allow normal operation of phpMyAdmin.
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 http://sourceforge.net/projects/phpmyadmin/ under the Bugs section.
[54]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:
[55]http://sourceforge.net/projects/phpmyadmin/ (and choose Forums) http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
[56]http://www.phpwizard.net/projects/phpMyAdmin/ (and choose Support http://www.phpwizard.net/projects/phpMyAdmin/ (and choose Support Forum)
Forum) ____________________________________________________________________________________________________________________________________
______________________________________________________________________
Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - 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
great features have been written by other people and you too can help 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), libraries/common.lib.php3 (common functions) and config.inc.php3.
* All files include header.inc.php3 (layout), All configuration data belongs in config.inc.php3. Please keep it free from other code.
libraries/common.lib.php3 (common functions) and config.inc.php3. Commonly used functions should be added to libraries/lib.inc.php3 and more specific ones may be added within a library stored
All configuration data belongs in config.inc.php3. Please keep it into the libraries sub-directory.
free from other code. * Obviously, you're free to use whatever coding style you want. But please try to keep your code as simple as possible: beginners
Commonly used functions should be added to libraries/lib.inc.php3 are using phpMyAdmin as an example application.
and more specific ones may be added within a library stored into By the way, we're currently updating all the scripts so they will be XHTML1.0 and CSS2 compliant on one hand, they will fit PEAR
the libraries sub-directory.
* Obviously, you're free to use whatever coding style you want. But
please try to keep your code as simple as possible: beginners are
using phpMyAdmin as an example application.
By the way, we're currently updating all the scripts so they will
be XHTML1.0 and CSS2 compliant on one hand, they will fit [65]PEAR
coding standards on the other hand. Please pay attention to this. coding standards on the other hand. Please pay attention to this.
* 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
stuff goes to tbl_*.php3, db-related code to db_*.php3 and so on. 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.inc.php3 and print() it out. * If you want to be really helpful, write an entry for the ChangeLog.
* If you want to be really helpful, write an entry for the
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:
cvs cvs -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin login
-d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy
admin login
[Password: simply press the Enter key] [Password: simply press the Enter key]
cvs -z3 cvs -z3 -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin checkout phpMyAdmin
-d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy
admin checkout phpMyAdmin
[This will create a new sub-directory named phpMyAdmin] [This will create a new sub-directory named phpMyAdmin]
* 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 phpMyAdmin SourceForge account
tracker of the phpMyAdmin SourceForge account (http://sourceforge.net/projects/phpmyadmin/)
([66]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 mailing list.
interested in that, please contact us using the phpmyadmin-devel ____________________________________________________________________________________________________________________________________
mailing list.
______________________________________________________________________ Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - Credits
____________________________________________________________________________________________________________________________________
Credits Credits
@@ -658,7 +506,7 @@ CREDITS, in chronological order
The following people have contributed minor changes, enhancements, bugfixes or The following people have contributed minor changes, enhancements, bugfixes or
or support for a new language since version 2.1.0: or support for a new language since version 2.1.0:
Ricardo ?, Sven-Erik Andersen, Alessandro Astarita, Borges Botelho, Bora Alioglu, Ricardo ?, Sven-Erik Andersen, Alessandro Astarita, Borges Botelho,
Olivier Bussier, Michal Cihar, Neil Darlow, Kristof Hamann, Thomas Kl<4B>ger, Olivier Bussier, Michal Cihar, Neil Darlow, Kristof Hamann, Thomas Kl<4B>ger,
Lubos Klokner, Martin Marconcini, Girish Nair, David Nordenberg, Lubos Klokner, Martin Marconcini, Girish Nair, David Nordenberg,
Bernard M. Piller, Laurent Haas, "Sakamoto", www.securereality.com.au, Bernard M. Piller, Laurent Haas, "Sakamoto", www.securereality.com.au,
@@ -705,24 +553,9 @@ 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.
______________________________________________________________________ ____________________________________________________________________________________________________________________________________
[83]Valid XHTML 1.0! [84]Valid CSS! Top - Requirements - Introduction - Installation - Configuration - FAQ - Developers - Credits
____________________________________________________________________________________________________________________________________
References Valid XHTML 1.0! Valid CSS!
1. http://www.phpwizard.net/projects/phpMyAdmin/
2. http://phpmyadmin.sourceforge.net/
47. http://www.phpwizard.net/phorum/list.php?f=1
48. http://www.mysql.com/doc/C/a/Can_not_connect_to_server.html
49. https://sourceforge.net/projects/phpmyadmin/
51. http://www.php.net/bugs.php?id=8966
52. http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=24933
53. http://people.redhat.com/nalin/test/php-4.0.4pl1-7.i386.rpm
54. http://sourceforge.net/projects/phpmyadmin/
55. http://sourceforge.net/projects/phpmyadmin/
56. http://www.phpwizard.net/projects/phpMyAdmin/
65. http://pear.php.net/
66. http://sourceforge.net/projects/phpmyadmin/
83. http://validator.w3.org/check/referer
84. http://jigsaw.w3.org/css-validator/