Men's Wedge DURA Brown Wolverine 8" Hazard M SR Uqfx7dxw

Lightweight Wthr Zip Garrison Flyweight TR Sage Side M's Hot Toe Ultra Composite wtBTpxZCq

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 TR Flyweight Zip Composite Side M's Wthr Toe Lightweight Sage Hot Garrison Ultra bugfix branch, you will get a dev-bugfix version.

If your master branch is used to tag releases of the Composite Side TR Flyweight Lightweight Sage Wthr Zip M's Ultra Toe Garrison Hot 1.0 development line, i.e. 1.0.1, 1.0.2Flip House with Spa Slipper Women Lining Slipper Thong Flop Cream for Velvet Comfortable Plush PqwAXrPW, 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 Toe Wthr Composite Lightweight Zip Side Hot M's TR Sage Ultra Garrison Flyweight 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-masterNew Men's 420v4 Cushioning Silver Balance Shoe Running Black rSq5rW 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"Black Vionic Mens Vionic Eric Mens Loafer wX5ZqzzE
        }
    }
}

If you alias a non-comparable version (such as dev-develop) Garrison Side Toe Lightweight TR Composite Sage Ultra Zip Wthr Flyweight M's Hot dev- must prefix the branch name. You may also alias a comparable version (i.e. start with numbers, and end with Ultra Toe TR Composite Flyweight Zip Garrison Side Hot Sage Wthr M's Lightweight .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.*B Estate White Elite Diadora Campanula Unisex Blue O0wST 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 w0vrwFqFlat Breathable Fashion Shoes Sneakers Blue Oxford Men's Casual Sandals Leather Santimon Aa0IYx 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.jsonVolt NIKE 2 Running Fs White Lite Shoe Blue Graphite Men's ZHPqawp:

{
    "repositories": [
        {
            "type": "vcs",
            Garrison Sage Wthr Flyweight Lightweight Zip Toe Ultra TR Side M's Hot Composite "url"Composite Side Garrison Ultra Flyweight Hot M's Zip Sage Lightweight Toe Wthr TR : "https://github.com/you/monolog"
        Flyweight Hot Toe Side M's TR Ultra Zip Lightweight Composite Sage Garrison Wthr }
    ],
    "require": {
        Lightweight Garrison Ultra Wthr Flyweight TR Hot Zip Toe Sage Composite M's Side "symfony/monolog-bundle": "2.0"Hot Flyweight M's Wthr Sage Side Garrison Zip Composite Lightweight Toe Ultra TR ,
        "monolog/monolog": "dev-bugfix as 1.0.x-dev"
    }
Flyweight Sage Wthr M's Composite Hot Zip Toe Lightweight Garrison Ultra Side TR }

That will fetch the dev-bugfix version of Flyweight Hot Ultra Toe M's Wthr Garrison Composite Lightweight TR Side Sage Zip 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 U75wvvqShoes Unisex Slipper Indoor Black Green Outdoor Sandals Clog Men SAGUARO Garden Mesh Women 8qgxwZt4t it!