Technical Analysis and Practical Guide to Resolving PHP Extension Missing Issues in Magento 2.0.2 Installation

Problem Background and Error Analysis

When installing Magento 2.0.2 Enterprise Edition using Composer, the system reports a PHP extension missing error. The specific error message states: magento/product-enterprise-edition 2.0.2 requires ext-gd * -> the requested PHP extension gd is missing from your system. This indicates that Magento relies on the GD extension for image manipulation, but this extension is not installed or enabled in the current system.

The error message further lists the configuration file paths used by PHP in CLI mode, including: /etc/php5/cli/php.ini and multiple .ini files. These files are responsible for loading and managing PHP extensions. Users can run the php --ini command to view the actual configuration files used by PHP, which aids in diagnosing extension loading issues.

PHP Extension Loading Mechanism Explained

PHP extensions are dynamically loaded via configuration files. In Ubuntu systems, /etc/php5/cli/php.ini is the main configuration file, while files in the /etc/php5/cli/conf.d/ directory manage specific extensions. For example, 20-curl.ini handles the cURL extension configuration. If extensions are not enabled in these files, PHP cannot recognize them, leading to Composer dependency check failures.

Taking the GD extension as an example, its configuration is typically enabled via directives like extension=gd.so. However, in many cases, extension packages (e.g., php5-gd) automatically create corresponding .ini files, eliminating the need for manual configuration changes. Understanding this mechanism is crucial for efficient problem resolution.

Solution and Implementation Steps

Based on best practices, resolving this issue requires installing multiple PHP extensions. Here are the detailed steps:

1. Install GD Extension: Run sudo apt-get install php5-gd. This command installs the GD library for image processing, a fundamental requirement for Magento.
2. Install Intl Extension: Execute sudo apt-get install php5-intl. The Intl extension provides internationalization support, handling multiple languages and locale settings.
3. Install XSL Extension: Use sudo apt-get install php5-xsl. The XSL extension is used for XML transformations, which Magento utilizes for theme and layout processing.

After installation, no manual modifications to the php.ini file are needed, as the package manager automatically configures the extensions. You can verify if the extensions are loaded by running php -m | grep gd; if it outputs gd, it indicates success.

Code Examples and Verification

Here is a simple PHP script to test if the extensions are working correctly:

<?php
if (extension_loaded('gd')) {
    echo "GD extension is loaded.\n";
} else {
    echo "GD extension is not loaded.\n";
}
if (extension_loaded('intl')) {
    echo "Intl extension is loaded.\n";
} else {
    echo "Intl extension is not loaded.\n";
}
if (extension_loaded('xsl')) {
    echo "XSL extension is loaded.\n";
} else {
    echo "XSL extension is not loaded.\n";
}
?>

Running this script (e.g., php test_extensions.php) confirms that all necessary extensions are enabled. If any extension is not loaded, recheck the installation steps or run sudo service apache2 restart (if using Apache) to apply changes.

Additional Solutions and Considerations

Other answers provide variant methods, such as installing php7.1-xml or php-mbstring, but these may target different PHP versions or specific scenarios. On Ubuntu, ensure to use packages matching the system's PHP version (e.g., php5-* for PHP 5.x). If the issue persists, check the php --ini output to confirm correct configuration file paths and verify there are no syntax errors.

In summary, by systematically installing missing extensions, you can efficiently resolve dependency issues in Magento installation, enhancing development productivity.