Jaxon

•    Version 4.x
•    Version 3.x
•    Version 2.x

A call to a class or a function can also transfer one or many files from the browser to the application, and save them into a configured directory.

The Jaxon upload function uses the javascript FormData object to encapsulate the uploaded files, as well as the other parameters of the Jaxon call, into an HTTP Ajax request. For the browsers that do not have the FormData class available, files are uploaded using an HTTP POST request in an iframe.

How it works

In order to be able to upload files with Jaxon, an input field must first be defined in the HTML code, and have an attribute type of value file, and the id and name attributes defined.

<form>
    <input type="file" id="upload_example" name="example_file" />
</form>

Multiple files upload is supported.

<form>
    <input type="file" id="upload_example" name="example_files[]" multiple="multiple" />
</form>

Then, the id of the input field must be passed as parameter when registering the class which implements the method that processes the uploaded files.

$jaxon->register(Jaxon::CALLABLE_CLASS, Upload::class, [
    'saveFile' => [
        'upload' => "'upload_example'"
    ]
]);

And when registering a directory,

$jaxon->register(Jaxon::CALLABLE_DIR, '/the/class/dir', [
    Upload::class => [
        'saveFile' => [
            'upload' => "'upload_example'"
        ]
    ]
]);

At the end, the uploaded files are available in the Jaxon class method.

class Upload
{
    public function saveFile()
    {
        $response = new Response;

        // Get uploaded files
        $aUploadedFiles = jaxon()->upload()->files();

        return $response;
    }
}

class Upload extends JaxonCallable
{
    public function saveFile()
    {
        // Get uploaded files
        $aUploadedFiles = $this->files();

        return $this->response;
    }
}

The call to jaxon()->upload()->files() returns an array where the key is the name attribute of the input field, and the value is an array of objects of class Jaxon\Request\Support\UploadedFile, each representing an uploaded file.

Configuration

The configuration options of the upload feature define the directory where the uploaded files are saved, and the conditions they must match in order to be accepted. The matching conditions are related to their type, extension and size.

The options that apply to all uploaded files are defined in the upload.default section.

• upload.default.dir: the directory where the files are saved.
• upload.default.types: an array of accepted mime types.
• upload.default.extensions: an array of accepted extensions.
• upload.default.max-size: the accepted maximum size.
• upload.default.min-size: the accepted minimum size.

The directory defined by upload.default.dir option must exist and be writable. The other options are not checked if they are undefined.

Options can also be defined that apply only to a specific file. In this case, the default string in the option name is replaced by the name attribute of the input field of the uploaded file, prepended with files..

In the previous example, the upload.files.example_files.dir option defines a different directory.

Upload with iframe

When the FormData class is not available in the browser, the files are uploaded using a simple HTTP POST request in an iframe in a first request, and the Jaxon function is called in a second request.

The HTTP request which transfers the file is sent to the same URI defined for Jaxon request, and processed by the same function.

if($jaxon->canProcessRequest())
{
    // Process the request.
    $jaxon->processRequest();
}

Between the two requests, Jaxon saves data into a temporary file located in the directory defined by the upload.default.dir config option, which must therefore be writable.