Docs update for SQL validator

This commit is contained in:
Robin Johnson
2002-09-08 19:50:18 +00:00
parent e7728afa82
commit 8e5dd76b7e
2 changed files with 805 additions and 734 deletions

View File

@@ -2322,7 +2322,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
<b>[6.14] How do I set up the SQL validator?</b>
<br />
To use it, you need a very recent version of PHP, built with
XML and PEAR support. On your system command line, run
Overload, XML and PEAR support. On your system command line, run
<tt>"pear install Mail_Mime Net_DIME SOAP"</tt> to get the nessecary
PEAR modules for usage.
<br />
@@ -2331,6 +2331,9 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
strings, numbers replaced with generic values). The Mimer SQL
Validator itself, is &copy; 2001 Upright Database Technology.
We utilize it as free XML-SOAP service.
<br />
The overload module is crucial to the functionality of the validator
service.
</p>
<p>

View File

@@ -7,8 +7,8 @@
+ Version history: ChangeLog
+ General notes: README
+ License: LICENSE
* Documentation version: $Id: Documentation.html,v 1.317 2002/08/12
07:28:11 rabus Exp $
* Documentation version: $Id: Documentation.html,v 1.337 2002/09/05
12:58:16 lem9 Exp $
______________________________________________________________________
Top - Requirements - Introduction - Installation -
@@ -676,9 +676,21 @@ CRIPT_NAME'], '/')+1);
values: "tbl_properties_structure.php3", "tbl_properties.php3",
"tbl_select.php3" or "tbl_change.php3".
$cfg['ManualBaseShort'] string
If set to an URL which points to the MySQL documentation (on
short pages), appropriate help links are generated.
$cfg['MySQLManualBase'] string
If set to an URL which points to the MySQL documentation (type
depends on $cfg['MySQLManualType']), appropriate help links are
generated.
See MySQL Documentation page for more information about MySQL
manuals and their types.
$cfg['MySQLManualType'] string
Type of MySQL documentation:
+ old - old style used in phpMyAdmin 2.3.0 and sooner
+ searchable - "Searchable, with user comments"
+ chapters - "HTML, one page per chapter"
+ big - "HTML, all on one page"
+ none - do not show documentation links
$cfg['DefaultLang'] string
Defines the default language to use, if not browser-defined or
@@ -705,6 +717,17 @@ CRIPT_NAME'], '/')+1);
(by default only these which are in unicode, just to avoid
losing some characters).
$cfg['RecodingEngine'] string
You can select here which functions will be used for charset
conversion. Possible values are:
+ auto - automatically use available one (first is tested
iconv, then recode)
+ iconv - use iconv or libiconv functions
+ recode - use recode_string function
Default is auto.
$cfg['AvailableCharsets'] array
Available charsets for MySQL conversion. You can add your own
(any of supported by recode/iconv) or remove these which you
@@ -754,6 +777,10 @@ CRIPT_NAME'], '/')+1);
Number of columns and rows for the textareas.
This value will be emphasized (*2) for sql query textareas.
$cfg['TextareaAutoSelect'] boolean
Defines if the whole textarea of the query box will be selected
on click.
$cfg['LimitChars'] integer
Maximal number of Chars showed in a TEXT OR a BLOB field on
browse view. Can be turned off by a toggle button on the browse
@@ -770,6 +797,18 @@ CRIPT_NAME'], '/')+1);
There are 2 display modes: horizontal and vertical. Define
which one is displayed by default.
$cfg['UploadDir'] string
The name of the directory, ending with a slash, where SQL files
have been uploaded by other means than phpMyAdmin (for example,
ftp). Those files are available under a drop-down box when you
click the database name, then the SQL tab.
Please note that the file names must have the suffix ".sql".
This feature is useful when your file is too big to be uploaded
via HTTP, or when file uploads are disabled in PHP.
Please note that if PHP is running in safe mode, this directory
must be owned by the same user as the owner of the phpMyAdmin
scripts.
$cfg['RepeatCells'] integer
Repeat the headers every X cells, or 0 to deactivate.
@@ -914,8 +953,9 @@ FAQ - Frequently Asked Questions
[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 (3 lines) from the scripts header.inc.php3, index.php3,
left.php3 and libraries/common.lib.php3.
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?
@@ -1038,6 +1078,11 @@ FAQ - Frequently Asked Questions
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.
This is most likely because in php.ini, your file_uploads parameter is
not set to "on".
[2. Configuration]
[2.1] The error message "Warning: Cannot add header information -
@@ -1286,6 +1331,7 @@ FAQ - Frequently Asked Questions
document.
[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.
@@ -1297,32 +1343,36 @@ FAQ - Frequently Asked Questions
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
example tables:
CREATE TABLE countries (
CREATE TABLE REL_countries (
country_code char(1) NOT NULL default '',
description varchar(10) NOT NULL default '',
PRIMARY KEY (country_code)
) TYPE=MyISAM;
INSERT INTO countries VALUES ('C', 'Canada');
CREATE TABLE persons (
INSERT INTO REL_countries VALUES ('C', 'Canada');
CREATE TABLE REL_persons (
id tinyint(4) NOT NULL auto_increment,
person_name varchar(32) NOT NULL default '',
town_code varchar(5) default '0',
country_code char(1) NOT NULL default '',
PRIMARY KEY (id)
) TYPE=MyISAM;
INSERT INTO persons VALUES (11, 'Marc', 'S', '');
INSERT INTO persons VALUES (15, 'Paul', 'S', 'C');
CREATE TABLE towns (
INSERT INTO REL_persons VALUES (11, 'Marc', 'S', '');
INSERT INTO REL_persons VALUES (15, 'Paul', 'S', 'C');
CREATE TABLE REL_towns (
town_code varchar(5) NOT NULL default '0',
description varchar(30) NOT NULL default '',
PRIMARY KEY (town_code)
) TYPE=MyISAM;
INSERT INTO towns VALUES ('S', 'Sherbrooke');
INSERT INTO towns VALUES ('M', 'Montr<74>al');
INSERT INTO `PMA_relation` VALUES ('mydb', 'persons',
'town_code', 'mydb', 'towns', 'town_code');
INSERT INTO `PMA_relation` VALUES ('mydb', 'persons',
'country_code', 'mydb', 'countries', 'country_code');
INSERT INTO REL_towns VALUES ('S', 'Sherbrooke');
INSERT INTO REL_towns VALUES ('M', 'Montr<74>al');
INSERT INTO `PMA_relation` VALUES ('mydb', 'REL_persons',
'town_code', 'mydb', 'REL_towns', 'town_code');
INSERT INTO `PMA_relation` VALUES ('mydb', 'REL_persons',
'country_code', 'mydb', 'REL_countries', 'country_code');
INSERT INTO `PMA_table_info` VALUES ('mydb', 'REL_towns',
'description');
INSERT INTO `PMA_table_info` VALUES ('mydb', 'REL_countries',
'description');
Then test like this:
* Click on your db name in the left frame
* Choose "Query by example"
@@ -1410,14 +1460,25 @@ FAQ - Frequently Asked Questions
work with it, nor delete it.
[6.14] How do I set up the SQL validator?
To use it, you need a very recent version of PHP, built with XML and
PEAR support. On your system command line, run "pear install Mail_Mime
Net_DIME SOAP" to get the nessecary PEAR modules for usage.
To use it, you need a very recent version of PHP, built with Overload,
XML and PEAR support. On your system command line, run "pear install
Mail_Mime Net_DIME SOAP" to get the nessecary PEAR modules for usage.
If you use it, you should be aware that any SQL statement you submit
will be stored anonymously (database/table/column names, strings,
numbers replaced with generic values). The Mimer SQL Validator itself,
is <20> 2001 Upright Database Technology. We utilize it as free XML-SOAP
service.
The overload module is crucial to the functionality of the validator
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".
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.
[7. phpMyAdmin project]
@@ -1530,30 +1591,30 @@ phpMyAdmin - Credits
CREDITS, in chronological order
-------------------------------
[tr] - Tobias Ratschiller <tobias_at_phpwizard.net>
- Tobias Ratschiller <tobias.ratschiller_at_maguma.com>
* creator of the phpmyadmin project
* maintainer from 1998 to summer 2000
[md] - Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca>
- Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca>
* multi-language version
* various fixes and improvements
* project co-administrator
[om] - Olivier M<>ller <om_at_omnis.ch>
- Olivier M<>ller <om_at_omnis.ch>
* started SourceForge phpMyAdmin project in March 2001
* sync'ed different existing CVS trees with new features and bugfixes
* multi-language improvements, dynamic language selection
* current project maintainer
* many bugfixes and improvements
[lc] - Lo<4C>c Chapeaux <lolo_at_phpheaven.net>
- Lo<4C>c Chapeaux <lolo_at_phpheaven.net>
* rewrote and optimized javascript, DHTML and DOM stuff
* rewrote the scripts so they fit the PEAR coding standards and
generate XHTML1.0 and CSS2 compliant codes
* improved the language detection system
* many bugfixes and improvements
[rj] - Robin Johnson <robbat2_at_users.sourceforge.net>
- Robin Johnson <robbat2_at_users.sourceforge.net>
* database maintence controls
* table type code
* Host authentication IP Allow/Deny
@@ -1562,79 +1623,86 @@ CREDITS, in chronological order
* SQL validator
* many bugfixes and improvements
[af] - Armel Fauveau <armel.fauveau_at_globalis-ms.com>
- Armel Fauveau <armel.fauveau_at_globalis-ms.com>
* bookmarks feature
* multiple dump feature
* gzip dump feature
* zip dump feature
[gl] - Geert Lund <glund_at_silversoft.dk>
- Geert Lund <glund_at_silversoft.dk>
* various fixes
* moderator of the phpMyAdmin users forum at phpwizard.net
[kc] - Korakot Chaovavanich <korakot_at_iname.com>
- Korakot Chaovavanich <korakot_at_iname.com>
* "insert as new row" feature
[pk] - Pete Kelly <webmaster_at_trafficg.com>
- Pete Kelly <webmaster_at_trafficg.com>
* rewrote and fix dump code
* bugfixes
[sa] - Steve Alberty <alberty_at_neptunlabs.de>
- Steve Alberty <alberty_at_neptunlabs.de>
* rewrote dump code for PHP4
* mySQL table statistics
* bugfixes
[bg] - Benjamin Gandon <gandon_at_isia.cma.fr>
- Benjamin Gandon <gandon_at_isia.cma.fr>
* main author of the version 2.1.0.1
* bugfixes
[at] - Alexander M. Turek <rabus_at_bugfixes.info>
- Alexander M. Turek <rabus_at_bugfixes.info>
* XML exports
* MySQL 4 related features
* various small features and fixes
* German language file updates
[mb] - Mike Beck <mike.beck_at_ibmiller.de>
- Mike Beck <mike.beck_at_ibmiller.de>
* automatic joins in QBE
* links column in printview
* Relation view
[mc] - Michal Cihar <nijel_at_users.sourceforge.net>
- Michal Cihar <nijel_at_users.sourceforge.net>
* enhanced index creation/display feature
* feature to use a different charset for HTML than for MySQL
Thanks to these guys who have sent us some major improvements to merge into the
code since version 2.1.0:
* Czech language file updates
- Christophe Gesch<63> from the "MySQL Form Generator for PHPMyAdmin"
(http://sourceforge.net/projects/phpmysqlformgen/) who suggested the patch
for multiple table printviews.
- Garvin Hicking <hicking at faktor-e.de> who built the patch for
vertical display of table rows.
- Yukihiro Kawada <kawada at den.fujifilm.co.jp> for the japanese kanji
encoding conversion feature.
- Piotr Roszatycki <d3xter at users.sourceforge.net> and Dan Wilson, for
the Cookie authentication mode.
- Axel Sander <n8falke at users.sourceforge.net> for the table
relation-links feature.
- Maxime Delorme <delorme.maxime at free.fr> for the PDF schema output;
thanks also to Olivier Plathey for the "FPDF" library
(see http://www.fpdf.org/).
- Olof Edlund <olof.edlund at upright.se> for the SQL validator server.
(http://sourceforge.net/projects/phpmysqlformgen/)
* suggested the patch for multiple table printviews
- Garvin Hicking <hicking_at_faktor-e.de>
* built the patch for vertical display of table rows
- Yukihiro Kawada <kawada_at_den.fujifilm.co.jp>
* japanese kanji encoding conversion feature
- Piotr Roszatycki <d3xter_at_users.sourceforge.net> and Dan Wilson
* the Cookie authentication mode
- Axel Sander <n8falke_at_users.sourceforge.net>
* table relation-links feature
- Maxime Delorme <delorme.maxime_at_free.fr>
* PDF schema output, thanks also to Olivier Plathey for the
"FPDF" library (see http://www.fpdf.org/).
- Olof Edlund <olof.edlund_at_upright.se>
* SQL validator server
- Ivan R. Lanin <ivanlanin_at_users.sourceforfe.net>
* phpMyAdmin logo
And also to the following people who have contributed minor changes,
enhancements, bugfixes or support for a new language since version 2.1.0:
Bora Alioglu, Ricardo ?, Sven-Erik Andersen, Alessandro Astarita,
P<EFBFBD>ter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow, Laurent Dhima,
Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner, Martin Marconcini,
Girish Nair, David Nordenberg, Andreas Pauley, Bernard M. Piller, Laurent Haas,
"Sakamoto", Yuval Sarna, www.securereality.com.au,
Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky, Rachim Tamsjadi,
Kositer Uros, Lu<4C>s V., Martijn W. van der Lee, Algis Vainauskas,
Daniel Villanueva, Vinay, Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk,
Thomas Michael Winningham, Vilius Zigmantas.
P<EFBFBD>ter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow,
Laurent Dhima, Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner,
Martin Marconcini, Girish Nair, David Nordenberg, Andreas Pauley,
Bernard M. Piller, Laurent Haas, "Sakamoto", Yuval Sarna,
www.securereality.com.au, Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky,
Rachim Tamsjadi, Kositer Uros, Lu<4C>s V., Martijn W. van der Lee,
Algis Vainauskas, Daniel Villanueva, Vinay, Ignacio Vazquez-Abrams, Chee Wai,
Jakub Wilk, Thomas Michael Winningham, Vilius Zigmantas.
Original Credits of Version 2.1.0