composer

mirror of https://github.com/composer/composer

Go to file

Jérémy JOURDIN fbadc19bf6 Add preFileDownload event on package.json fetch		2013-11-19 17:45:28 +01:00
bin	Just output a warning but don't prevent usage through non-cli SAPIs	2013-04-11 10:23:35 +02:00
doc	drop ^A	2013-11-13 22:41:44 +02:00
res	Add github-domains config value for GitHub Enterprise setups, fixes #728	2013-10-28 12:40:20 -04:00
src	Add preFileDownload event on package.json fetch	2013-11-19 17:45:28 +01:00
tests	Fix target-dir update checks, fixes #2395	2013-11-04 13:36:30 +01:00
.gitignore	* ignore vagrant related	2012-03-22 17:17:11 +01:00
.travis.yml	Add parallel build to travis script	2013-09-25 10:23:48 +02:00
CHANGELOG.md	Update release date	2013-05-04 11:13:13 +02:00
LICENSE	…
PORTING_INFO	…
README.md	Move homebrew docs to the docs	2013-10-16 16:24:48 +02:00
composer.json	Upgrade to latest process component	2013-09-09 18:34:57 +02:00
composer.lock	Update deps	2013-10-16 12:13:34 +02:00
phpunit.xml.dist	Add slow tests to slow group, excluded by default except for travis	2012-05-06 15:10:13 +02:00

README.md

Composer - Dependency Management for PHP

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

See https://getcomposer.org/ for more information and documentation.

Installation / Usage

Download the composer.phar executable or use the installer.
```
$ curl -sS https://getcomposer.org/installer | php
```
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 documentation.
```
{
    "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: cd composer && php ../composer.phar install

You can now run Composer by executing the bin/composer script: php /path/to/composer/bin/composer

Global installation of Composer (manual)

Follow instructions in the documentation

Updating Composer

Running php composer.phar self-update or equivalent will update a phar install with the latest version.

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.

To ensure a consistent code base, you should make sure the code follows the Coding Standards which we borrowed from Symfony.

If you would like to help take a look at the list of issues.

Community

Mailing lists for user support and development.

IRC channels are on irc.freenode.org: #composer for users and #composer-dev for development.

Stack Overflow has a growing collection of Composer related questions.

Requirements

PHP 5.3.2 or above (at least 5.3.4 recommended to avoid potential bugs)

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.
This project uses hiddeninput.exe to prompt for passwords on windows, sources and details can be found on the github page of the project.