diff --git a/ChangeLog b/ChangeLog index 4694e92a5..dd49c6ba2 100755 --- a/ChangeLog +++ b/ChangeLog @@ -5,6 +5,10 @@ phpMyAdmin - Changelog $Id$ $Source$ +2003-02-01 Michal Cihar + * Documentation.*, translators.html, docs.css: New documentation layout. + * scripts/create-release.sh: Added --dont_wrap_pre to lynx parameters. + 2003-02-01 Marc Delisle * tbl_change.php3, tbl_replace.php3, (new)tbl_replace_fields.php3, db_details.php3, tbl_query_box.php3, libraries/common.lib.php3: diff --git a/Documentation.html b/Documentation.html index a07633a8f..eac1840c8 100755 --- a/Documentation.html +++ b/Documentation.html @@ -2,93 +2,49 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + phpMyAdmin 2.4.0-dev - Documentation - + - - + +
+ +
+
+ Top  -  + Requirements  -  + Introduction  -  + Installation  -  + Configuration  -  + FAQ  -  + Developers  -  + Credits  -  + Translators +
+
+

phpMyAdmin 2.4.0-dev Documentation


- Usage tip: Display field. + Usage tip: Display field.

- +
$cfg['Servers'][$i]['table_coords'] string
$cfg['Servers'][$i]['pdf_pages'] string
@@ -843,12 +745,12 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' $cfg['Servers'][$i]['pdf_pages']
- Usage tips: PDF output. + Usage tips: PDF output.

- +
$cfg['Servers'][$i]['column_comments'] string
@@ -1479,12 +1381,12 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
$cfg['SQLValidator']['use'] boolean
- phpMyAdmin now supports use of the Mimer SQL Validator service, + phpMyAdmin now supports use of the Mimer SQL Validator service, as originally published on - Slashdot. + Slashdot.
For help in setting up your system to use the service, see the - FAQ #6.14. + FAQ #6.14.

@@ -1524,33 +1426,27 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
-
- Top  -  - Requirements  -  - Introduction  -  - Installation  -  - Configuration  -  - FAQ  -  - Developers  -  - Credits -
-

FAQ - Frequently Asked Questions

-Server  -  -Configuration  -  -Limitations  -  -Multi-user  -  -Browsers  -  -Usage tips  -  -Project - -

[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? -
+Server  -  +Configuration  -  +Limitations  -  +Multi-user  -  +Browsers  -  +Usage tips  -  +Project +

+ +
+

[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 +

+

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 @@ -1561,9 +1457,10 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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. @@ -1572,32 +1469,34 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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...."

- [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...." -
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 +

- [1.5] 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. For some more information and complete testings see the messages posted by André B. aka "djdeluxe76" in @@ -1606,9 +1505,9 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' Please use instead the cookie authentication mode.

+

+ [1.6] I can't use phpMyAdmin on PWS: nothing is displayed!

- [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, @@ -1616,10 +1515,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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). @@ -1630,10 +1530,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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). @@ -1651,11 +1552,12 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'

  • 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?
    @@ -1674,21 +1576,23 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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' directory @@ -1697,40 +1601,45 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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. @@ -1740,9 +1649,10 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -1750,30 +1660,31 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' to use php >= 4.1 since older versions of php are not compatible to MySQL 4.
    Furthermore, several users reported problems with phpMyAdmin related to - bugs in MySQL 4. MySQL 4 is still a beta - release and should be used for test purposes only! + bugs in MySQL 4. MySQL 4 is still a beta + release and should be used for test purposes only! Because of a major change in the definition syntax of string field types, this version of phpMyAdmin probably 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 @@ -1781,11 +1692,12 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -1796,25 +1708,27 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' "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):
    @@ -1826,18 +1740,20 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 +

    - [1.24] Some characters are being truncated in my queries, or I get - 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$
    @@ -1846,54 +1762,59 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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) +

    - [1.27] I get empty page when I want to view huge page (eg. - db_details_structure.php3 with plenty of dabases). -
    This is a PHP bug that occur when - GZIP output buffering enabled. If you turn it off (by $cfg['OBGzip'] + 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 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. @@ -1930,14 +1851,15 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'

    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 @@ -1945,23 +1867,25 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -1969,10 +1893,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -1980,46 +1905,53 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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: +

    +
    +-- MySQL dump 8.22
    +--
    +-- Host: localhost Database: database
    +---------------------------------------------------------
    +-- Server version 3.23.54
    +

    - [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
    - ---------------------------------------------------------
    - -- Server version 3.23.54
    -
    The invalid part of the code is the horizontal line made of dashes that appears once in every dump created with mysqldump. If you want to run your dump you have to turn it into valid MySQL. This means, you have to add a - whitespace after the first to dashes of the line or add a # before it:
    - + whitespace after the first to dashes of the line or add a # before it: +
    + -- -------------------------------------------------------
    -
    + or
    - + #--------------------------------------------------------- - +

    - +

    [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. @@ -2028,10 +1960,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' "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 webserver @@ -2056,18 +1989,21 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' +

    + [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 +

    - [4.4] phpMyAdmin always gives "Access denied" when using http - authentication.
    This could happen for several reasons:

      @@ -2085,18 +2021,20 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
    +

    + [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 @@ -2121,12 +2059,14 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'

    - +

    [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.
    @@ -2134,18 +2074,19 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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)

    - [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.
    @@ -2157,10 +2098,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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! @@ -2169,17 +2111,19 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -2187,63 +2131,71 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'

    +

    + [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 +

    - [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. -
    This is a Mozilla bug (see bug #26882 at - Bugzilla).
    + 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: @@ -2256,27 +2208,31 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -2291,10 +2247,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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. @@ -2303,9 +2260,10 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -2342,6 +2300,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
    To setup appropriate links and display information: +

    • on table "REL_persons" click Structure, then Relation view
    • in Links, for "town_code" choose "REL_towns->code"
    • @@ -2350,7 +2309,8 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
    • in "Choose field to display", choose "description"
    • repeat the two previous steps for table "REL_countries"
    -
    + +

    Then test like this:

      @@ -2368,19 +2328,21 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'

    - +
    +

    + [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.

    @@ -2420,19 +2382,20 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' saving the file under the name it offers). +

    + [6.9] phpMyAdmin is changing the type of one of my columns!

    - [6.9] phpMyAdmin is changing the type of one of my columns! -
    No, it's MySQL that is doing - silent column type changing. + 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 +

    - [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. -
    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 name @@ -2441,16 +2404,19 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 ø in the table statistics +

    - [6.11] What is the curious symbol ø 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 @@ -2459,19 +2425,21 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 @@ -2484,11 +2452,12 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' We utilize it as free SOAP service.

    -

    - [6.15] I want to add a BLOB field and put an index on it, but MySQL +

    + [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". -
    + 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 @@ -2497,19 +2466,22 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'

    +

    + [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. @@ -2520,10 +2492,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' 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 +

    - [7.2] 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 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. @@ -2540,10 +2513,11 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'

    +

    + [7.3] I would like to help out with the development of phpMyAdmin. How + should I proceed +

    - [7.3] I would like to help out with the development of phpMyAdmin. How - should I proceed? -
    The following method is preferred for new developers:

    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. + Developers section.


    -
    - Top  -  - Requirements  -  - Introduction  -  - Installation  -  - Configuration  -  - FAQ  -  - Developers  -  - Credits -
    -

    Developers Information

    @@ -2616,7 +2579,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://' using phpMyAdmin as an example application.
    As far as possible, we want the scripts to be XHTML1.0 and CSS2 compliant on one hand, they fit - PEAR coding standards + PEAR coding standards on the other hand. Please pay attention to this.

  • @@ -2651,7 +2614,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
  • put the modified files (tar'ed and gzip'ed) inside the patch tracker of the phpMyAdmin SourceForge account - (http://sourceforge.net/projects/phpmyadmin/) + (http://sourceforge.net/projects/phpmyadmin/)
  • @@ -2663,17 +2626,6 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
    -


    - Top  -  - Requirements  -  - Introduction  -  - Installation  -  - Configuration  -  - FAQ  -  - Developers  -  - Credits -
    -

    Credits

    @@ -2842,17 +2794,6 @@ Original Credits of Version 2.1.0
     
     
     
    -
    - Top  -  - Requirements  -  - Introduction  -  - Installation  -  - Configuration  -  - FAQ  -  - Developers  -  - Credits -
    -

    Valid XHTML 1.0! diff --git a/Documentation.txt b/Documentation.txt index 7a0172677..370dcbd44 100644 --- a/Documentation.txt +++ b/Documentation.txt @@ -1,19 +1,20 @@ + ______________________________________________________________________ + + Top - Requirements - Introduction - Installation - + Configuration - FAQ - Developers - Credits - Translators + ______________________________________________________________________ + phpMyAdmin 2.4.0-dev Documentation * Sourceforge phpMyAdmin project page [ http://www.phpmyadmin.net/ - ] + ] * Local documents: + 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 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'; - ... and if you want to use the many new relation and bookmark - features: - GRANT SELECT, INSERT, UPDATE, DELETE ON TO - 'pma'@'localhost'; (this of course requires you to have a special DB - for phpMyAdmin, the contents will be explained later) +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'; + + ... and if you want to use the many new relation and bookmark + features: + +GRANT SELECT, INSERT, UPDATE, DELETE ON 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,44 +945,49 @@ 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...." + [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...." + 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. + [1.5] 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. For some more information and complete testings see the messages posted by André B. aka "djdeluxe76" in this thread from the phpWizard forum. Please use instead the cookie authentication mode. - [1.6] I can't use phpMyAdmin on PWS: nothing is displayed! + [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): @@ -1137,12 +1141,14 @@ FAQ - Frequently Asked Questions check the value of this directive using the query 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. + [1.24] Some characters are being truncated in my queries, or I get + 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). + [1.27] I get empty page when I want to view huge page (eg. + 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 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,52 +1215,57 @@ 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 - -- MySQL dump 8.22 - -- - -- Host: localhost Database: database - --------------------------------------------------------- - -- Server version 3.23.54 + The problem is that mysqldump creates invalid comments like this: +-- MySQL dump 8.22 +-- +-- Host: localhost Database: database +--------------------------------------------------------- +-- Server version 3.23.54 The invalid part of the code is the horizontal line made of dashes that appears once in every dump created with mysqldump. If you want to @@ -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. + [4.4] phpMyAdmin always gives "Access denied" when using http + 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) + [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. + [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 + 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 @@ -1538,12 +1577,14 @@ FAQ - Frequently Asked Questions extension ".pdf", under other OSes you should be fine just saving the file under the name it offers). - [6.9] phpMyAdmin is changing the type of one of my columns! + [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. + [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 + 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 ø in the table statistics? + [6.11] What is the curious symbol ø 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 © 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? + [7.2] 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 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. @@ -1615,8 +1663,9 @@ FAQ - Frequently Asked Questions mailing list, because this is where we ask for translations of new messages. - [7.3] I would like to help out with the development of phpMyAdmin. How - should I proceed? + [7.3] I would like to help out with the development of phpMyAdmin. How + 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éter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow, Mats Engstrom, Ian Davidson, Laurent Dhima, Kristof Hamann, Thomas Klä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í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! diff --git a/docs.css b/docs.css new file mode 100644 index 000000000..d10715254 --- /dev/null +++ b/docs.css @@ -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 + * */ + 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%; +} + diff --git a/scripts/create-release.sh b/scripts/create-release.sh index 73b9594f8..b86301aab 100755 --- a/scripts/create-release.sh +++ b/scripts/create-release.sh @@ -59,7 +59,7 @@ Please ensure you have: "

    phpMyAdmin $1 Documentation

    " - 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 diff --git a/translators.html b/translators.html index 8feccf68d..6f2f2887d 100644 --- a/translators.html +++ b/translators.html @@ -6,48 +6,7 @@ phpMyAdmin 2.4.0-dev - Official translators - +