This commit is contained in:
Marc Delisle
2002-06-17 12:49:57 +00:00
parent 9a84c6e892
commit 2b243de9f2
2 changed files with 451 additions and 446 deletions

View File

@@ -753,7 +753,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;page_nr int(10) unsigned NOT NULL auto_increment,<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;page_nr int(10) unsigned NOT NULL auto_increment,<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;page_descr varchar(50) NOT NULL default '',<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;page_descr varchar(50) NOT NULL default '',<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;PRIMARY KEY (page_nr),<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;PRIMARY KEY (page_nr),<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;KEY (db_name),<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;KEY (db_name)<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;) TYPE=MyISAM COMMENT='PDF Relationpages for PMA';<br /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;) TYPE=MyISAM COMMENT='PDF Relationpages for PMA';<br />
</tt> </tt>
<li> <li>

View File

@@ -1,18 +1,18 @@
phpMyAdmin 2.3.0-dev Documentation phpMyAdmin 2.3.0-dev Documentation
* [1]Sourceforge phpMyAdmin project page [ * Sourceforge phpMyAdmin project page [ http://www.phpmyadmin.net/
http://www.phpmyadmin.net/ ] ]
* Local documents: * Local documents:
+ Version history: [2]ChangeLog + Version history: ChangeLog
+ General notes: [3]README + General notes: README
+ License: [4]LICENSE + License: LICENSE
* Documentation version: $Id: Documentation.html,v 1.244 2002/06/02 * Documentation version: $Id: Documentation.html,v 1.262 2002/06/17
19:37:54 loic1 Exp $ 12:49:20 lem9 Exp $
______________________________________________________________________ ______________________________________________________________________
[5]Top - [6]Requirements - [7]Introduction - [8]Installation - Top - Requirements - Introduction - Installation -
[9]Configuration - [10]FAQ - [11]Developers - [12]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
Requirements Requirements
@@ -25,8 +25,8 @@ Requirements
* a web-browser (doh!). * a web-browser (doh!).
______________________________________________________________________ ______________________________________________________________________
[13]Top - [14]Requirements - [15]Introduction - [16]Installation Top - Requirements - Introduction - Installation -
- [17]Configuration - [18]FAQ - [19]Developers - [20]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
Introduction Introduction
@@ -48,15 +48,15 @@ Introduction
* check referential integrity * check referential integrity
* create complex Queries automatically connecting required tables * create complex Queries automatically connecting required tables
* create PDF graphics of your Database layout * create PDF graphics of your Database layout
* communicate in more than [21]38 different languages * communicate in more than 38 different languages
(*) phpMyAdmin can compress (Zip, GZip -RFC 1952- or Bzip2 formats) (*) phpMyAdmin can compress (Zip, GZip -RFC 1952- or Bzip2 formats)
dumps and CSV exports if you use PHP4 >= 4.0.4 with Zlib support dumps and CSV exports if you use PHP4 >= 4.0.4 with Zlib support
(--with-zlib) and/or Bzip2 support (--with-bz2). (--with-zlib) and/or Bzip2 support (--with-bz2).
______________________________________________________________________ ______________________________________________________________________
[22]Top - [23]Requirements - [24]Introduction - [25]Installation Top - Requirements - Introduction - Installation -
- [26]Configuration - [27]FAQ - [28]Developers - [29]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
Installation Installation
@@ -84,12 +84,12 @@ Installation
3. 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 the values for host, user, password and authentication mode to fit
your environment. Also insert the correct value for your environment. Also insert the correct value for
$cfg['PmaAbsoluteUri']. Have a look at [30]Configuration section $cfg['PmaAbsoluteUri']. Have a look at Configuration section for
for an explanation of all values. an explanation of all values.
4. 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 installed phpMyAdmin (unless it's on a closed intranet, or you
wish to use http or cookie authentication), for example with wish to use http or cookie authentication), for example with
HTTP-AUTH (in a .htaccess file). See the [31]FAQ section for HTTP-AUTH (in a .htaccess file). See the FAQ section for
additional information. additional information.
5. 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 browser. phpMyAdmin should now display a welcome screen and
@@ -134,10 +134,11 @@ Installation
GRANT SELECT ON mysql.db TO 'pma'@'localhost'; GRANT SELECT ON mysql.db TO 'pma'@'localhost';
GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv) ON GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv) ON
mysql.tables_priv TO 'pma'@'localhost'; mysql.tables_priv TO 'pma'@'localhost';
... and if you want to use the many new relation and bookmark features: ... and if you want to use the many new relation and bookmark
GRANT SELECT, INSERT, DELETE ON <pma_db> TO 'pma'@'localhost'; features:
(this of course requires you to have a special DB for phpMyAdmin, the contents GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db> TO
will be explained later) 'pma'@'localhost'; (this of course requires you to have a special DB
for phpMyAdmin, the contents will be explained later)
* Then each of the true users should be granted of a set of * Then each of the true users should be granted of a set of
privileges on a set of particular databases but shouldn't have any privileges on a set of particular databases but shouldn't have any
global privileges. For example, to grant the user real_user with global privileges. For example, to grant the user real_user with
@@ -177,8 +178,8 @@ Installation
directives. directives.
______________________________________________________________________ ______________________________________________________________________
[32]Top - [33]Requirements - [34]Introduction - [35]Installation Top - Requirements - Introduction - Installation -
- [36]Configuration - [37]FAQ - [38]Developers - [39]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
Configuration Configuration
@@ -204,8 +205,8 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
. $_SERVER['HTTP_HOST'] . $_SERVER['HTTP_HOST']
. (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SER . (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SER
VER_PORT'] : '') VER_PORT'] : '')
. substr($_SERVER['PHP_SELF'], 0, strrpos($['PHP_SELF'], . substr($_SERVER['PHP_SELF'], 0, strrpos($_SERVER['PHP_
'/')+1); SELF'], '/')+1);
or or
@@ -257,8 +258,8 @@ CRIPT_NAME'], '/')+1);
columns) & mysql.tables_priv (all columns except "Grantor" & columns) & mysql.tables_priv (all columns except "Grantor" &
"Timestamp") tables. This account is used to check what "Timestamp") tables. This account is used to check what
databases the user will see at login. databases the user will see at login.
Please see the [40]install section on "Using http Please see the install section on "Using http authentication"
authentication" for more information. for more information.
Note that if you try login to phpMyAdmin with this Note that if you try login to phpMyAdmin with this
"controluser", you could get some errors, depending the exact "controluser", you could get some errors, depending the exact
privileges you gave to the "controluser". phpMyAdmin does not privileges you gave to the "controluser". phpMyAdmin does not
@@ -314,22 +315,23 @@ CRIPT_NAME'], '/')+1);
Starting with Version 2.3.0 phpMyAdmin offers a lot of Features Starting with Version 2.3.0 phpMyAdmin offers a lot of Features
to work with Master / Foreign - Tables. To use those as well as to work with Master / Foreign - Tables. To use those as well as
the bookmark feature you will need to create a new db. the bookmark feature you will need to create a new db.
To use this functionality as superuser create a new database:
+ create a new database for phpmyadmin: CREATE database
phpmyadmin; Note that controluser must have SELECT, INSERT
and DELETE privileges on the bookmark table. Here is a query
to set up those privileges (using "pma" as the controluser):
GRANT SELECT,INSERT,DELETE ON to 'pma'@localhost; do not
give any other user rights on this db.
+ Enter the databasename in $cfg['Servers'][$i]['pmadb']
$cfg['Servers'][$i]['bookmarktable'] string $cfg['Servers'][$i]['bookmarktable'] string
Since release 2.2.0 phpMyAdmin allows to bookmark queries. This Since release 2.2.0 phpMyAdmin allows to bookmark queries. This
can be useful for queries you often run. can be useful for queries you often run.
To use this functionality as superuser create a new database: To allow the usage of this functionality the superuser has to:
CREATE database phpmyadmin;
Note that controluser must have SELECT, INSERT and DELETE
privileges on the bookmark table. Here is a query to set up
those privileges (using "pma" as the controluser:
GRANT SELECT,INSERT,DELETE ON <pmadb> to
'pma'@localhost;
do _not_ give any other user rights on this db.
Enter the databasename in $cfg['Servers'][$i]['pmadb'] + set up a PMA database as described above
$cfg['Servers'][$i]['bookmarktable'] string + within this database create a table following this scheme:
Inside your phpMyAdmin Databse create a table following this scheme:
CREATE TABLE bookmark ( CREATE TABLE bookmark (
id int(11) DEFAULT '0' NOT NULL auto_increment, id int(11) DEFAULT '0' NOT NULL auto_increment,
dbase varchar(255) NOT NULL, dbase varchar(255) NOT NULL,
@@ -337,8 +339,14 @@ CRIPT_NAME'], '/')+1);
label varchar(255) NOT NULL, label varchar(255) NOT NULL,
query text NOT NULL, query text NOT NULL,
PRIMARY KEY (id) PRIMARY KEY (id)
); ) TYPE=MyISAM COMMENT='Bookmarks';
and add the name in $cfg['Servers'][$i]['bookmarktable'] + Enter the tablename in $cfg['Servers'][$i]['bookmarktable']
Note that controluser must have SELECT, INSERT and DELETE
privileges on the bookmark table. Here is a query to set up
those privileges (using "pma" as the controluser and phpmyadmin
as databasename:
GRANT SELECT,INSERT,DELETE ON <phpmyadmin> to 'pma'@localhost;
$cfg['Servers'][$i]['relation'] string $cfg['Servers'][$i]['relation'] string
Since release 2.2.4 you can describe, in a special 'relation' Since release 2.2.4 you can describe, in a special 'relation'
@@ -359,96 +367,99 @@ CRIPT_NAME'], '/')+1);
the table_coords table). the table_coords table).
The keys can be numeric or character. The keys can be numeric or character.
To use this functionality you have to To allow the usage of this functionality the superuser has to:
+ set up a PMA database as
described above and inside this database create a table:
CREATE TABLE relation ( + set up a PMA database as described above
master_db varchar(64) NOT NULL default '', + within this database create a table following this scheme:
master_table varchar(64) NOT NULL default '', CREATE TABLE `relation` (
master_field varchar(64) NOT NULL default '', `master_db` varchar(64) NOT NULL default '',
foreign_db varchar(64) NOT NULL default '', `master_table` varchar(64) NOT NULL default '',
foreign_table varchar(64) NOT NULL default '', `master_field` varchar(64) NOT NULL default '',
foreign_field varchar(64) NOT NULL default '', `foreign_db` varchar(64) NOT NULL default '',
PRIMARY KEY (master_db,master_table,master_field), `foreign_table` varchar(64) NOT NULL default '',
`foreign_field` varchar(64) NOT NULL default '',
PRIMARY KEY
(`master_db`,`master_table`,`master_field`),
KEY foreign_field (foreign_db,foreign_table) KEY foreign_field (foreign_db,foreign_table)
) TYPE=MyISAM COMMENT='Table Relation'; ) TYPE=MyISAM COMMENT='Relation table';
+ put the relation table name in + put the relation table name in
$cfg['Servers'][$i]['relation'] $cfg['Servers'][$i]['relation']
+ on the tablestructure page you will find a link to edit + now as normal user open phpMyAdmin and for each table where
a tables relation which you can use to fill this table. you want to use this feature, click "Structure/Relation
view/" and choose foreign fields.
$cfg['Servers'][$i]['table_info'] string $cfg['Servers'][$i]['table_info'] string
Since release 2.3.0 you can describe, in a special 'table_info' Since release 2.3.0 you can describe, in a special 'table_info'
table, which field is to be displayed as a tooltip when moving table, which field is to be displayed as a tooltip when moving
the cursor over the corresponding key. the cursor over the corresponding key.
This configuration variable will hold the name of this special This configuration variable will hold the name of this special
table. table. To allow the usage of this functionality the superuser
has to:
+ To use this functionality you have to set up a PMA database as
described above and inside this database create a table:
CREATE TABLE table_info (
db_name varchar(64) NOT NULL default '',
table_name varchar(64) NOT NULL default '',
display_field varchar(64) NOT NULL default '',
PRIMARY KEY (db_name,table_name)
) TYPE=MyISAM COMMENT='Table information for phpMyAdmin';
+ set up a PMA database as described above
+ within this database create a table following this scheme:
CREATE TABLE `PMA_table_info` (
`db_name` varchar(64) NOT NULL default '',
`table_name` varchar(64) NOT NULL default '',
`display_field` varchar(64) NOT NULL default '',
PRIMARY KEY (`db_name`,`table_name`)
) TYPE=MyISAM COMMENT='Table information for
phpMyAdmin';
+ put the table name in $cfg['Servers'][$i]['table_info'] + put the table name in $cfg['Servers'][$i]['table_info']
+ then for each table where you want to use this feature, click + then for each table where you want to use this feature, click
"Structure/Relation view/Choose field to display" to choose "Structure/Relation view/Choose field to display" to choose
the field. the field.
Usage tip: [41]Display field. Usage tip: Display field.
$cfg['Servers'][$i]['table_coords'] string $cfg['Servers'][$i]['table_coords'] string
$cfg['Servers'][$i]['pdf_pages'] string $cfg['Servers'][$i]['pdf_pages'] string
Since release 2.3.0 you can have phpMyAdmin create a PDF showing Since release 2.3.0 you can have phpMyAdmin create PDF Pages
the relations within your Database. To use this feature you will showing the relations between your tables. To do this it needs
need a table that stores the PDF pages to create and the Coordinates two tables 'pdf_pages' (storing information about the available
of Tables to use per page. pdf Pages) and 'table_coords' (storing coordinates where each
This configuration variable will hold the name of this special table will be placed on a PDF schema output).
table.
PDF output is supported under PHP4, and you must be using also PDF output is supported under PHP4, and you must be using also
the 'relation' feature. Also, we used the fpdf library which the 'relation' feature and have a table of PDF Pages (see
currently only supports iso-8859 (Latin1) character sets in $cfg['Servers'][$i]['pdf_pages']). Also, we used the fpdf
PDF. library which currently only supports iso-8859 (Latin1)
To use this functionality you have to: character sets in PDF.
To allow the usage of this functionality the superuser has to:
+ set up a PMA database as described above + set up a PMA database as described above
+ inside this database create a table: + within this database create a table following this scheme:
CREATE TABLE table_coords ( CREATE TABLE `table_coords` (
db_name varchar(64) NOT NULL default '', `db_name` varchar(64) NOT NULL default '',
table_name varchar(64) NOT NULL default '', `table_name` varchar(64) NOT NULL default '',
pdf_page_number int(11) NOT NULL default '0', `pdf_page_number` int NOT NULL default '0',
x float unsigned NOT NULL default '0', `x` float unsigned NOT NULL default '0',
y float unsigned NOT NULL default '0', `y` float unsigned NOT NULL default '0',
PRIMARY KEY (db_name,table_name,pdf_page_number) PRIMARY KEY (`db_name`,`table_name`,
) TYPE=MyISAM COMMENT='Table coordinates for phpMyAdmin PDF output'; `pdf_page_number`)
+ Also in the PMA database create the following table: ) TYPE=MyISAM COMMENT='Table coordinates for phpMyAdmin
CREATE TABLE pdf_pages ( PDF output';
db_name varchar(64) NOT NULL default '', + also within this database create: CREATE TABLE pdf_pages
(
`db_name` varchar(64) NOT NULL default '',
page_nr int(10) unsigned NOT NULL auto_increment, page_nr int(10) unsigned NOT NULL auto_increment,
page_descr varchar(50) NOT NULL default '', page_descr varchar(50) NOT NULL default '',
PRIMARY KEY (page_nr), PRIMARY KEY (page_nr),
KEY db (db_name) KEY (db_name)
) TYPE=MyISAM COMMENT='PDF Relationpages for PMA'; ) TYPE=MyISAM COMMENT='PDF Relationpages for PMA';
+ put the first table name in
$cfg['Servers'][$i]['table_coords'] and the second table name
in $cfg['Servers'][$i]['pdf_pages']
+ put the first tables name in $cfg['Servers'][$i]['table_coords'] Usage tips: PDF output.
+ put the second tables name in $cfg['Servers'][$i]['pdf_pages']
+ on the bottom of the structurepage for databases there is a link
to create pdf pages, and once you created one also one to have the
pdf created
Usage tips: [42]PDF output.
$cfg['Servers'][$i]['column_comments'] string $cfg['Servers'][$i]['column_comments'] string
Since release 2.3.0 you can store comments to describe each column Since release 2.3.0 you can store comments to describe each
for each table. These will then be shown on the printview. column for each table. These will then be shown on the
To use this functionality you have to: printview. To allow the usage of this functionality the
superuser has to:
+ set up a PMA database as described above + set up a PMA database as described above
+ inside this database create a table: + within this database create a table following this scheme:
CREATE TABLE column_comments ( CREATE TABLE column_comments (
id int(5) unsigned NOT NULL auto_increment, id int(5) unsigned NOT NULL auto_increment,
db_name varchar(64) NOT NULL default '', db_name varchar(64) NOT NULL default '',
@@ -458,7 +469,7 @@ CRIPT_NAME'], '/')+1);
PRIMARY KEY (id), PRIMARY KEY (id),
UNIQUE KEY db_name (db_name,table_name,column_name) UNIQUE KEY db_name (db_name,table_name,column_name)
) TYPE=MyISAM COMMENT='Comments for Columns'; ) TYPE=MyISAM COMMENT='Comments for Columns';
+ put the tables name in $cfg['Servers'][$i]['column_comments'] + put the table name in $cfg['Servers'][$i]['column_comments']
$cfg['Servers'][$i]['AllowDeny']['order'] string $cfg['Servers'][$i]['AllowDeny']['order'] string
If your rule order is empty, then IP authentication is If your rule order is empty, then IP authentication is
@@ -638,6 +649,26 @@ CRIPT_NAME'], '/')+1);
Force: always use this language (must be defined in the Force: always use this language (must be defined in the
select_lang.inc.php3 script). select_lang.inc.php3 script).
$cfg['DefaultCharset'] string
Default charset to use for recoding of MySQL queries. This must
be enabled and it's described by $cfg['AllowAnywhereRecoding']
option. You can give here any charset which is in
$cfg['AvailableCharsets'] array and this is just default
choice, user can select any of them.
$cfg['AllowAnywhereRecoding'] boolean
Allow charset recoding of MySQL queries. You need recode or
iconv support (compiled in or module) in php to allow MySQL
queries recoding and used language file must have it enabled
(by default only these which are in unicode, just to avoid
losing some characters).
$cfg['AvailableCharsets'] array
Available charsets for MySQL conversion. You can add your own
(any of supported by recode/iconv) or remove these which you
don't use. Charsets will be shown in same order as here listed,
so if you frequently use some of these move them to the top.
$cfg['LeftWidth'] integer $cfg['LeftWidth'] integer
Left frame width in pixel. Left frame width in pixel.
@@ -700,6 +731,34 @@ 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
Syntaxcoloring. 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 Configurationarrays
$cfg['keywords'] and $cfg['additional']
$cfg['colorFunctions'] string [HTML color]
If you use Syntaxcoloring then this defines the Color of
Functionnames. e.g. all that are found in $cfg['Functions'].
$cfg['colorKeywords'] string [HTML color]
If you use Syntaxcoloring then this defines the Color of
Keywords. e.g. all that are found in $cfg['keywords'].
$cfg['colorStrings'] string [HTML color]
If you use Syntaxcoloring then this defines the Color of
Strings. e.g. all that are between ' or "
$cfg['colorColType'] string [HTML color]
If you use Syntaxcoloring then this defines the Color of
ColumnTypes. e.g. all that are found in $cfg['ColumnTypes'].
$cfg['colorAdd'] string [HTML color]
If you use Syntaxcoloring 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.
@@ -711,16 +770,26 @@ CRIPT_NAME'], '/')+1);
$cfg['Functions'] array $cfg['Functions'] array
A list of functions MySQL supports. In most cases you don't A list of functions MySQL supports. In most cases you don't
need to edit this. need to edit this.
$cfg['keywords'] array
A list of Keywords that is used for Syntaxcoloring. All
Keywords that are in this list will also get a new line before
them. Usually you won't need to change those.
$cfg['additional'] array
A list of additional Keywords that is used for Syntaxcoloring.
All Keywords that are in this list will not get a new line
before them. Usually you won't need to change those.
______________________________________________________________________ ______________________________________________________________________
[43]Top - [44]Requirements - [45]Introduction - [46]Installation Top - Requirements - Introduction - Installation -
- [47]Configuration - [48]FAQ - [49]Developers - [50]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
FAQ - Frequently Asked Questions FAQ - Frequently Asked Questions
[51]Server - [52]Configuration - [53]Limitations - Server - Configuration - Limitations - Multi-user - Browsers
[54]Multi-user - [55]Browsers - [56]Usage tips - [57]Project - Usage tips - Project - Syntax Coloring
[Server] [Server]
@@ -746,23 +815,23 @@ FAQ - Frequently Asked Questions
I'm running phpMyAdmin with "cookie" authentication mode under PHP I'm running phpMyAdmin with "cookie" authentication mode under PHP
4.2.0 or 4.2.1 loaded as an Apache 2+ module but can't enter the 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 [58]bug report) from the official php This is a kown PHP bug (see this bug report) from the official php bug
bug database. It means there is and won't be any phpMyAdmin fix database. It means there is and won't be any phpMyAdmin fix against it
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 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 [59]bug report distribution. Have a look at the last message in this bug report from
from the official php bug database. the official php bug database.
Using phpMyAdmin on IIS, I'm facing crashes and/or many error messages Using phpMyAdmin on IIS, I'm facing crashes and/or many error messages
with the http or advanced authentication mode. with the http or advanced authentication mode.
This is a known problem with the php ISAPI filter: it's not so stable. This is a known problem with the php ISAPI filter: it's not so stable.
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 [60]this thread from the posted by Andr<64> B. aka "djdeluxe76" in this thread from the phpWizard
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! I can't use phpMyAdmin on PWS: nothing is displayed!
@@ -801,11 +870,11 @@ FAQ - Frequently Asked Questions
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?
So the problem is that this package has a serious bug that was So the problem is that this package has a serious bug that was
corrected ages ago in php (2001-01-28: see [61]php's bug tracking corrected ages ago in php (2001-01-28: see php's bug tracking system
system for more details). The problem is that the bugged package is for more details). The problem is that the bugged package is still
still available though it was corrected (see [62]redhat's bugzilla for available though it was corrected (see redhat's bugzilla for more
more details). details).
So please download [63]the fixed package (4.0.4pl1-9) and the problem So please download the fixed package (4.0.4pl1-9) and the problem
should go away. should go away.
And that fixes the \r\n problem with file uploads! And that fixes the \r\n problem with file uploads!
@@ -828,7 +897,7 @@ FAQ - Frequently Asked Questions
commands, removed. commands, removed.
I have lost my MySQL root password, what can I do? I have lost my MySQL root password, what can I do?
The MySql manual explains how to [64]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. 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
@@ -870,13 +939,13 @@ FAQ - Frequently Asked Questions
on other systems, too. on other systems, too.
If you encounter this bug together with another OS and/or MySQL If you encounter this bug together with another OS and/or MySQL
version or you know how to work around it, please post a message into version or you know how to work around it, please post a message into
[65]our bug tracker at SourceForge. our bug tracker at SourceForge.
I can't run the "display relations" feature because the script seems I can't run the "display relations" feature because the script seems
not to know the font face I'm using! 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 [66]FPDF manual to build these files. Please refers to the FPDF manual to build these files.
[Configuration] [Configuration]
@@ -902,7 +971,7 @@ FAQ - Frequently Asked Questions
change it to change it to
mysql.default_socket = /var/lib/mysql/mysql.sock mysql.default_socket = /var/lib/mysql/mysql.sock
Then restart apache and it will work. Then restart apache and it will work.
Here is a fix suggested by Brad Ummer in the [67]phpwizard forum: Here is a fix suggested by Brad Ummer in the 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 directory. In this directory there should be a file named
@@ -916,7 +985,7 @@ FAQ - Frequently Asked Questions
config.inc.php3. config.inc.php3.
For example: $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock'; For example: $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock';
Have also a look at the [68]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 Nothing is displayed by my browser when I try to run phpMyAdmin, what
@@ -1071,9 +1140,9 @@ FAQ - Frequently Asked Questions
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 whitespace in With Mozilla 0.9.? to 1.0 and Netscape 7.0-PR1 I can't type a
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 [69]Bugzilla). This is a Mozilla bug (see bug #26882 at Bugzilla).
[Using phpMyAdmin] [Using phpMyAdmin]
@@ -1120,9 +1189,8 @@ FAQ - Frequently Asked Questions
How can I use the relation table in Query-by-example? How can I use the relation table in Query-by-example?
Here is an example with the tables persons, towns and countries. If Here is an example with the tables persons, towns and countries. If
you don't have a PMA Database and a relation table, create it as you don't have a PMA_relation table, create it as explained in the
explained in the configuration section or beg your provider to do so. configuration section. Then create the example tables:
Then create the example tables:
CREATE TABLE countries ( CREATE TABLE countries (
country_code char(1) NOT NULL default '', country_code char(1) NOT NULL default '',
description varchar(10) NOT NULL default '', description varchar(10) NOT NULL default '',
@@ -1163,33 +1231,71 @@ FAQ - Frequently Asked Questions
* Click "Submit query" * Click "Submit query"
How can I use the "display field" feature? 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? How can I produce a PDF schema of my database?
First you have to fill the 'relation' and 'table_coords' configuration First you have to fill the 'relation', 'table_coords' and 'pdf_pages'
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
pages. You have to fill in the 'relation' table the page number for pages.
each master-foreign link. * Click on your db name in the left frame
A table may be displayed on more that one page, depending on how many * Choose "Structure" in the navigation on top
links it has to other tables. * Choose "Edit PDF Pages" which should be somewhere at the bottom of
Then manually fill the table_coords table with the page number and the the page
coordinates, x being the width and y the height, and (0,0) at the * Enter the name for a first pdf page and submit
upper left corner. For example, x=100 and y=200 means that the table * Choose this page to edit
will be at 200 mm down and 100 mm right from the upper left corner. * Now add a table you want to show on this page and it's coordinates
To generate the output, click on your database name, then choose and submit
'Structure' and 'Display PDF schema', and enter the page number. First you will have to guess this coordinates of course, so just
expect to have an area of about 297 * 210 and put the tables
coordinates somewhere in there, you will be able to have a look at
what happened and change them later.
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.
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
good start to have an idea of what coordinates to use.
* After every table you submitted you will have the possibility to
submit more tables
* When you have entered enough tables Click on your db name in the
left frame again
* Now, again at the bottom of the page you should be able to choose
"Display PDF schema"
For testing it might be useful to show the Grid as well, so you
can see the coordinates used
maybe also choose Color and submit.
* Save the file he will offer you to something like Schema.pdf
(Internet Explorer has some Bug there which might make it offer it
without an extension. Under Windows it is important to have the
Extension .pdf, in under OS you should be fine just saving the
file under the name it offers) in the navigation on top
I don't like the way syntaxcoloring displays my query
There is two things about the way how the Syntaxcoloring 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'] don'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 project] [phpMyAdmin project]
I have found a bug. How do I inform developers? I have found a bug. How do I inform developers?
Our Bug Tracker is located at Our Bug Tracker is located at
[70]http://sourceforge.net/projects/phpmyadmin/ under the Bugs http://sourceforge.net/projects/phpmyadmin/ under the Bugs section.
section.
But please first discuss your bug with other users: But please first discuss your bug with other users:
[71]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 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?
@@ -1216,15 +1322,15 @@ FAQ - Frequently Asked Questions
[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 [72]phpMyAdmin SourceForge account. tracker of the 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 [73]Developers section. Also, have a look at the Developers section.
______________________________________________________________________ ______________________________________________________________________
[74]Top - [75]Requirements - [76]Introduction - [77]Installation Top - Requirements - Introduction - Installation -
- [78]Configuration - [79]FAQ - [80]Developers - [81]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
Developers Information Developers Information
@@ -1246,8 +1352,8 @@ Developers Information
please try to keep your code as simple as possible: beginners are please try to keep your code as simple as possible: beginners are
using phpMyAdmin as an example application. using phpMyAdmin as an example application.
As far as possible, we want the scripts to be XHTML1.0 and CSS2 As far as possible, we want the scripts to be XHTML1.0 and CSS2
compliant on one hand, they fit [82]PEAR coding standards on the compliant on one hand, they fit PEAR coding standards on the other
other hand. Please pay attention to this. 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 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
@@ -1269,7 +1375,7 @@ Developers Information
* 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
([83]http://sourceforge.net/projects/phpmyadmin/) (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
@@ -1277,8 +1383,8 @@ Developers Information
mailing list. mailing list.
______________________________________________________________________ ______________________________________________________________________
[84]Top - [85]Requirements - [86]Introduction - [87]Installation Top - Requirements - Introduction - Installation -
- [88]Configuration - [89]FAQ - [90]Developers - [91]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
Credits Credits
@@ -1297,6 +1403,7 @@ CREDITS, in chronological order
[md] - Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca> [md] - Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca>
* multi-language version * multi-language version
* various fixes and improvements * various fixes and improvements
* project co-administrator
[om] - Olivier M<>ller <om_at_omnis.ch> [om] - Olivier M<>ller <om_at_omnis.ch>
* started SourceForge phpMyAdmin project in March 2001 * started SourceForge phpMyAdmin project in March 2001
@@ -1347,7 +1454,7 @@ CREDITS, in chronological order
* various small features and fixes * various small features and fixes
* German language file updates * German language file updates
[mb] - Mike Beck &lt;mike.beck at ibmiller.de&gt; [mb] - Mike Beck <mike.beck at ibmiller.de>
* automatic joint in QBE * automatic joint in QBE
* links column in printview * links column in printview
* Relation view * Relation view
@@ -1356,7 +1463,8 @@ 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. enhanced index creation/display feature, and the mecanism to display
a character set in MySQL different than the one in HTML.
- Christophe Gesch<63> from the "MySQL Form Generator for PHPMyAdmin" - Christophe Gesch<63> from the "MySQL Form Generator for PHPMyAdmin"
(http://sourceforge.net/projects/phpmysqlformgen/) who suggested the patch (http://sourceforge.net/projects/phpmysqlformgen/) who suggested the patch
for multiple table printviews. for multiple table printviews.
@@ -1382,7 +1490,8 @@ 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, Lu<EFBFBD>s V., Martijn W. van der Lee, Algis Vainauskas, Daniel Villanueva, Vinay,
Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk, Thomas Michael Winningham. Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk, Thomas Michael Winningham,
Vilius Zigmantas.
Original Credits of Version 2.1.0 Original Credits of Version 2.1.0
@@ -1426,112 +1535,8 @@ Original Credits of Version 2.1.0
and or just some feedback. and or just some feedback.
______________________________________________________________________ ______________________________________________________________________
[92]Top - [93]Requirements - [94]Introduction - [95]Installation Top - Requirements - Introduction - Installation -
- [96]Configuration - [97]FAQ - [98]Developers - [99]Credits Configuration - FAQ - Developers - Credits
______________________________________________________________________ ______________________________________________________________________
[100]Valid XHTML 1.0! [101]Valid CSS! Valid XHTML 1.0! Valid CSS!
References
1. http://www.phpmyadmin.net/
2. file://localhost/c:/tmp/ChangeLog
3. file://localhost/c:/tmp/README
4. file://localhost/c:/tmp/LICENSE
5. file://localhost/c:/tmp/documentation.html#top
6. file://localhost/c:/tmp/documentation.html#require
7. file://localhost/c:/tmp/documentation.html#intro
8. file://localhost/c:/tmp/documentation.html#setup
9. file://localhost/c:/tmp/documentation.html#config
10. file://localhost/c:/tmp/documentation.html#faq
11. file://localhost/c:/tmp/documentation.html#developers
12. file://localhost/c:/tmp/documentation.html#credits
13. file://localhost/c:/tmp/documentation.html#top
14. file://localhost/c:/tmp/documentation.html#require
15. file://localhost/c:/tmp/documentation.html#intro
16. file://localhost/c:/tmp/documentation.html#setup
17. file://localhost/c:/tmp/documentation.html#config
18. file://localhost/c:/tmp/documentation.html#faq
19. file://localhost/c:/tmp/documentation.html#developers
20. file://localhost/c:/tmp/documentation.html#credits
21. file://localhost/c:/tmp/translators.html
22. file://localhost/c:/tmp/documentation.html#top
23. file://localhost/c:/tmp/documentation.html#require
24. file://localhost/c:/tmp/documentation.html#intro
25. file://localhost/c:/tmp/documentation.html#setup
26. file://localhost/c:/tmp/documentation.html#config
27. file://localhost/c:/tmp/documentation.html#faq
28. file://localhost/c:/tmp/documentation.html#developers
29. file://localhost/c:/tmp/documentation.html#credits
30. file://localhost/c:/tmp/documentation.html#config
31. file://localhost/c:/tmp/documentation.html#faq
32. file://localhost/c:/tmp/documentation.html#top
33. file://localhost/c:/tmp/documentation.html#require
34. file://localhost/c:/tmp/documentation.html#intro
35. file://localhost/c:/tmp/documentation.html#setup
36. file://localhost/c:/tmp/documentation.html#config
37. file://localhost/c:/tmp/documentation.html#faq
38. file://localhost/c:/tmp/documentation.html#developers
39. file://localhost/c:/tmp/documentation.html#credits
40. file://localhost/c:/tmp/documentation.html#setup
41. file://localhost/c:/tmp/documentation.html#faqdisplay
42. file://localhost/c:/tmp/documentation.html#faqpdf
43. file://localhost/c:/tmp/documentation.html#top
44. file://localhost/c:/tmp/documentation.html#require
45. file://localhost/c:/tmp/documentation.html#intro
46. file://localhost/c:/tmp/documentation.html#setup
47. file://localhost/c:/tmp/documentation.html#config
48. file://localhost/c:/tmp/documentation.html#faq
49. file://localhost/c:/tmp/documentation.html#developers
50. file://localhost/c:/tmp/documentation.html#credits
51. file://localhost/c:/tmp/documentation.html#faqserver
52. file://localhost/c:/tmp/documentation.html#faqconfig
53. file://localhost/c:/tmp/documentation.html#faqlimitations
54. file://localhost/c:/tmp/documentation.html#faqmultiuser
55. file://localhost/c:/tmp/documentation.html#faqbrowsers
56. file://localhost/c:/tmp/documentation.html#faqusing
57. file://localhost/c:/tmp/documentation.html#faqproject
58. http://bugs.php.net/bug.php?id=16626
59. http://bugs.php.net/bug.php?id=12061
60. http://www.phpwizard.net/phorum/read.php?f=1&i=6624&t=6300
61. http://www.php.net/bugs.php?id=8966
62. http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=24933
63. http://www.redhat.com/swr/i386/php-4.0.4pl1-9.i386.html
64. http://www.mysql.com/doc/R/e/Resetting_permissions.html
65. http://sourceforge.net/tracker/index.php?func=detail&aid=540671&group_id=23067&atid=377408
66. http://www.fpdf.org/
67. http://www.phpwizard.net/phorum/list.php?f=1
68. http://www.mysql.com/doc/C/a/Can_not_connect_to_server.html
69. http://bugzilla.mozilla.org/
70. http://sourceforge.net/projects/phpmyadmin/
71. http://sourceforge.net/projects/phpmyadmin/
72. http://sourceforge.net/projects/phpmyadmin/
73. file://localhost/c:/tmp/documentation.html#developers
74. file://localhost/c:/tmp/documentation.html#top
75. file://localhost/c:/tmp/documentation.html#require
76. file://localhost/c:/tmp/documentation.html#intro
77. file://localhost/c:/tmp/documentation.html#setup
78. file://localhost/c:/tmp/documentation.html#config
79. file://localhost/c:/tmp/documentation.html#faq
80. file://localhost/c:/tmp/documentation.html#developers
81. file://localhost/c:/tmp/documentation.html#credits
82. http://pear.php.net/
83. http://sourceforge.net/projects/phpmyadmin/
84. file://localhost/c:/tmp/documentation.html#top
85. file://localhost/c:/tmp/documentation.html#require
86. file://localhost/c:/tmp/documentation.html#intro
87. file://localhost/c:/tmp/documentation.html#setup
88. file://localhost/c:/tmp/documentation.html#config
89. file://localhost/c:/tmp/documentation.html#faq
90. file://localhost/c:/tmp/documentation.html#developers
91. file://localhost/c:/tmp/documentation.html#credits
92. file://localhost/c:/tmp/documentation.html#top
93. file://localhost/c:/tmp/documentation.html#require
94. file://localhost/c:/tmp/documentation.html#intro
95. file://localhost/c:/tmp/documentation.html#setup
96. file://localhost/c:/tmp/documentation.html#config
97. file://localhost/c:/tmp/documentation.html#faq
98. file://localhost/c:/tmp/documentation.html#developers
99. file://localhost/c:/tmp/documentation.html#credits
100. http://validator.w3.org/check/referer
101. http://jigsaw.w3.org/css-validator/