How To Save An Image From an URL in PHP?

Published November 8, 2024

Problem: Saving Images from URLs in PHP

Saving images from URLs using PHP is a task in web development. It involves getting an image file from a remote server and storing it locally. This can be useful for caching, data processing, or content management.

PHP Solution for Saving Images from URLs

Using file_get_contents() and file_put_contents()

The file_get_contents() function in PHP reads a file into a string. When used with a URL, it fetches the content of that URL. To save an image from a URL, you can combine this function with file_put_contents().

Here's how to use file_put_contents() to save the image:

Use file_get_contents() to get the image data from the URL
Use file_put_contents() to save the data to a file on your server

The code structure for this method is:

$url = 'http://example.com/image.php';
$img = '/my/folder/flower.gif';
file_put_contents($img, file_get_contents($url));

This method is simple and works well for smaller images. However, it requires allow_url_fopen to be enabled in your PHP configuration.

Tip: Error Handling

Add error handling to your code to manage potential issues:

$url = 'http://example.com/image.php';
$img = '/my/folder/flower.gif';
$imageData = @file_get_contents($url);
if ($imageData === false) {
    die('Failed to fetch image from URL');
}
if (file_put_contents($img, $imageData) === false) {
    die('Failed to save image');
}
echo 'Image saved successfully';

Using cURL for Image Download

cURL is a library that allows you to make HTTP requests in PHP. It's more flexible than file_get_contents() and works even if allow_url_fopen is disabled.

To set up a cURL request for image download:

Initialize a cURL session
Set the URL to download from
Set options for the download
Execute the request
Close the cURL session

Here's the code structure for using cURL to save an image:

$ch = curl_init('http://example.com/image.php');
$fp = fopen('/my/folder/flower.gif', 'wb');
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_exec($ch);
curl_close($ch);
fclose($fp);

This method gives you more control over the download process and can handle larger files more efficiently.

Alternative Approaches

Using the GD Library

The GD library in PHP is a tool for image manipulation. It lets you create, change, and save images in different formats. When saving images from URLs, GD offers another method that can be useful in some cases.

To create an image from a URL using GD:

Use imagecreatefromstring() to create an image resource from the URL content
Use an image output function (e.g., imagepng(), imagejpeg()) to save the image

Here's a code example:

$url = 'http://example.com/image.php';
$imageData = file_get_contents($url);
$image = imagecreatefromstring($imageData);

if ($image !== false) {
    imagepng($image, '/my/folder/flower.png');
    imagedestroy($image);
    echo 'Image saved successfully';
} else {
    echo 'Failed to create image from URL';
}

This method allows you to do more image processing before saving if needed.

Tip: Image Resizing with GD

You can resize the image before saving it using the GD library. Here's how:

$newWidth = 300;
$newHeight = 200;
$resizedImage = imagecreatetruecolor($newWidth, $newHeight);
imagecopyresampled($resizedImage, $image, 0, 0, 0, 0, $newWidth, $newHeight, imagesx($image), imagesy($image));
imagepng($resizedImage, '/my/folder/resized_flower.png');
imagedestroy($resizedImage);

This code resizes the image to 300x200 pixels before saving.

Implementing a Progress Bar

For big image downloads, adding a progress bar can improve user experience. You can do this using cURL with a callback function.

To add a progress bar:

Define a callback function to update the progress
Use CURLOPT_PROGRESSFUNCTION to set the callback
Enable CURLOPT_NOPROGRESS to activate the progress function

Here's a code structure for progress tracking:

function progressCallback($downloadSize, $downloaded, $uploadSize, $uploaded)
{
    if ($downloadSize > 0) {
        $percent = round($downloaded / $downloadSize * 100);
        echo "Download progress: $percent%\r";
        flush();
    }
}

$ch = curl_init('http://example.com/large-image.jpg');
$fp = fopen('/my/folder/large-image.jpg', 'wb');
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_PROGRESSFUNCTION, 'progressCallback');
curl_setopt($ch, CURLOPT_NOPROGRESS, false);
curl_exec($ch);
curl_close($ch);
fclose($fp);

This code will show a basic text-based progress bar in the console. For web applications, you might want to use JavaScript to create a visual progress bar based on the data from the server.

Example: AJAX Progress Bar

To create a visual progress bar in a web application, you can use AJAX to send progress updates to the client. Here's a basic example using jQuery:

$.ajax({
    url: 'download_image.php',
    type: 'GET',
    xhr: function() {
        var xhr = new window.XMLHttpRequest();
        xhr.addEventListener('progress', function(evt) {
            if (evt.lengthComputable) {
                var percentComplete = evt.loaded / evt.total;
                $('.progress-bar').width(percentComplete * 100 + '%');
            }
        }, false);
        return xhr;
    },
    success: function() {
        alert('Download complete!');
    }
});

This JavaScript code updates a progress bar element on the page as the image downloads.

	English
	Deutsch
	Français