What is mod_uploader

mod_uploader is a file upload application works as Apache module. The following features are provided:

• It works faster than the thing made with Perl or PHP or Ruby, because it is made with C++ and works as Apache module.
• It includes simple template engine, so you can change page layouts without re-compilation.
• it can show progress report when uploading.

Demo

http://acapulco.dyndns.org:7070/up/ (in Japanese)

Preparing system

mod_uploader works on Unix-like systems such as Linux, FreeBSD, and Max OSX. ( Windows edition is here)

• Apache 2.0 or later
• GNU Compiler Collection 3.3 or later, or Intel C++ Compiler for Linux 9.1 or later
• GNU Make 3.8 or later
• GNU Libtool 1.5 or later
• ImageMagick 6.0 or later

mod_uploader is developed under Gentoo Linux Kernel 2.6.20 , GCC 3.4.5 , Apache 2.0.58, and ImageMagick 6.3.3.

License

mod_uploader is distributed under the terms of The zlib/libpng License.

Download

• mod_uploader-3.1.1.tgz

Getting a CVS checkout

You can checkout mod_uploader from SoutceForge. To do so, simply use the following commands:

$ cvs -d:pserver:anonymous@cvs.sourceforge.jp:/cvsroot/mod-uploader login
$ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.jp:/cvsroot/mod-uploader checkout -P mod_uploader

And, you can Browse the CVS repository of this project with your web browser.

ChangeLog

ChangeLog

Building

If you use GNU Compiler Collection, use the following commands:

$ ./configure
$ make

If you use Intel C++ Compiler, use the following commands:

$ env CC=icc ./configure
$ make

$ ./configure
$ make

$ ./configure
$ gmake

$ ./configure
$ env MACOSX_DEPLOYMENT_TARGET=10.4 make

Installation

$ su
# make -f GNUmakefile.apache install

Setting

Add the following setting to the apache configuration file (.htaccess is not permitted).

<Location "Place where uploader is set up (URL path, not file system path)">
    SetHandler                     uploader

    UploaderDataDirectory          Path of the direcory where meta data is saved
    UploaderFileDirectory          Path of the direcory where file is saved
    UploaderThumbDirectory         Path of the direcory where thumbnail image is saved
    UploaderTempDirectory          Path of the direcory where temporary file is saved

    UploaderTotalFileSizeLimit     Limit of total file size (KB)
    UploaderTotalFileNumberLimit   Limit of number of files
    UploaderFileSizeLimit          Limit of size per file (KB)
    UploaderPerPageItemNumber      Number of files showed in one page

    UploaderIndexViewTemplate      Template of top page (use index.htm)
    UploaderInfoViewTemplate       Template of info page (use info.htm)
    UploaderProgressViewTemplate   Template of progress reporting page (use progress.htm)
    UploaderDownloadViewTemplate   Template of download page (use download.htm)
    UploaderThumbnailViewTemplate  Template of thumbnail page (use thumbnail.htm)
    UploaderAdminViewTemplate      Template of administration page (use admin.htm)
    UploaderErrorViewTemplate      Template of error page (use error.htm)
</Location>
<Location "Place where uploader is set up (URL path, not file system path)"/admin>
    Order                   Deny,Allow
    Deny                    From All
    Allow                   From 127.0.0.1
</Location>

UploaderBaseUrl             The URL of uploader

Please use index.htm, info.htm, progress.htm, download.htm, thumbnail.htm, admin.htm, and error.htm that exists in the tmpl/en directory as template file.

For example, if you want to set up mod_uploader at http://foo/up/, use the following setting. Alias of /up_img, /up_css, and /up_js is not indispensable. If you do not want to edit template file, use those aliases.

<Location /up>
    SetHandler                     uploader

    UploaderBaseUrl                "http://foo/up"
    UploaderDataDirectory          "/path/to/mod_uploader/test/data"
    UploaderFileDirectory          "/path/to/mod_uploader/test/file"
    UploaderThumbDirectory         "/path/to/mod_uploader/test/thumb"
    UploaderTempDirectory          "/path/to/mod_uploader/test/temp"

    UploaderTotalFileSizeLimit     10485760
    UploaderTotalFileNumberLimit   200
    UploaderFileSizeLimit          1048576
    UploaderPerPageItemNumber      30

    UploaderIndexViewTemplate      "/path/to/mod_uploader/tmpl/en/index.htm"
    UploaderInfoViewTemplate       "/path/to/mod_uploader/tmpl/en/info.htm"
    UploaderProgressViewTemplate   "/path/to/mod_uploader/tmpl/en/progress.htm"
    UploaderDownloadViewTemplate   "/path/to/mod_uploader/tmpl/en/download.htm"
    UploaderThumbnailViewTemplate  "/path/to/mod_uploader/tmpl/en/thumbnail.htm"
    UploaderAdminViewTemplate      "/path/to/mod_uploader/tmpl/en/admin.htm"
    UploaderErrorViewTemplate      "/path/to/mod_uploader/tmpl/en/error.htm"
</Location>

<Location /up/admin>
    Order                   Deny,Allow
    Deny                    From All
    Allow                   From 127.0.0.1
</Location>

Alias /up_img                  "/path/to/mod_uploader/img"
Alias /up_css                  "/path/to/mod_uploader/css"
Alias /up_js                   "/path/to/mod_uploader/js"

Run

Star Apache as usual. Access the address you set up mod_uploader.

Run without installation

You can run mod_uploader without installation. Use the following command, and access http://localhost:8080/up/.

If you access from other computer, modify the part of localhost properly.

$ su -
# make -f GNUmakefile.apache start

If error related to LoadModule occured, please correct conf/en/apache.conf properly. To stop mod_uploader, use the following command:

# make -f GNUmakefile.apache stop

Tests

Resut of tests

API Document

http://acapulco.dyndns.org/mod_uploader/api/

Reference

[HOME]

$Id: apache.txt 2109 2006-11-26 23:11:04Z svn $