| version 1.1, 2002/11/03 23:47:00 |
version 1.2, 2002/12/03 21:05:51 |
|
|
| <!-- $Platon: phpWebFileManager/doc/sgml/introduction.sgml,v 1.4 2002/10/16 21:19:21 nepto Exp $ --> |
<!-- $Platon: phpMyEdit/doc/sgml/installation.sgml,v 1.1 2002/11/03 23:47:00 nepto Exp $ --> |
| |
|
| <chapter id="installation"> |
<chapter id="installation"> |
| <title>Installation</title> |
<title>Installation</title> |
| Line 11 In this chapter are detailed installatio |
|
| Line 11 In this chapter are detailed installatio |
|
| <title id="installation.getting-started.title">Getting started</title> |
<title id="installation.getting-started.title">Getting started</title> |
| <para> |
<para> |
| |
|
| |
<!-- OLD |
| &name; enables PHP scripters to quickly create a form for use with a MySQL |
&name; enables PHP scripters to quickly create a form for use with a MySQL |
| database table. The resulting form can be used to Add, Change, Copy, or Delete |
database table. The resulting form can be used to Add, Change, Copy, or Delete |
| records. |
records. |
| |
--> |
| |
|
| |
&name; enables PHP scripters to quickly create forms used to interact with data |
| |
stored in a MySQL database table. The procedure described below will enable you |
| |
to generate the <firstterm>calling script</firstterm> containing the database |
| |
logon and a variety of options. An included file |
| |
<filename>phpMyEdit.class.php</filename> will later manipulate MySQL records |
| |
based on user options which are configurable in the calling script. The calling |
| |
script essentially generates one form which facilitates actions that include add |
| |
record, change record, copy record, view record, delete record, etc. |
| |
|
| </para> |
</para> |
| <para> |
<para> |
| |
|
| &name; is available for download from <ulink |
&name; is available for download from <ulink |
| url="http://phpmyedit.sourceforge.net">Sourceforge.net</ulink>. Extract, or unzip, |
url="http://phpmyedit.sourceforge.net/">Sourceforge.net</ulink>. Extract, or |
| the program files to your computer's hard disk. The download file includes icons |
unzip, the program files to your computer's hard disk. The download file |
| and various language files which belong in sub-folders. |
includes icons and various language files which should be extracted into |
| |
sub-folders below the file named <filename>phpMyEdit.class.php</filename>. |
| |
|
| </para> |
</para> |
| <important><para> |
<important><para> |
| |
|
| Before installing the files on your webserver, the filenames are |
Before uploading the program files to your server, make certain that your FTP |
| case sensitive (don't force lower case upon uploading). |
client is not configured to force filenames to lower case letters. |
| |
|
| </para></important> |
</para></important> |
| <para> |
<para> |
| |
|
| Point your web browser to the file named <filename>phpMyEditSetup.php</filename> |
With the program files uploaded to your server, point your web browser to the |
| and log on to your MySQL database. The logon screen should resemble the picture |
file named <filename>phpMyEditSetup.php</filename>. You will be prompted to |
| below. |
enter your MySQL database logon (hostname, username, and password) and click the |
| |
<GUIbutton>Submit</GUIbutton> button. The logon screen should resemble the picture below. |
| |
|
| </para> |
</para> |
| <para> |
<para> |
|
|
| <title id="installation.table-selection.title">Table selection</title> |
<title id="installation.table-selection.title">Table selection</title> |
| <para> |
<para> |
| |
|
| |
<!-- OLD |
| After successfully logging on to your database server, a list of tables should |
After successfully logging on to your database server, a list of tables should |
| appear. Select a table and click Submit. |
appear. Select a table and click <GUIbutton>Submit</GUIbutton>. |
| |
--> |
| |
|
| |
After successfully logging on to a MySQL database, a list of MySQL tables will |
| |
be displayed. Select a table and click the <GUIbutton>Submit</GUIbutton> button. |
| |
|
| |
|
| |
|
| </para> |
</para> |
| <para> |
<para> |
| Line 71 appear. Select a table and click Submit. |
|
| Line 91 appear. Select a table and click Submit. |
|
| <title id="installation.id-selection.title">ID selection</title> |
<title id="installation.id-selection.title">ID selection</title> |
| <para> |
<para> |
| |
|
| |
<!-- OLD |
| |
|
| After selecting a MySQL table a list of columns, or fields, should appear. |
After selecting a MySQL table a list of columns, or fields, should appear. |
| Select a unique numeric identifier and click Submit. |
Select a unique numeric identifier and click <GUIbutton>Submit</GUIbutton>. |
| |
|
| |
--> |
| |
|
| |
After selecting a table, a list of its MySQL columns will be displayed. Select a |
| |
column that is a unique numeric identifier. The unique numeric identifier is |
| |
typically that column which is the unique auto-incremented record ID. Although |
| |
non-numeric unique identifiers are also supported, we recommend you to use |
| |
numeric one. |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
Below the list of column names you will find two input boxes containing a |
| |
suggested <GUIlabel>Page Title</GUIlabel> and suggested <GUIlabel>Base |
| |
Filename</GUIlabel>. Either accept or change the content of the input boxes. An |
| |
attempt will be made to generate a script, write the script to the base |
| |
filename, and then display the script in the web browser. |
| |
|
| </para> |
</para> |
| <para> |
<para> |
| Line 90 Select a unique numeric identifier and c |
|
| Line 129 Select a unique numeric identifier and c |
|
| <title id="installation.result-script.title">Result script</title> |
<title id="installation.result-script.title">Result script</title> |
| <para> |
<para> |
| |
|
| |
<!-- OLD |
| After selecting a unique identifier, the script should appear in your web |
After selecting a unique identifier, the script should appear in your web |
| browser. Highlight and copy the script, then paste it in your text editor. |
browser. Highlight and copy the script, then paste it in your text editor. |
| Depending on your system configuration, the script may be written to the current |
Depending on your system configuration, the script may be written to the current |
| directory. |
directory. |
| |
--> |
| |
|
| |
After clicking the <GUIbutton>Submit</GUIbutton> button, the script should |
| |
appear in your web browser along with a message indicating whether or not the |
| |
attempted disk write was successful. |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
Depending on your system configuration, the script may or may not have been |
| |
written to the directory from which <filename>phpMyEditSetup.php</filename> was |
| |
run. You will need to either open the file that was written to disk or else |
| |
highlight and copy the script from the web browser and paste it into a blank |
| |
document in your text editor. |
| |
|
| </para> |
</para> |
| <para> |
<para> |
|
|
| </mediaobject> |
</mediaobject> |
| |
|
| </para> |
</para> |
| |
<para> |
| |
|
| |
If the proposed <GUIlabel>Base Filename</GUIlabel> was "employees" and the disk |
| |
write was successful, a file named <filename>employees.php</filename> would |
| |
exist in the directory from which <filename>phpMyEditSetup.php</filename> was |
| |
run. |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
If the disk write was NOT successful and you've pasted the script into your text |
| |
editor, save the file in the same directory which contains the phpMyEdit program |
| |
files. Save the file with the <filename>.php</filename> extension. |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
Because HTML header and footer requirements vary between users, no header or |
| |
footer is generated. Add or include appropriate HTML markup as necessary (e.g. |
| |
<HTML><HEAD> [headers] </HEAD><BODY> [script] |
| |
</BODY></HTML>). By default the table will be enclosed by <div |
| |
class="main"> ... </div> which offers a degree of formatting in terms |
| |
of using CSS (cascading style sheets). |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
Once the header and footer are in place, there are script configuration options |
| |
that you should review and possibly change. |
| |
|
| |
</para> |
| </sect1> |
</sect1> |
| |
|
| </chapter> |
</chapter> |