tnegeli / m2clitools

2.0.0 2026-11-02 16:23 UTC

Requires

• php: ~8.2.0||~8.3.0||~8.4.0||~8.5.0
• magento/framework: ^103.0.7
• magento/module-catalog: ^104.0.7
• magento/module-indexer: ^100.4.7
• magento/module-swatches: ^100.4.7

MIT

• cli
• magento

Published on Packagist.org on 2026-11-02 16:24 UTC

README

Various CLI Tools for Magento 2

Available commands:

php bin/magento tnegeli:cleanup-unused-product-media

Use this command to backup (or delete) unused product media from filesystem.

You can use the --dry-run option to just test the result.

You can use the --delete option to remove files, instead of doing a backup.

php bin/magento tnegeli:cleanup-unused-category-media

Use this command to backup (or delete) unused category media from filesystem.

You can use the --dry-run option to just test the result.

You can use the --delete option to remove files, instead of doing a backup.

php bin/magento tnegeli:cleanup-unused-swatches-media

Use this command to backup (or delete) unused swatches media from filesystem.

You can use the --dry-run option to just test the result.

You can use the --delete option to remove files, instead of doing a backup.

php bin/magento tnegeli:cleanup-illegal-product-media

Use this command to identify and remove illegal entries in the media gallery database table, which might break catalog: images:resize process.

You can use the --dry-run option to just test the result and give you a list of value_id entries from the media gallery table which are illegal.

php bin/magento tnegeli:cleanup-illegal-product-media-non-existing-files

Use this command to identify and remove illegal entries in the media gallery database table that have no files on the filesystem, which might break catalog:images:resize process.

You can use the --dry-run option to just test the result and give you a list of value_id entries from the media gallery table which are illegal.

php bin/magento tnegeli:cleanup-illegal-product-image-markers-non-existing-files

Each product is checked for the attribute values of

• image
• small_image
• thumbnail

If a product references a file that does not exist, the reference is removed.

You can use the --dry-run option to just test your database.

Safety checks

The commands tnegeli:cleanup-illegal-product-media-non-existing-files and tnegeli:cleanup-illegal-product-image-markers-non-existing-files abort if the product media directory does not exist, or if not a single referenced file exists. Both usually mean the media files are missing (e.g. an unmounted media directory), not that the database entries are illegal. Use the --force option to remove the entries anyway.

Output verbosity

All commands print one line per affected file or database entry, plus a summary. More details are available via the standard verbosity options:

• -v: additionally list the image markers that are kept (image markers command)
• -vv: additionally list every checked file
• -vvv: additionally list every media value read from the database