Magento 2 Add Images To Product Programmatically
In this tutorial, I will show you how to programmatically add images to the product in Magento 2.
Product images play an essential role in building an eye-catching whole product page, which attracts customers in the first place. As a highly flexible and customizable platform, Magento allows adding or removing images from products in different ways. You can save a lot of time without having to add images manually.
Why you should add images to products in Magento 2?
You should not skip this tutorial especially if you haven’t present your products with stunning images. The benefits you can see after getting this done are numerous. It helps beautify your products, improve SEO performance, enhance customer experience, and more.
Now let’s dig in to how to add/ remove images to product programmatically in Magento 2 with two methods:
In this article, I will show you two method to add/ remove images to product programmatically:
- Method 1: Add Or Remove Media Images Programmatically By Using The
Magento_Catalog
Module Classes - Method 2: Add Or Remove Media Images Programmatically By Using Object Manager
Method 1: Add Or Remove Media Images Programmatically By Using The Magento_Catalog
Module Classes
Firstly, I will describe the process of adding and removing images programmatically in Magento 2 by using Magento_Catalog
module.
A one-off script is required to run it. Hence, the code displayed will reside in a single file which externally bootstraps the Magento 2 application.
The code below has been tested as of Magento Open Source version 2.2.5 and will delete all existing gallery images from a product, then add a single image, assigning the image to the base
, small_image
and thumbnail.
The code comments need to meet a few below requirements:
- The document root of the Magento 2 application must be set to
ROOT/pub
. - The directory containing the images need to be placed within
ROOT/pub/media
. - The images are named identical to the SKU of the product which images should be updated.
- Make sure that
[image_dir]
is replaced by the name of the directory which contains the images.
Add a file within the ROOT/pub
directory containing the code below and run the code either within the browser or via CLI. You can change various aspects of the file (such as the glob’d image file types) to meet your needs.
<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
/*
* Assumes doc root is set to ROOT/pub
*/
require_once dirname(__DIR__) . '/app/bootstrap.php';
$bootstrap = \Magento\Framework\App\Bootstrap::create(BP, $_SERVER);
class AssignImages extends \Magento\Framework\App\Http implements \Magento\Framework\AppInterface
{
public function launch()
{
$state = $this->_objectManager->get('Magento\Framework\App\State');
$state->setAreaCode('adminhtml');
$galleryReadHandler = $this->_objectManager->create('Magento\Catalog\Model\Product\Gallery\ReadHandler');
$imageProcessor = $this->_objectManager->create('Magento\Catalog\Model\Product\Gallery\Processor');
$productGallery = $this->_objectManager->create('Magento\Catalog\Model\ResourceModel\Product\Gallery');
/**
* Assumed images are named [sku].[ext] and reside in ROOT/pub/media/[image_dir]
*/
foreach (glob(__DIR__ . "/media/[image_dir]/*.{jpg,png,gif}", GLOB_BRACE) as $image) {
$imageFileName = trim(pathinfo($image)['filename']);
$sku = $imageFileName;
try {
$product = $this->_objectManager->create('Magento\Catalog\Model\Product')->loadByAttribute('sku', $sku);
if ($product) {
$galleryReadHandler->execute($product);
// Unset existing images
$images = $product->getMediaGalleryImages();
foreach($images as $child) {
$productGallery->deleteGallery($child->getValueId());
$imageProcessor->removeImage($product, $child->getFile());
}
/**
* Add image. Image directory must be in ROOT/pub/media for addImageToMediaGallery() method to work
*/
$product->addImageToMediaGallery('[image_dir]' . DIRECTORY_SEPARATOR . pathinfo($image)['basename'], array('image', 'small_image', 'thumbnail'), false, false);
$product->save();
echo "Added media image for {$sku}" . "\n";
}
} catch (\Exception $e) {
echo $e->getMessage();
}
}
return $this->_response;
}
public function catchException(\Magento\Framework\App\Bootstrap $bootstrap, \Exception $exception)
{
echo $exception->getMessage();
return false;
}
}
/** @var \Magento\Framework\App\Http $app */
$app = $bootstrap->createApplication('AssignImages');
$bootstrap->run($app);
Method 2: Add Or Remove Media Images Programmatically By Using Object Manager
Now, I will show you the second method to add or remove image from a product by using object manager
// Instance of object manager
$objectManager = \Magento\Framework\App\ObjectManager::getInstance();
//Remove Images From Product
$productId = 1 ; // Id of product
$product = $objectManager->create('Magento\Catalog\Model\Product')->load($productId);
$productRepository = $objectManager->create('Magento\Catalog\Api\ProductRepositoryInterface');
$existingMediaGalleryEntries = $product->getMediaGalleryEntries();
foreach ($existingMediaGalleryEntries as $key => $entry) {
unset($existingMediaGalleryEntries[$key]);
}
$product->setMediaGalleryEntries($existingMediaGalleryEntries);
$productRepository->save($product);
/*Add Images To The Product*/
$imagePath = "sample.png"; // path of the image
$product->addImageToMediaGallery($imagePath, array('image', 'small_image', 'thumbnail'), false, false);
$product->save();
Conclusion
Above are the detailed instructions for adding images to product programmatically in Magento 2. I hope that this guide is helpful for you. If you have any questions or want to show your opinion, feel free to leave a comment below. Thanks for reading!
Enjoyed the tutorial? Spread it to your friends!