2017 © Pedro Peláez
 

composer-plugin magento-composer-installer

Composer installer for Magento modules

image

magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  • Monday, May 28, 2018
  • by Flyingmana
  • Repository
  • 22 Watchers
  • 176 Stars
  • 199,189 Installations
  • PHP
  • 356 Dependents
  • 50 Suggesters
  • 74 Forks
  • 22 Open issues
  • 40 Versions
  • 6 % Grown

The README.md

Build Status Windows Build status Scrutinizer Code Quality Code Coverage Bountysource, (*1)

!!! support the maintainer of this project via Patreon: https://www.patreon.com/Flyingmana, (*2)

Become a Patreon, (*3)

Magento Composer Installer

The purpose of this project is to enable composer to install Magento modules, and automatically integrate them into a Magento installation and add Composer's vendor autoloader ability to Magento's so that Composer-compatible 3rd party tools can be used., (*4)

If you want to install the Magento Core, you should try AydinHassan/magento-core-composer-installer as an additional plugin., (*5)

We strongly recommend you to also read the general composer documentation at getcomposer.org, (*6)

Also you should see:, (*7)

Magento 2

Congratulation to be working with Magento 2. Don't try to use it together with this project. Your princess is in another Castle, (*8)

Project Details

This project only covers the custom installer for composer. If you have problems with outdated versions, need to install magento connect modules or similar, you need to look for packages.firegento.com which you probably should add as composer repository (globally), (*9)

composer config -g repositories.firegento composer https://packages.firegento.com, (*10)

supported PHP Versions

We don't officially support PHP versions which are End of Life means which they don't get security patches anymore. Even if the install requirement still allows them.
This will change, as soon as someone is willing to pay for supporting them., (*11)

support contacts

If you have problems please have patience, as normal support is done during free time.
If you are willing to pay to get your problem fixed, communicate this from the start to get faster responses., (*12)

If you need consulting, support, training or help regarding Magento and Composer, you have the chance to hire one of the following people/companies., (*13)

  • Daniel Fahlke aka Flyingmana (Maintainer): flyingmana@googlemail.com @Flyingmana
  • brandung - Magento Team: magento-team@brandung.de (http://brandung.de)

other support contacts, (*14)

  • irc: freenode the channels #magento-composer #magento-reddit and for german speaking people #magento-de
  • twitter: @firegento

changelog

See CHANGELOG.md., (*15)

=======, (*16)

Known issues

need to redeploy packages

earlier we suggested the use of the command integrator package, that is not needed anymore. composer.phar run-script post-install-cmd -vvv -- --redeploy
This does remove all deployed files and redeploys every module, (*17)

using non default autoloading

we handle this topic in our FAQ., (*18)

Timeouts and slow downloading.

Mostly caused by outages of Github, Repositories or the Internet. This is a common problem with having all packages remote., (*19)

For all of this issues you can make use of the commercial Toran Proxy. It also allows hosting of private packages and speeds up the whole downloading process., (*20)

Another alternative is to look into Satis, bare git mirrors and repository aliasing., (*21)

Another way to speedup downloads over ssh (also interesting for satis users) is to improve your ssh configs. At least for newer versions of openSSH you can add the following to your .ssh/config to reuse previous connections., (*22)

Host * 
    ControlPath ~/.ssh/controlmasters/%r@%h:%p
    ControlMaster auto
    ControlPersist 10m

also you need to create the controlmasters directory:, (*23)

mkdir ~/.ssh/controlmasters
chmod go-xr ~/.ssh/controlmasters

further information can be found on wikibooks, (*24)

Usage

Update the Installer

as this is a composer plugin, you should only use these two commands to update the installer, (*25)

composer require --no-update  magento-hackathon/magento-composer-installer="3.2.*"
composer update --no-plugins --no-scripts magento-hackathon/magento-composer-installer

the second command needs maybe a --with-dependencies
Depending on your workflow with composer, you may want to use more explicit versions, (*26)

Install a module in your project

make sure to use the public Magento module repository as composer repository:, (*27)

composer config -g repositories.firegento composer https://packages.firegento.com, (*28)

configure your magento root dir, the directory where your magento resides:
composer config extra.magento-root-dir "htdocs/", (*29)

an example how your project composer.json could look like:, (*30)

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.firegento.com"
        }
    ],
    "extra":{
        "magento-root-dir": "htdocs/"
    }
}

Auto add files to .gitignore

If you want to have the deployed files automatically added to your .gitignore file, then you can just set the auto-append-gitignore key to true:, (*31)

{
    "extra":{
        "magento-root-dir": "htdocs/",
        "auto-append-gitignore": true
    }
}

The .gitignore file will be loaded from the current directory, and if it does not exist, it will be created. Every set of module files, will have a comment above them describing the module name for clarity., (*32)

Multiple deploys will not add additional lines to your .gitignore, they will only ever be added once., (*33)

Adding Composer's autoloader to Magento

Documentation available here., (*34)

Overwriting a production setting (DevMode)

{
    "extra":{
        "magento-deploystrategy": "copy",
        "magento-deploystrategy-dev": "symlink"
    }
}

Example in devmode doc., (*35)

Include your project in deployment

When the magento-composer-installer is run, it only looks for magento-modules among your project's dependencies. Thus, if your project is a magento-module and you want to test it, you will need a second composer.json for deployment, where your project is configured as a required package., (*36)

If you wish to deploy your project's files (a.k.a. root package), too, you need to setup your composer.json as follows:, (*37)

{
    "type": "magento-module",
    ...
    "extra": {
        "magento-root-dir": "htdocs/",
        "include-root-package": true
    }
}

Testing

First clone the magento-composer-installer, then install the dev-stuff (installed by default):, (*38)

./bin/composer.phar install

then run vendor/bin/phpunit in project-root directory., (*39)

Note: Windows users please run phpunit with Administrator permissions., (*40)

Further Information

Core Contributors

  • Daniel Fahlke aka Flyingmana (Maintainer)
  • Jörg Weller
  • Karl Spies
  • Tobias Vogt
  • David Fuhr
  • Amir Tchavoshinia
  • Vinai Kopp (Maintainer)

Thank You

There are a few companies we want to thank for supporting this project in one way or another., (*41)

digital.manufaktur GmbH

Teached me (Flyingmana) most I know about Magento and paid my participation for the hackathon were the installer got created., (*42)

melovely

Support me (Flyingmana) as my current employer very much in my work on everything composer related., (*43)

The Versions

28/05 2018

dev-master

9999999-dev https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

07/06 2017

3.1.2

3.1.2.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

31/05 2017

3.1.1

3.1.1.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

23/02 2017

3.0.x-dev

3.0.9999999.9999999-dev https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

23/02 2017

3.1.0

3.1.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

29/08 2016

3.0.7

3.0.7.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

08/03 2016

3.0.7-rc.1

3.0.7.0-RC1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

05/02 2016

2.1.x-dev

2.1.9999999.9999999-dev https://github.com/Cotya/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

05/02 2016

2.1.3

2.1.3.0 https://github.com/Cotya/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

21/10 2015

3.0.6

3.0.6.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

03/10 2015

dev-test-appveyor

dev-test-appveyor https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

12/08 2015

dev-Flyingmana-patch-1

dev-Flyingmana-patch-1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

05/08 2015

3.0.5

3.0.5.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

12/07 2015

3.0.4

3.0.4.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

10/06 2015

3.0.4-beta1

3.0.4.0-beta1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies
by Dan Stefan Oprean

composer-installer magento

02/06 2015

3.0.3

3.0.3.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

20/05 2015

3.0.3-rc.2

3.0.3.0-RC2 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

04/05 2015

3.0.3-rc.1

3.0.3.0-RC1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

03/05 2015

2.1.3-rc.1

2.1.3.0-RC1 https://github.com/Cotya/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

28/03 2015

3.0.2

3.0.2.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

28/03 2015

3.0.1

3.0.1.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

25/03 2015

3.0.0

3.0.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

15/03 2015

3.0.0-beta.1

3.0.0.0-beta1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

07/01 2015

1.3.x-dev

1.3.9999999.9999999-dev https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

  • php >=5.3.2

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

12/12 2014

2.1.1

2.1.1.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

17/11 2014

3.0.0-alpha.2

3.0.0.0-alpha2 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

15/11 2014

3.0.0-alpha.1

3.0.0.0-alpha1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

14/11 2014

2.1.0

2.1.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

12/11 2014

2.1.0-rc.1

2.1.0.0-RC1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

06/06 2014

2.0.0

2.0.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

10/05 2014

2.0.0-beta4

2.0.0.0-beta4 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

  • composer-plugin-api 1.0.0

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

21/04 2014

2.0.0-beta3

2.0.0.0-beta3 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

  • composer-plugin-api 1.0.0

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

12/04 2014

2.0.0-beta2

2.0.0.0-beta2 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

26/02 2014

2.0.0-beta1

2.0.0.0-beta1 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

10/12 2013

1.3.2

1.3.2.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

09/11 2013

1.3.1

1.3.1.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

  • composer-plugin-api 1.0.0

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

07/09 2013

1.2

1.2.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

  • composer-plugin-api *

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

07/09 2013

1.3

1.3.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Requires

  • composer-plugin-api *

 

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

16/01 2013

1.1

1.1.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento

13/01 2013

1.0

1.0.0.0 https://github.com/magento-hackathon/magento-composer-installer

Composer installer for Magento modules

  Sources   Download

OSL-3.0

The Development Requires

by Vinai Kopp
by Daniel Fahlke aka Flyingmana
by Jörg Weller
by Karl Spies

composer-installer magento