NotFTP v1.3.1 (02/20/2003)
by Ryan Grove <ryan@wonko.com>
------------------------------

NotFTP is a fully-featured and easy to use Web-based HTTP-FTP gateway
written in PHP. It supports all common FTP functions (including uploads) and
allows the administrator to set a maximum transfer size and a daily transfer
quota for users. It is particularly well suited for making FTP accessible to
users behind an HTTP-only proxy. In addition, NotFTP usually works right out
of the box without any configuration.


KNOWN ISSUES:
-------------

* NotFTP does not correctly parse DOS-style directory listings. Since
  most FTP servers use UNIX-style listings, this is a minor issue, but it's
  something to be aware of if you're having trouble using NotFTP to connect
  to FTP servers with DOS-style listings. Currently, the only FTP server I
  know of that does this is Microsoft IIS, although IIS can easily be
  configured to use standard UNIX-style listings.

* Several users have reported that NotFTP does not work correctly on HTTPS
  servers. Since I don't have one to do testing on, I can't confirm this
  (nor can I fix it). Sorry.


REQUIREMENTS:
-------------

* PHP 4.3.0 or higher compiled with the --enable-ftp option (the Windows
  version of PHP has FTP support built in).
* PHP compiled with OpenSSL support (if you want to be able to connect to
  SSL-FTP servers).

NotFTP works just fine under both Unix and Windows versions of Apache, and
probably works under IIS as well. Your mileage may vary.


INSTALLATION:
-------------

In most cases, NotFTP will work right out of the box with no configuration.
Just plop it into a directory on your web server and browse to it with your
favorite browser. If you'd like to tinker with the settings anyway, just
open config.php in your favorite editor and read the comments.

By default, NotFTP is configured to use passthru downloading, which is very
convenient but requires that the FTP servers you connect to support passive
connections. If you need to connect to servers that don't allow passive
connections, follow these simple steps:

	1. Create a web-accessible directory for NotFTP to store files in
	   temporarily while users download them. Make sure your webserver user
	   has read and write access to this directory.

	2. Edit config.php. Set FILEPATH to the full path of the directory you
	   just created, and set PASSTHRUDOWNLOAD to false.

With passthru downloading disabled, NotFTP will temporarily store files in a
directory while users download them. Once the user has finished downloading
the file, NotFTP will delete it. This isn't quite as convenient as passthru
downloading, which streams the file directly to the user without storing it
first, but it allows users to download from servers that don't support
passive connections.

If you want to be able to upload files via NotFTP, you'll need to make sure
you have PHP configured to allow HTTP POST file uploads. See this page for
details:

http://www.php.net/manual/en/features.file-upload.php


SECURITY:
---------

It's very important to keep in mind that anyone who has access to NotFTP via
your website is basically using *your* server and *your* connection to
connect to FTP servers. NotFTP allows you to set file transfer quotas and
size limits, but these limits are stored in cookies and any knowledgeable
user could bypass them without too much trouble. For this reason, you
shouldn't give people access to NotFTP if you don't trust them to abuse your
server.

Furthermore, since FTP connections are being made through your machine, you
may be responsible for the legality of the data being transferred depending
on your local laws. Be aware of this.

Every effort has been made to ensure that NotFTP is as secure as possible,
but you still should treat it as if you're letting someone sit down at your
computer and use an FTP client. Don't be careless.


FEEDBACK:
---------

If you have any questions, comments or suggestions, feel free to contact
the author at ryan@wonko.com. The latest version of NotFTP will always be
available at http://wonko.com/notftp/ and via http://freshmeat.net/. The
latest development version of NotFTP is always available via CVS. See the
NotFTP project at SourceForge for details: http://sf.net/projects/notftp/


--
NotFTP
Copyright (c) 2002, 2003 by Ryan Grove. All rights reserved.
OSI Certified Open Source Software

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA  02111-1307  USA
