Saving Blob Object As a File On Server

Saving Blob Object As a File On Server

August 29, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Saving Blob Object As a File On Server

Saving Cropped Image Blob to Server: A Comprehensive Guide

In web development, working with images often involves manipulating them on the client-side before saving them to the server. With libraries like jQuery Cropper, we can easily crop and resize images within the browser. However, when it comes to actually saving these cropped images as files on the server, many developers face challenges due to the nature of blob objects.

Understanding Blob Objects

A Blob object represents an immutable raw data. It can represent any kind of data, but is often used to represent files or file-like data streams (such as image, video, or text).

In your case, you’re using the getCroppedCanvas method from jQuery Cropper to get the cropped image as a canvas object, and then converting that canvas to a blob using the toBlob function. This gives you an object representing the image data.

Saving the Blob to the Server

To save this blob to the server, you’re using the native XMLHttpRequest with FormData. Here’s how it works:

// Get the cropped image as a blob
$('#image').cropper('getCroppedCanvas').toBlob(function (blob) {
    // Create a new FormData object and append the blob
    var formData = new FormData();
    formData.append('croppedImage', blob);
    formData.append('form_key', window.FORM_KEY);

    $.ajax('/upload.php', {
        method: "POST",
        data: formData,
        processData: false,  // Prevent jQuery from processing the data
        contentType: false,   // Let the browser send the correct content type (multipart/form-data)
        success: function (data) {
            console.log(data);
        },
        error: function (data) {
            console.log(data);
        }
    });
});

The key points to note here are:

  1. The processData and contentType options in the AJAX call are set to false. This is crucial when sending FormData because jQuery would otherwise process the data as JSON, which isn’t suitable for file uploads.

  2. We’re appending two fields to the FormData: ‘croppedImage’ containing the blob object, and ‘form_key’ containing a security token (presumably used by Magento).

The PHP Side: Saving the Blob

On the server side, you’re trying to save the blob directly using file_put_contents. However, this approach has limitations.

<?php
$blob = $_POST['croppedImage'];
//return $blob;
file_put_contents('/media/crop_products/test.png', $blob);
?>

The issue here is that PHP doesn’t support binary data in the same way server-side languages like Node.js do. While $_POST['croppedImage'] will contain the raw binary data, file_put_contents expects a string or an array of strings for writing to the file.

The Correct Approach

To properly handle blob objects on the server side, you need to use move_uploaded_file instead of file_put_contents. This function moves an uploaded file from a temporary directory to its final destination. In your case, since the “uploaded” file is a binary string in $_POST['croppedImage'], it’s not actually stored temporarily on disk. However, you can treat it as if it were by using tempnam to create a temporary file name and then moving that temporary file.

Here’s how you could modify your PHP script:

<?php
$tmpName = tempnam('/tmp', 'IMG_');
file_put_contents($tmpName, base64_decode($_POST['croppedImage']));
move_uploaded_file($tmpName, '/media/crop_products/test.png');

// Unlink the temporary file to prevent it from accumulating on disk
unlink($tmpName);
?>

In this code:

  1. We’re creating a unique temporary filename using tempnam.

  2. We’re writing the binary data from $_POST['croppedImage'] (which is base64 encoded due to being sent as part of FormData) to the temporary file using base64_decode and file_put_contents.

  3. Then, we’re moving this temporary file to its final destination using move_uploaded_file.

  4. Finally, we’re deleting the temporary file with unlink to prevent it from accumulating on disk.

Conclusion

Working with blob objects requires a careful understanding of how data is handled across the client-server boundary. On the client side, you need to ensure you’re not processing the data and sending the correct content type. On the server side, you can’t simply write binary data directly; instead, you need to treat it as if it were an uploaded file using functions like tempnam and move_uploaded_file.

Remember that this is a basic example and doesn’t include error handling or security considerations (like validating the input data). In a real-world application, especially one dealing with user-uploaded images, you would need to add proper validation and sanitization to prevent any potential security vulnerabilities.

For more detailed guides on working with files in PHP, I recommend checking out our article on File Handling in PHP: A Comprehensive Guide at LaravelCompany.

Database JavaScript CLI

Our network