297 lines
13 KiB
Plaintext
297 lines
13 KiB
Plaintext
# ==================================================================
|
|
# MySQLMan - web based MySQL manager.
|
|
#
|
|
# Website : http://gossamer-threads.com/
|
|
# Support : http://gossamer-threads.com/scripts/support/
|
|
# CVS Info : 087,071,086,086,085
|
|
# Revision : $Id: README,v 1.4 2002/01/04 01:39:53 alex Exp $
|
|
#
|
|
# Copyright (c) 2000 Gossamer Threads Inc. All Rights Reserved.
|
|
# Redistribution in part or in whole strictly prohibited.
|
|
# ==================================================================
|
|
#
|
|
# COPYRIGHT NOTICE:
|
|
#
|
|
# Copyright 2000 Gossamer Threads Inc. All Rights Reserved.
|
|
#
|
|
# This program is being distributed as shareware. It may be used and
|
|
# modified free of charge for personal, academic or non-profit
|
|
# use, so long as this copyright notice and the header above remain intact.
|
|
# Any commercial use should be registered. Please also send me an email,
|
|
# and let me know where you are using this script. By using this program
|
|
# you agree to indemnify Gossamer Threads Inc. from any liability.
|
|
#
|
|
# Selling the code for this program without prior written consent is
|
|
# expressly forbidden. Obtain permission before redistributing this
|
|
# program over the Internet or in any other medium. In all cases
|
|
# copyright and header must remain intact.
|
|
#
|
|
# Please check the README file for full details on registration.
|
|
# =====================================================================
|
|
|
|
Revision History:
|
|
Jan 2, 2002: Version 1.09 Released
|
|
- Previous versions where bug fixes only released inside Links
|
|
SQL and Gossamer Mail
|
|
- Fixes template path problems many people have had.
|
|
Dec 28, 2000: Version 1.05 Released
|
|
- queries can now be saved in the SQL Monitor
|
|
- results of searches/browse can now be dumped to a file
|
|
or to a screen.
|
|
- revamped to use GT libs, and removed CGI.pm use
|
|
|
|
Aug 31, 2000: version 1.04 Released
|
|
- made if possible to save results from browse/search(select)
|
|
to a delimited file.
|
|
- save query option implemented in SQL monitor
|
|
- modified insert so that the script supports older
|
|
versions of mySQL as well.
|
|
- made it optional to hide fields with type TIMESTAMP
|
|
- made it optional to confirm delete action
|
|
when deleting a single record.
|
|
- on the INSERT form, if the column type is a TEXT/BLOB,
|
|
<TEXTAREA> form is used instead of a regular input type.
|
|
|
|
Aug 23, 2000: version 1.03 Released
|
|
- modified fields select feature to import/export.
|
|
- added local import.
|
|
- added export to screen.
|
|
- made SQL monitor capable of reading local files.
|
|
- comments allowed in SQL Monitor.
|
|
- help documents available.
|
|
- tab-index added to insert record form.
|
|
- field order selection when adding fields.
|
|
- if a database names is needed for connections, then
|
|
the user will be prompted to enter a database name
|
|
for connection.
|
|
|
|
July 07, 2000: version 1.02 Released
|
|
- added direct link to database specified in config file.
|
|
- added SQL Dump
|
|
- added fields select feature to import/export.
|
|
- fixed bugs in table properties/insert new records.
|
|
|
|
May 19, 2000: version 1.01 Released
|
|
- Fixed login bug that returns incorrect "back" link.
|
|
- Made MySQLMan dirctory automatically stored in @INC.
|
|
- Made $script_url in mysql.cfg set to MySQLMan directory
|
|
automatically.
|
|
|
|
May 16, 2000: Version 1.0 Released
|
|
|
|
TABLE OF CONTENTS
|
|
|
|
1. Welcome
|
|
1.1 About the Script
|
|
1.2 Registration
|
|
2. Installation
|
|
3. Customizing the look.
|
|
4. Problems
|
|
|
|
1. Welcome
|
|
----------------------------------------------------
|
|
MySQLMan is a web based database manager. It allows you to
|
|
perform common maintenance and administration tasks in Mysql
|
|
(Mysql is a great mostly-free SQL database server). MySQLMan
|
|
was based off of PHPmyadmin, but written in Perl. It allows
|
|
you to do common tasks like:
|
|
|
|
- browse/create/drop databases
|
|
- browse/search/create/drop/alter tables
|
|
- import/export/dump data
|
|
- add/remove/alter table columns
|
|
- adsd/remove/alter table keys
|
|
|
|
1.1 Registration
|
|
|
|
MySQLMan is free to download, modify and use, however you
|
|
are not allowed to redistribute MySQLMan in any form without
|
|
prior written consent. Also, you are not allowed to remove the
|
|
MySQLMan link.
|
|
|
|
We ask that if you use MySQLMan, please let us know at:
|
|
|
|
http://www.gossamer-threads.com/scripts/register/.
|
|
|
|
2. Installation
|
|
----------------------------------------------------
|
|
You should find the following files in the archive (mysql)
|
|
and they should have the following permissions
|
|
|
|
|
|
Files:
|
|
----------
|
|
mysql.cgi (755) -rwxr-xr-x
|
|
html.pl (644) -rw-r--r--
|
|
mysql.cfg (644) -rw-r--r--
|
|
bases.pm (644) -rw-r--r--
|
|
constants.pm (644) -rw-r--r--
|
|
GT/ (755) -rwxr-xr-x
|
|
GT/* (644) -rw-r--r--
|
|
README.txt (644) -rw-r--r--
|
|
|
|
|
|
Directory:
|
|
----------
|
|
templates (755) -rwxr-xr-x
|
|
|
|
alter_col.html (644) -rw-r--r--
|
|
confirm.html (644) -rw-r--r--
|
|
create_field.txt (644) -rw-r--r--
|
|
create_table.html (644) -rw-r--r--
|
|
database.html (644) -rw-r--r--
|
|
demo_prompt.html (644) -rw-r--r--
|
|
edit.html (644) -rw-r--r--
|
|
fields_selection.txt (644) -rw-r--r--
|
|
functions.txt (644) -rw-r--r--
|
|
header.txt (644) -rw-r--r--
|
|
insert.html (644) -rw-r--r--
|
|
login.html (644) -rw-r--r--
|
|
login_back.html (644) -rw-r--r--
|
|
logout.html (644) -rw-r--r--
|
|
message.txt (644) -rw-r--r--
|
|
op_add_fields.html (644) -rw-r--r--
|
|
op_create_db.html (644) -rw-r--r--
|
|
op_create_table.html (644) -rw-r--r--
|
|
op_export.html (644) -rw-r--r--
|
|
op_import.html (644) -rw-r--r--
|
|
op_mysqldump.html (644) -rw-r--r--
|
|
op_rename_table.html (644) -rw-r--r--
|
|
op_sql_monitor.html (644) -rw-r--r--
|
|
page_jump.txt (644) -rw-r--r--
|
|
property.html (644) -rw-r--r--
|
|
sqlerr.html (644) -rw-r--r--
|
|
table.html (644) -rw-r--r--
|
|
table_browse.html (644) -rw-r--r--
|
|
table_select.html (644) -rw-r--r--
|
|
|
|
help (755) -rwxr-xr-x
|
|
|
|
(MySQLMan HTML help pages. You may need to save the 2 .jpg
|
|
files outside of the cgi-bin and change help_column_def.html
|
|
and help_insert.html accordingly.)
|
|
|
|
help_add_col.html (644) -rw-r--r--
|
|
help_browse.html (644) -rw-r--r--
|
|
help_column_def.html (644) -rw-r--r--
|
|
help_confirm.html (644) -rw-r--r--
|
|
help_create_db.html (644) -rw-r--r--
|
|
help_create_table.html (644) -rw-r--r--
|
|
help_db_list.html (644) -rw-r--r--
|
|
help_demo.html (644) -rw-r--r--
|
|
help_edit.html (644) -rw-r--r--
|
|
help_edit_col_def.html (644) -rw-r--r--
|
|
help_export.html (644) -rw-r--r--
|
|
help_home.html (644) -rw-r--r--
|
|
help_import.html (644) -rw-r--r--
|
|
help_insert.html (644) -rw-r--r--
|
|
help_login.html (644) -rw-r--r--
|
|
help_login_back.html (644) -rw-r--r--
|
|
help_login_dbname.html (644) -rw-r--r--
|
|
help_logout.html (644) -rw-r--r--
|
|
help_no_page.html (644) -rw-r--r--
|
|
help_properties.html (644) -rw-r--r--
|
|
help_rename.html (644) -rw-r--r--
|
|
help_select.html (644) -rw-r--r--
|
|
help_sql_dump.html (644) -rw-r--r--
|
|
help_sql_monitor.html (644) -rw-r--r--
|
|
help_sqlerr.html (644) -rw-r--r--
|
|
help_table_list.html (644) -rw-r--r--
|
|
help_toolbar.html (644) -rw-r--r--
|
|
|
|
col_def.jpg (644) -rw-r--r--
|
|
insert.jpg (644) -rw-r--r--
|
|
|
|
|
|
|
|
The only file that should be accessible from the net is mysql.cgi.
|
|
All requests to the script will go through mysql.cgi.
|
|
|
|
Make sure you edit mysql.cgi and check that the path to perl points to
|
|
Perl 5.003 or better.
|
|
|
|
Edit mysql.cfg and set "script_url" in %config to the URL
|
|
that mysql.cgi resides in. Please note that you may leave it as
|
|
"mysql.cgi" to make the path relative.
|
|
|
|
Now you can open your browser and go the the URL where mysql.cgi resides
|
|
in to run the script.
|
|
|
|
NOTE:
|
|
i. For all other options available in MySQLMan, please refer to the
|
|
config file mysql.cfg.
|
|
|
|
ii. All files in the "templates" directory are used for displaying HTML pages.
|
|
Please refer to section 3 "Customizing the look" of this readme file
|
|
for detail.
|
|
|
|
iii. All files in the "help" directory are HTML pages for MySQLMan.
|
|
|
|
3. Customizing the look
|
|
------------------------
|
|
alter_col.html - Change field/column specification page.
|
|
confirm.html - Confirm action page.
|
|
create_table.html - Lets the user to construct the specificaitons.
|
|
of fields/columns of the new table being created.
|
|
database.html - List the databases in MySQL.
|
|
demo_prompt.html - The demo message prompted in demo mode.
|
|
edit.html - Edit record page.
|
|
insert.html - Insert new record.
|
|
login.html - The log-in page.
|
|
login_back.html - The feedback page when a new login info is entered.
|
|
logout.html - Displays logout message.
|
|
op_add_fields.html - Prompts the user the number of new fields to be added.
|
|
op_create_db.html - Prompts the user for a name for the new database to be created.
|
|
op_create_table.html - Prompts the user for a name for the new table to be created
|
|
and the number of columns in the new table.
|
|
op_export.html - Displays the input fields for export.
|
|
op_import.html - Displays the input fields for import.
|
|
op_mysqldump.html - Displays the input fields for SQL Dump.
|
|
op_rename_table.html - Prompts the user for a new name for the current table.
|
|
op_sql_monitor.html - Displays the SQL Monitor text box.
|
|
property.html - Display the property table of the current table.
|
|
sqlerr.html - Displays error message.
|
|
table.html - Displays the list of tables in the database chosen.
|
|
table_browse.html - Search page that allows the user to compose a SELECT query.
|
|
table_select.html - This will display the result of any query that requires
|
|
records to be displayed.
|
|
|
|
create_field.txt - Sets up the input fields used when adding/updating columns
|
|
in a table.
|
|
fields_selection.txt - field selection (select lists) for import/export.
|
|
functions.txt - The list of functions that are available when inserting/editing
|
|
a record.
|
|
header.txt - The header of each page (menu bar)
|
|
message.txt - Feedback message of each action performed.
|
|
page_jump.txt - Input text field that takes the user to the page specified
|
|
in the field when viewing the the records in a table.
|
|
|
|
MySQLMan is template based. html.pl is used together with GT_Base.pl
|
|
and GT_Template to substitude variables in the templates with real
|
|
values. Variables in the templates are in the form <%variable_name%>.
|
|
For more detailed usage of GT_Templates please refer to the bottom of
|
|
GT_Templates.pm.
|
|
|
|
Each page in MySQLMan is saved as HTML pages. Therefore, if you are
|
|
comfortable with HTML tags, it should be a breeze to change the look to
|
|
the way you like it to be. Values are passed into the page where the
|
|
variables are located. As a result, all you need to do to change the
|
|
look is to move the variables around or remove them if you don't
|
|
want them to be displayed.
|
|
|
|
However, all of the tables generated by the script is created in mysql.cgi.
|
|
If you would like to change the layout of the tables, then you will have go
|
|
through the functions where the tables are created.
|
|
|
|
|
|
4. Problems
|
|
----------------------------------------------------
|
|
If you have any problems during the setup, please visit the support
|
|
forum of our website at:
|
|
|
|
http://www.gossamer-threads.com/perl/forum/
|
|
|
|
Good Luck!
|
|
|
|
Alex
|