Composer - Package Management for PHP

Composer is a package manager tracking local dependencies of your projects and libraries.

See the about page on packagist.org for more information.

Installation / Usage

Download the composer.phar executable
Create a composer.json defining your dependencies. Note that this example is a short version for applications that are not meant to be published as packages themselves. To create libraries/packages please read the guidelines.
```
{
    "require": {
        "monolog/monolog": ">=1.0.0"
    }
}
```
Run Composer: php composer.phar install
Browse for more packages on Packagist.

Installation from Source

To run tests, or develop Composer itself, you must use the sources and not the phar file as described above.

Run git clone https://github.com/composer/composer.git
Download the composer.phar executable
Run Composer to get the dependencies: php composer.phar install

Global installation of composer

Since composer works with the current working directory it is possible to install it in a system wide way.

Change into a directory in your path like cd /usr/local/bin
Get composer wget http://getcomposer.org/composer.phar
Make the phar executeable chmod a+x composer.phar
Change into a project directory cd /path/to/my/project
Use composer as you normally would composer.phar install

Global installation of composer (via homebrew)

Homebrew can help you easily keep up-to-date with the latest composer version.

run `brew install https://raw.github.com/gist/1574469/composer.rb
Change into a project directory cd /path/to/my/project
Use composer as you normally would composer.phar install

Configuration

Additional options for composer can be configured in composer.json by using the config section.

{
    "config": {
        "vendor-dir": "custom/path/for/vendor"
    }
}

vendor-dir: The location to install vendor packages. The location can be supplied as an absolute or relative path but must be within the current working directory.

Contributing

All code contributions - including those of people having commit access - must go through a pull request and approved by a core developer before being merged. This is to ensure proper review of all the code.

Fork the project, create a feature branch, and send us a pull request.

Requirements

PHP 5.3+

Authors

Nils Adermann - naderman@naderman.de - http://twitter.com/naderman - http://www.naderman.de
Jordi Boggiano - j.boggiano@seld.be - http://twitter.com/seldaek - http://seld.be

See also the list of contributors who participated in this project.

License

Composer is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

This project's Solver started out as a PHP port of openSUSE's Libzypp satsolver.

3.5 KiB Raw Blame History