====== Portable Nanoweb Server ======

This is a modified version of the Nanoweb PHP web server [1]. Some features
of the original distribution were removed (like multiple themes). Others
were modified to work without any absolute path settings. This version
should work from a portable medium like an USB stick without any problems.

IMPORTANT: Do not contact the original Nanoweb authors with questions
           about this particular portable hack!

Feedback can be provided to Andreas Gohr <andi@splitbrain.org>, but
this is not an actively maintained project.

===== Setup =====

This distribution is meant as starting point for application developers
who want to make their PHP application USB-portable.

On Unix envionments this distribution should work out of the box with
a preinstalled PHP-CGI version. Just call php-cgi nanoweb.php. If needed,
you can adjust the PHP path settings in conf/unix.conf

For Windows environments, download the PHP 5 Windows binaries [2] and extract
it into the php directory. The server can be started through the provided
start.bat then.

The server is preconfigured to run on port 8080 and serving files from the
www directory.

Be sure to point all PHP paths to the CGI version of PHP. The CLI version
will not work!

===== Hints ======

When building your own "on-a-stick" distribution of your application you
should delete not used modules from PHP (php/ext) and Nanoweb (modules).

You should aslo disable logging in conf/nanoweb.conf.

inetd.exe is used on Windows, because the Windows version of PHP does not
support forking. Without forking nanoweb could only serve a single request
at a time, thus the inetd mode of nanoweb is used and inetd.exe is used for
spawning processes. inetd mode is significally slower than the standalone
mode of nanoweb - a price to pay for Windows compatibility.

===== Authors and Licenses =====

  * The Nanoweb portable distribution
    * Andreas Gohr <andi@splitbrain.org>
    * Licensed under the GNU General Public License 2
  * based on Nanoweb 2.2.8
    * Vincent Negrier aka. sIX <six@aegis-corp.org>
    * Licensed under the GNU General Public License 2 or later
  * using inetd.exe [3]
    * S. Freyder
    * Licensed under a BSD-like License

===== URLs =====

[1] http://nanoweb.si.kz/
[2] http://www.php.net/downloads.php
[3] http://www.lightner.net/lightner/bruce/httpd/w95httpd.html