This commit is contained in:
Alexander M. Turek
2002-05-15 17:56:26 +00:00
parent 0f9e805777
commit 5e14fbb78c
2 changed files with 191 additions and 191 deletions

View File

@@ -307,7 +307,7 @@
</li>
<li>
Then each of the <i>true</i> users should be granted of a set of
privileges on a set of perticular 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 <i>real_user</i> with
all privileges on the database <i>user_base</i>:<br />
&nbsp;&nbsp;&nbsp;<tt>GRANT ALL PRIVILEGES ON user_base.* TO 'real_user'@localhost IDENTIFIED BY 'real_password';</tt>
@@ -592,7 +592,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
</li>
<li>
display in an optional tooltip the &quot;display field&quot;
when browsing the master table, if
when browsing the master table, if
you move the mouse to a column containing a foreign key;
</li>
<li>
@@ -646,8 +646,8 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE src_column master_field VARCHAR(32) NOT NULL<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE dest_table foreign_table VARCHAR(32) NOT NULL<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE relation CHANGE dest_column foreign_field VARCHAR(32) NOT NULL<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `foreign_display_field` VARCHAR(32) NOT NULL;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `pdf_page_number` int(11) NOT NULL;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `foreign_display_field` VARCHAR(32) NOT NULL;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD `pdf_page_number` int(11) NOT NULL;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ALTER TABLE `relation` ADD INDEX(`pdf_page_number`);<br />
</tt><br />
</dd>
@@ -659,11 +659,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
Since release 2.3.0 you can describe, in a special 'pdf_table_position'
table, the coordinates where each table will be placed on a PDF schema
output. This configuration variable will hold the name of this special
table.
<br /><br />
table.
<br /><br />
This feature is supported under PHP4, and you must be using also
the 'relation' feature.
<br /><br />
<br /><br />
To use this functionality you have to:
<ul>
<li>
@@ -1676,14 +1676,14 @@ $cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
<p>
<b>How can I produce a PDF schema of my database?</b>
<br />
First you have to fill the 'relation' and 'pdf_table_position'
First you have to fill the 'relation' and 'pdf_table_position'
configuration variables.
<br /><br />
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. You have to fill in the 'relation' table the page number for
each master-foreign link.
<br /><br />
Then manually fill the pdf_table_position table with the coordinates,
Then manually fill the pdf_table_position table with the coordinates,
x being the width and y the height, and (0,0) at the upper left corner.
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.
@@ -1871,55 +1871,55 @@ CREDITS, in chronological order
-------------------------------
[tr] - Tobias Ratschiller &lt;tobias_at_phpwizard.net&gt;
* creator of the phpmyadmin project
* maintainer from 1998 to summer 2000
* creator of the phpmyadmin project
* maintainer from 1998 to summer 2000
[md] - Marc Delisle &lt;DelislMa_at_CollegeSherbrooke.qc.ca&gt;
* multi-language version
* various fixes and improvements
* multi-language version
* various fixes and improvements
[om] - Olivier M<>ller &lt;om_at_omnis.ch&gt;
* started SourceForge phpMyAdmin project in March 2001
* sync'ed different existing CVS trees with new features and bugfixes
* multi-language improvements, dynamic language selection
* current project maintainer, with Marc and Loic
* started SourceForge phpMyAdmin project in March 2001
* sync'ed different existing CVS trees with new features and bugfixes
* multi-language improvements, dynamic language selection
* current project maintainer, with Marc and Loic
[lc] - Lo<4C>c Chapeaux &lt;lolo_at_phpheaven.net&gt;
* rewrote and optimized javascript, DHTML and DOM stuff
* rewrote the scripts so they fit the PEAR coding standards and
generate XHTML1.0 and CSS2 compliant codes
* improved the language detection system
* many bugfixes and improvements
* rewrote and optimized javascript, DHTML and DOM stuff
* rewrote the scripts so they fit the PEAR coding standards and
generate XHTML1.0 and CSS2 compliant codes
* improved the language detection system
* many bugfixes and improvements
[rj] - Robin Johnson &lt;robbat2_at_users.sourceforge.net&gt;
* database maintence controls
* table type code
* database maintence controls
* table type code
[af] - Armel Fauveau &lt;armel.fauveau_at_globalis-ms.com&gt;
* bookmarks feature
* multiple dump feature
* gzip dump feature
* zip dump feature
* bookmarks feature
* multiple dump feature
* gzip dump feature
* zip dump feature
[gl] - Geert Lund &lt;glund_at_silversoft.dk&gt;
* various fixes
* moderator of the phpMyAdmin users forum at phpwizard.net
* various fixes
* moderator of the phpMyAdmin users forum at phpwizard.net
[kc] - Korakot Chaovavanich &lt;korakot_at_iname.com&gt;
* &quot;insert as new row&quot; feature
* &quot;insert as new row&quot; feature
[pk] - Pete Kelly &lt;webmaster_at_trafficg.com&gt;
* rewrote and fix dump code
* bugfixes
* rewrote and fix dump code
* bugfixes
[sa] - Steve Alberty &lt;alberty_at_neptunlabs.de&gt;
* rewrote dump code for PHP4
* mySQL table statistics
* bugfixes
* rewrote dump code for PHP4
* mySQL table statistics
* bugfixes
[bg] - Benjamin Gandon &lt;gandon_at_isia.cma.fr&gt;
* main author of the version 2.1.0.1
* bugfixes
* main author of the version 2.1.0.1
* bugfixes
[at] - Alexander M. Turek &lt;rabus_at_bugfixes.info&gt;
* various small features and fixes
@@ -1943,7 +1943,7 @@ code since version 2.1.0:
relation-links feature.
- Mike Beck &lt;mike.beck at ibmiller.de&gt; for his work on the Relation table
feature: automatic joint in QBE, links column in printview, Relation view.
- Maxime Delorme &lt;delorme.maxime at free.fr&gt; for the PDF schema output;
- Maxime Delorme &lt;delorme.maxime at free.fr&gt; for the PDF schema output;
thanks also to Olivier Plathey for the fpdf library (www.fpdf.org).
And also to the following people who have contributed minor changes,

View File

@@ -1,6 +1,6 @@
phpMyAdmin 2.3.0-dev Documentation
* [1]Sourceforge phpMyAdmin project page [
http://www.phpmyadmin.net/ ]
* Local documents:
@@ -10,11 +10,11 @@
* Documentation version: $Id: Documentation.html,v 1.220 2002/05/01
18:29:43 lem9 Exp $
______________________________________________________________________
[5]Top - [6]Requirements - [7]Introduction - [8]Installation -
[9]Configuration - [10]FAQ - [11]Developers - [12]Credits
______________________________________________________________________
Requirements
* PHP3 or PHP4: phpMyAdmin widely uses the 'str_replace()' php
@@ -24,11 +24,11 @@ Requirements
* MySQL (tested with 3.21.x, 3.22.x, 3.23.x and 4.0.x);
* a web-browser (doh!).
______________________________________________________________________
[13]Top - [14]Requirements - [15]Introduction - [16]Installation
- [17]Configuration - [18]FAQ - [19]Developers - [20]Credits
______________________________________________________________________
Introduction
phpMyAdmin can manage a whole MySQL-server (needs a super-user) but
@@ -47,31 +47,31 @@ Introduction
* administer multiple servers and single databases
* check referential integrity
* communicate in more than 38 different languages
(*) 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).
______________________________________________________________________
[21]Top - [22]Requirements - [23]Introduction - [24]Installation
- [25]Configuration - [26]FAQ - [27]Developers - [28]Credits
______________________________________________________________________
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.
Documentation warning: when you see in this document a .php3 file
extension, please transpose to .php if you are using a kit with files
having this extension.
Quick Install:
1. Use a distribution kit with the files having the extension (.php3
or .php) depending on the way your web/PHP server interprets those
@@ -93,13 +93,13 @@ Installation
your browser. phpMyAdmin should now display a welcome screen and
your databases, or a login dialog if using http or cookie
authentication mode.
Upgrading from an older version:
* Please do not copy your older config.inc.php3 over the new one: it
may offer new configuration variables, and the new version may
depend on these for normal behavior. It is suggested instead to
insert your site values in the new one.
Using authentication modes:
* Http and cookie authentication modes are recommended in a
multi-user environment where you want to give users access to
@@ -122,7 +122,7 @@ Installation
$cfg['Servers'][$i]['controlpass'] settings.
This example assumes you want to use pma as the controluser and
pmapass as the controlpass:
GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY
'pmapass';
GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv,
@@ -136,7 +136,7 @@ Installation
GRANT SELECT, INSERT, DELETE ON <bookmark_db>.<bookmark_table> TO
'pma'@'localhost';
* Then each of the true users should be granted of a set of
privileges on a set of perticular databases but shouldn't have any
privileges on a set of particular databases but shouldn't have any
global privileges. For example, to grant the user real_user with
all privileges on the database user_base:
GRANT ALL PRIVILEGES ON user_base.* TO 'real_user'@localhost
@@ -145,21 +145,21 @@ Installation
management system.
With http or cookie auth mode, you don't need to fill the
user/password fields inside the $cfg['Servers'] array.
'http' authentication mode:
* Was called 'advanced' in versions before 2.2.3.
* Introduced in 1.3.0, it uses Basic HTTP authentication method and
allows you to login as any valid MySQL user.
* Is only supported with PHP running as an Apache module, not with
cgi.
'cookie' authentication mode:
* You can use this method as a replacement for the http
authentication (for example, if you're running IIS).
* Obviously, the user must enable cookies in the browser.
* With this mode, the use can truly logout of phpMyAdmin and login
back with the same username.
'config' authentication mode:
* This mode is the less secure one because it requires you to fill
the $cfg['Servers'][$i]['user'] and
@@ -169,20 +169,20 @@ Installation
In the ISP FAQ section, there is an entry explaining how to
protect your configuration file.
______________________________________________________________________
[31]Top - [32]Requirements - [33]Introduction - [34]Installation
- [35]Configuration - [36]FAQ - [37]Developers - [38]Credits
______________________________________________________________________
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.
$cfg['PmaAbsoluteUri'] string
Sets here the complete url (with full path) to your phpMyAdmin
version. E.g.
@@ -192,7 +192,7 @@ Configuration
servers, the path is case-sensitive.
This setting can be dynamically completed. For example, you can
try to use such a kind of code:
$cfg['PmaAbsoluteUri'] = (!empty($HTTPS) ? 'https' : 'http') . '://'
. $HTTP_HOST . (!empty($SERVER_PORT) ? ':' . $SERVER_POR
T : '')
@@ -215,24 +215,24 @@ ORT : '')
$cfg['Servers'][$i]['host'] the hostname of the second server,
etc. If you have only one server to administer, simply leave
free the hostname of the other $cfg['Server']-entries.
$cfg['Servers'][$i]['host'] string
The hostname of your $i-th MySQL-server. E.g. localhost.
$cfg['Servers'][$i]['port'] string
The port-number of your $i-th MySQL-server. Default is 3306
(leave blank).
$cfg['Servers'][$i]['socket'] string
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.
$cfg['Servers'][$i]['connect_type'] string
What type connection to use with the MySQL server. Your options
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.
$cfg['Servers'][$i]['controluser'] string
$cfg['Servers'][$i]['controlpass'] string
When using http or cookie authentication modes (or 'config'
@@ -249,11 +249,11 @@ ORT : '')
privileges you gave to the "controluser". phpMyAdmin does not
support a direct login with the "controluser".
In versions before 2.2.5, those were called "stduser/stdpass".
$cfg['Servers'][$i]['auth_type'] string ['http'|'cookie'|'config']
Whether config or cookie or http authentication should be used
for this server.
+ 'config' authentication ($auth_type = 'config') is the plain
old way: username and password are stored in config.inc.php3.
+ 'cookie' authentication mode ($auth_type = 'cookie') as
@@ -264,16 +264,16 @@ ORT : '')
+ 'http' authentication (was called 'advanced' in older
versions) ($auth_type = 'http') as introduced in 1.3.0 allows
you to log in as any valid MySQL user via HTTP-Auth.
Please see the install section on "Using authentication modes"
for more information.
$cfg['Servers'][$i]['user'] string
$cfg['Servers'][$i]['password'] string
The user/password-pair which phpMyAdmin will use to connect to
this MySQL-server. This user/password pair is not needed when
http or cookie authentication is used, and should be empty.
$cfg['Servers'][$i]['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. Since phpMyAdmin 2.2.1,
@@ -287,20 +287,20 @@ ORT : '')
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.
$cfg['Servers'][$i]['verbose'] string
Only useful when using phpMyAdmin with multiple server entries.
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
example.
$cfg['Servers'][$i]['bookmarkdb'] string
$cfg['Servers'][$i]['bookmarktable'] string
Since release 2.2.0 phpMyAdmin allows to bookmark queries. This
can be useful for queries you often run.
To use this functionality you have to:
+ create a table following this scheme:
CREATE TABLE bookmark (
id int(11) DEFAULT '0' NOT NULL auto_increment,
@@ -315,18 +315,18 @@ ORT : '')
$cfg['Servers'][$i]['bookmarktable'] with the database and
table names you've choosen so phpMyAdmin will be able to find
the bookmarks.
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 <bookmarkdb>.<bookmarktable> to
'pma'@localhost;
$cfg['Servers'][$i]['relation'] string
Since release 2.2.4 you can describe, in a special 'relation'
table, which field is a key in another table (a foreign key).
phpMyAdmin currently uses this to
+ make clickable, when you browse the master table, the data
values that point to the foreign table;
+ display links on the table properties page, to check
@@ -334,10 +334,10 @@ ORT : '')
described key;
+ in query-by-example, create automatic joints (see an example
in the FAQ, section "Using phpMyAdmin").
The keys can be numeric or character.
To use this functionality you have to:
+ create in the same database a table (for example 'relation')
following this scheme:
CREATE TABLE `relation` (
@@ -351,7 +351,7 @@ ORT : '')
$cfg['Servers'][$i]['relation']
+ then manually fill the relation table with information about
the keys.
If you created a relation table before release 2.3.0, you can
upgrade it with those commands, assuming your table name is
"relation":
@@ -363,7 +363,7 @@ ORT : '')
VARCHAR(32) NOT NULL
ALTER TABLE relation CHANGE dest_column foreign_field
VARCHAR(32) NOT NULL
$cfg['ServerDefault'] integer
If you have more than one server configured, you can set
$cfg['ServerDefault'] to any one of them to autoconnect to that
@@ -371,48 +371,48 @@ ORT : '')
list of servers without logging in.
If you have only one server configured, $cfg['ServerDefault']
MUST be set to that server.
$cfg['OBGzip'] boolean
Defines whether to use gzip output buffering for increased
speed in HTTP transfers.
$cfg['PersistentConnections'] boolean
Whether persistent connections should be used or not
(mysql_connect or mysql_pconnect).
$cfg['ExecTimeLimit'] integer [number of seconds]
Set the number of seconds a script is allowed to run. If
seconds is set to zero, no time limit is imposed.
This setting is used while importing/exporting dump files but
has no effect when PHP is running in safe mode.
$cfg['SkipLockedTables'] boolean
Mark used tables and make it possible to show databases with
locked tables (since 3.23.30).
$cfg['ShowSQL'] boolean
Defines whether sql-queries generated by phpMyAdmin should be
displayed or not.
$cfg['AllowUserDropDatabase'] boolean
Defines whether normal users (non-administrator) are allowed to
delete their own database or not. If set as FALSE, the link
"Drop Database" will not be shown, and even a "DROP DATABASE
mydatabase" will be rejected. Quite practical for ISP's with
many customers.
$cfg['Confirm'] boolean
Whether a warning ("Are your really sure..") should be
displayed when you're about to loose data.
$cfg['ShowTooltip'] boolean
Defines whether to display table comment as tooltip in left
frame or not.
$cfg['LeftFrameLight'] boolean
Defines whether to use select-based menu and display only the
current tables in the left frame (smaller page).
$cfg['ShowMysqlInfo'] boolean
$cfg['ShowMysqlVars'] boolean
$cfg['ShowPhpInfo'] boolean
@@ -429,41 +429,41 @@ ORT : '')
effect with "config" authentication mode: because of the hard
coded password value in the configuration file, end users can't
be allowed to change their passwords.
$cfg['LoginCookieRecall'] boolean
Define whether the previous login should be recalled or not in
cookie authentication mode.
$cfg['ShowStats'] 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.
$cfg['ShowBlob'] boolean
Defines whether BLOB fields are shown when browsing a table's
content or not.
$cfg['NavigationBarIconic'] boolean
Defines whether navigation bar buttons contain text or symbols
only.
$cfg['ShowAll'] boolean
Defines whether an user should be displayed a "show all
(records)" button in browse mode or not.
$cfg['MaxRows'] integer
Number of rows displayed when browsing a resultset. If the
resultset contains more rows, Previous/Next links will be
shown.
$cfg['Order'] string [DESC|ASC|SMART]
Defines whether fields are displayed in ascending (ASC) order,
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.
$cfg['ProtectBinary'] boolean or string
Defines whether BLOB or BINARY fields are protected from
edition when browsing a table's content or not. Valid values
@@ -471,54 +471,54 @@ ORT : '')
- 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.
$cfg['ShowFunctionFields'] boolean
Defines whether MySQL functions fields should be displayed or
not in edit/insert mode.
$cfg['ZipDump'] boolean
$cfg['GZipDump'] boolean
$cfg['BZipDump'] boolean
Defines whether to allow the use of zip/gzip/bzip compression
when creating a dump file or not.
$cfg['ManualBaseShort'] string
If set to an URL which points to the MySQL documentation (on
short pages), appropriate help links are generated.
$cfg['DefaultLang'] string
Defines the default language to use, if not browser-defined or
user-defined.
See the select_lang.inc.php3 script to know the valid values
for this setting.
$cfg['Lang'] string
Force: always use this language (must be defined in the
select_lang.inc.php3 script).
$cfg['LeftWidth'] integer
Left frame width in pixel.
$cfg['LeftBgColor'] string [HTML color]
$cfg['RightBgColor'] string [HTML color]
The background colors (HTML) used for both the frames.
$cfg['LeftPointerColor'] string [HTML color]
The color (HTML) used for the pointer in the left frame (does
not work with NS4).
$cfg['Border'] integer
The size of a table's border.
$cfg['ThBgcolor'] string [HTML color]
The color (HTML) used for table headers.
$cfg['BgcolorOne'] string [HTML color]
The color (HTML) #1 for table rows.
$cfg['BgcolorTwo'] string [HTML color]
The color (HTML) #2 for table rows.
$cfg['BrowsePointerColor'] string [HTML color]
$cfg['BrowseMarkerColor'] string [HTML color]
The colors (HTML) uses for the pointer and the marker in browse
@@ -528,55 +528,55 @@ ORT : '')
clicking on them.
You can disable both of these features by emptying the
respective directive.
$cfg['TextareaCols'] integer
$cfg['TextareaRows'] integer
Number of columns and rows for the textareas.
This value will be emphasized (*2) for sql query textareas.
$cfg['LimitChars'] integer
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.
$cfg['ModifyDeleteAtLeft'] boolean
$cfg['ModifyDeleteAtRight'] boolean
Defines the place where modify and delete links would be put
when tables contents are displayed (you may have them displayed
both at the left and at the right). "Left" and "right" are
parsed as "top" and "bottom" with vertical display mode.
$cfg['DefaultDisplay'] string
There are 2 display modes: horizontal and vertical. Define
which one is displayed by default.
$cfg['RepeatCells'] integer
Repeat the headers every X cells, or 0 to deactivate.
$cfg['ColumnTypes'] array
All possible types of a MySQL column. In most cases you don't
need to edit this.
$cfg['AttributeTypes'] array
Possible attributes for fields. In most cases you don't need to
edit this.
$cfg['Functions'] array
A list of functions MySQL supports. In most cases you don't
need to edit this.
______________________________________________________________________
[40]Top - [41]Requirements - [42]Introduction - [43]Installation
- [44]Configuration - [45]FAQ - [46]Developers - [47]Credits
______________________________________________________________________
FAQ - Frequently Asked Questions
[48]Server - [49]Configuration - [50]Limitations -
[51]Multi-user - [52]Browsers - [53]Usage tips - [54]Project
[Server]
I'm running php 4+ and my server is crashing each time a specific
action is required or phpMyAdmin sends a blank page or a page full of
cryptic characters to my browser, what can I do?
@@ -588,21 +588,21 @@ FAQ - Frequently Asked Questions
candidates of php 4.2.0 (tested with php 4.2.0 RC1 to RC4) together
with MS Internet Explorer. Please upgrade to the release version php
4.2.0.
My Apache server crashes when using phpMyAdmin.
You should first try the latest versions of Apache (and possibly
MySQL).
See also the other FAQ entry about php bugs with output buffering.
If your server keeps crashing, please ask for help in the various
Apache support groups.
Using phpMyAdmin on IIS, I'm displayed the error message: "The
specified CGI application misbehaved by not returning a complete set
of HTTP headers...."
You just forgot to read the install.txt file from the php
distribution. Have a look at the last message in this [55]bug report
from the official php bug database.
Using phpMyAdmin on IIS, I'm facing crashes and/or many error messages
with the http or advanced authentication mode.
This is a known problem with the php ISAPI filter: it's not so stable.
@@ -610,13 +610,13 @@ FAQ - Frequently Asked Questions
posted by Andr<64> B. aka "djdeluxe76" in [56]this thread from the
phpWizard forum.
Please use instead the cookie authentication mode.
I can't use phpMyAdmin on PWS: nothing is displayed!
This seems to be a PWS bug. Filippo Simoncini found a workaroud (at
this time there is no better fix): remove or comment the DOCTYPE
declarations (3 lines) from the scripts header.inc.php3, index.php3,
left.php3 and libraries/common.lib.php3.
How can I GZip or Bzip a dump or a CSV export. It seems to not work?
These features are based on the gzencode() and bzcompress() php
functions to be more independent of the platform (Unix/Windows, Safe
@@ -625,7 +625,7 @@ FAQ - Frequently Asked Questions
We faced php crashes when trying to download a dump with MS Internet
Explorer when phpMyAdmin is run with a release candidate of php 4.2.0.
In this case you should switch to the release version of php 4.2.0.
I cannot insert a text file in a table, and I get an error about safe
mode being in effect.
Your uploaded file is saved by PHP in the "upload dir", as defined in
@@ -639,7 +639,7 @@ FAQ - Frequently Asked Questions
* give proper permission: chmod 600 /tmp/php
* put upload_tmp_dir = /tmp/php in php.ini
* restart Apache
I'm having troubles when uploading files. In general file uploads
don't work on my system and uploaded files have a Content-Type: header
in the first line.
@@ -654,7 +654,7 @@ FAQ - Frequently Asked Questions
So please download [59]the fixed package (4.0.4pl1-9) and the problem
should go away.
And that fixes the \r\n problem with file uploads!
I'm having troubles when uploading files with phpMyAdmin running on a
secure server. My browser is Internet Explorer and I'm using the
Apache server.
@@ -662,7 +662,7 @@ FAQ - Frequently Asked Questions
httpd.conf:
SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown
It seems to clear up many problems between IE and SSL.
I get an 'open_basedir restriction' while uploading a file from the
query box.
Since version 2.2.4, phpMyAdmin supports servers with open_basedir
@@ -672,31 +672,31 @@ FAQ - Frequently Asked Questions
and the same owner as the owner of your phpMyAdmin directory. The
uploaded files will be moved there, and after execution of your SQL
commands, removed.
I have lost my MySQL root password, what can I do?
The MySql manual explains how to [60]reset the permissions.
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
cannot access the uploaded query.
I get an error 'No SQL query' when trying to submit a query from the
convenient text area.
Check the post_max_size directive from your php configuration file and
try to increase it.
I have problems with mysql.user field names.
In older MySQL versions, the User and Password fields were named user
and password. Please modify your field names to align with current
standards.
I cannot upload big dump files.
The first things to check (or ask your host provider to check) are the
values of upload_max_filesize, memory_limit and post_max_size in the
php.ini configuration file.
All of these three settings limit the maximum size of data that can be
submitted and handled by php.
Does phpMyAdmin support MySQL 4?
MySQL 4 is not yet fully supported by phpMyAdmin.
Because of MySQL 4's backwards compatibility you can use phpMyAdmin
@@ -707,7 +707,7 @@ FAQ - Frequently Asked Questions
Furthermore, several users reported problems with phpMyAdmin related
to bugs in MySQL 4. MySQL 4 is still an alpha release and should be
used for test purposes only!
I'm running MySQL 4.0.1 on a Windows NT machine. Each time I create a
table the table name is changed to lowercase.
This seems to be a bug of MySQL 4.0.1 because it also appears when
@@ -717,21 +717,21 @@ FAQ - Frequently Asked Questions
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
[61]our bug tracker at SourceForge.
[Configuration]
The error message "Warning: Cannot add header information - headers
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 the <?php
tag at the beginning, neither after the ?> tag at the end.
phpMyAdmin can't connect to MySQL. What's wrong?
Either there is an error with your PHP setup or your username/password
is wrong. Try to make a small script which uses mysql_connect and see
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
local MySQL server through socket '/tmp/mysql.sock' (111)...") is
displayed. What can I do?
@@ -755,10 +755,10 @@ FAQ - Frequently Asked Questions
phpMyAdmin, you need to complete the socket information in the
config.inc.php3.
For example: $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock';
Have also a look at the [63]corresponding section of the MySQL
documentation.
Nothing is displayed by my browser when I try to run phpMyAdmin, what
can I do?
Try to set the $cfg['OBGZip'] directive to FALSE in the phpMyAdmin
@@ -766,15 +766,15 @@ FAQ - Frequently Asked Questions
Also have a look at your php version number: if it contains "4.0b..."
it means you're running a beta version of PHP. That's not a so good
idea, please upgrade to a plain revision.
Each time I want to insert or change a record or drop a database or a
table, an error 404 (page not found) is displayed or, with http or
cookie authentication, I'm asked to login again. What's wrong?
Check the value you set for the $cfg['PmaAbsoluteUri'] directive in
the phpMyAdmin configuration file.
[Known limitations]
When using http authentication, an user who logged out can not relog
in with the same nick.
This is related to the authentication mechanism (protocol) used by
@@ -782,7 +782,7 @@ FAQ - Frequently Asked Questions
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.
When dumping a large table in compressed mode, I get a memory limit
error or a time limit error.
As of version 2.2.4, we build the compressed dump in memory, so large
@@ -790,9 +790,9 @@ FAQ - Frequently Asked Questions
system calls to mysqldump then gzip or bzip2) would not be applicable
in environments where PHP is in safe mode: access to system programs
is is limited by the system administrator, and time limit is enforced.
[ISPs, multi-user installations ]
I'm an ISP. Can I setup one central copy of phpMyAdmin or do I need to
install it for each customer?
Since version 2.0.3, you can setup a central copy of phpMyAdmin for
@@ -800,7 +800,7 @@ FAQ - Frequently Asked Questions
by NetCologne GmbH. This requires a properly setup MySQL user
management and phpMyAdmin http authentication. See the install section
on "Using http authentication".
What's the preferred way of making phpMyAdmin secure against evil
access?
This depends on your system.
@@ -816,13 +816,13 @@ FAQ - Frequently Asked Questions
the group under which Apache runs.
* You should use PHP safe mode, to protect from other users that try
to include your config.inc.php3 in their scripts.
I get errors about not being able to include a file in /lang or in
/libraries.
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.
phpMyAdmin always gives "Access denied" when using http
authentication.
This could happen for several reasons:
@@ -832,27 +832,27 @@ FAQ - Frequently Asked Questions
* You have already setup a security mechanism for the
phpMyAdmin-directory, eg. a .htaccess file. This would interfere
with phpMyAdmin's authentication, so remove it.
Is it possible to let users create their own databases?
Starting with 2.2.5, in the user management page, you can enter a
wildcard database name for a user, and put the privileges you want.
For example, adding SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,
INDEX, ALTER would let a user create/manage his/her database(s).
[Browsers or client OS]
I get an out of memory error, and my controls are non-functional, when
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.
A workaround is to create a smaller number of fields, then come back
to your table properties and add the other fields.
With Xitami 2.5b4, phpMyAdmin won't process form fields.
This is not a phpMyAdmin problem but a Xitami known bug: you'll face
it with each script/website that use forms.
Upgrade or downgrade your Xitami server.
I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2)
With Konqueror 2.1.1: plain dumps, zip and gzip dumps work ok, except
that the proposed file name for the dump is always 'tbl_dump.php'.
@@ -861,7 +861,7 @@ FAQ - Frequently Asked Questions
user's temporary directory, so they must be moved before closing
Konqueror, or else they disappear. Gzip dumps give an error message.
Testing needs to be done for Konqueror 2.2.2.
I can't use the cookie authentication mode because Internet Explorer
never stores the cookies.
MS Internet Explorer seems to be really buggy about cookies, at least
@@ -869,11 +869,11 @@ FAQ - Frequently Asked Questions
4.1.1 bug in this area!
Then, If you're running php 4.1.1, try to upgrade or downgrade... it
may works!
In Internet Explorer 5.0, I get Javascript errors when browsing my
rows.
Upgrade to at least Internet Explorer 5.5SP2.
In Internet Explorer 5.0, 5.5 or 6.0, I get an error when trying to
modify a row in a table with many fields, or with a text field.
Your table neither have a primary key nor an unique one, so we must
@@ -881,44 +881,44 @@ FAQ - Frequently Asked Questions
the URL in those browsers, and this not happen in Netscape, for
example. The workaround is to create a primary or unique key, or use
another browser.
I refresh (reload) my browser, and come back to the welcome page.
Some browsers support right-clicking into the frame you want to
refresh, just do this in the right frame.
With Mozilla 0.9.7 I have problems sending a query modified in the
query box.
Looks like a Mozilla bug: 0.9.6 was ok. We will keep an eye on future
Mozilla versions.
With Mozilla 0.9.? to 1.0-RC1 I can't type a whitespace in the
SQL-Query edit area: the page scrolls down.
This is a Mozilla bug (see bug #26882 at [64]Bugzilla).
[Using phpMyAdmin]
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
specifying a wrong field-type.
Common errors include:
* Using VARCHAR without a size argument
* Using TEXT or BLOB with a size argument
Also, look at the syntax chapter in the MySQL manual to confirm that
your syntax is correct.
When I create a table, I click the Index checkbox for 2 fields and
phpMyAdmin generates only one index with those 2 fields.
In phpMyAdmin 2.2.0 and 2.2.1, this is the way to create a
multi-fields 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.
How can I insert a null value into my table?
Since version 2.2.3, you have a checkbox for each field that can be
null. Before 2.2.3, you had to enter "null", without the quotes, as
the field's value.
How can I backup my database or table?
Click on a database or table name in the left frame, the properties
will be displayed. Then go to the Dump section, you can dump the
@@ -930,14 +930,14 @@ FAQ - Frequently Asked Questions
$cfg['ExecTimeLimit'] configuration variable.
For additional help on this subject, look for the word "dump" in this
document.
How can I restore (upload) my database or table using a dump?
Click on a database name in the left frame, the properties will be
displayed. Then in the "Run SQL query" section, type in your local
dump filename, or use the Browse button. Then click Go.
For additional help on this subject, look for the word "upload" in
this document.
How can I use the relation table in Query-by-example?
Here is an example with the tables persons, towns and countries. Start
by creating this:
@@ -986,16 +986,16 @@ FAQ - Frequently Asked Questions
* Click "Update query" and you will see in the query box that the
correct joints have been generated
* Click "Submit query"
[phpMyAdmin project]
I have found a bug. How do I inform developers?
Our Bug Tracker is located at
[65]http://sourceforge.net/projects/phpmyadmin/ under the Bugs
section.
But please first discuss your bug with other users:
[66]http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
I want to translate the messages to a new language or upgrade an
existing language, where do I start?
Always use the current cvs version of your language file. For a new
@@ -1006,7 +1006,7 @@ FAQ - Frequently Asked Questions
It would be a good idea to subscribe to the phpmyadmin-translators
mailing list, because this is where we ask for translations of new
messages.
I would like to help out with the development of phpMyAdmin. How
should I proceed?
The following method is preferred for new developers:
@@ -1022,22 +1022,22 @@ FAQ - Frequently Asked Questions
* add your stuff
* put the modified files (tar'ed and gzip'ed) inside the patch
tracker of the [67]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 [68]Developers section.
______________________________________________________________________
[69]Top - [70]Requirements - [71]Introduction - [72]Installation
- [73]Configuration - [74]FAQ - [75]Developers - [76]Credits
______________________________________________________________________
Developers Information
phpMyAdmin is Open Source, so you're invited to contribute to it. Many
great features have been written by other people and you too can help
to make phpMyAdmin a useful tool.
If you're planning to contribute source, please read the following
information:
* All files include header.inc.php3 (layout),
@@ -1059,7 +1059,7 @@ Developers Information
string (at least) to english.inc.php3 and print() it out.
* 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
method is preferred for new developers:
* fetch the current CVS tree over anonymous CVS:
@@ -1075,17 +1075,17 @@ Developers Information
* put the modified files (tar'ed and gzip'ed) inside the patch
tracker of the phpMyAdmin SourceForge account
([78]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
interested in that, please contact us using the phpmyadmin-devel
mailing list.
______________________________________________________________________
[79]Top - [80]Requirements - [81]Introduction - [82]Installation
- [83]Configuration - [84]FAQ - [85]Developers - [86]Credits
______________________________________________________________________
Credits
@@ -1221,12 +1221,12 @@ Original Credits of Version 2.1.0
And thanks to everyone else who sent me email with suggestions, bug-reports
and or just some feedback.
______________________________________________________________________
[87]Top - [88]Requirements - [89]Introduction - [90]Installation
- [91]Configuration - [92]FAQ - [93]Developers - [94]Credits
______________________________________________________________________
[95]Valid XHTML 1.0! [96]Valid CSS!
[95]Valid XHTML 1.0! [96]Valid CSS!
References