# INSTALL

      phpHtmlLib INSTALLATION

      Introduction
      ============

      I have tried to make the phpHtmlLib fairly easy to install
      and to use on anyone's current running site.  There are a few assumptions
      I've made, but it shouldn't be a problem for 99% of the folks out there.  I
      haven't tested the libs in a windows environment, as I don't have a M$ O.S.
      installed anywhere in my house.  If you encounter any issues, please let me
      know.  I welcome any and all feedback.

      Thanks and enjoy,
      Walt A. Boring IV
      waboring@newsblob.com

      Installing the libs
      ================================================

      1. Overview for the impatient
         --------------------------

         $ mv phphtmllib <your webdir DOCUMENT_ROOT>

         NOTE: in your script, set a global variable $phphtmllib to the
               location of your phphtml install.  If you installed it into
    	     your DOCUMENT_ROOT, you would do
    	   <?php
    	      $phphtmllib = $_SERVER["DOCUMENT_ROOT"] . "/phphtmllib";
    	      include_once("$phphtmllib/includes.inc");
    	   ?>

      2. Requirements
         ------------

         The following requirements exist for using phpHtmlLib :

         o  PHP version 4.2.x

         Optional
         o  One of phpHtmlLib's DataListSource Classes can work with
            PEAR and/or ADODB DB abstraction layer classes.  PEAR should
    	already be installed if you have a proper PHP install.  You
    	can get ADODB (much better IMHO) from
    	http://php.weblogs.com/ADODB

      3. Installing
         ----------

         1. Copy the entire phphtmllib directory into your website's source
            tree.  I typically install it in DOCUMENT_ROOT/phphtmllib.
    	  You don't have to have it installed in the document root, but that is
    	  where I normally install it.

         2. In each script that uses the libs, you MUST set a global variable
            $phphtmllib to the path of your phphtmllib dir in your web tree.
    	  So, if you installed phphtmllib in your DOCUMENT_ROOT, like I do,
    	  then you set $phphtmllib = $_SERVER["DOCUMENT_ROOT"] . "/phphtmllib"
    	  I usually do this at the top of my scripts, or have a include file
    	  of defines and such that sets this.

            After that you should be able to include the main includes file
    	  include_once("$phphtmllib/includes.inc"); to include all of the files
    	  in the lib, or you can include each file that you need individually
    	  to save include processing.
         3. Optionally, review the SECURITY file if you are installing
          phphtmllib into a production environment.

      9. Contacts
         --------

         o All the latest updates and news will be posted on phpHtmlLib's project
           website at http://phphtmllib.newsblob.com

         o You can always contact me by sending an email to: Walt Boring
           waboring@newsblob.com

         Thanks for trying phpHtmlLib.
                                              Walt Boring IV

Documentation generated on Thu, 1 Sep 2005 17:05:08 -0700 by phpDocumentor 1.3.0RC3