From 560f98c567b2779051b9c2250f9d28cd496db9cd Mon Sep 17 00:00:00 2001 From: Marc Delisle Date: Fri, 9 Nov 2001 15:13:59 +0000 Subject: [PATCH] FAQ sub-sections --- ChangeLog | 3 + Documentation.html | 436 +++++++++++++++++++++++---------------------- 2 files changed, 229 insertions(+), 210 deletions(-) diff --git a/ChangeLog b/ChangeLog index f8f0c7675..0683af675 100755 --- a/ChangeLog +++ b/ChangeLog @@ -5,6 +5,9 @@ phpMyAdmin - Changelog $Id$ $Source$ +2001-11-09 Marc Delisle + * Documentation.html: small additions, FAQ sub-sections + 2001-11-09 Loïc Chapeaux * config.inc.php3; Documentation.html; main.php3; phpinfo.php3; libraries/common.lib.php3: diff --git a/Documentation.html b/Documentation.html index be24c0bc6..cee8c188f 100755 --- a/Documentation.html +++ b/Documentation.html @@ -571,6 +571,13 @@ Defines whether to display the "MySQL runtime information", "MySQL system variables" and "PHP information" links or not for simple users at the starting main (right) frame. + This setting does not check MySQL commands entered directly. +

+ + Please note that to block the usage of phpinfo() in scripts, you + have to put this in your php.ini: +
+ disable_functions = phpinfo()

@@ -777,12 +784,13 @@

FAQ - Frequently Asked Questions

+

[Server]

I'm running php 4+ and my server is crashing each time a specific action - is required or phpMyAdmin send a blank page to my browser, what can I + is required or phpMyAdmin sends a blank page to my browser, what can I do?
- There is some known php bugs with output buffering and compression.
+ There are some known php bugs with output buffering and compression.
Try to set the $cfgOBGzip directive to FALSE in your config.inc.php or .php3 file and the zlib.output_compression directive to Off in your php @@ -790,179 +798,24 @@

- The error message "Warning: Cannot add header information - headers - already sent by ..." is displayed, what's the problem? + My Apache server crashes when using phpMyAdmin.
- Edit your config.inc.php or .php3 file and ensure there is nothing - (ie no blank lines, no spaces, no characters...) neither before the - <?php tag at the beginning, neither after the ?> - tag at the end. -

- -

- I can't insert new rows into a table - MySQL brings up a SQL-error. + You should first try the latest versions of Apache (and possibly MySQL).
- Examine the SQL error with care. I've found that many programmers - specifying a wrong field-type.
- Common errors include: -

-
    -
  • Using VARCHAR without a size argument
    • -
  • Using TEXT or BLOB with a size argument
    • -
-

- Also, look at the syntax chapter in the MySQL manual to confirm that your - syntax is correct. -

- -

- phpMyAdmin can't connect to MySQL. What's wrong? + See also the other FAQ entry about php bugs with output buffering.
- 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. + If your server keeps crashing, please ask for help in the various + Apache support groups.

-

- 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? + Using phpMyAdmin on IIS, I'm displayed the error message: "The + specified CGI application misbehaved by not returning a complete set of + HTTP headers...."
- Here is a fix suggested by Brad Ummer in the - - phpwizard forum: -

-
    -
  • - First, you need to determine what socket is being used by MySQL. -
    - To do this, telnet to your server and go to the MySQL bin directory. In - this directory there should be a file named mysqladmin. Type - ./mysqladmin variables, and this should give you a bunch of - info about your MySQL server, including the socket - (/tmp/mysql.sock, for example). -
    • -
  • - Then, you need to tell PHP to use this socket.
    Assuming you are - using PHP 3.0.10 or better, you can specify the socket to use when you - open the connection. To do this in phpMyAdmin, you need to complete the - socket information in the config.inc.php3.
    - For example: - $cfgServers[n]['socket'] = '/tmp/mysql.sock'; -
    • -
-

- Have also a look at the - - corresponding section of the MySQL documentation. -

- -

- phpMyAdmin always gives "Access denied" when using advanced - authentication.
- This could happen for several reasons: -

-
    -
  • - $cfgServers[n]['stduser'] and/or - $cfgServers[n]['stdpass'] are wrong. -
    • -
  • - The username/password you specify in the login-dialog are invalid. -
    • -
  • - You have already setup a security mechanism for the - phpMyAdmin-directory, eg. a .htaccess file. This would interfere with - phpMyAdmin's authentication, so remove it. -
    • -
- - -

- When using advanced authentication, an user who logged out can not - relogs 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. -

- -

- 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 -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin login
    - [Password: simply press the Enter key]
    - cvs -z3 -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin checkout phpMyAdmin
    - [This will create a new sub-directory named phpMyAdmin] -
    • -
  • - add your stuff -
    • -
  • - put the modified files (tar'ed and gzip'ed) inside the patch tracker of - the - phpMyAdmin SourceForge account. -
    • -
-

- Write access to the CVS tree is granted only to experienced developers who - have already contributed something useful to phpMyAdmin.
- Also, have a look at the Developers section. -

- -

- 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 - (with Apache you can use .htaccess files, for example).
- If other people have telnet access to your server, you should use - phpMyAdmin's advanced authentication feature. -

- Suggestions: -

-
    -
  • - Your config.inc.php3 file should be chmod 660. -
    • -
  • - All your phpMyAdmin files should be chown phpmy.apache, where phpmy - is a user whose password is only known to you, and apache is the - group under which Apache runs. -
    • -
  • - You should use PHP safe mode, to protect from other users that try - to include your config.inc.php3 in their scripts. -
    • -
- -

- How can I insert a null value into my table? -
- Enter "null", without the quotes, as the field's value. This is - especially useful for Timestamp or AutoIncrement fields. -

- -

- 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 - advanced authentication. See the install section on "Using advanced authentication" + 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.

@@ -1016,16 +869,146 @@ And that fixes the \r\n problem with file uploads!

+ + +

[Configuration]

+

- When I create a table, I click the Index checkbox for 2 fields and - phpMyAdmin generates only one index with those 2 fields. + The error message "Warning: Cannot add header information - headers + already sent by ..." is displayed, what's the problem?
- 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. + Edit your config.inc.php or .php3 file and ensure there is nothing + (ie no blank lines, no spaces, no characters...) neither before the + <?php tag at the beginning, neither after the ?> + tag at the end.

+

+ phpMyAdmin can't connect to MySQL. What's wrong? +
+ Either there is an error with your PHP setup or your username/password is + wrong. Try to make a small script which uses mysql_connect and see if it + works. If it doesn't, it may be you haven't even compiled MySQL support + into PHP. +

+ +

+ The error message "Warning: MySQL Connection Failed: Can't connect + to local MySQL server through socket '/tmp/mysql.sock' (111)...") is + displayed. What can I do? +
+ Here is a fix suggested by Brad Ummer in the + + phpwizard forum: +

+
    +
  • + First, you need to determine what socket is being used by MySQL. +
    + To do this, telnet to your server and go to the MySQL bin directory. In + this directory there should be a file named mysqladmin. Type + ./mysqladmin variables, and this should give you a bunch of + info about your MySQL server, including the socket + (/tmp/mysql.sock, for example). +
    • +
  • + Then, you need to tell PHP to use this socket.
    Assuming you are + using PHP 3.0.10 or better, you can specify the socket to use when you + open the connection. To do this in phpMyAdmin, you need to complete the + socket information in the config.inc.php3.
    + For example: + $cfgServers[n]['socket'] = '/tmp/mysql.sock'; +
    • +
+

+ Have also a look at the + + corresponding section of the MySQL documentation. +

+ +

[Known limitations]

+ +

+ When using advanced authentication, an user who logged out can not + relogs 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. +

+ +

[ISPs]

+

+ 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 + advanced authentication. See the install section on "Using advanced authentication" +

+ +

+ 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 + (with Apache you can use .htaccess files, for example).
+ If other people have telnet access to your server, you should use + phpMyAdmin's advanced authentication feature. +

+ Suggestions: +

+
    +
  • + Your config.inc.php3 file should be chmod 660. +
    • +
  • + All your phpMyAdmin files should be chown phpmy.apache, where phpmy + is a user whose password is only known to you, and apache is the + group under which Apache runs. +
    • +
  • + You should use PHP safe mode, to protect from other users that try + to include your config.inc.php3 in their scripts. +
    • +
+ +

+ I get errors about not being able to include a file in /lang +
+ Check php.ini, or ask your sysadmin to check it. The + include_path must contain "." somewhere in it, and + open_basedir, if used, must contain "." and + "./lang" to allow normal operation of phpMyAdmin. +

+

+ phpMyAdmin always gives "Access denied" when using advanced + authentication.
+ This could happen for several reasons: +

+
    +
  • + $cfgServers[n]['stduser'] and/or + $cfgServers[n]['stdpass'] are wrong. +
    • +
  • + The username/password you specify in the login-dialog are invalid. +
    • +
  • + You have already setup a security mechanism for the + phpMyAdmin-directory, eg. a .htaccess file. This would interfere with + phpMyAdmin's authentication, so remove it. +
    • +
+ + +

[Browsers or client OS]

I get an out of memory error, and my controls are non-functional, when trying to create a table with more than 14 fields. @@ -1037,15 +1020,6 @@ your table properties and add the other fields.

-

- I get errors about not being able to include a file in /lang -
- Check php.ini, or ask your sysadmin to check it. The - include_path must contain "." somewhere in it, and - open_basedir, if used, must contain "." and - "./lang" to allow normal operation of phpMyAdmin. -

-

With Xitami 2.5b4, phpMyAdmin won't process form fields
@@ -1054,40 +1028,40 @@ Upgrade or downgrade your Xitami server.

+

[Using phpMyAdmin]

- Using phpMyAdmin on IIS, I'm dipslayed the error message: "The - specified CGI application misbehaved by not returning a complete set of - HTTP headers...." + I can't insert new rows into a table - MySQL brings up a SQL-error.
- 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. + Examine the SQL error with care. I've found that many programmers + specifying a wrong field-type.
+ Common errors include: +

+
    +
  • Using VARCHAR without a size argument
    • +
  • Using TEXT or BLOB with a size argument
    • +
+

+ Also, look at the syntax chapter in the MySQL manual to confirm that your + syntax is correct. +

+

+ When I create a table, I click the Index checkbox for 2 fields and + phpMyAdmin generates only one index with those 2 fields. +
+ In phpMyAdmin 2.2.0 and 2.2.1, this is the way to create a multi-fields + index. If you want two indexes, create the first one when creating the + table, save, then display the table properties and click the Index link to + create the other index.

- I want to translate the messages to a new language or upgrade an - existing language, where do I start? + How can I insert a null value into my table?
- Always use the current cvs version of your language file. - For a new language, start from english.inc.php3. If you don't know - how to get the cvs version, please ask one of the developers. It would be a - good idea to subscribe to the phpmyadmin-translators discussion list, - because this is where we ask for translations of new messages. You can - then send your translations to the sourceforge.net translation tracker. -

- -

- 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. + Enter "null", without the quotes, as the field's value. This is + especially useful for Timestamp or AutoIncrement fields.

+

[phpMyAdmin project]

I have found a bug. How do I inform developers?
@@ -1104,6 +1078,48 @@ Forum)

+

+ 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.inc.php3. If you don't know + how to get the cvs version, please ask one of the developers. It would be a + good idea to subscribe to the phpmyadmin-translators discussion list, + because this is where we ask for translations of new messages. You can + then send your translations to the sourceforge.net translation tracker. +

+ +

+ 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 -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin login
    + [Password: simply press the Enter key]
    + cvs -z3 -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmyadmin checkout phpMyAdmin
    + [This will create a new sub-directory named phpMyAdmin] +
    • +
  • + add your stuff +
    • +
  • + put the modified files (tar'ed and gzip'ed) inside the patch tracker of + the + phpMyAdmin SourceForge account. +
    • +
+

+ Write access to the CVS tree is granted only to experienced developers who + have already contributed something useful to phpMyAdmin.
+ Also, have a look at the Developers section. +

+ +