2012-02-18 12:34:07 +00:00
|
|
|
# Introduction
|
|
|
|
|
|
|
|
Composer is a tool for dependency management in PHP. It allows you to declare
|
2012-03-14 03:07:22 +00:00
|
|
|
the dependent libraries your project needs and it will install them in your
|
|
|
|
project for you.
|
2012-02-18 12:34:07 +00:00
|
|
|
|
|
|
|
## Dependency management
|
|
|
|
|
2012-03-14 03:07:22 +00:00
|
|
|
Composer is not a package manager. Yes, it deals with "packages" or libraries, but
|
|
|
|
it manages them on a per-project basis, installing them in a directory (e.g. `vendor`)
|
|
|
|
inside your project. By default it will never install anything globally. Thus,
|
|
|
|
it is a dependency manager.
|
2012-02-18 12:34:07 +00:00
|
|
|
|
2012-03-14 03:07:22 +00:00
|
|
|
This idea is not new and Composer is strongly inspired by node's [npm](http://npmjs.org/)
|
|
|
|
and ruby's [bundler](http://gembundler.com/). But there has not been such a tool
|
|
|
|
for PHP.
|
2012-02-18 12:34:07 +00:00
|
|
|
|
2012-03-15 12:53:34 +00:00
|
|
|
The problem that Composer solves is this:
|
2012-03-14 03:07:22 +00:00
|
|
|
|
|
|
|
a) You have a project that depends on a number of libraries.
|
|
|
|
|
|
|
|
b) Some of those libraries depend on other libraries .
|
|
|
|
|
|
|
|
c) You declare the things you depend on
|
|
|
|
|
|
|
|
d) Composer finds out which versions of which packages need to be installed, and
|
2012-03-15 12:53:34 +00:00
|
|
|
installs them (meaning it downloads them into your project).
|
2012-02-18 12:34:07 +00:00
|
|
|
|
|
|
|
## Declaring dependencies
|
|
|
|
|
|
|
|
Let's say you are creating a project, and you need a library that does logging.
|
|
|
|
You decide to use [monolog](https://github.com/Seldaek/monolog). In order to
|
|
|
|
add it to your project, all you need to do is create a `composer.json` file
|
|
|
|
which describes the project's dependencies.
|
|
|
|
|
2012-02-29 14:56:53 +00:00
|
|
|
{
|
|
|
|
"require": {
|
|
|
|
"monolog/monolog": "1.0.*"
|
|
|
|
}
|
2012-02-18 12:34:07 +00:00
|
|
|
}
|
|
|
|
|
2012-03-14 03:07:22 +00:00
|
|
|
We are simply stating that our project requires some `monolog/monolog` package,
|
2012-02-18 17:11:00 +00:00
|
|
|
any version beginning with `1.0`.
|
2012-02-18 12:34:07 +00:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
2012-03-20 11:50:23 +00:00
|
|
|
### Downloading the Composer Executable
|
2012-03-14 03:07:22 +00:00
|
|
|
|
2012-06-13 16:30:51 +00:00
|
|
|
#### Locally
|
|
|
|
|
2012-03-14 03:07:22 +00:00
|
|
|
To actually get Composer, we need to do two things. The first one is installing
|
2012-10-09 02:54:54 +00:00
|
|
|
Composer (again, this means downloading it into your project):
|
2012-02-18 12:34:07 +00:00
|
|
|
|
2012-07-26 14:03:12 +00:00
|
|
|
$ curl -s https://getcomposer.org/installer | php
|
2012-02-18 12:34:07 +00:00
|
|
|
|
|
|
|
This will just check a few PHP settings and then download `composer.phar` to
|
2012-03-15 12:53:34 +00:00
|
|
|
your working directory. This file is the Composer binary. It is a PHAR (PHP
|
2012-03-14 03:07:22 +00:00
|
|
|
archive), which is an archive format for PHP which can be run on the command
|
|
|
|
line, amongst other things.
|
2012-02-18 12:34:07 +00:00
|
|
|
|
2012-03-15 12:53:34 +00:00
|
|
|
You can install Composer to a specific directory by using the `--install-dir`
|
2012-03-08 05:41:29 +00:00
|
|
|
option and providing a target directory (it can be an absolute or relative path):
|
|
|
|
|
2012-07-26 14:03:12 +00:00
|
|
|
$ curl -s https://getcomposer.org/installer | php -- --install-dir=bin
|
2012-03-08 05:41:29 +00:00
|
|
|
|
2012-06-13 16:30:51 +00:00
|
|
|
#### Globally
|
|
|
|
|
2012-03-14 03:07:22 +00:00
|
|
|
You can place this file anywhere you wish. If you put it in your `PATH`,
|
|
|
|
you can access it globally. On unixy systems you can even make it
|
|
|
|
executable and invoke it without `php`.
|
|
|
|
|
2012-06-20 21:15:54 +00:00
|
|
|
You can run these commands to easily access `composer` from anywhere on your system:
|
2012-06-13 16:30:51 +00:00
|
|
|
|
2012-07-26 14:03:12 +00:00
|
|
|
$ curl -s https://getcomposer.org/installer | php
|
2012-06-13 16:30:51 +00:00
|
|
|
$ sudo mv composer.phar /usr/local/bin/composer
|
|
|
|
|
|
|
|
Then, just run `composer` in order to run composer
|
|
|
|
|
2012-03-20 11:50:23 +00:00
|
|
|
### Using Composer
|
2012-03-14 03:07:22 +00:00
|
|
|
|
2012-05-04 11:30:42 +00:00
|
|
|
Next, run the `install` command to resolve and download dependencies:
|
2012-02-18 12:34:07 +00:00
|
|
|
|
|
|
|
$ php composer.phar install
|
|
|
|
|
2012-03-14 03:07:22 +00:00
|
|
|
This will download monolog into the `vendor/monolog/monolog` directory.
|
2012-02-18 12:34:07 +00:00
|
|
|
|
|
|
|
## Autoloading
|
|
|
|
|
2012-03-15 12:53:34 +00:00
|
|
|
Besides downloading the library, Composer also prepares an autoload file that's
|
2012-03-14 03:07:22 +00:00
|
|
|
capable of autoloading all of the classes in any of the libraries that it
|
|
|
|
downloads. To use it, just add the following line to your code's bootstrap
|
|
|
|
process:
|
2012-02-18 12:34:07 +00:00
|
|
|
|
2012-04-19 19:55:35 +00:00
|
|
|
require 'vendor/autoload.php';
|
2012-02-18 12:34:07 +00:00
|
|
|
|
2012-03-15 12:53:34 +00:00
|
|
|
Woh! Now start using monolog! To keep learning more about Composer, keep
|
2012-03-14 03:07:22 +00:00
|
|
|
reading the "Basic Usage" chapter.
|
2012-03-07 16:35:53 +00:00
|
|
|
|
|
|
|
[Basic Usage](01-basic-usage.md) →
|