Der Upload-Helper basiert auf der class.upload.php von verot.net, die wir allerdings um die Bildbearbeitungsfunktionen bereinigt haben. (Hierzu haben wir class.Images.php zur Verfügung.) Die Handhabung von Dateiuploads wird hiermit wesentlich vereinfacht.

Es existiert eine Seite mit einem Dateiupload-Formular.

Auf der Serverseite existiert ein Script - z.B. ein Modul -, welches die Dateiuploads entgegen nimmt und weiter verarbeitet.

Hat man mehrere Upload-Felder, ist das die schnellste Variante. Die hierbei festgestellten Fehler werden hierbei in Form eines Arrays zurückgeliefert. Zusätzlich erhält man ein Boolean-Result, welches false ist, wenn es Fehler gab, ansonsten true.

Codebeispiel:

$dir = CAT_PATH.'/modules/myModule/upload';
list( $ok, $errors ) = CAT_Helper_Upload::uploadAll(
    'files',
    utf8_decode(CAT_Helper_Directory::sanitizePath($dir))
);

In diesem Beispiel werden alle Dateien, die über das Formular hochgeladen wurden, in das Verzeichnis CAT_PATH/modules/myModule/upload übertragen. Der Parameter files beinhaltet den Namen des Upload-Formularfeldes.

    <input type="file" name="files" id="files" />

Die Variable $ok hat den Wert true, wenn alle Dateien erfolgreich verarbeitet werden konnten. Ist dies nicht der Fall, beinhaltet $errors eine Liste der festgestellten Fehler.

Die Verwendung von utf8_decode() stellt sicher, daß Verzeichnisnamen mit Umlauten korrekt verarbeitet werden können. Es kann genau wie CAT_Helper_Directory::sanitizePath() weggelassen werden.

Die Syntax ist in diesem Fall angelehnt an die class.upload.php, welche ja auch die Basis darstellt. Kurzform:

    CAT_Helper_Upload::getInstance(<Dateiname>)->process(<Verzeichnis>);

Ein bißchen mehr Kontrollmöglichkeiten erhält man durch eine Aufteilung der Kommandos.

// Instanz erzeugen
$current = CAT_Helper_Upload::getInstance($_FILES['file']);
// prüfen, ob die Datei tatsächlich hochgeladen wurde
if ( $current->uploaded ) {
    // ok, hochgeladene Datei in das gewünschte Verzeichnis verschieben
    $current->process(CAT_PATH.'/modules/myModule/upload');
    // Erfolg prüfen
    if ( $current->processed )
    {
        // ... usw. ...
    }
}

Mehr Informationen sind in der Original-Dokumentation zur class.upload.php zu finden:

http://www.verot.net/php_class_upload_docs.htm

Prinzipiell gelten alle Informationen, die nichts mit Bildbearbeitung zu tun haben.