updated
This commit is contained in:
@@ -1,16 +1,16 @@
|
||||
|
||||
phpMyAdmin 2.2.0 Documentation
|
||||
phpMyAdmin 2.2.1-rc1 Documentation
|
||||
|
||||
* [1]Official phpMyAdmin project homepage
|
||||
http://www.phpwizard.net/projects/phpMyAdmin/
|
||||
* [2]Sourceforge phpMyAdmin download page
|
||||
http://phpmyadmin.sourceforge.net/
|
||||
* [1]Official phpMyAdmin project homepage [
|
||||
http://www.phpwizard.net/projects/phpMyAdmin/ ]
|
||||
* [2]Sourceforge phpMyAdmin download page [
|
||||
http://phpmyadmin.sourceforge.net/ ]
|
||||
* Local documents:
|
||||
+ Version history: [3]ChangeLog
|
||||
+ General notes: [4]README
|
||||
+ License: [5]LICENSE
|
||||
* Documentation version:
|
||||
$Id$
|
||||
* Documentation version: $Id: Documentation.html,v 1.80 2001/10/19
|
||||
14:05:30 loic1 Exp $
|
||||
______________________________________________________________________
|
||||
|
||||
Requirements
|
||||
@@ -41,13 +41,22 @@ Introduction
|
||||
* administer multiple servers and single databases
|
||||
* communicate in more than 20 different languages
|
||||
|
||||
(*) phpMyAdmin can compress (GZip format -RFC 1952- or Bzip2) dumps
|
||||
and CSV exports if you use PHP4 >= 4.0.4 with Zlib support
|
||||
(*) phpMyAdmin can compress (Zip, GZip -RFC 1952- or Bzip2 formats)
|
||||
dumps and CSV exports if you use PHP4 >= 4.0.4 with Zlib support
|
||||
(--with-zlib) and/or Bzip2 support (--with-bz2).
|
||||
______________________________________________________________________
|
||||
|
||||
Installation
|
||||
|
||||
NOTE: phpMyAdmin does not apply any special security methods to the
|
||||
MySQL database server. It is still the sysadmin's job to grant
|
||||
permissions on the MySQL databases properly.
|
||||
|
||||
Warning for Mac users: php seems not to like Mac end of lines
|
||||
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.
|
||||
|
||||
Quick Install:
|
||||
1. Untar or unzip the distribution (be sure to unzip the
|
||||
subdirectories): tar xzvf phpMyAdmin_x.x.x.tar.gz
|
||||
@@ -73,6 +82,11 @@ Installation
|
||||
|
||||
Configuration
|
||||
|
||||
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
|
||||
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.
|
||||
|
||||
$cfgPmaAbsoluteUri string
|
||||
@@ -128,6 +142,10 @@ Configuration
|
||||
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
|
||||
@@ -146,6 +164,10 @@ Configuration
|
||||
$cfgServers[n]['only_db'] string or array
|
||||
If set to a(an array of) database name(s), only this(these)
|
||||
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
|
||||
databases will be displayed but not at all other databases
|
||||
can't be used.
|
||||
|
||||
$cfgServers[n]['verbose'] string
|
||||
Only useful when using phpMyAdmin with multiple server entries.
|
||||
@@ -185,21 +207,21 @@ Configuration
|
||||
If you have only one server configured, $cfgServerDefault MUST
|
||||
be set to that server.
|
||||
|
||||
$cfgConfirm boolean
|
||||
Whether a warning ("Are your really sure..") should be
|
||||
displayed when you're about to loose data.
|
||||
$cfgOBGzip boolean
|
||||
Defines whether to use gzip output buffering for increased
|
||||
speed in HTTP transfers.
|
||||
|
||||
$cfgPersistentConnections boolean
|
||||
Whether persistent connections should be used or not
|
||||
(mysql_connect or mysql_pconnect).
|
||||
|
||||
$cfgShowBlob boolean
|
||||
Defines whether BLOB fields are shown when browsing a table's
|
||||
content or not.
|
||||
$cfgSkipLockedTables boolean
|
||||
Mark used tables and make it possible to show databases with
|
||||
locked tables (since 3.23.30).
|
||||
|
||||
$cfgProtectBlob boolean
|
||||
Defines whether BLOB fields are protected from edition when
|
||||
browsing a table's content or not.
|
||||
$cfgShowSQL boolean
|
||||
Defines whether sql-queries generated by phpMyAdmin should be
|
||||
displayed or not.
|
||||
|
||||
$cfgAllowUserDropDatabase boolean
|
||||
Defines whether standard users (non administrator) are allowed
|
||||
@@ -208,13 +230,28 @@ Configuration
|
||||
mydatabase" will be rejected. Quite practical for ISP's with
|
||||
many customers.
|
||||
|
||||
$cfgShowSQL boolean
|
||||
Defines whether sql-queries generated by phpMyAdmin should be
|
||||
displayed or not.
|
||||
$cfgConfirm boolean
|
||||
Whether a warning ("Are your really sure..") should be
|
||||
displayed when you're about to loose data.
|
||||
|
||||
$cfgSkipLockedTables boolean
|
||||
Mark used tables and make it possible to show databases with
|
||||
locked tables (since 3.23.30).
|
||||
$cfgShowTooltip boolean
|
||||
Defines whether to display table comment as tooltip in left
|
||||
frame or not.
|
||||
|
||||
$cfgShowStats boolean
|
||||
Defines whether to display space usage and statistics about
|
||||
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
|
||||
Berkeley DB tables.
|
||||
|
||||
$cfgShowBlob boolean
|
||||
Defines whether BLOB fields are shown when browsing a table's
|
||||
content or not.
|
||||
|
||||
$cfgShowAll boolean
|
||||
Defines whether an user should be displayed a "show all
|
||||
(records)" button in browse mode or not.
|
||||
|
||||
$cfgMaxRows integer
|
||||
Number of rows displayed when browsing a resultset. If the
|
||||
@@ -227,14 +264,19 @@ Configuration
|
||||
descending order for fields of type TIME, DATE, DATETIME &
|
||||
TIMESTAMP, ascending order else- by default.
|
||||
|
||||
$cfgOBGzip boolean
|
||||
Defines whether to use gzip output buffering for increased
|
||||
speed in HTTP transfers.
|
||||
$cfgProtectBinary boolean
|
||||
Defines whether BLOB or BINARY fields are protected from
|
||||
edition when browsing a table's content or not. Valid values
|
||||
are:
|
||||
- FALSE to allow edition of all fields;
|
||||
- blob to allow edition of all fields except BLOBS;
|
||||
- all to disallow edition of all BINARY or BLOB fields.
|
||||
|
||||
$cfgGZipDump boolean
|
||||
$cfgZipDump boolean
|
||||
$cfgGZipDump boolean
|
||||
$cfgBZipDump boolean
|
||||
Defines whether to allow the use of gzip/bzip compression when
|
||||
creating a dump file or not.
|
||||
Defines whether to allow the use of zip/gzip/bzip compression
|
||||
when creating a dump file or not.
|
||||
|
||||
$cfgManualBase string
|
||||
If set to an URL which points to the MySQL documentation,
|
||||
@@ -250,6 +292,10 @@ Configuration
|
||||
Force: always use this language (must be defined in the
|
||||
select_lang.inc.php3 script).
|
||||
|
||||
$cfgLeftBgColor string [HTML color] $cfgRightBgColor string [HTML
|
||||
color]
|
||||
The background colors (HTML) used for both the frames.
|
||||
|
||||
$cfgBorder integer
|
||||
The size of a table's border.
|
||||
|
||||
@@ -267,8 +313,9 @@ Configuration
|
||||
Number of columns and rows for the textareas.
|
||||
|
||||
$cfgLimitChars integer
|
||||
Maximal number of Chars showed in a TEXT field on browse view.
|
||||
Can be turned off by a toggle button on the browse page.
|
||||
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
|
||||
page.
|
||||
|
||||
$cfgModifyDeleteAtLeft boolean
|
||||
$cfgModifyDeleteAtRight boolean
|
||||
@@ -294,10 +341,19 @@ Configuration
|
||||
|
||||
FAQ - Frequently Asked Questions
|
||||
|
||||
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, what
|
||||
can I do?
|
||||
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
|
||||
.php3 file and the zlib.output_compression directive to Off in your
|
||||
php configuration file.
|
||||
|
||||
The error message "Warning: Cannot add header information - headers
|
||||
already sent by ..." is displayed, what's the problem?
|
||||
Look at the end of your config.inc.php or .php3 file, there must be no
|
||||
blank lines or spaces after the ?>.
|
||||
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
|
||||
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.
|
||||
Examine the SQL error with care. I've found that many programmers
|
||||
@@ -332,6 +388,9 @@ FAQ - Frequently Asked Questions
|
||||
config.inc.php3.
|
||||
For example: $cfgServers[n]['socket'] = '/tmp/mysql.sock';
|
||||
|
||||
Have also a look at the [48]corresponding section of the MySQL
|
||||
documentation.
|
||||
|
||||
phpMyAdmin always gives "Access denied" when using advanced
|
||||
authentication.
|
||||
This could happen for some reasons:
|
||||
@@ -365,11 +424,11 @@ FAQ - Frequently Asked Questions
|
||||
[This will create a new sub-directory named phpMyAdmin]
|
||||
* add your stuff
|
||||
* put the modified files (tar'ed and gzip'ed) inside the patch
|
||||
tracker of the [48]phpMyAdmin SourceForge account.
|
||||
tracker of the [49]phpMyAdmin SourceForge account.
|
||||
|
||||
Write access to the CVS tree is granted only to experienced developers
|
||||
who have already contributed something useful to phpMyAdmin.
|
||||
Also, have a look at the [49]Developers section.
|
||||
Also, have a look at the [50]Developers section.
|
||||
|
||||
What's the preferred way of making phpMyAdmin secure against evil
|
||||
access?
|
||||
@@ -449,11 +508,11 @@ FAQ - Frequently Asked Questions
|
||||
7.0 and you updated your php rpm to php-4.0.4pl1-3.i386.rpm, didn't
|
||||
you?
|
||||
So the problem is that this package has a serious bug that was
|
||||
corrected ages ago in php (2001-01-28: see [50]php's bug tracking
|
||||
corrected ages ago in php (2001-01-28: see [51]php's bug tracking
|
||||
system for more details). The problem is that the bugged package is
|
||||
still available though it was corrected (see [51]redhat's bugzilla for
|
||||
still available though it was corrected (see [52]redhat's bugzilla for
|
||||
more details).
|
||||
So please download [52]the fixed package and the problem should go
|
||||
So please download [53]the fixed package and the problem should go
|
||||
away.
|
||||
And that fixes the \r\n problem with file uploads!
|
||||
|
||||
@@ -466,16 +525,23 @@ FAQ - Frequently Asked Questions
|
||||
|
||||
I get an out of memory error, and my controls are non-functional, when
|
||||
trying to create a table with more than 14 fields.
|
||||
This is a problem under investigation. Seems to be OS and/or browser-
|
||||
dependent. For now, create a smaller number of fields, then come back
|
||||
We could reproduce this problem only under Win98/98SE. Testing under
|
||||
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 have found a bug. How do I inform developpers?
|
||||
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
|
||||
contain "." somewhere in it, and open_basedir, if used, must contain
|
||||
"." and "./lang" to allow normal operation of phpMyAdmin.
|
||||
|
||||
I have found a bug. How do I inform developers?
|
||||
Our Bug Tracker is located at
|
||||
[53]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:
|
||||
[54]http://sourceforge.net/projects/phpmyadmin (and choose Forums)
|
||||
[55]http://www.phpwizard.net/projects/phpMyAdmin (and choose Support
|
||||
[55]http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
|
||||
[56]http://www.phpwizard.net/projects/phpMyAdmin/ (and choose Support
|
||||
Forum)
|
||||
______________________________________________________________________
|
||||
|
||||
@@ -487,16 +553,18 @@ Developers Information
|
||||
|
||||
If you're planning to contribute source, please read the following
|
||||
information:
|
||||
* All files include header.inc.php3 (layout), lib.inc.php3 (common
|
||||
functions) and config.inc.php3.
|
||||
* All files include header.inc.php3 (layout),
|
||||
libraries/common.lib.php3 (common functions) and config.inc.php3.
|
||||
All configuration data belongs in config.inc.php3. Please keep it
|
||||
free from other code.
|
||||
Commonly used functions should be added to lib.inc.php3.
|
||||
Commonly used functions should be added to libraries/lib.inc.php3
|
||||
and more specific ones may be added within a library stored into
|
||||
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 [64]PEAR
|
||||
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.
|
||||
* 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.
|
||||
@@ -519,7 +587,7 @@ Developers Information
|
||||
* add your stuff
|
||||
* put the modified files (tar'ed and gzip'ed) inside the patch
|
||||
tracker of the phpMyAdmin SourceForge account
|
||||
([65]http://sourceforge.net/projects/phpmyadmin/)
|
||||
([66]http://sourceforge.net/projects/phpmyadmin/)
|
||||
|
||||
Write access to the CVS tree is granted only to developers who have
|
||||
already contributed something useful to phpMyAdmin. If you're
|
||||
@@ -565,7 +633,7 @@ CREDITS, in chronological order
|
||||
* bookmarks feature
|
||||
* multiple dump feature
|
||||
* gzip dump feature
|
||||
* zip dump feature
|
||||
* zip dump feature
|
||||
|
||||
[gl] - Geert Lund <glund_at_silversoft.dk>
|
||||
* various fixes
|
||||
@@ -639,21 +707,22 @@ Original Credits of Version 2.1.0
|
||||
and or just some feedback.
|
||||
______________________________________________________________________
|
||||
|
||||
[82]Valid XHTML 1.0! [83]Valid CSS!
|
||||
[83]Valid XHTML 1.0! [84]Valid CSS!
|
||||
|
||||
References
|
||||
|
||||
1. http://www.phpwizard.net/projects/phpMyAdmin/
|
||||
2. http://phpmyadmin.sourceforge.net/
|
||||
47. http://www.phpwizard.net/phorum/list.php?f=1
|
||||
48. https://sourceforge.net/projects/phpmyadmin/
|
||||
50. http://www.php.net/bugs.php?id=8966
|
||||
51. http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=24933
|
||||
52. http://people.redhat.com/nalin/test/php-4.0.4pl1-7.i386.rpm
|
||||
53. http://sourceforge.net/projects/phpmyadmin
|
||||
54. http://sourceforge.net/projects/phpmyadmin
|
||||
55. http://www.phpwizard.net/projects/phpMyAdmin
|
||||
64. http://pear.php.net/
|
||||
65. http://sourceforge.net/projects/phpmyadmin/
|
||||
82. http://validator.w3.org/check/referer
|
||||
83. http://jigsaw.w3.org/css-validator/
|
||||
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/
|
||||
|
Reference in New Issue
Block a user