| 1 |
<? |
| 2 |
include("../format.php"); |
| 3 |
printHeader("phpAiksaur: Installation"); |
| 4 |
?> |
| 5 |
|
| 6 |
<h2>phpAiksaur Installation</h2> |
| 7 |
|
| 8 |
<p>This guide will take you through installing phpAiksaur on your computer. |
| 9 |
</p> |
| 10 |
|
| 11 |
<h3>0. Install Web Server</h3> |
| 12 |
<p>If you do not already have a PHP-enabled web server, you will need |
| 13 |
to get one. I think |
| 14 |
that just about any version of PHP 3 or 4 should work, but have only tested |
| 15 |
AikSaurus with PHP 4. Please let me know of successes or failures that you |
| 16 |
may encounter. If you don't have such a server, here are links to |
| 17 |
<a href="http://www.apache.org/">Apache</a> and |
| 18 |
<a href="http://www.php.net/">PHP</a>. |
| 19 |
</p> |
| 20 |
|
| 21 |
<h3>1. Install AikSaurus Core Libraries</h3> |
| 22 |
|
| 23 |
<p>Now you need to <a href="/install.php">install the core library</a> |
| 24 |
on to your web server. Once you have installed the library, you should have a |
| 25 |
new program named <strong>CommandLineDemo</strong>. Be sure to mark down where |
| 26 |
this program is because we will need it in a few minutes. |
| 27 |
</p> |
| 28 |
|
| 29 |
|
| 30 |
<h3>2. Download phpAiksaur</h3> |
| 31 |
|
| 32 |
<p>At this point, you should <a href="source.php">download phpAiksaur</a> |
| 33 |
and extract it to somewhere that is accessible on your web server. For |
| 34 |
the rest of this document, I will assume you have extracted it so that |
| 35 |
it lives in: |
| 36 |
</p> |
| 37 |
<blockquote> |
| 38 |
<code>http://www,your-domain.com/aiksaurus/</code> |
| 39 |
</blockquote> |
| 40 |
|
| 41 |
<p>You don't need to do anything else, just extract the files and you'll |
| 42 |
be fine. |
| 43 |
</p> |
| 44 |
|
| 45 |
<h3>3. Configure phpAiksaur</h3> |
| 46 |
|
| 47 |
<p>The first thing we need to do is tell phpAiksaur where to find the |
| 48 |
<b>CommandLineDemo</b> program that you downloaded a few minutes ago. |
| 49 |
</p> |
| 50 |
|
| 51 |
<p>To do this, you should edit the file <b>phpAiksaur.php</b> and change |
| 52 |
the line that says: |
| 53 |
</p> |
| 54 |
|
| 55 |
<blockquote> |
| 56 |
<code>define(EXEC_PATH, "./CommandLineDemo");</code> |
| 57 |
</blockquote> |
| 58 |
|
| 59 |
<p>To match your system.</p> |
| 60 |
|
| 61 |
<p><strong>NOTE</strong>: Due to the peculiarities of autoconf/automake, the |
| 62 |
<b>CommandLineDemo</b> program that gets created in the main directory is actually |
| 63 |
just a shell script that points to <code>./libs/CommandLineDemo</code>. If you are going to |
| 64 |
move the CommandLineDemo somewhere else, say, into <code>your-domain.com/aiksaurus</code>, |
| 65 |
you will need to move the program that is in <code>./libs</code> instead of the shell |
| 66 |
script. |
| 67 |
</p> |
| 68 |
|
| 69 |
<p>Example: if you built AikSaurus in <code>/home/jared/AikSaurus-0.XX</code>, you will |
| 70 |
want to run the following commands:</p> |
| 71 |
<blockquote> |
| 72 |
<code> |
| 73 |
$ cd /home/jared/AikSaurus-0.XX<br> |
| 74 |
$ [./configure; make; make install]<br> |
| 75 |
$ cd .libs<br> |
| 76 |
$ mv CommandLineDemo /path/to/phpAiksaur/ |
| 77 |
</code></blockquote> |
| 78 |
|
| 79 |
<p>And that's all the configuration you should have to do.</p> |
| 80 |
|
| 81 |
<h3>4. Testing</h3> |
| 82 |
|
| 83 |
<p>Now it's just a matter of testing out your installation. You should be |
| 84 |
able to just point your web browser at: <code> |
| 85 |
<blockquote> |
| 86 |
<code>http://www.your-server.com/aiksaurus/index.php</code> |
| 87 |
</blockquote> |
| 88 |
<p>You should now be seeing a simple page that lets you test your installation. |
| 89 |
Go ahead and make sure everything works, then customize to your heart's |
| 90 |
content. |
| 91 |
</p> |
| 92 |
|
| 93 |
<h3>If you need help</h3> |
| 94 |
|
| 95 |
<p>If you run into problems not covered here or have any questions, go ahead |
| 96 |
and email me at <a href="mailto:[email protected]">[email protected]</a>. |
| 97 |
</p> |
| 98 |
|
| 99 |
<? |
| 100 |
printFooter(); |
| 101 |
?> |
| 102 |
|