📄 2. Pre-Flight Check: Verifying System Requirements

Note: For full installation intructions, please see our general installation guide for Magento & Hyvä extensions.

For the JaJuMa WebP Optimized Images extension to function, your server must have at least one of the supported image conversion tools available. Performing this quick "pre-flight check" ensures your environment is ready and helps prevent configuration issues.

Before proceeding, ensure your server meets these system requirements for the WebP Optimized Images extension as described below.

The extension supports three powerful conversion tools:

1. GD:
   A widely available graphics library for PHP.
2. cwebp:
   Google's official command-line encoder for WebP.
3. Imagemagick:
   A popular open-source image processing suite.

You can verify their availability directly from the command-line interface (CLI) of your server.

🔧 2.1 How to Check from the CLI

Log in to your server via SSH and run the following commands from any directory.

2.1.1 Check for GD Library with WebP Support

GD is commonly included with PHP, but you must ensure its WebP functionality is enabled.

Command:

    php -i | grep -E 'WebP Support|GD'

Expected Success Output:
You should see output similar to the following. The critical line is WebP Support => enabled. If this is missing or disabled, GD cannot be used for conversion.

    GD Support => enabled
    GD Version => bundled (2.1.0 compatible)
    WebP Support => enabled

An empty result indicates GD is likely not installed or configured correctly.

2.1.2 Check for cwebp

cwebp is Google's official tool and is highly recommended for its performance and quality.

Command (to check for global availability):

    cwebp -h

Expected Success Output:
The command will display the help menu with all available options and parameters. If you see an error like "command not found," cwebp is not available as a global command.

If the Global Command Fails:
The extension comes bundled with the cwebp binary. You can test if it can run on your server directly.

1. Navigate to your Magento root directory.

2. Run the following command

   # Path for manual install
   ./app/code/Jajuma/WebpImages/bin/cwebp -h
   
   # Path for composer install
   ./vendor/jajuma/module-webpimages/bin/cwebp

If this command displays the help menu, you can use this path in the extension's configuration. If it fails with a permission or dependency error, the binary may not be executable by your web user or may be missing required system libraries.

2.1.3 Check for Imagemagick

Imagemagick is often available on hosting environments via the convert command.

Command:

    convert -version

Expected Success Output:
This will display version and copyright information for Imagemagick. An error indicates it is not available globally.

💡 Pro Tip: If you are unable to verify any of these tools or encounter permission errors, please contact your hosting provider for assistance. They can help install the necessary tools (like cwebp) or ensure the correct file permissions are set for the web user.

Once you have confirmed that at least one of these tools is available, you can proceed to the configuration steps.

📞 Need Help?

Having trouble with the setup? Check our Troubleshooting, FAQ & Best Practices for common solutions.

Still have questions or need help verifying your system requirements? Our expert team is here to assist. Please don't hesitate to contact our support team for personalized assistance.