Was ist mod_uploader?

mod_uploader ist eine Dateiuploader-Anwendung, die als Apache Modul arbeitet. Folgende Funktionen bietet das Modul:

• Es arbeitet schneller als die Uploader welche mit Perl, PHP oder Ruby erstellt wurden, weil es mit C++ erstellt wurde und als Apache Modul eingesetzt wird.
• Es beinhaltet eine einfache Template-Engine, so dass man das Aussehen einfach anpassen kann ohne neu zu kompilieren.
• Es kann den Fortschritt anzeigen, während die Datei hochgeladen wird.

Demo

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

System vorbereiten

mod_uploader funktioniert auf Unix-ähnlichen systemen wie Linux, FreeBSD und Max OSX. ( Die Windows Version gibt es hier)

• Apache 2.0 oder höher
• GNU Compiler Collection 3.3 oder höher, oder Intel C++ Compiler für Linux 9.1 oder höher
• GNU Make 3.8 oder höher
• GNU Libtool 1.5 oder höher
• ImageMagick 6.0 oder höher

mod_uploader wurde unter Gentoo Linux entwickelt, Kernel 2.6.20 , GCC 3.4.5 , Apache 2.0.58, und ImageMagick 6.3.3.

Lizenz

Die Distribution von mod_uploader unterliegt den Bedingungen der The zlib/libpng License.

Download

• mod_uploader-3.1.1.tgz

Sourcen über CVS holen

Man kann die Sourcen für mod_uploader bei SourceForge auschecken. Um das zu tun, verwende einfach die folgenden Befehle:

$ 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

Und, man kann auch direkt in dem CVS-Repository des Projekts navigieren mit deinem Webbrowser.

ChangeLog

ChangeLog

Kompilation

Wenn die GNU Compiler Collection verwendet wird, benutze folgende Befehle:

$ ./configure
$ make

Wenn der Intel C++ Compiler benutzt wird, verwende diese Befehle:

$ env CC=icc ./configure
$ make

$ ./configure
$ make

$ ./configure
$ gmake

$ ./configure
$ env MACOSX_DEPLOYMENT_TARGET=10.4 make

Installation

$ su
# make -f GNUmakefile.apache install

Einstellungen

Füge folgende Einstellungen zu deiner Apache config-Datei hinzu (.htaccess ist nicht erlaubt).

<Location "Der Ort wo der Uploader sich befindet (URL-Pfad, nicht der Dateisystem-Pfad)">
    SetHandler                     uploader

    UploaderBaseUrl                Die URL des Uploaders

    UploaderDataDirectory          Pfad des Verzeichnisses wo die Metadaten sich befinden
    UploaderFileDirectory          Pfad des Verzeichnisses wo die Dateien gespeichert werden
    UploaderThumbDirectory         Pfad des Verzeichnisses wo die Miniaturbilder gespeichert werden
    UploaderTempDirectory          Pfad des Verzeichnisses wo die temporären Daten gespeichert werden

    UploaderTotalFileSizeLimit     Limit für die Gesamtgrösse der Dateien (KB)
    UploaderTotalFileNumberLimit   Limit für die Anzahl der Dateien
    UploaderFileSizeLimit          Limit für die Grösse pro Datei (KB)
    UploaderPerPageItemNumber      Anzahl der Dateien, die auf einer Seite angezeigt werden

    UploaderIndexViewTemplate      Vorlage der Hauptseitee (benutze index.htm)
    UploaderInfoViewTemplate       (benutze info.htm)
    UploaderProgressViewTemplate   Vorlage der Fortschrittsanzeigeseite (benutze progress.htm)
    UploaderDownloadViewTemplate   Vorlage der Downloadseite (benutze download.htm)
    UploaderThumbnailViewTemplate  Vorlage der Miniaturansichtsseite (benutze thumbnail.htm)
    UploaderAdminViewTemplate      Vorlage der Administrationsseite (benutze admin.htm)
    UploaderErrorViewTemplate      Vorlage der Fehlerseite (benutze error.htm)
</Location>
<Location "Der Ort wo der Uploader sich befindet (URL-Pfad, nicht der Dateisystem-Pfad)"/admin>
    Order                   Deny,Allow
    Deny                    From All
    Allow                   From 127.0.0.1
</Location>

Bitte benutze index.htm, info.htm, progress.htm, download.htm, thumbnail.htm, admin.htm und error.htm die sich im tmpl/en Verzeichnis befinden als Vorlage.

Wenn man zum Beispiel up mod_uploader als http://foo/up/ einstellen will, benutzt man die folgenden Einstellungen. Alias der /up_img, /up_css und /up_js Verzeichniss is nicht unerlässlich. Wenn man nicht die Vorlagen editieren will, benutze diese Aliase.

<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"

Ausführen

Starte Apache wie immer. Wähle die URL, die für den mod_uploader eingestellt wurde.

Ausführen ohne Installation

Man kann den mod_uploader auch ohne Installation verwenden. Benutze dazu folgende Befehle und rufe anschliessend die Seite http://localhost:8080/up/ auf.

Wenn man die Seite von einem anderen PC erreichen will, ändere die Einstellung localhost entsprechend ab.

$ su -
# make -f GNUmakefile.apache start

Wenn ein Fehler betreffend LoadModule auftritt, korrigiere bitte die conf/en/apache.conf entsprechend. Um den mod_uploader zu stoppen, benutze den folgenden Befehl:

# make -f GNUmakefile.apache stop

Tests

Testergebnisse

API-Dokument

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

Hinweis

Anerkennung

Special thanks to Peter Friesen for German translation.

[HOME]

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