Using a Composed Project

git clone https://github.com/symfony/standard-edition myproject
            

cd myproject/
            

curl -s http://getcomposer.org/installer | php
            

Using a Composed Project

php composer.phar install
            

Using a Composed Project

vendor/
    autoload.php
    composer/
    monolog/
        monolog/
    symfony/
        symfony/
        monolog-bundle/
    twig/
        twig/
        extensions/
    [...]
            

One-line Project Initialization

php composer.phar create-project <package> [<dir>] [<version>]

php composer.phar create-project symfony/framework-standard-edition
            

Downloading Project Dependencies

composer.json

• Located in project root directory
• Defines dependencies

{
    "require": {
        "silex/silex": ">=1.0.0-dev",
        "symfony/finder": "2.1-dev",
        "twig/twig": "1.*",
        "predis/service-provider": "dev-master"
        "symfony/console": "~2.1"
    },
    "require-dev": {
        "mikey179/vfsStream": "*"
    }
}
            

Source install: With install --prefer-source it clones/checks out the code.

Creating a Package Definition

{
    "name": "predis/predis",
    "type": "library",
    "description": "Flexible and feature-complete Redis client",
    "keywords": ["nosql", "redis", "predis"],
    "homepage": "http://github.com/nrk/predis",
    "license": "MIT",
    "authors": [
        {
            "name": "Daniele Alessandri",
            "email": "suppakilla@gmail.com",
            "homepage": "http://clorophilla.net"
        }
    ],
    "require": {
        "php": ">=5.3.0"
    },
    "autoload": {
        "psr-0": {"Predis": "lib/"}
    }
}
            

Note: Package Definition === Application/Root Definition

Avoiding version chaos
in your team

Autoloading

Libraries/projects define their namespaces:

"autoload": {
    "psr-0": {
        "Vendor\\Namespace": "lib/"
    },
    "classmap": ["src/", "VeryOld.php"]
},
"include-path": ["src/", ""]
            

vendor/autoload.php
                

require __DIR__.'/../vendor/autoload.php';

use Silex\Application;
use Silex\Extension\TwigExtension;

use Symfony\Component\Finder\Finder;
use Symfony\Component\HttpFoundation\Response;

$app = new Application();
// ...
                

Autoloading Tests

Add your own namespaces for testing purposes in PHPUnit's bootstrap:

# tests/bootstrap.php

$loader = require __DIR__.'/../vendor/autoload.php';

$loader->add('My\Test', __DIR__);
            

Alternative Repositories

"repositories": [
    {
        "type": "composer",
        "url": "http://private.satis.example.org"
    },
    {
        "type": "vcs",
        "url": "git://example.org/MyRepo.git"
    },
    {
        "packagist": false
    }
]
            

See docs for more

Depending on packages without composer.json

"repositories": [
    {
        "type": "package",
        "package": {
            "name": "vendor/package",
            "version": "1.0.0",
            "dist": {
                "url": "http://example.org/package.zip",
                "type": "zip"
            },
            "source": {
                "url": "git://example.org/package.git",
                "type": "git",
                "reference": "tag name, branch name or commit hash"
            }
        }
    }
],
"require": {
    "vendor/package": "1.0.0"
}
            

Note: repositories are only available to the root package

Bonus Slide: Aliases & Branches

Situation

• I use symfony/monolog-bundle 2.0.10
• symfony/monolog-bundle 2.0.10 requires symfony/monolog-bridge 2.0.10
• symfony/monolog-bridge 2.0.10 requires monolog/monolog 1.*
• I added a feature to monolog in my-feature-branch on my github fork

Solution

"repositories": [
    {
        "type": "vcs",
        "url": "git://github.com/my/monolog.git"
    }
]
"require": {
    "symfony/monolog-bundle": "2.0.10",
    "monolog/monolog": "dev-my-feature-branch as 1.1.0"
}