INSTALL

   1 0. INSTALLATION
   2
   3 PhpWiki requires PHP version 3.0.9 or greater, since it uses the
   4 preg_*() family of functions.
   5
   6 Untar/gzip this file into the directory where you want it to live.
   7 That's it. To improve efficiency, edit wiki_config.php3 and set the
   8 $ServerAddress by hand; this will save a regexp call on every invocation.
   9
  10 bash$ gzip -d phpwiki-X.XX.tar.gz
  11 bash$ tar xvf phpwiki-X.XX.tar
  12
  13 Let's say you own the web server http://www.foo.com/. You untar in the
  14 server's root directory; then you should be able to just go to your new
  15 Wiki:
  16
  17 http://www.foo.com/wiki/index.php3
  18
  19 If you configure your server to recognize index.php3 as the index of a
  20 directory, you can just do:
  21
  22 http://www.foo.com/wiki/
  23
  24
  25 1. CONFIGURATION
  26
  27 PhpWiki will create two DBM files in /tmp. One contains the pages of the
  28 live site and the other has the archived pages.
  29
  30 If you don't want the DBM files to live in /tmp you must make sure the web
  31 server can read/write to it.  It's probably a bad idea to leave it in
  32 /tmp. (Again, edit wiki_config.php3).
  33
  34 For example, you create a subdirectory called "pages" in the wiki
  35 directory made when you untarred PhpWiki. Move the DBM files there, and do
  36
  37 bash$ chmod 666 wikidb wikiarchive
  38
  39 so your web server can read/write the DBM files. Then you must do
  40
  41 bash$ chmod 777 pages
  42
  43 on the "pages" directory to make sure the server can also create/set
  44 the lock file (PHP has a built in locking mechanism for DBM file access).
  45
  46 The first time you run this Wiki it will load a set of basic pages from
  47 the pgsrc/ directory. These should be enough to get your Wiki started!
  48
  49
  50 2. ALLOWING EMBEDDED HTML
  51
  52 PhpWiki ships with this featured disabled by default. According to CERT
  53 (http://www.cert.org/advisories/CA-2000-02.html) malicious users can embed
  54 HTML in your pages that allow pure evil to happen. You can uncomment the
  55 "elseif" in wiki_display.php3 to allow embedded HTML; but you should never
  56 do this if your Wiki is publically accessible.
  57
  58
  59 3. ETC
  60
  61 Installing PHP is beyond the scope of this document :-)
  62 You should visit http://www.php.net/ if you don't have PHP.
  63 Note that I have the web server configured to allow index.php3
  64 as the root document of a directory.
  65
  66 This web application was written under PHP version 3.0.12. I used
  67 a very generic installation, so hopefully you will have no problems.
  68 The development platform is a Redhat Linux 4.2 box.
  69
  70 That should be all. Send patches, bugs etc. to swain@wcsb.org.
  71
  72 FIN