Magento - programmatically add image from url?

Magento - programmatically add image from url?

July 4, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - programmatically add image from url?

Solving Image Upload Issues in Magento

As a seasoned developer working with e-commerce platforms like Magento, I often encounter challenges when trying to programmatically add images from URLs during the product creation process. In this post, we’ll address a common issue faced by users seeking to upload an image from a URL and set it as the primary product image.

The Problem: Image Upload Fails

Let’s examine the given script that attempts to fetch an image from a remote URL and assign it to a newly created Magento product:

// Load the new product
$product = Mage::getModel('catalog/product')->load($new_product_id);

// Set the image URL
$url = 'http://media.asicdn.com/images/jpgo/6080000/6089330.jpg';
$img = '/media/catalog/product/images/image1.jpg';

// Download and save the image locally
file_put_contents($img, file_get_contents($url));

// Set media gallery and add images to the product
$product->setMediaGallery(array('images' => array(), 'values' => array()));
$product->addImageToMediaGallery($img, array('image', 'small_image', 'thumbnail'), false, false);

// Save the product
Mage::app()->setCurrentStore(Mage_Core_Model_App::ADMIN_STORE_ID);
$product->save();

However, this script encounters an error when it tries to save the image:

Fatal error: Uncaught exception 'Mage_Core_Exception' with message 'Image does not exist.' in /home/superweb/public_html/sportsdirect/app/Mage.php on line 595

The product is created, but no image is associated with it.

The Solution: Correct Image Handling

To resolve this issue, we need to ensure that the image path and handling are done correctly within Magento’s file system. Let me guide you through a more robust approach:

  1. Ensure the media directory exists: Before downloading the image locally, you should check if the /media/catalog/product directory exists. If not, create it using Mage::getBaseDir('media').

  2. Use Magento’s built-in file transfer functions: Instead of relying on file_get_contents, use Magento’s Mage_Core_Helper_File_Upload class to download and save the image.

  3. Set the correct media gallery values: When calling $product->setMediaGallery(), ensure you provide populated arrays for ‘images’ and ‘values’.

Here’s an example of how to modify your script:

// Load the new product
$product = Mage::getModel('catalog/product')->load($new_product_id);

// Set the image URL
$url = 'http://media.asicdn.com/images/jpgo/6080000/6089330.jpg';
$imgPath = $this->getImageUploadDirectory() . '/image1.jpg';

// Download and save the image using Magento's helper
Mage::helper('core/file_upload')->copyFile($url, $imgPath);

// Set media gallery and add images to the product
$product->setMediaGallery(array(
    'images' => array(array(
        'file' => $this->prepareImage($imgPath),
        'type' => 'image',
        'label' => 'Image 1'
    )),
    'values' => array()
));

// Save the product
Mage::app()->setCurrentStore(Mage_Core_Model_App::ADMIN_STORE_ID);
$product->save();

In this revised version, I’ve:

  • Used getImageUploadDirectory() to obtain the correct media directory path.
  • Copied the image using Magento’s file upload helper.
  • Populated arrays for ‘images’ and ‘values’ when setting the media gallery.

Conclusion

Programmatically adding images from URLs in Magento requires careful handling of file paths and media directories. By leveraging Magento’s built-in functions and ensuring that the necessary directories exist, you can successfully fetch remote images and assign them to your products.

Always remember to test your scripts thoroughly, especially when dealing with file uploads, to prevent potential security vulnerabilities or data loss. For more detailed insights into Magento development best practices, I recommend exploring the resources available on Laravel Company’s blog.

Happy coding!

Catalog Admin Errors

Our network