Wallogit.com
2017 © Pedro Peláez
Implements a server-side strategy for collection and recovery of PSR-7 UploadedFile objects
kodus/tempkit-fsThis package implements a server-side strategy for temporary collection and
recovery of PSR-7 UploadedFile objects
as files stored in a Flysystem file-system., (*1)
This is a fork of kodus/tempkit which
implements the same thing using the regular file-system API in PHP., (*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)
Bootstrap the service using an existing Flysystem FilesystemInterface instance:, (*7)
$service = new TempFileService($filesystem, __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());
}
Note that, if you don't flush the temporary file, it will of course be garbage-collected after the defined expiration period., (*10)
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., (*11)
TempFileService for inline documentation.Implements a server-side strategy for collection and recovery of PSR-7 UploadedFile objects
MIT