The following example shows how to allow the upload of a single file.

Let's assume you have a form with a file input named fileInputName:

<form method="post" enctype="multipart/form-data">
    <input type="file" name="fileInputName" id="file">
    <input type="submit" value="Upload">
</form>

In your PHP script that is called when the form is submitted, use the FileUpload class to check whether the file upload should be allowed and to get the uploaded files:

$fileUpload = new FileUpload();

// File Upload Options
$fileUpload->setInputName("fileInputName") // Set the Name of the File Input
             ->setMultiple(false) // Only allow a single File
             ->setAllowedMimeTypes(["image/jpeg", "image/png"]) // Only allow JPEG and PNG Files
             ->setMaxSize(2) // Only allow Files up to 2 MiB
             ->handleUploadedFiles();

// Check if there were Errors during the Upload
if(!($fileUpload->successful())) {
    $errors = $fileUpload->getErrors();
    return;
}

// Get the uploaded File
$uploadedFile = $fileUpload->getFiles();

If the file upload was successful, the $uploadedFile will be an array with the following structure:

[
    [0] => [
        "name" => "file.jpeg",
        "type" => "image/jpeg",
        "tmp_name" => "/tmp/php/php1h4j1o",
        "error" => 0,
        "size" => 1024
    ]
]

The following example shows how to allow the upload of multiple files.

Let's assume you have a form with a file input named fileInputName, with the multiple attribute set:

<form method="post" enctype="multipart/form-data">
    <input type="file" name="fileInputName" id="file" multiple>
    <input type="submit" value="Upload">
</form>

In your PHP script that is called when the form is submitted, use the FileUpload class to check whether the file upload should be allowed and to get the uploaded files:

$fileUpload = new FileUpload();

// File Upload Options
$fileUpload->setInputName("fileInputName") // Set the Name of the File Input
             ->setMultiple(true) // Allow multiple Files
             ->setAllowedMimeTypes(["image/jpeg", "image/png"]) // Only allow JPEG and PNG Files
             ->setMaxSize(2) // Only allow Files up to 2 MiB
             ->handleUploadedFiles();

// Check if there were Errors during the Upload
if(!($fileUpload->successful())) {
    $errors = $fileUpload->getErrors();
    return;
}

// Get the uploaded Files
$uploadedFiles = $fileUpload->getFiles();

If the file upload was successful, the $uploadedFiles will be an array with the following structure:

[
    [0] => [
        "name" => "file1.jpeg",
        "type" => "image/jpeg",
        "tmp_name" => "/tmp/php/php1h4j1o",
        "error" => 0,
        "size" => 1024
    ],
    [1] => [
        "name" => "file2.jpeg",
        "type" => "image/jpeg",
        "tmp_name" => "/tmp/php/php1h4j1o",
        "error" => 0,
        "size" => 1024
    ],
    // ...
]

The following options can be set for the file upload:

You can check whether there were errors during the file upload with the successful() method. It returns true if there were no errors and false if there was at least one error.

Errors that occur during the file upload can be retrieved with the getErrors() method. It returns them as Enum values of the UploadError class. There are the following errors: