Le projet

Et maintenant ?

Dependency Hell

Répétez pour chacune des dépendances :

• Où la trouver ?
• Quelles sont ses dépendances ? Lesquelles sont nécessaires ?
• Comment et où installer le tout ?
• Gestion de l'autoloading
• Version de la dépendance

Solutions

Pear

• installation globale
• channels (channel1/package !== channel2/package)
• impossible de figer des dépendances

Submodules

• dépendances des dépendances ?
• autoloading ?

Composer

En bref

• installation simple
• dépendances propres au projet
• résolution efficace des dépendances (solver SAT)
• plus quelques bonus

Behind the scenes

• composer.json : description des dépendances
• composer.lock : image exacte d'une installation
• Packagist, satis : sources de packages

Installation

$ curl -sS https://getcomposer.org/installer | php

composer.json

{
  "require": {
    "pimple/pimple": "1.*",
    "symfony/event-dispatcher": "2.1.*",
    "kunststube/router": "dev-master",
    "symfony/yaml": "2.1.*",
    "twig/twig": "1.*",
    "jms/serializer": ">=0.8.0,<=0.11.0"
  },

  "autoload": {
    "psr-0": {
      "": "src/"
    }
  }
}

% php composer.phar install
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file

  - Installing pimple/pimple (v1.0.2)
    Downloading: 100%

  - Installing twig/twig (v1.12.2)
    Downloading: 100%

  - Installing symfony/yaml (v2.1.8)
    Downloading: 100%

  [...]

Generating autoload files

.
├── [...]
├── composer.json
├── composer.lock
└── vendor
    ├── autoload.php
    ├── [...]
    ├── kunststube
    │   └── router
    ├── pimple
    │   └── pimple
    ├── symfony
    │   ├── event-dispatcher
    │   └── yaml
    └── twig
        └── twig

Autoloading

require 'vendor/autoload.php';

Dans un bootstrap de tests :

$loader = require 'vendor/autoload.php';
$loader->add('Acme\\Test\\', __DIR__);

Commandes utiles

• install : lit composer.lock et installe les dépendances
• update :
  • lit composer.json
  • vérifie les dépendances
  • installe/met à jour et maintient composer.lock
• require
  • ajoute une entrée dans composer.json
  • vérifie les dépendances
  • installe et maintient composer.lock

Quelques conseils

• composer.phar à jour
• php composer.phar --prefer-dist --optimize-autoloader pour les déploiements
• update <package>
• .gitignore

Pour aller plus loin

• stability flags
• dev requirements
• scripts
• Platform packages (version de PHP, extensions)