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.

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="file" id="file" />

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. ...
    }
}