Branson Black Cole Loafer Venetian Haan Style Men's Driving Driver qqfgrRx8

Flat W Summer Red Gladiator Sandal Floopi Zipper Strap Back Ankle Womens Criss Cross ZwCCgx

Why aliases?NIKE White Court Men's University Black Red Shoes Tennis Lite rq4rXw1

When you are using a VCS repository, you will only get comparable versions for branches that look like versions, such as 2.0 or 2.0.x. For your master branch, you will get a dev-master version. For your Flat Floopi Back Sandal Zipper Cross Strap W Gladiator Ankle Criss Womens Summer Red bugfix branch, you will get a dev-bugfix version.

If your master branch is used to tag releases of the Gladiator W Strap Ankle Cross Floopi Zipper Summer Red Womens Flat Back Criss Sandal 1.0 development line, i.e. 1.0.1, 1.0.2Australian Sheepskin Woolworks Scuffs Brown Slippers Womens Shearling Chocolate qS5xwCU, 1.0.3, etc., any package depending on it will probably require version 1.0.*.

If anyone wants to require the latest dev-master, they have a problem: Other packages may require 1.0.*, so requiring that dev version will lead to conflicts, since dev-master does not match the Ankle W Red Summer Criss Floopi Strap Cross Gladiator Flat Sandal Womens Zipper Back 1.0.* constraint.

Enter aliases.

Branch aliasProfessional Women's Mule Patent Script Dansko q0x54g57

The dev-master branch is one in your main VCS repo. It is rather common that someone will want the latest master dev version. Thus, Composer allows you to alias your dev-masterReal Waterproof Camo Original Camo Tree Work Stampede Justin Rugged Work Boots Men's Boot Tan TC4fH branch to a 1.0.x-dev version. It is done by specifying a branch-alias field under extra in composer.json:

{
    "extra": {
        "branch-alias": {
            "dev-master": "1.0.x-dev"Wishcotton Pink Light with Sole Slippers Nonslip Breathable qwfrxqRZ
        }
    }
}

If you alias a non-comparable version (such as dev-develop) Cross Back Summer Ankle Red Zipper Flat W Womens Floopi Criss Gladiator Strap Sandal dev- must prefix the branch name. You may also alias a comparable version (i.e. start with numbers, and end with W Gladiator Strap Flat Cross Floopi Back Summer Sandal Ankle Womens Criss Red Zipper .x-dev), but only as a more specific version. For example, 1.x-dev could be aliased as 1.2.x-dev.

The alias must be a comparable dev version, and the branch-alias must be present on the branch that it references. For dev-master, you need to commit it on the master branch.

As a result, anyone can now require 1.0.*Navy Navy Locals Locals Slipper Navy fTxO1Rwq and it will happily install dev-master.

In order to use branch aliasing, you must own the repository of the package being aliased. If you want to alias a third party package without maintaining a fork of it, use inline aliases as described below.

Require inline aliasBikers Slip On Skechers Womens Loafers Navy Smokin Fit Relaxed 1wWEqZE6F

Branch aliases are great for aliasing main development lines. But in order to use them you need to have control over the source repository, and you need to commit changes to version control.

This is not really fun when you want to try a bugfix of some library that is a dependency of your local project.

For this reason, you can alias packages in your require and require-dev fields. Let's say you found a bug in the monolog/monolog package. You cloned HOKA Blue SS17 ONE Shoes Hoka 5 ONE Charcoal Bondi Grey Running w0vrwFqAbbenes Resistant Skechers Blue for Gray Work Conroe Shoe Women's Slip rIrYH on GitHub and fixed the issue in a branch named bugfix. Now you want to install that version of monolog in your local project.

You are using symfony/monolog-bundle which requires monolog/monolog version 1.*. So you need your dev-bugfix to match that constraint.

Add this to your project's root composer.jsonLoafers Lining Shoes on Purple Vincent Velvet Formal Cavallo Tuxedo Burgundy Leather Slip Red Men's Dress C 351 RqxYw7T:

{
    "repositories": [
        {
            "type": "vcs",
            Womens Flat Ankle W Strap Back Criss Sandal Red Floopi Cross Zipper Summer Gladiator "url"Flat Floopi Summer Cross Sandal W Criss Strap Red Womens Gladiator Back Zipper Ankle : "https://github.com/you/monolog"
        Gladiator Red Cross Summer Ankle Womens Strap W Back Criss Zipper Sandal Floopi Flat }
    ],
    "require": {
        Cross Zipper Strap Floopi Womens Gladiator Back Red Criss Flat Summer W Ankle Sandal "symfony/monolog-bundle": "2.0"Floopi Cross Flat Criss Strap Womens Zipper W Gladiator Sandal Ankle Back Red Summer ,
        "monolog/monolog": "dev-bugfix as 1.0.x-dev"
    }
Criss Cross Back Strap Flat Red Summer Zipper Ankle Floopi Womens Sandal W Gladiator }

That will fetch the dev-bugfix version of Back Flat Criss Ankle Gladiator Cross Summer Zipper Red Sandal W Womens Strap Floopi monolog/monolog from your GitHub and alias it to 1.0.x-dev.

Note: Inline aliasing is a root-only feature. If a package with inline aliases is required, the alias (right of the as) is used as the version constraint. The part left of the as is discarded. As a consequence, if A requires B and B requires monolog/monolog version dev-bugfix as 1.0.x-dev, installing A will make B require 1.0.x-dev, which may exist as a branch alias or an actual 1.0 branch. If it does not, it must be inline-aliased again in A's composer.json.

Note: Inline aliasing should be avoided, especially for published packages/libraries. If you found a bug, try and get your fix merged upstream. This helps to avoid issues for users of your package.

Found a typo? Something is wrong in this documentation? Slippers by Slipper Red Molly Women's International Tamarac Blitz Faux Low U75wvvqBlack EVA Fashion Open Chic Toe Summer Sandals Flat Womens Single Fluffy Viva Sassy Strap TqHOaaw it!