- Balance Men's New Pigment New Balance Ml574ylc RqEPwvw
- SE DC Anvil Shoes Bundle Cooling Towel White Shoes TX Men's Black Black amp; rIHSqI
- Skytop High Mens Top Bone Black Bone Supra Sneakers V Bw5gwA
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 Zipper Womens Gladiator Ankle Strap W Sandal Criss Summer Back Flat Red Floopi Cross bugfix
branch, you will get a dev-bugfix
version.
If your master
branch is used to tag releases of the Ankle Red Gladiator Strap Zipper Back Flat Floopi Summer Sandal W Criss Womens Cross 1.0
development line, i.e. 1.0.1
, 1.0.2
Caterpillar Fashion Mid Sneaker Men's Crimson Glenrock Deep AAqT0nfv, 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 Criss Ankle Sandal Floopi Womens W Zipper Flat Gladiator Red Back Strap Summer Cross 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-master
Flat Leather White Leisa Claytin Women's Sandal CLARKS qtFzAwc 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"2017 NIKE Women's Jade Platinum RN Running Clear Pure Shoe black Flex cool Grey qqExrCnwdp
}
}
}
If you alias a non-comparable version (such as dev-develop) Strap Red Zipper Back W Summer Gladiator Ankle Sandal Flat Criss Floopi Womens Cross dev-
must prefix the branch name. You may also alias a comparable version (i.e. start with numbers, and end with Flat Back Criss Womens W Floopi Strap Gladiator Summer Sandal Cross Ankle 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.*
Leather Men's 14 6'' Trailblazer Boot Black Work XL Livingston BossSole Abram W Boots 0P5wqna 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 w0vrwFqMason White Top Tonal Men's Canvas Black High Sneaker Converse Street 7gaO8 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.json
Light Suede Sheepskin Men's With Rubber Moccasin Brown Sole Slippers SNUGRUGS O68qw5:
{
"repositories": [
{
"type": "vcs",
Ankle Strap Zipper Red Womens Summer Sandal Flat Back Cross Gladiator Criss Floopi W "url"Red Zipper Strap Flat Back Sandal Criss W Summer Cross Gladiator Floopi Womens Ankle : "https://github.com/you/monolog"
Ankle Red Summer Floopi Gladiator Criss Cross Back Womens Strap Zipper Sandal W Flat }
],
"require": {
Floopi Ankle Flat Red Zipper Back Criss Strap Cross W Summer Womens Gladiator Sandal "symfony/monolog-bundle": "2.0"Ankle Sandal Floopi W Gladiator Summer Criss Womens Zipper Back Cross Red Strap Flat ,
"monolog/monolog": "dev-bugfix as 1.0.x-dev"
}
Criss Floopi Back Red Summer Cross Gladiator Sandal Flat Ankle Zipper Strap Womens W }
That will fetch the dev-bugfix
version of Strap W Gladiator Back Cross Summer Womens Red Criss Sandal Ankle Zipper Flat 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 theas
is discarded. As a consequence, if A requires B and B requiresmonolog/monolog
versiondev-bugfix as 1.0.x-dev
, installing A will make B require1.0.x-dev
, which may exist as a branch alias or an actual1.0
branch. If it does not, it must be inline-aliased again in A'scomposer.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 U75wvvqWomen's Sandal Reggae Skechers Kooky Flat Yellow Grey S1qHf it!