kodus/tempkit
This package implements a server-side strategy for temporary collection and
recovery of PSR-7 UploadedFile objects., (*1)
A dedicated FlySystem port is
also available., (*2)
, (*3)
You can use this service to implement controllers that collect uploaded files
posted asynchronously by a browser and return the temporary file UUIDs, then,
on completion, recover the uploaded files and move them to permanent storage., (*4)
The filename and MIME-type (as posted by the client) will be preserved., (*5)
Unrecovered files are automatically flushed after a defined expiration period., (*6)
Usage
Bootstrap the service:, (*7)
$service = new TempFileService(__DIR__ . '/temp');
In your asynchronous file post-controller, collect posted files and return UUIDs:, (*8)
$uuids = [];
foreach ($request->getUploadedFiles() as $file) {
$uuids[] = $service->collect($file);
}
echo json_encode($uuids);
In your form post-controller, recover the collected files:, (*9)
foreach ($uuids as $uuid) {
$file = $service->recover($uuid);
// get information about recovered file:
$filename = $file->getClientFilename();
$media_type = $file->getClientMediaType();
// move recovered file into permanent storage:
$file->moveTo(__DIR__ . '/files/' . $file->getClientFilename());
}
Alternatively, obtain the path to the temporary file and move/copy the file by other means - for
example, to import an uploaded file into FlySystem:, (*10)
$file = $service->recover($uuid);
$stream = fopen($file->getTempPath(), "r");
$filesystem->writeStream("uploads/" . $file->getClientFilename(), $stream);
fclose($stream);
$file->flush(); // optionally flush the temporary file after copying
Note that, if you don't flush the temporary file, it will of course be garbage-collected after
the defined expiration period., (*11)
Also, if you manually rename or move the temporary file, the JSON meta-data file will be collected
and flushed for you immediately when the TempFile instance is destroyed., (*12)
Refer to TempFileService for inline documentation.
Wallogit.com
