composer: game changing dependency management

172
Composer Game Changing Dependency Management php[architect] DevOps Summit Series Jeremy Kendall

Upload: jeremy-kendall

Post on 06-May-2015

2.161 views

Category:

Technology


2 download

DESCRIPTION

Managing dependencies and third-party code in PHP applications is a daily challenge, keeping everyone on the same versions during development and at deploy time a struggle. Meet Composer, a tool designed to help you maintain a consistent set of dependencies as well as share and discover new libraries. Let’s see how you can use this tool in your Applications and Libraries to wrangle your dependencies with a simple json configuration file and a command line interface.

TRANSCRIPT

Page 1: Composer: Game Changing Dependency Management

ComposerGame Changing Dependency Management

php[architect] DevOps Summit Series Jeremy Kendall

Page 2: Composer: Game Changing Dependency Management
Page 3: Composer: Game Changing Dependency Management

I love to code

Page 4: Composer: Game Changing Dependency Management

I love to code

I’m terribly forgetful

Page 5: Composer: Game Changing Dependency Management

I love to code

I’m terribly forgetful

I take pictures

Page 6: Composer: Game Changing Dependency Management

I love to code

I’m terribly forgetful

I take pictures

I work at OpenSky

Page 7: Composer: Game Changing Dependency Management

Adding Dependencies is Easy

Page 8: Composer: Game Changing Dependency Management

Adding Dependencies is Easy

‣ Copy and Paste

Page 9: Composer: Game Changing Dependency Management

Adding Dependencies is Easy

‣ Copy and Paste

‣ DIY Solution

Page 10: Composer: Game Changing Dependency Management

Adding Dependencies is Easy

‣ Copy and Paste

‣ DIY Solution

‣ SVN Externals

Page 11: Composer: Game Changing Dependency Management

Adding Dependencies is Easy

‣ Copy and Paste

‣ DIY Solution

‣ SVN Externals

‣ Git Submodules

Page 12: Composer: Game Changing Dependency Management

Managing them is Messy

Page 13: Composer: Game Changing Dependency Management

What is Composer?

Page 14: Composer: Game Changing Dependency Management

What is Composer?

‣ Dependency management tool

Page 15: Composer: Game Changing Dependency Management

What is Composer?

‣ Dependency management tool

‣ Per-project

Page 16: Composer: Game Changing Dependency Management

What is Composer?

‣ Dependency management tool

‣ Per-project

‣ Inspired by:

Page 17: Composer: Game Changing Dependency Management

What is Composer?

‣ Dependency management tool

‣ Per-project

‣ Inspired by:

‣ node’s npm

Page 18: Composer: Game Changing Dependency Management

What is Composer?

‣ Dependency management tool

‣ Per-project

‣ Inspired by:

‣ node’s npm

‣ ruby’s bundler

Page 19: Composer: Game Changing Dependency Management

Benefits

Page 20: Composer: Game Changing Dependency Management

Benefits

‣ Easily declare project dependencies

Page 21: Composer: Game Changing Dependency Management

Benefits

‣ Easily declare project dependencies

‣ Updating dependency versions extremely simple

Page 22: Composer: Game Changing Dependency Management

Benefits

‣ Easily declare project dependencies

‣ Updating dependency versions extremely simple

‣ Ensures your team is on the same page

Page 23: Composer: Game Changing Dependency Management

Benefits

‣ Easily declare project dependencies

‣ Updating dependency versions extremely simple

‣ Ensures your team is on the same page

‣ Tons of excellent related features

Page 24: Composer: Game Changing Dependency Management

Installing

Page 25: Composer: Game Changing Dependency Management

Installing Locally$ curl -sS https://getcomposer.org/installer | phpIn your project:

Page 26: Composer: Game Changing Dependency Management

Installing Locally$ curl -sS https://getcomposer.org/installer | phpIn your project:

$ curl -sS https://getcomposer.org/installer | php -- --install-dir=binSpecify a directory:

Page 27: Composer: Game Changing Dependency Management

Installing Locally$ curl -sS https://getcomposer.org/installer | phpIn your project:

$ curl -sS https://getcomposer.org/installer | php -- --install-dir=binSpecify a directory:

$ curl -sS https://getcomposer.org/installer | php#!/usr/bin/env phpAll settings correct for using ComposerDownloading...

Composer successfully installed to: /Users/jkendall/dev/composer.pharUse it: php composer.phar

What you’ll see:

Page 28: Composer: Game Changing Dependency Management

Installing Globally

$ curl -sS https://getcomposer.org/installer | php$ mv composer.phar /usr/local/bin/composer

Recommended

Page 29: Composer: Game Changing Dependency Management

Installing Globally

$ curl -sS https://getcomposer.org/installer | php$ mv composer.phar /usr/local/bin/composer

(You might need to use sudo)

Recommended

Page 30: Composer: Game Changing Dependency Management

(There’s an installer for Windows folks)

Page 31: Composer: Game Changing Dependency Management

Keeping up to Date

$ composer self-updateYou are using the latest composer version.

$ php composer.phar self-updateYou are using the latest composer version.

or

Page 32: Composer: Game Changing Dependency Management

Keeping up to Date

$ composer self-updateYou are using the latest composer version.

(Always updates to the latest dev-master)

$ php composer.phar self-updateYou are using the latest composer version.

or

Page 33: Composer: Game Changing Dependency Management

Defining Dependencies

Page 34: Composer: Game Changing Dependency Management

composer.json

{ "require": { "monolog/monolog": "1.5.*" }}

Page 35: Composer: Game Changing Dependency Management

composer.json

{ "require": { "monolog/monolog": "1.5.*" }}

‣Place in the root of your project

Page 36: Composer: Game Changing Dependency Management

composer.json

{ "require": { "monolog/monolog": "1.5.*" }}

‣Place in the root of your project‣“require” specifies package and version

Page 37: Composer: Game Changing Dependency Management

composer.json

{ "require": { "monolog/monolog": "1.5.*" }}

‣Place in the root of your project‣“require” specifies package and version‣monolog logging library

Page 38: Composer: Game Changing Dependency Management

composer.json

{ "require": { "monolog/monolog": "1.5.*" }}

‣Place in the root of your project‣“require” specifies package and version‣monolog logging library‣Version >= 1.5.0 and < 1.6

Page 39: Composer: Game Changing Dependency Management

composer.json

{ "require": { "monolog/monolog": "1.5.*" }}

‣Place in the root of your project‣“require” specifies package and version‣monolog logging library‣Version >= 1.5.0 and < 1.6‣No fuss, no muss

Page 40: Composer: Game Changing Dependency Management

Versions

Page 41: Composer: Game Changing Dependency Management

‣ Exact version: 1.0.0, 12.2.4, etc.

Versions

Page 42: Composer: Game Changing Dependency Management

‣ Exact version: 1.0.0, 12.2.4, etc.

‣Wildcard: 3.*, 4.2.*

Versions

Page 43: Composer: Game Changing Dependency Management

‣ Exact version: 1.0.0, 12.2.4, etc.

‣Wildcard: 3.*, 4.2.*

‣ Range: >, >=, <=, !=

Versions

Page 44: Composer: Game Changing Dependency Management

‣ Exact version: 1.0.0, 12.2.4, etc.

‣Wildcard: 3.*, 4.2.*

‣ Range: >, >=, <=, !=

‣ Example: >=2.4

Versions

Page 45: Composer: Game Changing Dependency Management

‣ Exact version: 1.0.0, 12.2.4, etc.

‣Wildcard: 3.*, 4.2.*

‣ Range: >, >=, <=, !=

‣ Example: >=2.4

‣ Range: >=1.0,<1.7 (comma separated)

Versions

Page 46: Composer: Game Changing Dependency Management

‣ Exact version: 1.0.0, 12.2.4, etc.

‣Wildcard: 3.*, 4.2.*

‣ Range: >, >=, <=, !=

‣ Example: >=2.4

‣ Range: >=1.0,<1.7 (comma separated)

‣ Next Significant Release: ~1.3.3

Versions

Page 47: Composer: Game Changing Dependency Management

Installing Dependencies

$ composer installLoading composer repositories with package informationInstalling dependencies (including require-dev) - Installing psr/log (1.0.0) Loading from cache

- Installing monolog/monolog (1.5.0) Loading from cache

monolog/monolog suggests installing mlehner/gelf-php (Allow sending log messages to a GrayLog2 server)monolog/monolog suggests installing raven/raven (Allow sending log messages to a Sentry server)monolog/monolog suggests installing doctrine/couchdb (Allow sending log messages to a CouchDB server)monolog/monolog suggests installing ext-amqp (Allow sending log messages to an AMQP server (1.0+ required))Writing lock fileGenerating autoload files

composer install

Page 48: Composer: Game Changing Dependency Management

composer.lock

Page 49: Composer: Game Changing Dependency Management

composer.lock

‣ install writes a dependency lock file

Page 50: Composer: Game Changing Dependency Management

composer.lock

‣ install writes a dependency lock file

‣ List of exact versions installed

Page 51: Composer: Game Changing Dependency Management

composer.lock

‣ install writes a dependency lock file

‣ List of exact versions installed

‣ Commit both composer.lock and composer.json

Page 52: Composer: Game Changing Dependency Management

composer.lock

‣ install writes a dependency lock file

‣ List of exact versions installed

‣ Commit both composer.lock and composer.json

‣ composer install now checks the lock file, not composer.json

Page 53: Composer: Game Changing Dependency Management

composer.lock

‣ install writes a dependency lock file

‣ List of exact versions installed

‣ Commit both composer.lock and composer.json

‣ composer install now checks the lock file, not composer.json

‣ Update dependencies with composer update

Page 54: Composer: Game Changing Dependency Management

Updating Dependencies

Page 55: Composer: Game Changing Dependency Management

Updating Dependencies

{ "require": { "monolog/monolog": "1.6.*@dev" }}

Page 56: Composer: Game Changing Dependency Management

Updating Dependencies

{ "require": { "monolog/monolog": "1.6.*@dev" }}

‣Updates monolog library version

Page 57: Composer: Game Changing Dependency Management

Updating Dependencies

{ "require": { "monolog/monolog": "1.6.*@dev" }}

‣Updates monolog library version‣Version >= 1.6.0 and < 1.7 (dev)

Page 58: Composer: Game Changing Dependency Management

Updating Dependencies

$ composer updateLoading composer repositories with package informationUpdating dependencies (including require-dev) - Removing monolog/monolog (1.5.0) - Installing monolog/monolog (dev-master c933bb6) Cloning c933bb67a8a2e45c42d0626a0cd6569789bf6ed7

Writing lock fileGenerating autoload files

composer update

Page 59: Composer: Game Changing Dependency Management

Updating Dependencies

$ composer updateLoading composer repositories with package informationUpdating dependencies (including require-dev) - Removing monolog/monolog (1.5.0) - Installing monolog/monolog (dev-master c933bb6) Cloning c933bb67a8a2e45c42d0626a0cd6569789bf6ed7

Writing lock fileGenerating autoload files

‣Reads from composer.json

composer update

Page 60: Composer: Game Changing Dependency Management

Updating Dependencies

$ composer updateLoading composer repositories with package informationUpdating dependencies (including require-dev) - Removing monolog/monolog (1.5.0) - Installing monolog/monolog (dev-master c933bb6) Cloning c933bb67a8a2e45c42d0626a0cd6569789bf6ed7

Writing lock fileGenerating autoload files

‣Reads from composer.json‣Updates dependencies

composer update

Page 61: Composer: Game Changing Dependency Management

Updating Dependencies

$ composer updateLoading composer repositories with package informationUpdating dependencies (including require-dev) - Removing monolog/monolog (1.5.0) - Installing monolog/monolog (dev-master c933bb6) Cloning c933bb67a8a2e45c42d0626a0cd6569789bf6ed7

Writing lock fileGenerating autoload files

‣Reads from composer.json‣Updates dependencies‣Rewrites lock file

composer update

Page 62: Composer: Game Changing Dependency Management

Adding New Dependencies

Edit composer.json . . .

{ "require": { "monolog/monolog": "1.6.*@dev", "ircmaxell/password-compat": "1.0.3"

}}

Page 63: Composer: Game Changing Dependency Management

Adding New DependenciesOr use the command line

$ composer require ircmaxell/password-compat:1.0.3composer.json has been updatedLoading composer repositories with package informationUpdating dependencies (including require-dev) - Installing ircmaxell/password-compat (1.0.3) Downloading: 100%

Writing lock fileGenerating autoload files

composer require

Page 64: Composer: Game Changing Dependency Management

Autoloading

Page 65: Composer: Game Changing Dependency Management

Autoloading

‣ Composer generates vendor/autoload.php

Page 66: Composer: Game Changing Dependency Management

Autoloading

‣ Composer generates vendor/autoload.php

‣ Add require ‘vendor/autoload.php’;

Page 67: Composer: Game Changing Dependency Management

Autoloading

‣ Composer generates vendor/autoload.php

‣ Add require ‘vendor/autoload.php’;

‣ Immediately begin using your dependencies

Page 68: Composer: Game Changing Dependency Management

Autoloading

{ "require": { "monolog/monolog": "1.6.*@dev" }, "autoload": { "psr-0": { "Beeblebrox\\": "src/" } }}

Don’t forget to add your own code!

Page 69: Composer: Game Changing Dependency Management

Autoloading

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

Pro Tip

Grab an autoloader instance and add more namespaces.

Page 70: Composer: Game Changing Dependency Management

Kickstart a Project

$ composer create-project slim/slim-skeleton super-sweet-applicationInstalling slim/slim-skeleton (1.1.0) - Installing slim/slim-skeleton (1.1.0) Downloading: 100%

Created project in super-sweet-applicationLoading composer repositories with package informationInstalling dependencies (including require-dev) - Installing slim/slim (2.3.0) Downloading: 100%

- Installing slim/extras (2.0.3) Loading from cache

- Installing twig/twig (v1.13.1) Loading from cache

Writing lock fileGenerating autoload files

composer create-project

Page 71: Composer: Game Changing Dependency Management

Your Very Own Library

Page 72: Composer: Game Changing Dependency Management

Libraries

Page 73: Composer: Game Changing Dependency Management

Libraries

‣ Everyone has written a library of some sort

Page 74: Composer: Game Changing Dependency Management

Libraries

‣ Everyone has written a library of some sort

‣ Making up examples is not my strong suit

Page 75: Composer: Game Changing Dependency Management

Libraries

‣ Everyone has written a library of some sort

‣ Making up examples is not my strong suit

‣ Let’s walk through a real library . . .

Page 76: Composer: Game Changing Dependency Management

Libraries

‣ Everyone has written a library of some sort

‣ Making up examples is not my strong suit

‣ Let’s walk through a real library . . .

‣ . . . and check out some awesome Composer features

Page 77: Composer: Game Changing Dependency Management

PHP Domain Parser

https://github.com/jeremykendall/php-domain-parser

Page 78: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

Page 79: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

Package requirements

Page 80: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

Package requirements

Autoloading

Page 81: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

Add the “name” keyand it’s installable

Page 82: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

Additional metadata

Page 83: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

Don’t forget the license!

Page 84: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

Full fledged library!

Page 85: Composer: Game Changing Dependency Management

Now for the cool(er) stuff . . .

Page 86: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

require-dev

Page 87: Composer: Game Changing Dependency Management

require-dev

Page 88: Composer: Game Changing Dependency Management

require-dev

‣ Lists packages required for development (think tests)

Page 89: Composer: Game Changing Dependency Management

require-dev

‣ Lists packages required for development (think tests)

‣ Only applies to the root package

Page 90: Composer: Game Changing Dependency Management

require-dev

‣ Lists packages required for development (think tests)

‣ Only applies to the root package

‣ Both install and update install require-dev by default

Page 91: Composer: Game Changing Dependency Management

require-dev

‣ Lists packages required for development (think tests)

‣ Only applies to the root package

‣ Both install and update install require-dev by default

‣ (Use the --no-dev flag to skip installing dev dependencies)

Page 92: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

bin

Page 93: Composer: Game Changing Dependency Management

bin

Page 94: Composer: Game Changing Dependency Management

bin

‣ cli scripts to pass along to package users

Page 95: Composer: Game Changing Dependency Management

bin

‣ cli scripts to pass along to package users

‣ A set of files that should be treated as binaries

Page 96: Composer: Game Changing Dependency Management

bin

‣ cli scripts to pass along to package users

‣ A set of files that should be treated as binaries

‣ Installs binaries to vendor/bin for any project that depends on your project

Page 97: Composer: Game Changing Dependency Management

bin

‣ cli scripts to pass along to package users

‣ A set of files that should be treated as binaries

‣ Installs binaries to vendor/bin for any project that depends on your project

‣ php-domain-parser uses a bin to update the local copy of the public suffix list

Page 98: Composer: Game Changing Dependency Management

{ "name": "jeremykendall/php-domain-parser", "description": "Public Suffix List based URL parsing implemented in PHP.", "license": "MIT", "authors": [ { "name": "Jeremy Kendall", "homepage": "http://about.me/jeremykendall", "role": "Developer" } ], "bin": ["bin/pdp-psl"], "keywords": ["Public Suffix List", "domain parsing", "url parsing"], "require": { "php": ">=5.3.0", "ext-curl": "*" }, "require-dev": { "mikey179/vfsStream": "1.1.*", "jeremykendall/phpctagger": "0.0.*" }, "autoload": { "psr-0": { "Pdp": "library/" } }, "scripts": { "post-install-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ], "post-update-cmd": [ "PhpCtagger\\Composer\\Script\\Ctagger::ctag" ] }}

scripts

Page 99: Composer: Game Changing Dependency Management

scripts

Page 100: Composer: Game Changing Dependency Management

scripts

‣ Used to execute custom code during the Composer execution process

Page 101: Composer: Game Changing Dependency Management

scripts

‣ Used to execute custom code during the Composer execution process

‣ PHP callback (defined as a static method) . . .

Page 102: Composer: Game Changing Dependency Management

scripts

‣ Used to execute custom code during the Composer execution process

‣ PHP callback (defined as a static method) . . .

‣ . . . or any command-line executable command

Page 103: Composer: Game Changing Dependency Management

scripts

‣ Used to execute custom code during the Composer execution process

‣ PHP callback (defined as a static method) . . .

‣ . . . or any command-line executable command

‣ Only scripts defined in the root composer.json are executed

Page 104: Composer: Game Changing Dependency Management

scripts

‣ Used to execute custom code during the Composer execution process

‣ PHP callback (defined as a static method) . . .

‣ . . . or any command-line executable command

‣ Only scripts defined in the root composer.json are executed

‣ If a script is defined in a dependency, you can use it in your composer.json

Page 105: Composer: Game Changing Dependency Management

scripts

Page 106: Composer: Game Changing Dependency Management

scripts

‣ Composer fires “named events” during execution

Page 107: Composer: Game Changing Dependency Management

scripts

‣ Composer fires “named events” during execution

‣ Named events include:

Page 108: Composer: Game Changing Dependency Management

scripts

‣ Composer fires “named events” during execution

‣ Named events include:

‣ pre- and post-install-cmd

Page 109: Composer: Game Changing Dependency Management

scripts

‣ Composer fires “named events” during execution

‣ Named events include:

‣ pre- and post-install-cmd

‣ pre- and post-update-cmd

Page 110: Composer: Game Changing Dependency Management

scripts

‣ Composer fires “named events” during execution

‣ Named events include:

‣ pre- and post-install-cmd

‣ pre- and post-update-cmd

‣ post-root-package-install

Page 111: Composer: Game Changing Dependency Management

scripts

‣ Composer fires “named events” during execution

‣ Named events include:

‣ pre- and post-install-cmd

‣ pre- and post-update-cmd

‣ post-root-package-install

‣ Many more . . .

Page 112: Composer: Game Changing Dependency Management

Running scripts

Page 113: Composer: Game Changing Dependency Management

Running scripts

Execute Composer (script will execute if the named event is triggered) or . . .

Page 114: Composer: Game Changing Dependency Management

Running scripts

Execute Composer (script will execute if the named event is triggered) or . . .

Page 115: Composer: Game Changing Dependency Management

Running scripts

Execute Composer (script will execute if the named event is triggered) or . . .

composer run-script <named event>

Page 116: Composer: Game Changing Dependency Management

Example public static function create(Event $event) { $dir = dirname($event->getComposer()->getConfig()->get('vendor-dir'));

$io = $event->getIO();

$io->write('Reviewing your Flaming Archer environment . . .', true);

$configExists = file_exists($dir . '/config.php'); $configDistExists = file_exists($dir . '/config-dist.php');

if (!$configExists && $configDistExists) { $io->write('Creating config.php by copying config-dist.php . . .', true); copy($dir . '/config-dist.php', $dir . '/config.php'); $io->write("Done! Please edit config.php.", true); } else { $io->write('Found config.php.', true); } }

https://github.com/jeremykendall/flaming-archer/blob/develop/library/Fa/Composer/Script/Config.php

Page 117: Composer: Game Changing Dependency Management

You’ve built your library.Now what?

Page 118: Composer: Game Changing Dependency Management

Push it to a VCS

Page 119: Composer: Game Changing Dependency Management

Push it to a VCS‣ git, svn, or hg all work equally well

Page 120: Composer: Game Changing Dependency Management

Push it to a VCS‣ git, svn, or hg all work equally well

‣ For the sake of simplicity I’ll assume git/github

Page 121: Composer: Game Changing Dependency Management

Push it to a VCS‣ git, svn, or hg all work equally well

‣ For the sake of simplicity I’ll assume git/github

‣ Package versions:

Page 122: Composer: Game Changing Dependency Management

Push it to a VCS‣ git, svn, or hg all work equally well

‣ For the sake of simplicity I’ll assume git/github

‣ Package versions:

‣ Tags are package versions (1.0.0, v2.5.4, etc)

Page 123: Composer: Game Changing Dependency Management

Push it to a VCS‣ git, svn, or hg all work equally well

‣ For the sake of simplicity I’ll assume git/github

‣ Package versions:

‣ Tags are package versions (1.0.0, v2.5.4, etc)

‣ Branches are dev versions (dev-{branchname}, {branchname}-dev)

Page 124: Composer: Game Changing Dependency Management

Push it to a VCS‣ git, svn, or hg all work equally well

‣ For the sake of simplicity I’ll assume git/github

‣ Package versions:

‣ Tags are package versions (1.0.0, v2.5.4, etc)

‣ Branches are dev versions (dev-{branchname}, {branchname}-dev)

‣ For this reason, I strongly recommend using semantic versioning: http://semver.org

Page 125: Composer: Game Changing Dependency Management

Share!

Page 126: Composer: Game Changing Dependency Management

Packagist

Page 127: Composer: Game Changing Dependency Management

Packagist

Page 128: Composer: Game Changing Dependency Management

Packagist

‣ The main package repository for Composer

Page 129: Composer: Game Changing Dependency Management

Packagist

‣ The main package repository for Composer

‣ (Aside: Search Packagist before “rolling your own”)

Page 130: Composer: Game Changing Dependency Management

Packagist

‣ The main package repository for Composer

‣ (Aside: Search Packagist before “rolling your own”)

‣ Packages published there need no special settings in composer.json to be installable (see “repositories” key)

Page 131: Composer: Game Changing Dependency Management

Packagist

‣ The main package repository for Composer

‣ (Aside: Search Packagist before “rolling your own”)

‣ Packages published there need no special settings in composer.json to be installable (see “repositories” key)

‣ Submitting is dead simple

Page 132: Composer: Game Changing Dependency Management

Packagist

‣ The main package repository for Composer

‣ (Aside: Search Packagist before “rolling your own”)

‣ Packages published there need no special settings in composer.json to be installable (see “repositories” key)

‣ Submitting is dead simple

‣ Create account, hit big green submit button

Page 133: Composer: Game Changing Dependency Management

Packagist

Page 134: Composer: Game Changing Dependency Management

Packagist: Package Search

Page 135: Composer: Game Changing Dependency Management

Packagist: Keyword Search

Page 136: Composer: Game Changing Dependency Management

Packagist: Package

Page 137: Composer: Game Changing Dependency Management

But what about internal proprietary packages?

Page 138: Composer: Game Changing Dependency Management

Satis to the Rescue

Page 139: Composer: Game Changing Dependency Management

Satis to the Rescue

‣ Static composer repository generator

Page 140: Composer: Game Changing Dependency Management

Satis to the Rescue

‣ Static composer repository generator

‣ Lightweight, static file based version of Packagist

Page 141: Composer: Game Changing Dependency Management

Satis to the Rescue

‣ Static composer repository generator

‣ Lightweight, static file based version of Packagist

‣ Simple to configure

Page 142: Composer: Game Changing Dependency Management

Satis to the Rescue

‣ Static composer repository generator

‣ Lightweight, static file based version of Packagist

‣ Simple to configure

‣ Flexible

Page 143: Composer: Game Changing Dependency Management

$ composer create-project composer/satis --stability=dev --keep-vcsInstalling composer/satis (dev-master 059588ef0fd0977964ad13637e02012519686202) - Installing composer/satis (dev-master master) Cloning master

Created project in /Users/jkendall/dev/satisLoading composer repositories with package informationInstalling dependencies (including require-dev) from lock fileWarning: The lock file is not up to date with the latest changes in composer.json . . . - Installing symfony/process (dev-master 75c8101) Cloning 75c810176f8e069714cef8696d7ecc3aa86e8168

- [ . . . ]

- Installing twig/twig (v1.13.1) Loading from cache

symfony/console suggests installing symfony/event-dispatcher ()Generating autoload files

composer create-project composer/satis --stability=dev --keep-vcs

Page 144: Composer: Game Changing Dependency Management

Satis config.json

{ "name": "Satis Demo", "homepage": "http://satis.dev", "repositories": [ { "type": "vcs", "url": "https://github.com/jeremykendall/php-domain-parser" }, { "type": "vcs", "url": "https://github.com/jeremykendall/phpctagger" } ], "require": { "jeremykendall/php-domain-parser": ">=0.0.5", "jeremykendall/phpctagger": ">0.0.6" }, "archive": { "directory": "dist", "format": "tar" }}

Page 145: Composer: Game Changing Dependency Management

Satis config.json

{ "name": "Satis Demo", "homepage": "http://satis.dev", "repositories": [ { "type": "vcs", "url": "https://github.com/jeremykendall/php-domain-parser" }, { "type": "vcs", "url": "https://github.com/jeremykendall/phpctagger" } ], "require": { "jeremykendall/php-domain-parser": ">=0.0.5", "jeremykendall/phpctagger": ">0.0.6" }, "archive": { "directory": "dist", "format": "tar" }}

Page 146: Composer: Game Changing Dependency Management

Satis config.json

{ "name": "Satis Demo", "homepage": "http://satis.dev", "repositories": [ { "type": "vcs", "url": "https://github.com/jeremykendall/php-domain-parser" }, { "type": "vcs", "url": "https://github.com/jeremykendall/phpctagger" } ], "require": { "jeremykendall/php-domain-parser": ">=0.0.5", "jeremykendall/phpctagger": ">0.0.6" }, "archive": { "directory": "dist", "format": "tar" }}

Page 147: Composer: Game Changing Dependency Management

Satis config.json

{ "name": "Satis Demo", "homepage": "http://satis.dev", "repositories": [ { "type": "vcs", "url": "https://github.com/jeremykendall/php-domain-parser" }, { "type": "vcs", "url": "https://github.com/jeremykendall/phpctagger" } ], "require": { "jeremykendall/php-domain-parser": ">=0.0.5", "jeremykendall/phpctagger": ">0.0.6" }, "archive": { "directory": "dist", "format": "tar" }}

Page 148: Composer: Game Changing Dependency Management

Satis config.json

{ "name": "Satis Demo", "homepage": "http://satis.dev", "repositories": [ { "type": "vcs", "url": "https://github.com/jeremykendall/php-domain-parser" }, { "type": "vcs", "url": "https://github.com/jeremykendall/phpctagger" } ], "require": { "jeremykendall/php-domain-parser": ">=0.0.5", "jeremykendall/phpctagger": ">0.0.6" }, "archive": { "directory": "dist", "format": "tar" }}

Page 149: Composer: Game Changing Dependency Management

Build Repo

$ php bin/satis build config.json web/

Page 150: Composer: Game Changing Dependency Management

composer.json

{ "repositories": [ { "type": "composer", "url": "http://satis.dev" } ], "require": { "jeremykendall/php-domain-parser": "0.0.7" }}

Page 151: Composer: Game Changing Dependency Management

composer.json

{ "repositories": [ { "type": "composer", "url": "http://satis.dev" } ], "require": { "jeremykendall/php-domain-parser": "0.0.7" }}

Page 152: Composer: Game Changing Dependency Management

composer.json

{ "repositories": [ { "type": "composer", "url": "http://satis.dev" } ], "require": { "jeremykendall/php-domain-parser": "0.0.7" }}

Page 153: Composer: Game Changing Dependency Management

Satis Demo Project

Page 154: Composer: Game Changing Dependency Management

Satis Demo Project

‣Want to goof around with Satis?

Page 155: Composer: Game Changing Dependency Management

Satis Demo Project

‣Want to goof around with Satis?

‣ See: https://github.com/jeremykendall/satis-demo

Page 156: Composer: Game Changing Dependency Management

Satis Demo Project

‣Want to goof around with Satis?

‣ See: https://github.com/jeremykendall/satis-demo

‣ Clone, follow instructions in README, and WIN

Page 157: Composer: Game Changing Dependency Management

Satis Demo Project

‣Want to goof around with Satis?

‣ See: https://github.com/jeremykendall/satis-demo

‣ Clone, follow instructions in README, and WIN

‣ Satis really is dead simple to set up

Page 158: Composer: Game Changing Dependency Management

Parting Tips and Tricks

Page 159: Composer: Game Changing Dependency Management

composer install --no-dev --prefer-dist --optimize-autoloader

Page 160: Composer: Game Changing Dependency Management

“example/package”: “2.3.x-dev#5aec89a”

Page 161: Composer: Game Changing Dependency Management

Non-Composer and PEAR packages can be installed (see “repositories” key documentation)

Page 162: Composer: Game Changing Dependency Management

http://getcomposer.org

#composer on irc.freenode.org

Page 163: Composer: Game Changing Dependency Management

There’s So Much More!

Page 164: Composer: Game Changing Dependency Management

Credits

Page 165: Composer: Game Changing Dependency Management

Credits

‣ Thanks to php[architect] for having me

IMMA LET YOU FINISH, BUT RAFAEL DOHMS

HAS THE BEST COMPOSER TALK OF

ALL TIME.

Page 166: Composer: Game Changing Dependency Management

Credits

Page 167: Composer: Game Changing Dependency Management

Credits

‣ Thanks to Rafael Dohms, the Composer presenter

Page 168: Composer: Game Changing Dependency Management

Credits

‣ Thanks to Rafael Dohms, the Composer presenter

‣ Thanks to php[architect] for having me

Page 169: Composer: Game Changing Dependency Management

Credits

‣ Thanks to Rafael Dohms, the Composer presenter

‣ Thanks to php[architect] for having me

‣ Thanks to Jordi Boggiano, Nils Adermann, and the community for an amazing project (and all the documentation I cribbed from)

Page 170: Composer: Game Changing Dependency Management

Credits

‣ Thanks to Rafael Dohms, the Composer presenter

‣ Thanks to php[architect] for having me

‣ Thanks to Jordi Boggiano, Nils Adermann, and the community for an amazing project (and all the documentation I cribbed from)

‣ Thanks to our sponsors for help making this happen

Page 171: Composer: Game Changing Dependency Management

Credits

‣ Thanks to Rafael Dohms, the Composer presenter

‣ Thanks to php[architect] for having me

‣ Thanks to Jordi Boggiano, Nils Adermann, and the community for an amazing project (and all the documentation I cribbed from)

‣ Thanks to our sponsors for help making this happen

‣ Thanks to all of you for being here

Page 172: Composer: Game Changing Dependency Management

Thanks!

[email protected]

http://about.me/jeremykendall

@jeremykendall

https://joind.in/8968