cfd7a50f0a
For one thing this wouldn't have worked for any custom installers anyway which can write installed code to other places. This will now allow one to use composer archive on a clean code checkout to build an archive as we are used to. Or on one that had composer install run to build an archive that can be used for deployment which includes the vendors. |
||
---|---|---|
bin | ||
doc | ||
res | ||
src | ||
tests | ||
.gitignore | ||
.travis.yml | ||
CHANGELOG.md | ||
LICENSE | ||
PORTING_INFO | ||
README.md | ||
composer.json | ||
composer.lock | ||
phpunit.xml.dist |
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 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:
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)
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
curl -sS https://getcomposer.org/installer | php
- Make the phar executable
chmod a+x composer.phar
- Change into a project directory
cd /path/to/my/project
- Use Composer as you normally would
composer.phar install
- Optionally you can rename the composer.phar to composer to make it easier
Global installation of Composer (via homebrew)
Composer is part of the homebrew-php project.
- Tap the homebrew-php repository into your brew installation if you haven't done yet:
brew tap josegonzalez/homebrew-php
- Run
brew install josegonzalez/php/composer
. - Use Composer with the
composer
command.
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.