| 1 | jonen | 1.1 |  | 
| 2 |  |  | phpHtmlLib INSTALLATION | 
| 3 |  |  |  | 
| 4 |  |  |  | 
| 5 |  |  | Introduction | 
| 6 |  |  | ============ | 
| 7 |  |  |  | 
| 8 |  |  | I have tried to make the phpHtmlLib fairly easy to install | 
| 9 |  |  | and to use on anyone's current running site.  There are a few assumptions | 
| 10 |  |  | I've made, but it shouldn't be a problem for 99% of the folks out there.  I | 
| 11 |  |  | haven't tested the libs in a windows environment, as I don't have a M$ O.S. | 
| 12 |  |  | installed anywhere in my house.  If you encounter any issues, please let me | 
| 13 |  |  | know.  I welcome any and all feedback. | 
| 14 |  |  |  | 
| 15 |  |  | Thanks and enjoy, | 
| 16 |  |  | Walt A. Boring IV | 
| 17 |  |  | waboring@buildabetterweb.com | 
| 18 |  |  |  | 
| 19 |  |  |  | 
| 20 |  |  |  | 
| 21 |  |  | Installing the libs | 
| 22 |  |  | ================================================ | 
| 23 |  |  |  | 
| 24 |  |  | 1. Overview for the impatient | 
| 25 |  |  | -------------------------- | 
| 26 |  |  |  | 
| 27 |  |  | $ mv phphtmllib <your webdir DOCUMENT_ROOT> | 
| 28 |  |  |  | 
| 29 |  |  | NOTE: in your script, set a global variable $phphtmllib to the | 
| 30 |  |  | location of your phphtml install.  If you installed it into | 
| 31 |  |  | your DOCUMENT_ROOT, you would do | 
| 32 |  |  | <?php | 
| 33 |  |  | $phphtmllib = $_SERVER["DOCUMENT_ROOT"] . "/phphtmllib"; | 
| 34 |  |  | include_once("$phphtmllib/includes.inc"); | 
| 35 |  |  | ?> | 
| 36 |  |  |  | 
| 37 |  |  | 2. Requirements | 
| 38 |  |  | ------------ | 
| 39 |  |  |  | 
| 40 |  |  | The following requirements exist for using phpHtmlLib : | 
| 41 |  |  |  | 
| 42 | jonen | 1.3 | o  PHP version 4.2.x | 
| 43 | jonen | 1.2 |  | 
| 44 |  |  | Optional | 
| 45 |  |  | o  One of phpHtmlLib's DataListSource Classes can work with | 
| 46 |  |  | PEAR and/or ADODB DB abstraction layer classes.  PEAR should | 
| 47 |  |  | already be installed if you have a proper PHP install.  You | 
| 48 |  |  | can get ADODB (much better IMHO) from | 
| 49 |  |  | http://php.weblogs.com/ADODB | 
| 50 | jonen | 1.1 |  | 
| 51 |  |  |  | 
| 52 |  |  | 3. Installing | 
| 53 |  |  | ---------- | 
| 54 |  |  |  | 
| 55 |  |  | 1. Copy the entire phphtmllib directory into your website's source | 
| 56 |  |  | tree.  I typically install it in DOCUMENT_ROOT/phphtmllib. | 
| 57 |  |  | You don't have to have it installed in the document root, but that is | 
| 58 |  |  | where I normally install it. | 
| 59 |  |  |  | 
| 60 |  |  | 2. In each script that uses the libs, you MUST set a global variable | 
| 61 |  |  | $phphtmllib to the path of your phphtmllib dir in your web tree. | 
| 62 |  |  | So, if you installed phphtmllib in your DOCUMENT_ROOT, like I do, | 
| 63 |  |  | then you set $phphtmllib = $_SERVER["DOCUMENT_ROOT"] . "/phphtmllib" | 
| 64 |  |  | I usually do this at the top of my scripts, or have a include file | 
| 65 |  |  | of defines and such that sets this. | 
| 66 |  |  |  | 
| 67 |  |  | After that you should be able to include the main includes file | 
| 68 |  |  | include_once("$phphtmllib/includes.inc"); to include all of the files | 
| 69 |  |  | in the lib, or you can include each file that you need individually | 
| 70 |  |  | to save include processing. | 
| 71 | jonen | 1.4 | 3. Optionally, review the SECURITY file if you are installing | 
| 72 |  |  | phphtmllib into a production environment. | 
| 73 | jonen | 1.1 |  | 
| 74 |  |  | 9. Contacts | 
| 75 |  |  | -------- | 
| 76 |  |  |  | 
| 77 |  |  | o All the latest updates and news will be posted on phpHtmlLib's project | 
| 78 |  |  | website at http://phphtmllib.newsblob.com | 
| 79 |  |  |  | 
| 80 |  |  | o You can always contact me by sending an email to: Walt Boring | 
| 81 |  |  | waboring@buildabetterweb.com | 
| 82 |  |  |  | 
| 83 |  |  |  | 
| 84 |  |  | Thanks for trying phpHtmlLib. | 
| 85 |  |  | Walt Boring IV | 
| 86 |  |  |  |