magento-core-composer-installer
, (*1)
A Composer Plugin to manage Magento Core, (*2)
This tool allows you to manage Magento Core in your project using Composer., (*3)
Advantages:
* Keep Magento out of your project repository
* Allows for easy upgrades to new Magento versions, (*4)
You require this tool in your project and require a specific version of Magento. An initial install of a
Magento package will trigger an install to your Magento root directory. A .gitignore file will be automatically created
with all of the files in the Magento core package (Some are grouped, more on this later)., (*5)
When a package is removed, either using composer remove magento/magento or manually removing from your composer.json file
and running composer update all of the files present in the version of Magento you are removing will be deleted from
your magento-root-dir folder. If there are custom files in any of these folders, these will not be deleted., (*6)
This allows you to install and remove the Magento core in to your project without having to commit it as the .gitignore
is automatically updated. Further to this, in your project root you could ignore the .gitignore in the magento-root-dir
This would mean that you can install, update & remove Magento core without any untracked files showing in your
repository., (*7)
Now updating Magento Core is easy, simply change your require to "magento/magento": 1.10.0 or whatever the newest version is and run composer update!, (*8)
Compatibility
This tool works with any version of PHP >= 5.3. It is automatically tested using Travis on version PHP versions 5.3, 5.4, 5.5 & HHVM., (*9)
Installation
$ cd magento-project
$ composer require aydin-hassan/magento-core-composer-installer
The latest stable version will be installed., (*10)
In order for the installer to actually do anything, you will also need to require a core Magento package.
This should be a Magento release with a composer.json file in the root. It should be defined like so:, (*11)
{
"name": "magento/magento",
"description": "Magento Mirror",
"type": "magento-core"
}
See here for an example. You can use this repository for your Magento CE builds if you wish so., (*12)
You can create your own public or private Magento repository to host the different versions.
You should tag each version as the version it is. The type key is important. The Magento Core Composer Installer
will only install packages which have a type of magento-core., (*13)
Read here to see how you can create your own Magento Source Code Repository., (*14)
To use the Magento package you will have to add the repository to your projects composer.json file:, (*15)
"repositories": [
{
"type": "vcs",
"url": "git@github.com:AydinHassan/magento-community.git"
}
],
Then you can do:, (*16)
$ composer require "magento/magento:1.9.1.0"
Overall your projects composer.json should look something like:, (*17)
{
"name": "somevendor/someproject",
"description": "Magento build for ...",
"require-dev": {
"phpunit/phpunit": "~4.4"
},
"require": {
"aydin-hassan/magento-core-composer-installer" : "~1.0",
"magento/magento" : "1.9.1.0"
},
"authors": [
{
"name": "Aydin Hassan",
"email": "aydin@hotmail.co.uk"
}
],
"repositories": [
{
"type": "vcs",
"url": "git@github.com:AydinHassan/magento-community.git"
}
],
"extra": {
"magento-root-dir": "htdocs"
}
}
Also note the magento-root-dir, this is used to specify where you want Magento to be installed to., (*18)
Configuration
Configuration can be provided under the magento-core-deploy under the extra key in your root composer.json file, (*19)
Available configuration, (*20)
-
excludes - An array of files to not copy when installing the core, useful if local overrides are necessary, or you want to track a .htaccess.
-
ignore-directories - An array of folders to group ignores together to make the core .gitignore smaller.
-
git-ignore-append - Defaults to true. Whether to append to the .gitignore in the magento-root-dir folder. If false it will be wiped out on each deploy.
Example configuration:, (*21)
{
...
"extra" {
"magento-root-dir": "htdocs",
"magento-core-deploy" : {
"excludes": [
".htaccess"
],
"ignore-directories": [
"lib/Zend"
],
"git-ignore-append": false
}
}
}
The above config will, install everything from the core package, except the file .htaccess, it will group all files
under lib\Zend in the htdocs\.gitignore file. And it will wipe the htdocs\.gitignore every time Magento is updated or removed., (*22)
Excludes
Use this to exclude certain files and folders from being copied from the core in to your root directory. If the exclude path you include is actually a folder, everything within that folder will be excluded., (*23)
Exclude all files within lib, (*24)
{
...
"extra" {
"magento-root-dir": "htdocs",
"magento-core-deploy" : {
"excludes": [
"lib"
]
}
}
}
Exclude just app/etc/local.xml, (*25)
{
...
"extra" {
"magento-root-dir": "htdocs",
"magento-core-deploy" : {
"excludes": [
"app/etc/local.xml"
]
}
}
}
Ignore Directories
This one requires a little more explanation. Generating a .gitignore for every file in Magento results in a file well over
10,000 lines. On investigation this seems to slow git commands like git status down quite a bit. Some issues were taking
up to 14 seconds for me., (*26)
In order to combat this, any files which are in a default set of folders, will not be added to the .gitignore, instead
only the folder will, this greatly reduces the size of the .gitignore. The list of folders which are ignored by default can be
found here, (*27)
If you need to commit files inside these directories then you can override this list by setting the ignore-directories
key, noted above. Your list will not be merged, it will be used instead. This is in case you want to remove one of the ignore directories., (*28)
Creating a core package
I have provided a script which allows you to easily manage a mirror of Magento. It will work for both Community and Enterprise. The below instructions explain how to create a core package., (*29)
Add new Magento version script: https://gist.github.com/AydinHassan/6ed0bf2219ea0f122402, (*30)
- Create a repository or clone an existing one:
cd && mkdir magento-mirror && git init
- Download a version of Magento and extract it:
cd && tar -xzf magento.tar.gz
- Download this script to your home directory:
cd && curl https://gist.githubusercontent.com/AydinHassan/6ed0bf2219ea0f122402/raw/28d1e629947ef4e92082914172c5000a417d87c5/add-magento-version.php -o add-magento-version.php
- Run it with the locations of your repository and the extracted Magento code:
php add-magento-version.php ~/magento-mirror ~/magento
- The new version will be committed & tagged. You can now push this up to the remote.
The script will figure out the version and edition of Magento from the source. It will create branches and tags based on those versions., (*31)
Branches are major.minor:, (*32)
so 1.9.0.0, 1.9.0.1 & 1.9.10 all go in the 1.9 branch, (*33)
1.10.0.0 would cause a new 1.10 branch to be created., (*34)
1.10 will be branched of 1.9 so you can diff them easily, (*35)
Running the Tests
$ git clone git@github.com:AydinHassan/magento-core-composer-installer.git
$ cd magento-core-composer-installer
$ composer install
$ ./vendor/bin/phpunit
Wallogit.com
