README

Composer Azure Plugin

Composer Azure plugin is an attempt to use Composer with Azure DevOps artifacts, via universal packages.

Install

Composer Azure Plugin requires Composer 1.0.0 or newer. It should be installed globally.

$ composer global require trace-one/composer-azure-plugin

You have to be logged in via the Azure command line interface.

Usage

{
    "require": {
        "vendor-name/my-package": "1.0.0"
    },
    "extra": {
        "azure-repositories": [
            {
                "organization": "organization-name.visualstudio.com",
                "feed": "MyFeed",
                "packages": [
                    "vendor-name/my-package"
                ]
            }
        ]
    }
}

Publishing a package

Universal packages do not support vendor names, we then use a dot as separator. Once inside the folder of the package you want to publish, simply publish with the correct name.

az artifacts universal publish
    --organization https://organization-name.visualstudio.com/
    --feed MyFeed
    --name vendor-name.my-package
    --version 1.0.0
    --description "My PHP package"
    --path .

Known limitations

This package is a very early attempt, and has a few known limitations:

No version management: the version specified into the package.json file has to be the exact required version
No composer publish command: you have to publish your packages using the default Azure CLI

Feel free to suggest any improvement!

trace-one / composer-azure-plugin

Maintainers

Details