Composer is a popular package manager for PHP. Many platforms use composer, including Magento 2. Within Magento 2, Composer allows managing libraries, Magento and third-party modules.
There are 2 ways of installing new modules and libraries in Magento 2: via manual file upload and Composer. In comparison with the manual upload, Composer offers automatic management of modules:
Composer installs, updates and removes modules once a specific command has been run. It scans the
composer.json file and manages modules according to the set dependencies.
To download and install Magento modules, the vendor repository is required. The repository is a Composer path to the storage with Amasty extensions. Without the repository, Composer won’t be able to locate and download the requested package.
The Amasty repository can be added with the next command:
composer config repositories.amasty composer <path>
Where <path> indicates the repository for a specific Magento edition:
https://composer.amasty.com/community/ - for community extensions.
https://composer.amasty.com/enterprise/ - for enterprise extensions.
Amasty repository is a private one. To access the purchased modules, access keys are required. The customer will be asked for a login (Public Key) and password (Private Key) when trying to install the package from the Amasty Composer repository for the first time.
Access keys can be found and generated in the Customer Account on Amasty.com → Account → Products → Access keys:
It is possible to manually save the keys in the repository, so there is no need to get authorized every time. Find the Magento root directory and indicate:
composer config --auth http-basic.composer.amasty.com $COMPOSER_AMASTY_USERNAME $COMPOSER_AMASTY_PASSWORD
$COMPOSER_AMASTY_USERNAME is the Public Key and
$COMPOSER_AMASTY_PASSWORD is the Private Key.
Otherwise, when the customer will be asked for access keys for the first time, they need to agree to save the credentials by printing “yes”:
After the authorization is successfully finished, installation and update of modules can be started.
The list of the purchased extensions and their composer names are available at the Customer account at Amasty.com → Account → Products. Composer names of extensions can be found at the Composer packages section:
Composer allows to run various operations with extension packages:
The next command will show all available for download Amasty modules:
composer show -a amasty/*
To check what module versions are available, a variation of the command should be used:
composer show -a amasty/module-name
To install the module, the following command should be used:
composer require amasty/module-name
It is possible to install a specific version of the module with this command:
composer require amasty/module-name:1.2.3
One of the significant composer advantages is that it allows installing multiple extensions with one run. Extensions should be listed with a space:
composer require amasty/module-name-a amasty/module-name-b amasty/module-name-c
To activate the extension, the commands below should be executed:
php bin/magento setup:upgrade
If Magento is in Production mode, the following commands should also be run:
php bin/magento setup:di:compile php bin/magento setup:static-content:deploy (your locale)
The extension update process is the same as the module installation process. The following command will run the update for a specified extension:
composer update amasty/module-name
It is also possible to update multiple extensions with one command:
composer update amasty/module-name-a amasty/module-name-b amasty/module-name-c
The “update” command updates only the last version number: e.g. 1.2.x (only x will be updated). To update the version from 1.x.x to 1.x.x the following command has to be executed:
composer require amasty/module-name --update-with-dependencies (or -w)
Composer allows updating all extensions of one vendor. To update all installed Amasty extensions, the command below can be used:
composer update amasty/*
Along with vendor extensions update, Сomposer can update all modules installed on Magento with the next command:
After the extension update, the same commands as after the extension installation should be run:
php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy (your locale)
The command below will delete the specified extension:
composer remove amasty/module-name
Instead of the
composer_name the corresponding module name which is indicated in the Customer Account must be specified.
Composer provides the functionality of removing all extensions of one vendor. To remove all Amasty extensions, the command below can be used:
composer remove amasty/*
Many extensions have additional modules that come with the main extension but they are not mandatory for the correct work of the major extension and, therefore, marked as “suggested”. Such extensions either provide additional features that extend the main extension functionality. For example, GraphQL and MFTF additional modules can be found in the list of the suggested extensions. The next command will display all suggested modules:
There are seven Amasty repositories (for both Community and Enterprise editions):
They are completely identical, therefore it is possible to add several of them using different Amasty.com customer accounts.
The way mirror repositories are named, won’t affect their behaviour.
This way the customer can have two repositories added with different customer credentials. Using several Amasty repositories does not affect the way composer commands are executed. In other words, to install the Improved Layered Navigation extension, please use the same command as usual:
composer require amasty/shopby