Magento Composer Installer

This is a fork of the Magento Composer Installer repo that provides support for Magento 2 components (modules, themes, language packages, libraries and components)., _(*1)

Usage

In the component's composer.json, specify:, _(*2)

type, type of Magento 2 component.
extra/map, list of files to move and their paths relative to the Magento root directory.
extra/chmod, list of permissions that should be set for files., _(*3)

Note:, _(*4)
- extra/map is required only if your component needs to be moved to a location other than <Magento root>/vendor. Otherwise, omit this section.
- extra/chmod is required only if you need to set specific permissions for files.

Supported Components

The following list explains the use of type in composer.json., _(*5)

Magento Module

"type": "magento2-module", _(*6)

Installation location: Default vendor directory or as defined in extra/map, _(*7)

Example:, _(*8)

{
    "name": "magento/module-core",
    "description": "N/A",
    "require": {
        ...
    },
    "type": "magento2-module",
    "extra": {
        "map": [
            [
                "*",
                "Magento/Core"
            ]
        ]
    }
}

Final location is <magento root>/app/code/Magento/Core, _(*9)

Magento Theme

"type": "magento2-theme", _(*10)

Installation location: app/design, _(*11)

Example:, _(*12)

{
    "name": "magento/theme-frontend-luma",
    "description": "N/A",
    "require": {
        ...
    },
    "type": "magento2-theme",
    "extra": {
        "map": [
            [
                "*",
                "frontend/Magento/luma"
            ]
        ]
    }
}

Final location is <magento_root>/app/design/frontend/Magento/luma, _(*13)

Magento Language Package

"type": "magento2-language", _(*14)

Installation location: app/i18n, _(*15)

Example:, _(*16)

{
    "name": "magento/language-de_de",
    "description": "German (Germany) language",
    "require": {
        ...
    },
    "type": "magento2-language",
    "extra": {
        "map": [
            [
                "*",
                "Magento/de_DE"
            ]
        ]
    }
}

Final location is <magento_root>/app/i18n/Magento/de_DE, _(*17)

Magento Library

"type": "magento2-library", _(*18)

Support for libraries located in lib/internal instead of in the vendor directory., _(*19)

Example:, _(*20)

{
    "name": "magento/framework",
    "description": "N/A",
    "require": {
       ...
    },
    "type": "magento2-library",
    "extra": {
        "map": [
            [
                "*",
                "Magento/Framework"
            ]
        ]
    }
}

Final location is <magento_root>/lib/internal/Magento/Framework, _(*21)

Magento Component

"type": "magento2-component", _(*22)

Installation location: Magento root directory, _(*23)

Example:, _(*24)

{
    "name": "magento/migration-tool",
    "description": "N/A",
    "require": {
        ...
    },
    "type": "magento2-component",
    "extra": {
        "map": [
            [
                "*",
                "dev/tools/Magento/Tools/Migration"
            ]
        ]
    }
}

Final location is <magento_root>/dev/tools/Magento/Tools/Migration, _(*25)

Autoload

After handling all Magento components, <magento_root>/app/etc/vendor_path.php specifies the path to your vendor directory., _(*26)

This information allows the Magento application to utilize the Composer autoloader for any libraries installed in the vendor directory. The path to vendor varies between particular installations and depends on the magento_root setting for the Magento Composer installer. That's why it should be generated for each installation., _(*27)

You must run composer install to install dependencies for a new application or composer update to update dependencies for an existing application., _(*28)

Deployment Strategy

The Magneto Composer Installer uses the copy deployment strategy. It copies each file or directory from the vendor directory to its designated location based on the extra/map section in the component's composer.json., _(*29)

There are other deployment strategies that could be used; however, we don't guarantee that any of them will work., _(*30)

Usage `extra/chmod`

The following example shows how you can set specific permissions for files., _(*31)

Example:, _(*32)

{
    "name": "magento/module-sample",
    "description": "N/A",
    "require": {
        ...
    },
    "type": "magento2-module",
    "extra": {
         "chmod": [
            {
                "mask": "0755",
                "path": "bin/magento"
            },
            {
                "mask": "0644",
                "path": "some_dir/file.jpg"
            }
        ]
    }
}

mask is a bit mask for chmod command, _(*33)

path is a path to file relative to the Magento root folder, _(*34)