PHP的依赖管理--composer源码

Jordi Boggiano 3cc5698e7b Allow PHP 5.2 autoloaders to consume namespace, classmap and include path files, fixes #1730 12 年之前
bin cfc8bf0730 Make phar build fails more debuggable 12 年之前
doc 5b3d8dc874 Update should-i-commit-the-dependencies-in-my-vendor-directory.md 12 年之前
res 72a4146383 Scratch 'prefer-source'; 'preferred-install' is the bee's knees 12 年之前
src 3cc5698e7b Allow PHP 5.2 autoloaders to consume namespace, classmap and include path files, fixes #1730 12 年之前
tests 3cc5698e7b Allow PHP 5.2 autoloaders to consume namespace, classmap and include path files, fixes #1730 12 年之前
.gitignore cd2c6dc5d2 * ignore vagrant related 13 年之前
.travis.yml 57959c096e Clone on travis to avoid ssl issues on 5.3, disallow failures for 5.5 now that its updated 12 年之前
CHANGELOG.md 625e174f76 Update deps & changelog format 12 年之前
LICENSE 7ea2fd6c93 Fix author/copyright 14 年之前
PORTING_INFO 933cc6179b Import initial partial port of the libzypp satsolver. 14 年之前
README.md c1a4e5d43b Add curl -sS everywhere 12 年之前
composer.json c17aac04a9 Mark minimum phpunit version 12 年之前
composer.lock 087bc44f44 Update deps 12 年之前
phpunit.xml.dist 6967ec16b3 Add slow tests to slow group, excluded by default except for travis 13 年之前

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.

Build Status

Installation / Usage

  1. Download the composer.phar executable or use the installer.

    $ curl -sS https://getcomposer.org/installer | php
    
  2. 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"
        }
    }
    
  3. Run Composer: php composer.phar install

  4. 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.

  1. Run git clone https://github.com/composer/composer.git
  2. Download the composer.phar executable
  3. 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.

  1. Change into a directory in your path like cd /usr/local/bin
  2. Get Composer curl -sS https://getcomposer.org/installer | php
  3. Make the phar executable chmod a+x composer.phar
  4. Change into a project directory cd /path/to/my/project
  5. Use Composer as you normally would composer.phar install
  6. 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.

  1. Tap the homebrew-php repository into your brew installation if you haven't done yet: brew tap josegonzalez/homebrew-php
  2. Run brew install josegonzalez/php/composer.
  3. 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.