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

New documentation layout.

Browse Source
This commit is contained in:
Michal Čihař
2003-02-01 16:27:39 +00:00
parent bb0fd98464
commit d14365a4f9
6 changed files with 853 additions and 740 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@@ -5,6 +5,10 @@ phpMyAdmin - Changelog
$Id$
$Source$
2003-02-01 Michal Cihar <nijel@users.sourceforge.net>
* Documentation.*, translators.html, docs.css: New documentation layout.
* scripts/create-release.sh: Added --dont_wrap_pre to lynx parameters.
2003-02-01 Marc Delisle <lem9@users.sourceforge.net>
* tbl_change.php3, tbl_replace.php3, (new)tbl_replace_fields.php3,
db_details.php3, tbl_query_box.php3, libraries/common.lib.php3:

885
Documentation.html
View File

File diff suppressed because it is too large Load Diff

411
Documentation.txt
View File

@@ -1,4 +1,10 @@
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits - Translators
______________________________________________________________________
phpMyAdmin 2.4.0-dev Documentation
* Sourceforge phpMyAdmin project page [ http://www.phpmyadmin.net/
@@ -7,13 +13,8 @@
+ Version history: ChangeLog
+ General notes: README
+ License: LICENSE
* Documentation version: $Id: Documentation.html,v 1.379 2003/01/24
02:45:18 lem9 Exp $
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
* Documentation version: $Id: Documentation.html,v 1.381 2003/01/30
13:55:58 nijel Exp $
Requirements
@@ -26,11 +27,6 @@ Requirements
field types, this version of phpMyAdmin probably won't work
correctly with MySQL >= 4.1.0!
* a web-browser (doh!).
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
Introduction
@@ -59,11 +55,6 @@ Introduction
(*) 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).
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
Installation
@@ -126,7 +117,7 @@ Installation
* Http and cookie authentication modes are more secure: the MySQL
password does not need to be set in the phpMyAdmin configuration
file (except for the "controluser" -see the Configuration
section-).
section).
However, keep in mind that the password travels in plain text,
unless you are using the https protocol.
In cookie mode, we send the password in a temporary cookie, so
@@ -142,20 +133,22 @@ Installation
pmapass as the controlpass, but this is only an example: use
something else in your file:
GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY
'pmapass';
GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv,
Delete_priv, Create_priv, Drop_priv, Reload_priv, Shutdown_priv,
Process_priv, File_priv, Grant_priv, References_priv, Index_priv,
Alter_priv) ON mysql.user TO 'pma'@'localhost';
GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY 'pmapass';
GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv, Delete_priv, Create_priv,
Drop_priv, Reload_priv, Shutdown_priv, Process_priv, File_priv,
Grant_priv, References_priv, Index_priv, Alter_priv)
ON mysql.user TO 'pma'@'localhost';
GRANT SELECT ON mysql.db TO 'pma'@'localhost';
GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv) ON
mysql.tables_priv TO 'pma'@'localhost';
GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv)
ON mysql.tables_priv TO 'pma'@'localhost';
... and if you want to use the many new relation and bookmark
features:
GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db> TO
'pma'@'localhost'; (this of course requires you to have a special DB
for phpMyAdmin, the contents will be explained later)
GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db> TO '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 a set of privileges
on a set of particular databases. Normally you shouldn't give
global privileges to an ordinary user, unless you understand the
@@ -196,11 +189,6 @@ Installation
Host authentication $cfg['Servers'][$i]['AllowDeny']['order'] and
$cfg['Servers'][$i]['AllowDeny']['rules'] configuration
directives.
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
Configuration
@@ -228,19 +216,15 @@ Configuration
$cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
. $_SERVER['HTTP_HOST']
. (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SER
VER_PORT'] : '')
. substr($_SERVER['PHP_SELF'], 0, strrpos($_SERVER['PHP_
SELF'], '/')+1);
. (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SERVER_PORT'] : '')
. substr($_SERVER['PHP_SELF'], 0, strrpos($_SERVER['PHP_SELF'], '/')+1);
or
$cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
. $_SERVER['SERVER_NAME']
. (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SER
VER_PORT'] : '')
. substr($_SERVER['SCRIPT_NAME'], 0, strrpos($_SERVER['S
CRIPT_NAME'], '/')+1);
. (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SERVER_PORT'] : '')
. substr($_SERVER['SCRIPT_NAME'], 0, strrpos($_SERVER['SCRIPT_NAME'], '/')+1);
Please note that the $_SERVER array doesn't exist in
@@ -294,6 +278,11 @@ CRIPT_NAME'], '/')+1);
To use the socket mode, your MySQL server must be on the same
machine as the Web server.
$cfg['Servers'][$i]['compress'] boolean
Wheather to use a compressed protocol for the MySQL server
connection or not (experimental).
This feature requires PHP >= 4.3.0.
$cfg['Servers'][$i]['controluser'] string
$cfg['Servers'][$i]['controlpass'] string
When using http or cookie authentication modes (or 'config'
@@ -935,11 +924,6 @@ CRIPT_NAME'], '/')+1);
$cfg['Functions'] array
A list of functions MySQL supports. In most cases you don't
need to edit this.
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
FAQ - Frequently Asked Questions
@@ -948,9 +932,10 @@ FAQ - Frequently Asked Questions
[1. Server]
[1.1] 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?
[1.1] 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
There are some known php bugs with output buffering and compression.
Try to set the $cfg['OBGzip'] directive to FALSE in your
config.inc.php or .php3 file and the zlib.output_compression directive
@@ -960,29 +945,33 @@ FAQ - Frequently Asked Questions
with MS Internet Explorer. Please upgrade to the release version php
4.2.0.
[1.2] My Apache server crashes when using phpMyAdmin.
[1.2] 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.
[1.3] 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
script: I'm always displayed the login screen.
[1.3] 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 script:
I'm always displayed the login screen
This is a known PHP bug (see this bug report) from the official php
bug database. It means there is and won't be any phpMyAdmin fix
against it because there is no way to code a fix.
[1.4] Using phpMyAdmin on IIS, I'm displayed the error message: "The
specified CGI application misbehaved by not returning a complete set
of HTTP headers...."
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 bug report from
the official php bug database.
[1.5] Using phpMyAdmin on IIS, I'm facing crashes and/or many error
messages with the http or advanced authentication mode.
messages with the http or advanced authentication mode
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
posted by Andr<64> B. aka "djdeluxe76" in this thread from the phpWizard
@@ -990,14 +979,15 @@ FAQ - Frequently Asked Questions
Please use instead the cookie authentication mode.
[1.6] 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 (2 lines) from the scripts header.inc.php3,
header_printview.inc.php3, index.php3, left.php3 and
libraries/common.lib.php3.
[1.7] How can I GZip or Bzip a dump or a CSV export. It seems to not
work?
[1.7] 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
Mode or not, and so on). So, you must have PHP4 >= 4.0.4 and
@@ -1006,8 +996,9 @@ FAQ - Frequently Asked Questions
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.
[1.8] I cannot insert a text file in a table, and I get an error about
safe mode being in effect.
[1.8] 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
php.ini by the variable upload_tmp_dir (usually the system default is
/tmp).
@@ -1020,9 +1011,10 @@ FAQ - Frequently Asked Questions
* put upload_tmp_dir = /tmp/php in php.ini
* restart Apache
[1.9] 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.
[1.9] 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
It's not really phpMyAdmin related but RedHat 7.0. You have a RedHat
7.0 and you updated your php rpm to php-4.0.4pl1-3.i386.rpm, didn't
you?
@@ -1035,16 +1027,18 @@ FAQ - Frequently Asked Questions
should go away.
And that fixes the \r\n problem with file uploads!
[1.10] 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.
[1.10] 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
As suggested by "Rob M" in the phpWizard forum, add this line to your
httpd.conf:
SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown
It seems to clear up many problems between IE and SSL.
[1.11] I get an 'open_basedir restriction' while uploading a file from
the query box.
[1.11] 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
restrictions. Assuming that the restriction allows you to open files
in the current directory ('.'), all you have to do is create a 'tmp'
@@ -1053,25 +1047,29 @@ FAQ - Frequently Asked Questions
uploaded files will be moved there, and after execution of your SQL
commands, removed.
[1.12] I have lost my MySQL root password, what can I do?
[1.12] I have lost my MySQL root password, what can I do
The MySql manual explains how to reset the permissions.
[1.13] I get an error 'No SQL query' when trying to execute a
bookmark.
[1.13] 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.
[1.14] I get an error 'No SQL query' when trying to submit a query
from the convenient text area.
[1.14] 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.
[1.15] I have problems with mysql.user field names.
[1.15] 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.
[1.16] I cannot upload big dump files.
[1.16] 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.
@@ -1079,7 +1077,8 @@ FAQ - Frequently Asked Questions
submitted and handled by php. One user also said that post_max_size
and memory_limit need to be larger than upload_max_filesize.
[1.17] Does phpMyAdmin support MySQL 4?
[1.17] 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
for administering MySQL 4 servers, but phpMyAdmin does not yet support
@@ -1093,21 +1092,24 @@ FAQ - Frequently Asked Questions
won't work correctly with MySQL >= 4.1.0! We will work on the support
as soon as MySQL 4.1.0 is released.
[1.18] I'm running MySQL <= 4.0.1 having lower_case_table_names set to
1. If I create a new table with a capital letter in its name it is
changed to lowercase as it should. But if I try to DROP this table
MySQL is unable to find the corresponding file.
[1.18] I'm running MySQL <= 4.0.1 having lower_case_table_names set to 1.
If I create a new table with a capital letter in its name it is changed to
lowercase as it should. But if I try to DROP this table MySQL is unable to
find the corresponding file
This is a bug of MySQL <= 4.0.1. Please upgrade to at least
MySQL 4.0.2 or turn off your lower_case_table_names directive.
[1.19] I can't run the "display relations" feature because the script
seems not to know the font face I'm using!
[1.19] I can't run the "display relations" feature because the script seems
not to know the font face I'm using!
The "FPDF" library we're using for this feature requires some special
files to use font faces.
Please refers to the FPDF manual to build these files.
[1.20] I receive the error "cannot load MySQL extension, please check
PHP Configuration".
[1.20] I receive the error "cannot load MySQL extension, please check PHP
Configuration"
To connect to a MySQL server, PHP needs a set of MySQL functions
called "MySQL extension". This extension may be part of the PHP server
(compiled-in), otherwise it needs to be loaded dynamically. Its name
@@ -1116,17 +1118,19 @@ FAQ - Frequently Asked Questions
Usually, the problem is solved by installing a software package called
"PHP-MySQL" or something similar.
[1.21] I am running the CGI version of PHP under Unix, and I cannot
login using cookie auth.
[1.21] I am running the CGI version of PHP under Unix, and I cannot login
using cookie auth
In php.ini, set mysql.max_links higher than 1.
[1.22] I don't see the "Location of text file" field, so I cannot
upload.
[1.22] I don't see the "Location of text file" field, so I cannot upload
This is most likely because in php.ini, your file_uploads parameter is
not set to "on".
[1.23] I'm running MySQL on a Win32 machine. Each time I create a new
table the table and field names are changed to lowercase!
[1.23] I'm running MySQL on a Win32 machine. Each time I create a new table
the table and field names are changed to lowercase!
This happens because the MySQL directive lower_case_table_names
defaults to 1 (ON) in the Win32 version of MySQL. You can change this
behavior by simply changing the directive to 0 (OFF):
@@ -1138,11 +1142,13 @@ FAQ - Frequently Asked Questions
SHOW VARIABLES LIKE 'lower_case_table_names';
[1.24] Some characters are being truncated in my queries, or I get
characters randomly added. I am running PHP 4.2.3.
characters randomly added. I am running PHP 4.2.3
This is a PHP 4.2.3 bug.
[1.25] I am running Apache with mod_gzip-1.3.26.1a on Windows XP, and
I get problems, such as undefined variables when I run a SQL query.
[1.25] I am running Apache with mod_gzip-1.3.26.1a on Windows XP, and I get
problems, such as undefined variables when I run a SQL query
A tip from Jose Fandos: put a comment on the following two lines in
httpd.conf, like this:
# mod_gzip_item_include file \.php$
@@ -1150,36 +1156,41 @@ FAQ - Frequently Asked Questions
as this version of mod_gzip on Apache (Windows) has problems handling
php scripts. Of course you have to restart Apache.
[1.26] I just installed phpMyAdmin in my document root of IIS but I
get the error "No input file specified" when trying to run phpMyAdmin.
[1.26] I just installed phpMyAdmin in my document root of IIS but I get the
error "No input file specified" when trying to run phpMyAdmin.
This is a permission problem. Right-click on the phpmyadmin folder and
choose properties. Under the tab Security, click on "Add" and select
the user "IUSER_machine" from the list. Now set his permissions and it
should work.
[1.27] I get empty page when I want to view huge page (eg.
db_details_structure.php3 with plenty of dabases).
db_details_structure.php3 with plenty of dabases)
This is a PHP bug that occur when GZIP output buffering enabled. If
you turn off it (by $cfg['OBGzip'] = FALSE in config.inc.php3, it
should work. This bug will be fixed least in PHP >= 4.5.0.
you turn off it (by $cfg['OBGzip'] = FALSE in config.inc.php3), it
should work. This bug will be fixed in PHP 5.0.0.
[2. Configuration]
[2.1] The error message "Warning: Cannot add header information -
headers already sent by ..." is displayed, what's the problem?
[2.1] 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.
[2.2] phpMyAdmin can't connect to MySQL. What's wrong?
[2.2] 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.
[2.3] 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?
[2.3] 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
For RedHat users, Harald Legner suggests this on the mailing list:
On my RedHat-Box the socket of mysql is /var/lib/mysql/mysql.sock. In
your php.ini you will find a line
@@ -1204,47 +1215,52 @@ FAQ - Frequently Asked Questions
Have also a look at the corresponding section of the MySQL
documentation.
[2.4] Nothing is displayed by my browser when I try to run phpMyAdmin,
what can I do?
[2.4] 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
configuration file. It helps sometime.
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.
[2.5] 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?
[2.5] 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.
[3. Known limitations]
[3.1] When using http authentication, an user who logged out can not
relog in with the same nick.
[3.1] 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
phpMyAdmin. We plan to change it as soon as we may find enough free
time to do it, but you can bypass this problem: just close all the
opened browser windows and then go back to phpMyAdmin. You should be
able to logs in again.
[3.2] When dumping a large table in compressed mode, I get a memory
limit error or a time limit error.
[3.2] 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
tables dumps may hang. The only alternative we can think about (using
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.
[3.3] With InnoDB tables, I lose foreign key relationships when I
rename or alter a table.
[3.3] With InnoDB tables, I lose foreign key relationships when I rename or
alter a table
This seems to be a InnoDB bug (fixed in MySQL 3.23.50?). However, keep
in mind that phpMyAdmin as of version 2.3.0 does not support InnoDB.
[3.4] I am unable to import dumps I created with the mysqldump tool
bundled with the MySQL server distribution.
The problem is that mysqldump creates invalid comments like this:
[3.4] I am unable to import dumps I created with the mysqldump tool bundled
with the MySQL server distribution
The problem is that mysqldump creates invalid comments like this:
-- MySQL dump 8.22
--
-- Host: localhost Database: database
@@ -1262,16 +1278,18 @@ FAQ - Frequently Asked Questions
[4. ISPs, multi-user installations ]
[4.1] I'm an ISP. Can I setup one central copy of phpMyAdmin or do I
need to install it for each customer?
[4.1] 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
all your users. The development of this feature was kindly sponsored
by NetCologne GmbH. This requires a properly setup MySQL user
management and phpMyAdmin http or cookie authentication. See the
install section on "Using http authentication".
[4.2] What's the preferred way of making phpMyAdmin secure against
evil access?
[4.2] What's the preferred way of making phpMyAdmin secure against evil
access
This depends on your system.
If you're running a server which cannot be accessed by other people,
it's sufficient to use the directory protection bundled with your
@@ -1286,14 +1304,16 @@ FAQ - Frequently Asked Questions
* You should use PHP safe mode, to protect from other users that try
to include your config.inc.php3 in their scripts.
[4.3] I get errors about not being able to include a file in /lang or
in /libraries.
[4.3] 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.
[4.4] phpMyAdmin always gives "Access denied" when using http
authentication.
authentication
This could happen for several reasons:
* $cfg['Servers'][$i]['controluser'] and/or
$cfg['Servers'][$i]['controlpass'] are wrong.
@@ -1302,13 +1322,15 @@ FAQ - Frequently Asked Questions
phpMyAdmin-directory, eg. a .htaccess file. This would interfere
with phpMyAdmin's authentication, so remove it.
[4.5] Is it possible to let users create their own databases?
[4.5] 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).
[4.6] How can I use the Host-based authentication additions?
[4.6] How can I use the Host-based authentication additions
If you have existing rules from an old .htaccess file, you can take
them and add a username between the 'deny'/'allow' and 'from' strings.
Using the username wildcard of '%' would be a major benefit here if
@@ -1330,20 +1352,22 @@ FAQ - Frequently Asked Questions
[5. Browsers or client OS]
[5.1] I get an out of memory error, and my controls are
non-functional, when trying to create a table with more than 14
fields.
[5.1] 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.
[5.2] With Xitami 2.5b4, phpMyAdmin won't process form fields.
[5.2] 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.
[5.3] 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'.
Bzip2 dumps don't seem to work.
@@ -1352,61 +1376,69 @@ FAQ - Frequently Asked Questions
Konqueror, or else they disappear. Gzip dumps give an error message.
Testing needs to be done for Konqueror 2.2.2.
[5.4] I can't use the cookie authentication mode because Internet
Explorer never stores the cookies.
[5.4] 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
till version 6. And thanks to Andrew Zivolup we've traced also a php
4.1.1 bug in this area!
Then, if you're running php 4.1.1, try to upgrade or downgrade... it
may work!
[5.5] In Internet Explorer 5.0, I get Javascript errors when browsing
my rows.
[5.5] In Internet Explorer 5.0, I get Javascript errors when browsing my
rows
Upgrade to at least Internet Explorer 5.5SP2.
[5.6] 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.
[5.6] 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
use a long URL to identify this row. There is a limit on the lenght of
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.
[5.7] I refresh (reload) my browser, and come back to the welcome
page.
[5.7] 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.
[5.8] With Mozilla 0.9.7 I have problems sending a query modified in
the query box.
[5.8] 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.
[5.9] With Mozilla 0.9.? to 1.0 and Netscape 7.0-PR1 I can't type a
whitespace in 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 Bugzilla).
[5.10] With Netscape 4.75 I get empty rows between each row of data in
a CSV exported file.
[5.10] With Netscape 4.75 I get empty rows between each row of data in a
CSV exported file
This is a known Netscape 4.75 bug: it adds some line feeds when
exporting data in octet-stream mode. Since we can't detect the
specific Netscape version, we cannot workaround this bug.
[5.11] Extended-ASCII characters like German umlauts are displayed
wrong.
[5.11] Extended-ASCII characters like German umlauts are displayed wrong
Please ensure that you have set your browser's charset to the one of
the language file you have selected on phpMyAdmin's start page.
Alternatively, you can try the auto detection mode that is supported
by the recent versions of the most browsers.
[5.12] Apple OS X: Safari browser changes special characters to "?".
[5.12] Apple OS X: Safari browser changes special characters to "?"
This issue has been reported by a OS X user, who adds that Chimera,
Netscape and Mozilla do not have this problem.
[6. Using phpMyAdmin]
[6.1] I can't insert new rows into a table / I can't create a table -
MySQL brings up a SQL-error.
[6.1] I can't insert new rows into a table / I can't create a table - MySQL
brings up a SQL-error
Examine the SQL error with care. Often the problem is caused by
specifying a wrong field-type.
Common errors include:
@@ -1416,19 +1448,22 @@ FAQ - Frequently Asked Questions
Also, look at the syntax chapter in the MySQL manual to confirm that
your syntax is correct.
[6.2] When I create a table, I click the Index checkbox for 2 fields
and phpMyAdmin generates only one index with those 2 fields.
[6.2] 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.
[6.3] How can I insert a null value into my table?
[6.3] 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.
[6.4] How can I backup my database or table?
[6.4] 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 on the menu, click "Export", you can dump the
structure, the data, or both. This will generate standard SQL
@@ -1440,15 +1475,17 @@ FAQ - Frequently Asked Questions
For additional help on this subject, look for the word "dump" in this
document.
[6.5] How can I restore (upload) my database or table using a dump?
How can I run a ".sql" file?
[6.5] How can I restore (upload) my database or table using a dump? How can
I run a ".sql" file
Click on a database name in the left frame, the properties will be
local displayed. Then in the "Run SQL query" section, type in your
dump filename, or use the Browse button. Then click Go.
For additional help on this subject, look for the word "upload" in
this document.
[6.6] How can I use the relation table in Query-by-example?
[6.6] How can I use the relation table in Query-by-example
Here is an example with the tables persons, towns and countries, all
located in the database mydb. If you don't have a PMA_relation table,
create it as explained in the configuration section. Then create the
@@ -1496,12 +1533,14 @@ FAQ - Frequently Asked Questions
correct joins have been generated
* Click "Submit query"
[6.7] How can I use the "display field" feature?
[6.7] How can I use the "display field" feature
Starting from the previous example, create the PMA_table_info as
explained in the configuration section, then browse your persons
table, and move the mouse over a town code or country code.
[6.8] How can I produce a PDF schema of my database?
[6.8] How can I produce a PDF schema of my database
First you have to fill the "relation", "table_coords" and "pdf_pages"
configuration variables.
Then, think about your schema layout: which tables will go on which
@@ -1539,11 +1578,13 @@ FAQ - Frequently Asked Questions
the file under the name it offers).
[6.9] phpMyAdmin is changing the type of one of my columns!
No, it's MySQL that is doing silent column type changing.
[6.10] My database has an underscore in it's name, and when I grant
privileges to a user for this database, a backslash is added before
the underscore.
privileges to a user for this database, a backslash is added before the
underscore
This is normal and means that the grant is done only for this
database. If there was no backslash, this would be a wildcard grant,
and the underscore would mean "any character". So, if the database
@@ -1552,10 +1593,12 @@ FAQ - Frequently Asked Questions
If you really want to grant using a wildcard, there is a dialog box "
Database (wildcards allowed)" for this.
[6.11] What is the curious symbol <20> in the table statistics?
[6.11] What is the curious symbol <20> in the table statistics
It means "average".
[6.12] I want to understand some Export options.
[6.12] I want to understand some Export options
"Complete inserts" adds the column names on every INSERT command, for
better documentation (but resulting file is bigger).
"Extended inserts" provides a shorter dump file by using only once the
@@ -1563,13 +1606,15 @@ FAQ - Frequently Asked Questions
"Enclose table and field names with backquotes" ensures that field and
table names formed with special characters are protected.
[6.13] I would like to create a database with a dot in its name.
[6.13] I would like to create a database with a dot in its name
This is a bad idea, because in MySQL the syntax "database.table" is
the normal way to reference a database and table name. Worse, MySQL
will usually let you create a database with a dot, but then you cannot
work with it, nor delete it.
[6.14] How do I set up the SQL validator?
[6.14] How do I set up the SQL validator
To use it, you need a very recent version of PHP, 4.3.0 recommended,
with XML, PCRE and PEAR support. On your system command line, run
"pear install Net_Socket Net_URL HTTP_Request Mail_Mime Net_DIME SOAP"
@@ -1580,29 +1625,32 @@ FAQ - Frequently Asked Questions
is <20> 2001 Upright Database Technology. We utilize it as free SOAP
service.
[6.15] I want to add a BLOB field and put an index on it, but MySQL
says "BLOB column '...' used in key specification without a key
length".
[6.15] I want to add a BLOB field and put an index on it, but MySQL says
"BLOB column '...' used in key specification without a key length"
The right way to do this, is to create the field without any indexes,
then display the table structure and use the "Create an index" dialog.
On this page, you will be able to choose your BLOB field, and set a
size to the index, which is the condition to create an index on a BLOB
field.
[6.16] How can I simply move in page with plenty editing fields?
[6.16] How can I simply move in page with plenty editing fields
You can use Ctrl+arrows for moving on most pages with plenty editing
fields (table structure changes, row editing, etc.).
[7. phpMyAdmin project]
[7.1] I have found a bug. How do I inform developers?
[7.1] I have found a bug. How do I inform developers
Our Bug Tracker is located at
http://sourceforge.net/projects/phpmyadmin/ under the Bugs section.
But please first discuss your bug with other users:
http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
[7.2] 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
Always use the current cvs version of your language file. For a new
language, start from english-iso-8859-1.inc.php3. If you don't know
how to get the cvs version, please ask one of the developers.
@@ -1616,7 +1664,8 @@ FAQ - Frequently Asked Questions
messages.
[7.3] I would like to help out with the development of phpMyAdmin. How
should I proceed?
should I proceed
The following method is preferred for new developers:
* fetch the current CVS tree over anonymous CVS:
cvs
@@ -1634,11 +1683,6 @@ FAQ - Frequently Asked Questions
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 Developers section.
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
Developers Information
@@ -1690,11 +1734,6 @@ Developers Information
already contributed something useful to phpMyAdmin. If you're
interested in that, please contact us using the phpmyadmin-devel
mailing list.
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
Credits
@@ -1811,8 +1850,7 @@ enhancements, bugfixes or support for a new language since version 2.1.0:
Bora Alioglu, Ricardo ?, Sven-Erik Andersen, Alessandro Astarita,
P<EFBFBD>ter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow,
Mats Engstrom, Ian Davidson, Laurent Dhima, Kristof Hamann, Thomas Kl<4B>ger,
Lubos Klokner, Martin Marconcini, Girish Nair, David Nordenberg, Andreas Pauley
,
Lubos Klokner, Martin Marconcini, Girish Nair, David Nordenberg, Andreas Pauley,
Bernard M. Piller, Laurent Haas, "Sakamoto", Yuval Sarna,
www.securereality.com.au, Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky,
Rachim Tamsjadi, Kositer Uros, Lu<4C>s V., Martijn W. van der Lee,
@@ -1859,10 +1897,5 @@ 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.
______________________________________________________________________
Top - Requirements - Introduction - Installation -
Configuration - FAQ - Developers - Credits
______________________________________________________________________
Valid XHTML 1.0! Valid CSS!

163
docs.css Normal file
View File

@@ -0,0 +1,163 @@
/* $Id$ */
/* Stylesheet for phpMyAdmin documentation */
/* vim: expandtab ts=4 sw=4 sts=4 tw=78
*/
body {
background-color: #ffffff;
font-family: sans-serif;
color: #000;
margin: 0px;
padding: 2em 0px 2em 0px;
}
a {
text-decoration: none;
color: #000099;
background-color: #ffffff;
font-weight: normal;
}
a:hover {
background-color: #99CCFF;
background-color: #ffffff;
font-weight: bolder
}
div.header {
width: 100%;
background-color: #ddeeff;
color: #000000;
text-align: center;
padding-bottom: 2px;
border-bottom: 1px solid #000000;
font-weight: bold;
left: 0px;
top: 0px;
position: fixed;*/
/* following MSIE hack was originally written by Riki Fridrich
* <http://www.fckbkk.sk> */
position: expression("absolute");
width: expression(document.body.clientWidth);
top: expression(document.body.scrollTop + this.offsetHeight - this.offsetHeight);
}
div.header hr {
display: none;
}
div.header a {
text-decoration: none;
font-size: medium;
color: #000099;
background-color: #ddeeff;
font-weight: normal;
}
div.header a:hover {
background-color: #99CCFF;
font-weight: bolder
}
h1 {
text-align: center;
padding-left: 8%;
margin-top: 1em;
background-color: #ddeeff;
font-size: x-large;
border-top: 1px solid #000000;
border-bottom: 1px solid #000000;
clear: both;
}
h2 {
padding-left: 8%;
margin-top: 1em;
background-color: #ddeeff;
font-size: large;
border-top: 1px solid #000000;
border-bottom: 1px solid #000000;
clear: both;
}
h3 {
padding-left: 10%;
margin-top: 1em;
background-color: #ddeeff;
font-size: medium;
border-top: 1px solid #000000;
border-bottom: 1px solid #000000;
clear: both;
}
h4 {
padding: 0px;
margin: 10px 5% 2px 5%;
font-weight: bold;
}
p {
margin: 2px 5% 2px 5%;
}
table {
margin: 2px 5% 2px 5%;
border: none;
}
table tr,table td,table th {
border: none;
}
table.translators {
text-align: center;
display: table; margin-left: auto; margin-right: auto;
border-collapse: collapse;
}
table.translators th {
background-color: #d3dce3;
}
table.translators td, table.translators th {
border: 1px solid #000000;
padding: 5px;
}
ul {
margin: 2px 5% 2px 5%;
}
pre {
margin: 2px 5% 2px 5%;
}
pre.wrap {
white-space: normal;
}
dl {
margin: 1em 6% 1em 6%;
}
dt {
font-weight: bold;
margin-left: 2em;
padding-top: 6px;
}
dd {
margin-left: 4em;
}
ol {
margin: 1em 6% 1em 6%;
}
.important {
color: #bb0000;
}
p.footnote {
margin: 2px 5% 2px 7%;
}
p.footnote:first-line {
margin-left: -2%;
}

2
scripts/create-release.sh
View File

@@ -59,7 +59,7 @@ Please ensure you have:
" <h1>phpMyAdmin $1 Documentation</h1> "
- in translators.html
2. built the new "Documentation.txt" version using:
lynx --nolist --dump Documentation.html > Documentation.txt
lynx --dont_wrap_pre --nolist --dump Documentation.html > Documentation.txt
3. synchronized the language files:
cd lang
./sync_lang.sh

70
translators.html
View File

@@ -6,48 +6,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>phpMyAdmin 2.4.0-dev - Official translators</title>
<style type="text/css">
<!--
body {
font-family: Arial, Helvetica, sans-serif;
font-size: normal;
}
p {
font-family: Arial, Helvetica, sans-serif;
font-size: normal;
}
h1 {
font-family: Verdana, Arial, Helvetica, sans-serif;
font-size: x-latge;
font-weight: bold;
color: #000066;
}
th {
font-family: Arial, Helvetica, sans-serif;
font-size: normal;
color: #000000;
background-color: #d3dce3;
}
td {
font-family: Arial, Helvetica, sans-serif;
font-size: normal;
}
.redtext {
color: #bb0000;
}
.navigation {
font-family: Verdana, Arial, Helvetica, sans-serif;
text-decoration: none;
font-size: normal;
color: #000099;
font-weight: normal;
}
.navigation:hover {
background-color: #99ccff;
font-weight: bolder;
}
//-->
</style>
<link rel="stylesheet" type="text/css" href="docs.css" />
<script lanuage="javascript" type="text/javascript">
<!--
function PMA_notice(language) {
@@ -67,33 +26,46 @@
</head>
<body bgcolor="#FFFFFF">
<body>
<h1 align="center">phpMyAdmin 2.4.0-dev official translators list</h1>
<br />
<div class="header">
<hr noshade="noshade" width="100%" />
<a href="Documentation.html#top">Documentation</a> &nbsp;-&nbsp;
<a href="Documentation.html#require">Requirements</a> &nbsp;-&nbsp;
<a href="Documentation.html#intro">Introduction</a> &nbsp;-&nbsp;
<a href="Documentation.html#setup">Installation</a> &nbsp;-&nbsp;
<a href="Documentation.html#config">Configuration</a> &nbsp;-&nbsp;
<a href="Documentation.html#faq">FAQ</a> &nbsp;-&nbsp;
<a href="Documentation.html#developers">Developers</a> &nbsp;-&nbsp;
<a href="Documentation.html#credits">Credits</a> &nbsp;-&nbsp;
<a href="Translators.html">translators</a>
<hr noshade="noshade" width="100%" />
</div>
<h1>phpMyAdmin 2.4.0-dev official translators list</h1>
<p>
Here is the list of the so called &quot;official translators&quot; of
phpMyAdmin.
</p>
<p>
<span class="redtext">If you want to suggest some improvements on a
<span class="important">If you want to suggest some improvements on a
translation please ask them</span>: we (the phpMyAdmin developement team)
don't know anything about most of these languages and then we can't have
any opinion on grammar issues or bad translations!
</p>
<p>
All translations listed here are included in this distribution.
<span class="redtext">Please don't ask the translators to send you a
<span class="important">Please don't ask the translators to send you a
localized phpMyAdmin version!</span>
</p>
<p>
<span class="redtext">Please do not expect the translators to provide
<span class="important">Please do not expect the translators to provide
e-mail support.</span>
</p>
<br />
<table border="1" cellpadding="5" cellspacing="5" align="center">
<table class="translators">
<tr>
<th>Language</th>
<th>Official translator(s)</th>