How to use a specific tag/version with composer and a private git repository?

Question

I've got some packages host on the Gitlab of my company. I want to request a specific version of these packages but each time I try, composer download the latest commit of the master branch.

composer.json :

{
   "name" : "MyProject",
   "require" : {
      "user/project" : "v0.5.0"
   },
   "type" : "project",
   "repositories" : [
      {
         "url" : "[email protected]:user/project.git",
         "type" : "vcs"
      }
   ],
   "config" : {
      "vendor-dir" : "private/class"
   }
}

The structure of the repository of my package :

tag v0.5.0 : commit dd6ed3c8...
commit X,Y,Z
tag v0.7.0 : commit 15293ac6...
last commit f15600a1...

When I execute "composer install" :

Loading composer repositories with package information

Installing dependencies (including require-dev)

Analyzed 69 packages to resolve dependencies

Analyzed 67 rules to resolve dependencies

Installing user/project (dev-master f15600a)

Cloning f15600a1

It downloads the last commit only.

How can I configure the composer.json file of my project to use a specific tag ?

Jens A. Koch · Accepted Answer · 2016-01-15 13:19:12Z

78

How to require a specific Git tag?

Change the version requirement to dev-master, followed by a hash # and the Git tag name, e.g. v0.5.0, like so:

"require": {
    "vendor/package": "dev-master#v0.5.0"
}

How to require a specific Git commit?

Change the version requirement to dev-master, followed by a hash # and the Git commit reference, e.g. dd6ed3c8, like so:

"require": {
    "vendor/package": "dev-master#dd6ed3c8"
}

Referencing: https://getcomposer.org/doc/04-schema.md#package-links

Define your own package and set version and reference

An alternative to working with repositories of "type": "vcs" is to define a custom package "type": "package" inside repositories and work with a reference.

The reference is either a Git commit hash, or a tag or branch name, like origin/master.

This will tie the version to a specific commit reference, in this case dd6ed3c8.

"repositories": [
  # ...
  {
    "type": "package",
    "package": {
      "name": "vendor/package",
      "version": "v0.5.0",
      "source": {
        "url": "[email protected]:vendor/project.git",
        "type": "git",
        "reference": "dd6ed3c8"
      }
    }
  }
]

edited Jan 15, 2016 at 13:19

answered Jan 14, 2016 at 12:37

Jens A. Koch

42.1k14 gold badges123 silver badges147 bronze badges

Sign up to request clarification or add additional context in comments.

7 Comments

Airmanbzh Over a year ago

I already try this and each time it downloads the last commit. Not the requested tag/commit

Jens A. Koch Over a year ago

I don't know why type vcs doesn't work out for you. I've added an example for defining your own package inside repositories. This allows to set a version and a reference.

Airmanbzh Over a year ago

I tried your last proposition and still the same result. It clones the whole repository (and uses the last commit) I don't understand why this happens. Maybe I need to use something similar to packagist...

Jens A. Koch Over a year ago

It seems that Gitlab repositories are a problem for Composer and that it will only use Github and Bitbucket's APIs to download the zip archive.While in Gitlab,it will not pick the reference up on a checkout, nor will it fetch a dist(archive of the source) - it will just git clone.

Jens A. Koch Over a year ago

Maybe this helps: github.com/wemakecustom/gitlab-composer Its a branch/tag indexer for Gitlab repositories. Untested.

|

TonyB · Accepted Answer · 2017-02-28 16:58:51Z

31

Pull by git tag:

{
  "repositories": [
    {
      "type": "git",
      "url": "https://gitlab.xxx.com/some/repo.git"
    }
  ],
  "require": {
    "some/repo": "1.0.2"
  }
}

Pull by latest git commit:

{
  "repositories": [
    {
      "type": "git",
      "url": "https://gitlab.xxx.com/some/repo.git"
    }
  ],
  "require": {
    "some/repo": "dev-master"
  }
}

Pull by specific git commit:

{
  "repositories": [
    {
      "type": "git",
      "url": "https://gitlab.xxx.com/some/repo.git"
    }
  ],
  "require": {
    "some/repo": "dev-master#68696f39"
  }
}

Add repository via Composer Cli and pull latest git commit:

composer config repositories.repo git https://gitlab.xxx.com/some/repo.git
composer require "some/repo:dev-master"
composer update

edited Feb 28, 2017 at 16:58

answered Jan 4, 2017 at 19:37

TonyB

4234 silver badges6 bronze badges

Comments

totas · Accepted Answer · 2017-12-13 16:30:03Z

11

To require a specific branch you can also just dev-branchname like this:

"require": {
    "user/project" : "dev-my-branch"
},

answered Dec 13, 2017 at 16:30

totas

10.8k6 gold badges37 silver badges33 bronze badges

1 Comment

rabbitt Over a year ago

Enough people saying dev-master made enough sense, but thank you for clarifying this easily with the whole dev- bit... :)

lstonon · Accepted Answer · 2016-02-23 14:57:44Z

2

You can use a specific version hash after '#', for example:

require": {
    "user/project": "dev-master#31454f258f10329ae7c48763eb898a75c39e0a9f"
}

see: https://getcomposer.org/doc/04-schema.md#package-links

answered Feb 23, 2016 at 14:57

lstonon

1213 bronze badges

1 Comment

Arefe Over a year ago

Thanks, I didn't know you can use the version hash for the purpose.

Collectives™ on Stack Overflow

How to use a specific tag/version with composer and a private git repository?

4 Answers 4

7 Comments

Comments

1 Comment

1 Comment

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

4 Answers 4

7 Comments

Comments

1 Comment

1 Comment

Your Answer

Sign up or log in

Post as a guest

Linked

Related