From 4c65b02b68e51a134ba0bc568dd24642351aec51 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Olivier=20M=C3=BCller?= Date: Fri, 3 Aug 2001 09:19:35 +0000 Subject: [PATCH] adding Documentation.txt --- ChangeLog | 10 + Documentation.txt | 711 ++++++++++++++++++++++++++++++++++++++++++++++ INSTALL | 50 +--- README | 15 +- 4 files changed, 731 insertions(+), 55 deletions(-) create mode 100644 Documentation.txt diff --git a/ChangeLog b/ChangeLog index b230e631b..7e5016e24 100755 --- a/ChangeLog +++ b/ChangeLog @@ -5,6 +5,16 @@ phpMyAdmin - Changelog $Id$ $Source$ +2001-08-03 Olivier Müller + * Generated Documentation.txt based on Documentation.html + (not everybody is having a webbrowser on their servers... :) + But please do continue to work *ONLY* on Documentation.html. + And then just run a "lynx Documentation.html --dump > Documentation.txt" + to update the .txt file. If you don't have lynx, don't worry, + I'll update this file myself anyway on every release. + * removed contents of INSTALL (now points to the Documentation) + and updated README + 2001-08-02 Marc Delisle * tbl_qbe.php3: workaround a PHP3 problem * tbl_change.php3: bug 446830 (enums), adapted patch diff --git a/Documentation.txt b/Documentation.txt new file mode 100644 index 000000000..59096da29 --- /dev/null +++ b/Documentation.txt @@ -0,0 +1,711 @@ + + phpMyAdmin 2.2.0 Documentation + + * [1]Official phpMyAdmin project homepage [ + http://www.phpwizard.net/projects/phpMyAdmin/ ] + * [2]Sourceforge phpMyAdmin download page [ + http://phpmyadmin.sourceforge.net/ ] + * Local documents: + + Version history: [3]ChangeLog + + Installation instructions: [4]INSTALL + + General notes: [5]README + + Credits information: [6]CREDITS + + License: [7]LICENSE + * Documentation version: $Id: Documentation.html,v 1.35 2001/08/02 + 19:47:58 gandon Exp $ + ______________________________________________________________________ + + [8]Top - [9]Requirements - [10]Introduction - [11]Installation + - [12]Configuration - [13]FAQ - [14]Developers - [15]Credits + ______________________________________________________________________ + +Requirements + + * phpMyAdmin widely uses the 'str_replace()' php function that was + added in PHP 3.0.6, but was buggy up until PHP 3.0.8. Then you + should not run this script with PHP3 < 3.0.8. + PHP also needs to be compiled with mysql and PRCE support; + * MySQL (tested with 3.21.x, 3.22.x and 3.23.x); + * a web-browser (doh!). + ______________________________________________________________________ + + [16]Top - [17]Requirements - [18]Introduction - [19]Installation + - [20]Configuration - [21]FAQ - [22]Developers - [23]Credits + ______________________________________________________________________ + +Introduction + + phpMyAdmin can administer a whole MySQL-server (needs a super-user) + but also a single database. To accomplish the latter you'll need a + properly set up MySQL-user who can read/write only the desired + database. It's up to you to look up the appropiate part in the MySQL + manual. Currently phpMyAdmin can: + * create and drop databases + * create, copy, drop and alter tables + * delete, edit and add fields + * execute any SQL-statement, even batch-queries + * manage keys on fields + * load text files into tables + * create (*) and read dumps of tables + * export (*) and import data to CSV values + * administer multiple servers and single databases + * communicate in more than 20 different languages + + (*) phpMyAdmin can compress (GZip format -RFC 1952- or Bzip2) dumps + and CSV exports if you use PHP4 >= 4.0.4 with Zlib support + (--with-zlib) and/or Bzip2 support (--with-bz2). + ______________________________________________________________________ + + [24]Top - [25]Requirements - [26]Introduction - [27]Installation + - [28]Configuration - [29]FAQ - [30]Developers - [31]Credits + ______________________________________________________________________ + +Installation + + Quick Install: + 1. Untar or unzip the distribution (be sure to untar the + subdirectories): tar xzvf phpMyAdmin_x.x.x.tar.gz + 2. Open the file config.inc.php3 in your favourite editor and change + the values for host, user and password to fit your environment. + Have a look at Documentation.html for an explanation of all + values. + 3. It is recommended that you protect the directory in which you + installed phpMyAdmin (unless it's on a closed intranet), for + example with HTTP-AUTH (in a .htaccess file). See the FAQ section + for additional information. + 4. Open the file //index.php3 in + your browser. phpMyAdmin should now display a welcome screen and + your databases, or a login dialog if using advanced + authentication. + + Installation notes: + * Be sure to protect the phpMyAdmin-directory. By default, it is not + protected in any way! It shouldn't be readable by anyone and + especially not by search-engines. Although I've added a "nofollow" + directive on every page, there may be search-engines that don't + care about that and still follow the links on the page. Think of + AltaVista following a link named "Drop Database". You can get an + overview of Apache's authentification methods at: + [32]http://www.apacheweek.com/features/userauth + * If you don't use the extension ".php3" for your scripts, you can + use the bundled script extchg.sh to modify phpMyAdmin (or any + other script) to work with a different extension. Beware though, + that currently changing the extension from .html to something + other won't work (it'd change all "string".htmlspecialchars() + constructs). + + Upgrading from an older version: + * Please do not copy your older config.inc.php3 over the new one: it + may offer new configuration variables, and the new version may + depend on these for normal behavior. It is suggested instead to + insert your site values in the new one. + ______________________________________________________________________ + + [33]Top - [34]Requirements - [35]Introduction - [36]Installation + - [37]Configuration - [38]FAQ - [39]Developers - [40]Credits + ______________________________________________________________________ + +Configuration + + All configurable data is placed in config.inc.php3. + + $cfgServers array + Since version 1.4.2, phpMyAdmin supports the administration of + multiple MySQL-server. Therefore, a $cfgServers-array has been + added which contains the login information for the different + servers. $cfgServers[1]['host'] contains the hostname of the + first server, $cfgServers[2]['host'] the hostname of the second + server, etc. If you have only one server to administer, simply + leave free the hostname of the other $cfgServer-entries. + + $cfgServers[n]['host'] string + The hostname of your n-th MySQL-server. E.g. localhost. + + $cfgServers[n]['port'] string + The port-number of your n-th MySQL-server. Default is 3300 + (leave blank). + + $cfgServers[n]['adv_auth'] boolean + Whether basic or advanced authentication should be used for + this server. + Basic authentication ($adv_auth = false) is the plain old way: + username and password are stored in config.inc.php3. Advanced + authentication ($adv_auth = true) as introduced in 1.3.0 allows + you to log in as any valid MySQL user via HTTP-Auth. + Please note that this authentication mode is only supported + with PHP running as an Apache module, and not with cgi. + Using advanced authentication is recommended: + + + when phpMyAdmin is running in a multi-user environment where + people have shell-access that you don't want to know the + username/password for MySQL. + + when you want to give users access to their own database and + don't want them to play around with others. + + Advanced authentication is secure as the standard user needs + just read-only-access to the mysql database. MySQL passwords + cannot be decrypted easily, so there's no chance for a normal + user to look at other users' plaintext passwords. + All you have to provide in config.inc is a standard user which + can connect to MySQL and read the mysql user/db table (see + $cfgServers[n]['stduser']). + See also the FAQ section for more information about security. + + $cfgServers[n]['stduser'] string + $cfgServers[n]['stdpass'] string + A user/pasword pair used to verify the real user/password pair + when using advanced authentification. This user must be able to + connect to MySQL and read the mysql user table. + Not needed when using basic authentification. + + $cfgServers[n]['user'] string + $cfgServers[n]['password'] string + The user/password-pair which phpMyAdmin will use to connect to + this MySQL-server when using basic authentification. + Not needed when using advanced authentification. + + $cfgServers[n]['only_db'] string + If set to a database name, only this database will be shown to + the user. + + $cfgServers[n]['verbose'] string + Only useful when using phpMyAdmin with multiple server entries. + If set, this string will be displayed instead of the hostname + in the pulldown menu on the main page. This can be useful if + you want to show only certain databases on your system, for + example. + + $cfgServers[n]['bookmarkdb'] string + $cfgServers[n]['bookmarktable'] string + Since release 2.2.0 phpMyAdmin allows to bookmark queries. This + can be useful for queries you often run. + To use this functionality you have to: + + + create a table following this scheme: + CREATE TABLE bookmark ( + id int(11) DEFAULT '0' NOT NULL auto_increment, + dbase varchar(255) NOT NULL, + user varchar(255) NOT NULL, + label varchar(255) NOT NULL, + query text NOT NULL, + PRIMARY KEY (id) + ); + + then complete the two variables $cfgServers[n]['bookmarkdb'] + and $cfgServers[n]['bookmarktable'] so phpMyAdmin will be + able to find the bookmark table. + + $cfgServerDefault integer + If you have more than one server configured, you can set + $cfgServerDefault to any one of them to autoconnect to that + server when phpMyAdmin is started, or set it to 0 to be given a + list of servers without logging in. + If you have only one server configured, $cfgServerDefault MUST + be set to that server. + + $cfgManualBase string + If set to an URL which points to the MySQL documentation, + appropriate help links are generated. + + $cfgConfirm boolean + Whether a warning ("Are your really sure..") should be + displayed when you're about to loose data. + + $cfgPersistentConnections boolean + Whether persistent connections should be used or not + (mysql_connect or mysql_pconnect). + + $cfgBorder integer + The size of a table's border. + + $cfgThBgcolor string [HTML color] + The color (HTML) used for table headers. + + $cfgBgcolorOne string [HTML color] + The color (HTML) #1 for table rows. + + $cfgBgcolorTwo string [HTML color] + The color (HTML) #2 for table rows. + + $cfgMaxRows integer + Number of rows displayed when browsing a resultset. If the + resultset contains more rows, Previous/Next links will be + shown. + + $cfgOrder string ["DESC"|"ASC"] + Defines whether fields are displayed in ascending ("ASC") order + or in descending ("DESC") order when you click on the + field-name. + + $cfgShowBlob boolean + Defines whether BLOB fields are shown when browsing a table's + content or not. + + $cfgProtectBlob boolean + Defines whether BLOB fields are protected from edition when + browsing a table's content or not. + + $cfgShowSQL boolean + $cfgShowSQL boolean + Defines whether sql-queries generated by phpMyAdmin should be + displayed or not. + + $cfgTextareaCols integer + Number of columns for the textareas. + + $cfgTextareaRows integer + Number of rows for the textareas. + + $cfgModifyDeleteAtLeft boolean + $cfgModifyDeleteAtRight boolean + Defines the place where modify and delete links would be put + when tables contents are displayed (you may have them displayed + both at the left and at the right). + + $cfgSkipLockedTables boolean + Mark used tables and make it possible to show databases with + locked tables (since 3.23.30). + + $cfgLeftWidth integer + Left frame width in pixel. + + $cfgDefaultLang string + Defines the default language to use, if not browser-defined or + user-defined. + See the select_lang.inc.php3 script to know the valid values + for this setting. + + $cfgLang string + Force: always use this language (must be defined in the + select_lang.inc.php3 script). + + $cfgOBGzip boolean + Defines whether to use gzip output buffering for increased + speed in HTTP transfers. + + $cfgColumnTypes array + All possible types of a MySQL column. In most cases you don't + need to edit this. + + $cfgFunctions array + A list of functions MySQL supports. In most cases you don't + need to edit this. + + $cfgAttributeTypes array + Possible attributes for fields. In most cases you don't need to + edit this. + ______________________________________________________________________ + + [41]Top - [42]Requirements - [43]Introduction - [44]Installation + - [45]Configuration - [46]FAQ - [47]Developers - [48]Credits + ______________________________________________________________________ + +FAQ - Frequently Asked Questions + + The error message "Warning: Cannot add header information - headers + already sent by ..." is displayed, what's the problem? + Look at the end of your config.inc.php or .php3 file, there must be no + blank lines or spaces after the ?>. + + I can't insert new rows into a table - MySQL brings up a SQL-error. + Examine the SQL error with care. I've found that many programmers + specifying a wrong field-type. + Common errors include: + * Using VARCHAR without a size argument + * Using TEXT or BLOB with a size argument + + Also, look at the syntax chapter in the MySQL manual to confirm that + your syntax is correct. + + 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 [49]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 edit the host information in the + config.inc.php file using the format 'host_name:socket_name'. + For example: $cfgServers[n]['host'] = 'localhost:/tmp/mysql.sock'; + + phpMyAdmin always gives "Access denied" when using advanced + authentification. + This could happen for some reasons: + * $stduser/$stdpassword is wrong. Try to turn off $adv_auth and use + this username and password to connect to MySQL. + * The username/password your specify in the login-dialog is wrong. + Try the same as above and see if it works. + * You have already setup a security mechanism for the + phpMyAdmin-directory, eg. a .htaccess file. This would interfere + with phpMyAdmin's authentification, so remove it. + + 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/phpmy + admin login + [Password: simply press the Enter key] + cvs -z3 + -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy + admin checkout phpMyAdmin + or + cvs -z3 + -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy + admin checkout phpMyAdmin-devel + [This will create a new sub-directory named phpMyAdmin or + phpMyAdmin-devel] + * add your stuff + * put the modified files (tar'ed and gzip'ed) inside the patch + tracker of the [50]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 file DEVELOPERS. + + 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 authentification 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 ot 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's + advanced authentication. phpMyAdmin performs these steps, when + authenticating a user: + 1. Select all entries from the mysql.user table where the + username/password matches the challenging user. If no rows are + returned, the authentication has failed. Otherwise, phpMyAdmin + continues with step 2. + 2. If the user's global Select_Priv is "N" (ie the user is not + allowed to access all databases), phpMyAdmin searches the mysql.db + table for entries with Select_Priv = "Y" belonging to the user. If + no entries are found, the authentication has failed. Otherwise, + phpMyAdmin shows all databases the user is allowed to view. + If the user's global Select_Priv is "Y", all databases in the + system are shown. + + This means that you need to add a user to the mysql database as + following: + INSERT INTO user (Host, User, Password, 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) VALUES ('localhost', 'foo', PASSWORD('bar'), + 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N') + INSERT INTO db (Host, Db, User, Select_priv, Insert_priv, Update_priv, + Delete_priv, Create_priv, Drop_priv, Grant_priv, References_priv, + Index_priv, Alter_priv) VALUES ('localhost', 'foo_db', 'foo', 'Y', + 'Y', 'Y', 'Y', 'Y', 'Y', '', '', '', '') + Then only the "foo_db" database will be displayed to user "foo". + + How can I GZip or Bzip a dump or a CSV export. It seem 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 + Zlib/Bzip2 support (--with-zlib and --with-bz2). + + I try to insert a text file in a table, and I get: + Error MySQL said: The file '/tmp/phpkvpp60' must be in the database + directory or be readable by all + 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). If this directory is not readable by all, the MySQL server + (which must be running on the same machine) cannot open the file + (except if running as root, which is not recommended). + The system administrator can do a "chmod 777 /tmp": then the MySQL + server will accept to read it. Also, the user must have File + privilege. + + 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? + So the problem is that this packaged has a serious bug that was + corrected ages ago in php (2001-01-28: see [51]php's bug tracking + system for more details). The problem is that the bugged package is + still available though it was corrected (see [52]redhat's bugzilla for + more details). + So please download [53]the fixed package and the problem should go + away. + And that fixes the \r\n problem with file uploads! + ______________________________________________________________________ + + [54]Top - [55]Requirements - [56]Introduction - [57]Installation + - [58]Configuration - [59]FAQ - [60]Developers - [61]Credits + ______________________________________________________________________ + +Developers Information + + phpMyAdmin is Open Source, so you're invited to contribute to it. Many + great features have been written by other people and you too can help + to make phpMyAdmin a useful tool. + + If you're planning to contribute source, please read the following + information: + * All files include header.inc.php3 (layout), lib.inc.php3 (common + functions) and config.inc.php3. + All configuration data belongs in config.inc.php3. Please keep it + free from other code. + Commonly used functions should be added to lib.inc.php3. + * Obviously, you're free to use whatever coding style you want. But + please try to keep your code as simple as possible: beginners are + using phpMyAdmin as an example application. + By the way, we're currently updating all the scripts so they will + be XHTML1.0 and CSS2 compliant on one hand, they will fit [62]PEAR + coding standards on the other hand. Please pay attention to this. + * Please try to keep up the file-naming conventions. Table-related + stuff goes to tbl_*.php3, db-related code to db_*.php3 and so on. + * Please don't use verbose strings in your code, instead add the + string (at least) to english.inc.php3 and print() it out. + * If you want to be really helpful, write an entry for the + ChangeLog. + + IMPORTANT: With 1.4.1, development has switched to CVS. The following + method is preferred for new developers: + * fetch the current CVS tree over anonymous CVS: + cvs + -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy + admin login + [Password: simply press the Enter key] + cvs -z3 + -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy + admin checkout phpMyAdmin + or + cvs -z3 + -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy + admin checkout phpMyAdmin-devel + [This will create a new sub-directory named phpMyAdmin or + phpMyAdmin-devel] + * add your stuff + * put the modified files (tar'ed and gzip'ed) inside the patch + tracker of the phpMyAdmin SourceForge account + ([63]http://sourceforge.net/projects/phpmyadmin/) + + Write access to the CVS tree is granted only to developers who have + already contributed something useful to phpMyAdmin. If you're + interested in that, please contact us using the phpmyadmin-devel + mailing list. + ______________________________________________________________________ + + [64]Top - [65]Requirements - [66]Introduction - [67]Installation + - [68]Configuration - [69]FAQ - [70]Developers - [71]Credits + ______________________________________________________________________ + +Credits + +CREDITS, in chronological order +------------------------------- + +[tr] - Tobias Ratschiller + * creator of the phpmyadmin project + * maintainer from 1998 to summer 2000 + +[md] - Marc Delisle + * multi-language version + * various fixes + +[om] - Olivier Müller + * started sourceforge phpMyAdmin project + * sync'ed different existing CVS trees with new features and bugfixes + * current project maintainer, with Marc and Loic + +[lc] - Loïc Chapeaux + * rewrote and optimized javascript, DHTML and DOM stuff + * started to rewrite the scripts so they fit the PEAR coding standards + and generate XHTML1.0 and CSS2 compliant codes + * improved the language detection system + * bugfixes + +[mg] - Mirko Giese + +[rj] - Robin Johnson + * Database maintence controls + * Table type code + +[af] - Armel Fauveau + * Bookmarks feature + * Multiple dump feature + * Gzip dump feature + +[kc] - Korakot Chaovavanich +[pk] - Pete Kelly + +[sa] - Steve Alberty + * rewrote dump code for PHP4 + * MySQL Table Statistics + +Benjamin Gandon is the main author of the version +2.1.0.1 + +The following people have contributed minor changes, enhancements, bugfixes or +or support for a new language since version 2.1.0: +Ricardo ?, Sven-Erik Andersen, Alessandro Astarita, Borges Botelho, +Olivier Bussier, Michal Cihar, Neil Darlow, Kristof Hamann, Thomas Kläger, +Lubos Klokner, +Martin Marconcini, Girish Nair, David Nordenberg, Bernard M. Piller, +Laurent Haas, "Sakamoto", www.securereality.com.au, Michael Tacelosky, +Daniel Villanueva, Vinay, Chee Wai, Thomas Michael Winningham. + + +Original Credits of Version 2.1.0 +--------------------------------- + + This work is based on Peter Kuppelwieser's MySQL-Webadmin. It was his idea + to create a web-based interface to MySQL using PHP3. Although I have not + used any of his source-code, there are some concepts I've borrowed from + him. phpMyAdmin was created because Peter told me he wasn't going to + further develop his (great) tool. + Thanks go to + - Amalesh Kempf who contributed the code + for the check when dropping a table or database. He also suggested that + you should be able to specify the primary key on tbl_create.php3. To + version 1.1.1 he contributed the ldi_*.php3-set (Import text-files) as + well as a bug-report. Plus many smaller improvements. + - Jan Legenhausen : He made many of the changes that + were introduced in 1.3.0 (including quite significant ones like the + authentification). For 1.4.1 he enhanced the table-dump feature. Plus + bug-fixes and help. + - Marc Delisle made phpMyAdmin + language-independent by outsourcing the strings to a separate file. He + also contributed the French translation. + - Alexandr Bravo who contributed + tbl_select.php3, a feature to display only some fields from a table. + - Chris Jackson added support for MySQL functions + in tbl_change.php3. He also added the "Query by Example" feature in 2.0. + - Dave Walton added support for multiple + servers and is a regular contributor for bug-fixes. + - Gabriel Ash contributed the random access + features for 2.0.6. + The following people have contributed minor changes, enhancements, bugfixes + or support for a new language: + Jim Kraai, Jordi Bruguera, Miquel Obrador, Geert Lund, Thomas Kleemann, + Alexander Leidinger, Kiko Albiol, Daniel C. Chao, Pavel Piankov, + Sascha Kettler, Joe Pruett, Renato Lins, Mark Kronsbein, Jannis Hermanns, + G. Wieggers. + + And thanks to everyone else who sent me email with suggestions, bug-reports + and + or just some feedback. + ______________________________________________________________________ + + [72]Top - [73]Requirements - [74]Introduction - [75]Installation + - [76]Configuration - [77]FAQ - [78]Developers - [79]Credits + ______________________________________________________________________ + + [80]Valid XHTML 1.0! [81]Valid CSS! + +References + + 1. http://www.phpwizard.net/projects/phpMyAdmin/ + 2. http://phpmyadmin.sourceforge.net/ + 3. file://localhost/home/om/www/phpMyAdmin/ChangeLog + 4. file://localhost/home/om/www/phpMyAdmin/INSTALL + 5. file://localhost/home/om/www/phpMyAdmin/README + 6. file://localhost/home/om/www/phpMyAdmin/CREDITS + 7. file://localhost/home/om/www/phpMyAdmin/LICENSE + 8. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 9. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 10. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 11. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 12. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 13. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 14. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 15. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 16. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 17. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 18. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 19. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 20. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 21. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 22. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 23. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 24. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 25. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 26. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 27. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 28. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 29. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 30. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 31. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 32. http://www.apacheweek.com/features/userauth + 33. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 34. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 35. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 36. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 37. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 38. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 39. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 40. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 41. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 42. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 43. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 44. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 45. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 46. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 47. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 48. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 49. http://www.phpwizard.net/phorum/list.php?f=1 + 50. https://sourceforge.net/projects/phpmyadmin/ + 51. http://www.php.net/bugs.php?id=8966 + 52. http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=24933 + 53. http://people.redhat.com/nalin/test/php-4.0.4pl1-7.i386.rpm + 54. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 55. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 56. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 57. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 58. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 59. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 60. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 61. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 62. http://pear.php.net/ + 63. http://sourceforge.net/projects/phpmyadmin/ + 64. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 65. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 66. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 67. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 68. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 69. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 70. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 71. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 72. file://localhost/home/om/www/phpMyAdmin/Documentation.html#top + 73. file://localhost/home/om/www/phpMyAdmin/Documentation.html#require + 74. file://localhost/home/om/www/phpMyAdmin/Documentation.html#intro + 75. file://localhost/home/om/www/phpMyAdmin/Documentation.html#setup + 76. file://localhost/home/om/www/phpMyAdmin/Documentation.html#config + 77. file://localhost/home/om/www/phpMyAdmin/Documentation.html#faq + 78. file://localhost/home/om/www/phpMyAdmin/Documentation.html#developers + 79. file://localhost/home/om/www/phpMyAdmin/Documentation.html#credits + 80. http://validator.w3.org/check/referer + 81. http://jigsaw.w3.org/css-validator/ diff --git a/INSTALL b/INSTALL index 148b4ef3f..29bc6de01 100755 --- a/INSTALL +++ b/INSTALL @@ -1,53 +1,9 @@ $Id$ phpMyAdmin - Installation +------------------------- - Preface: - phpMyAdmin can administer a whole MySQL-server (needs a super-user) - but also a single database. To accomplish the latter you'll need - a properly set up MySQL-user who can read/write only the desired - database. It's up to you to look up the appropiate part in the - MySQL manual. + Please have a look to the Documentation.txt or + Documentation.html files. - Quick Install: - [1] Untar the distribution (be sure to untar the subdirectories) - tar xvf phpMyAdmin_x.x.x.tar - [2] Open the file config.inc.php3 in your favourite editor and change - the values for host, user and password to fit your environment. - Have a lok at Documentation.html for an explanation of all values. - [3] It is recommended that you protect the directory in which - you installed phpMyAdmin (unless it's on a closed intranet), - for example with HTTP-AUTH (in a .htaccess-file). - [4] Open the file //index.php3 - in your browser. phpMyAdmin should now display a welcome screen - and your databases. - Bookmarks: - To use the new bookmarks feature, you will have to create a new - db and table on your system, and to type the informations in - config.ini.php3. Table definition: - - CREATE TABLE bookmark ( - id int(11) DEFAULT '0' NOT NULL auto_increment, - dbase varchar(255) NOT NULL, - user varchar(255) NOT NULL, - label varchar(255) NOT NULL, - query text NOT NULL, - PRIMARY KEY (id) - ); - - Installation notes: - + Be sure to protect the phpMyAdmin-directory. By default, it is not - protected in any way! It shouldn't be readable by anyone and - especially not by search-engines. Although I've added a "nofollow" - directive on every page, there may be search-engines that don't - care about that and still follow the links on the page. - Think of AltaVista following a link named "Drop Database" - You can get an overview of Apache's authentification methods at - http://www.apacheweek.com/features/userauth . - + If you don't use the extension ".php3" for your scripts, you can use - the bundled script "extchg.sh" to modify phpMyAdmin (or any other script) - to work with a different extension. Beware though, that currently changing - the extension from .html to something other won't work (it'd change all - "string".htmlspecialchars() constructs). - diff --git a/README b/README index 3d3cae2a4..9b8a0e03b 100755 --- a/README +++ b/README @@ -5,8 +5,8 @@ phpMyAdmin - Readme A set of PHP-scripts to adminstrate MySQL over the WWW. - Version 2.2.0 - xx/07/2001 - -------------------------- + Version 2.2.0 - August 2001 + --------------------------- http://phpwizard.net/projects/phpMyAdmin/ http://phpmyadmin.sourceforge.net/ @@ -14,7 +14,7 @@ phpMyAdmin - Readme Copyright (C) 2001- Olivier Müller Loïc Chapeaux Marc Delisle - [check CREDITS file for more details] + [check Documentation.txt/.html file for more details] This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -53,23 +53,22 @@ phpMyAdmin - Readme You can get the newest version at http://phpmyadmin.sourceforge.net/. Credits: - Please see the CREDITS file. + Please see the Documentation.txt/.html file. Installation: - Please see the INSTALL file. - For info on configuration have a look Documentation.html + Please see the Documentation.txt/.html file. ChangeLog: Now in ChangeLog Documentation: - Basic documentation available in Documentation.html + Basic documentation available in Documentation.txt/.html Support: There is a support forum under http://phpwizard.net/phorum/list.php?f=1 - Enjoy, + Enjoy! The phpMyAdmin Devel team