Description

store(string $path, array $blob, ?string $as = null): ?false|int|string;

This function makes it easy for you to put the blob data returned by $_POST variable. Unlike the usual PHP upload mechanism, this application will make a copy of the data from $_FILES variable to $_POST variable and then will change its array structure to make it easier for data consumers to iterate over. This function will return the file path of the blob that was successfully moved or false if the file path already exists, or in the form of an error code, or null if the move process failed.

Let’s say you have an HTML structure of a form like this, along with the PHP code to initialize the file upload process:

<?php

if ('POST' === $_SERVER['REQUEST_METHOD']) {
    test($_FILES, $_POST);
    exit;
}

?>

<form enctype="multipart/form-data" method="post">
  <input name="blob" type="file">
  <input min="1" name="blob[height]" step="1" type="number" value="768">
  <input min="1" name="blob[width]" step="1" type="number" value="1024">
  <button type="submit">
    <?= i('Upload'); ?>
  </button>
</form>

So when you select a file and then submit the form, this is the data you will get in both variables:

$_FILES = [
    'blob' => [
        'error' => 0,
        'full_path' => 'example.png',
        'name' => 'example.png',
        'size' => 82884,
        'tmp_name' => '\tmp\php9gNNH6',
        'type' => 'image/png'
    ]
];

$_POST = [
    'blob' => [
        'height' => 768,
        'name' => 'example.png',
        'path' => '/tmp/php9gNNH6',
        'route' => null,
        'size' => 82884,
        'status' => 0,
        'type' => 'image/png',
        'width' => 1024
    ]
];

Again, let’s say you have an HTML structure of a form like this, which allows you to upload multiple files at once, along with the PHP code to initialize the file upload process:

<?php

if ('POST' === $_SERVER['REQUEST_METHOD']) {
    test($_FILES, $_POST);
    exit;
}

?>

<form enctype="multipart/form-data" method="post">
  <input multiple name="blobs[]" type="file">
  <input min="1" name="blobs[height]" step="1" type="number" value="768">
  <input min="1" name="blobs[width]" step="1" type="number" value="1024">
  <button type="submit">
    <?= i('Upload'); ?>
  </button>
</form>

So when you select multiple files and then submit the form, this is the data you will get in both variables:

$_FILES = [
    'blobs' => [
        'error' => [0, 0, 0, 0],
        'full_path' => ['example-1.png', 'example-2.png', 'example-3.png', 'example-4.png'],
        'name' => ['example-1.png', 'example-2.png', 'example-3.png', 'example-4.png'],
        'size' => [770638, 396104, 972387, 82884],
        'tmp_name' => ['\tmp\phpwkuZxh', '\tmp\phpIT8z1L', '\tmp\phpsBnxum', '\tmp\phpETAL9I'],
        'type' => ['image/png', 'image/png', 'image/png', 'image/png']
    ]
];

$_POST = [
    'blobs' => [
        '0' => [
            'name' => 'example-1.png',
            'path' => '\tmp\phpwkuZxh',
            'route' => null,
            'size' => 770638,
            'status' => 0,
            'type' => 'image/png'
        ],
        '1' => [
            'name' => 'example-2.png',
            'path' => '\tmp\phpIT8z1L',
            'route' => null,
            'size' => 396104,
            'status' => 0,
            'type' => 'image/png'
        ],
        '2' => [
            'name' => 'example-3.png',
            'path' => '\tmp\phpsBnxum',
            'route' => null,
            'size' => 972387,
            'status' => 0,
            'type' => 'image/png'
        ],
        '3' => [
            'name' => 'example-4.png',
            'path' => '\tmp\phpETAL9I',
            'route' => null,
            'size' => 82884,
            'status' => 0,
            'type' => 'image/png'
        ],
        'height' => 768,
        'width' => 1024
    ]
];

Example

Single file upload:

if ('POST' === $_SERVER['REQUEST_METHOD']) {
    $status = store('.\path\to\folder', $_POST['blob']);
    if (false === $status) {
        exit('File already exists.');
    }
    if (null === $status) {
        exit('Failed to upload due to file system errors.');
    }
    if (is_int($status)) {
        exit('Failed to upload with status code: ' . $status);
    }
    exit('File ' . $status . ' uploaded successfully.');
}

Multiple file uploads:

$values = [];
if ('POST' === $_SERVER['REQUEST_METHOD']) {
    foreach ($_POST['blobs'] as $k => $v) {
        if (!is_array($v)) {
            continue; // This data is not associated with the blob
        }
        $values[] = store('.\path\to\folder', $v);
    }
    test($values);
    exit;
}

Below is a list of file upload error codes according to the PHP manual: