1
0
Fork 0
Go to file
Jordi Boggiano 2d670fc5cb Merge pull request #1003 from benwaine/documentation_clarification
Added a small clarification to the 05-repositories article.
2012-08-15 04:00:22 -07:00
bin Boost memory_limit at runtime if permitted 2012-06-14 14:21:44 +02:00
doc Merge pull request #1003 from benwaine/documentation_clarification 2012-08-15 04:00:22 -07:00
res Add Files Autoloading key. This is a necessary feature to allow purely or partly functional libraries to be "autoloadable" by composer by calling require_once on every file in the "autoload"."files" list. 2012-06-02 18:18:33 +02:00
src Fix PEAR binaries when the bin dir is non standard, fixes #1001 2012-08-15 12:29:43 +02:00
tests Make PSR0 scanning optional 2012-08-14 20:28:49 +02:00
.gitignore * ignore vagrant related 2012-03-22 17:17:11 +01:00
.travis.yml Quiet composer install 2012-06-27 18:40:18 +02:00
CHANGELOG.md Update changelog 2012-07-04 15:08:06 +02:00
LICENSE Fix author/copyright 2011-04-17 21:39:53 +02:00
PORTING_INFO Import initial partial port of the libzypp satsolver. 2011-04-05 17:37:19 +02:00
README.md Typo fixes 2012-06-20 14:15:54 -07:00
composer.json Add openssl to suggest, refs #930 2012-07-20 10:37:17 +02:00
composer.lock Update deps 2012-07-19 18:50:57 +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 - Package Management for PHP

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

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

Build Status

Installation / Usage

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

    $ curl -s http://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 -s http://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

The developer mailing list is on google groups IRC channels are available for discussion as well, on irc.freenode.org #composer for users and #composer-dev for development.

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.