User Tools

Site Tools


Sidebar

magento_2:composer_user_guide

Composer User Guide

What is Composer?

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.

Why is it better to use Composer?

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:

  • Packages are installed automatically with one command and there is no need to manually upload them;
  • Composer automatically installs the dependency modules and libraries required for the main module;
  • Composer is capable of updating multiple modules in one run;
  • With composer, it is possible to install a specific version of the module.

How does it work?

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.

How to start using Composer for Amasty extensions?

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.

Where to generate access keys and find Composer names?

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:

magento_2:composer_user_guide: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

Where $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:

magento_2:composer_user_guide:composer-packages

Composer commands and their usage

Composer allows to run various operations with extension packages:

Checking available extensions and their versions

The next command will show all available for download Amasty modules:

composer show -a amasty/*

magento_2:composer_user_guide:show-extensions

To check what module versions are available, a variation of the command should be used:

composer show -a amasty/module-name

magento_2:composer_user_guide:module-versions

Extension installation

To install the module, the following command should be used:

composer require amasty/module-name

magento_2:composer_user_guide:module-installation

It is possible to install a specific version of the module with this command:

composer require amasty/module-name:1.2.3

magento_2:composer_user_guide:specific-version-installation

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

magento_2:composer_user_guide:several-extensions-installation

To activate the extension, the commands below should be executed:

php bin/magento setup:upgrade 

magento_2:composer_user_guide: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)

magento_2:composer_user_guide:setup-dicompile

Extension Update

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

magento_2:composer_user_guide:update-extension

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

magento_2:composer_user_guide:update-several-extensions

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)

magento_2:composer_user_guide:dependencies

Composer allows updating all extensions of one vendor. To update all installed Amasty extensions, the command below can be used:

composer update amasty/*

magento_2:composer_user_guide:updates-from-vendor

Along with vendor extensions update, Сomposer can update all modules installed on Magento with the next command:

composer update

magento_2:composer_user_guide:composer-update

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)

Extension Deleting

The command below will delete the specified extension:

composer remove amasty/module-name

magento_2:composer_user_guide:remove-extension

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/*

magento_2:composer_user_guide:remove-all-vendor-extensions

Suggested Packages

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:

composer suggest

magento_2:composer_user_guide:suggests

Composer with multiple Amasty.com accounts and one Magento installation

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.

For example:

composer config repositories.amasty_account1 composer https://composer1.amasty.com/community/ composer config repositories.amasty_account2 composer https://composer2.amasty.com/community/

The way mirror repositories are named, won’t affect their behaviour.

magento_2:composer_user_guide:composer-accounts

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
magento_2/composer_user_guide.txt · Last modified: 2024/07/25 11:08 by skudrov