Composer the Right Way - PHPSRB16

Composer
the right way
@rdohms
Rafael Dohms

Library Publisher
photo: 18millionpixels

Library Publisher
Library Consumer

Library Publisher
Library
Library Consumer

Library Publisher
Library
Library Consumer
Packagist

{
"require": {
"monolog/monolog": “2.0”
}
}

{
"require": {
}
}
{
"name": “monolog/monolog”
...
}

{
"require": {
}
}
{
...
}
./composer.json has been updated
Loading composer repositories with package information
Updating dependencies (including require-dev)
Your requirements could not be resolved to an installable set of packages.
Problem 1
- The requested package monolog/monolog could not be found in any version, there may be a typo in the package name.
Potential causes:
- A typo in the package name
- The package is not available in a stable-enough version according to your minimum-stability setting
see <https://groups.google.com/d/topic/composer-dev/_g3ASeIFlrc/discussion> for more details.
Read <http://getcomposer.org/doc/articles/troubleshooting.md> for further common problems.
Installation failed, reverting ./composer.json to its original content.

{
"require": {
}
}
{
...
}
Problem 1
Potential causes:
___ 
~1.1

{
"require": {
}
}
{
...
}
Problem 1
Potential causes:
- Installing psr/log (1.0.0)
Loading from cache
- Installing monolog/monolog (1.11.0)
Downloading: 100%
monolog/monolog suggests installing graylog2/gelf-php (Allow sending log messages to a GrayLog2 server)
[...]
monolog/monolog suggests installing ext-mongo (Allow sending log messages to a MongoDB server)
monolog/monolog suggests installing aws/aws-sdk-php (Allow sending log messages to AWS services like DynamoDB)
monolog/monolog suggests installing rollbar/rollbar (Allow sending log messages to Rollbar)
Writing lock file
Generating autoload files
___ 
~1.1

composercomposer.json!
composer.lock!

discovery Packagist
"
composer.lock!

discovery sourcePackagist
"
Repository
#
composer.lock!

discovery source
installation
Packagist
"
Vendor 
Folder
$
Repository
#
composer.lock!

2 139 872 458
two billion, one hundred and thirty-nine million,
eight hundred and seventy-two thousand, four
hundred and ﬁfty-eight .
+

$ composer self-update
Production
$ composer self-update --snapshot
Development
$ composer self-update --preview
CI / Build

$ composer init
Library Publisher

$ composer init
Library Publisher
$ composer require <vendor>/<package>
Library Consumer

Install instructions
1. Edit your composer.json

2. Add `package/vendor`

3. Run `composer update`

3. Run `composer update`
or was that install? err… i can’t remember.

$ composer require monolog/monolog
Tip

$ composer require monolog/monolog
Tip
Using version ^1.11 for monolog/monolog

$ composer require monolog/monolog --sort-packages
Tip

$ composer remove monolog/monolog
Tip

Library Publishers
Composer for

Library Publisher Unique vendor names
vendor / package

pick your own  
unique vendor

or join a collective

README!
CHANGELOG%
LICENSE&
Library Publisher What’s in your library?

README!
CHANGELOG%
LICENSE&
' What problem does it solve?
' Usage examples
' Install instructions
' How can I contribute?

README!
CHANGELOG%
LICENSE&
' List relevant changes
' Make BC breaks prominent
' Show examples of how to upgrade
' Usage examples

README!
CHANGELOG%
LICENSE&
' List relevant changes
' Make BC breaks prominent
' Show examples of how to upgrade
' Pick one that reﬂects your values
' choosealicense.com can help
' Usage examples

Library Publisher Semantic Versioning
1 . 2 3.major minor patch

Bug Fixes

New Features Bug Fixes

API / BC
Breaks
New Features Bug Fixes

Library Publisher Tagging
Please, tag your
releases.

Library Publisher Tagging
Please, tag your
releases.
often!

Library Publisher “I'm out"
photo: nickwebb

Library Publisher “I'm out"
Click here and provide an alternative

Pick the  
correct  
version
Library Publisher Pick a Version

*the asterisk

*the asterisk○Library Publisher Pick a Version

~the tilde

~1.2
>=1.2.0, <2.0.0

~1.2
>=1.2.0, <2.0.0
)

~1.2.3
>=1.2.3, <1.3

~1.2.3
>=1.2.3, <1.3
)

Yo @rdohms, I’m
really happy for you and
I’m gonna let you ﬁnish, but
the tilde operator is
totally old news.

^the caret

1.2.3
>=1.2.3, <2.0.0
^

1.2.3
>=1.2.3, <2.0.0
)
^
)

0.3.0
>=0.3.0, <0.4.0
^

0.3.0
>=0.3.0, <0.4.0
^
)

0.3.0
>=0.3.0, <0.4.0
^
)
Major Version Zero

"require": {
"zendframework/zend-stdlib": “2.1.*”,
"zendframework/zend-servicemanager": "2.1.*",
},
“require-dev": {
“phpunit/phpunit": “~3.7”
}
"require": {
"zendframework/zend-stdlib": “^2.3”,
"zendframework/zend-servicemanager": “^2.3",
},
“require-dev": {
“phpunit/phpunit": “~4”
}
3rd party library
Your application

"require": {
},
“require-dev": {
}
"require": {
},
“require-dev": {
}
3rd party library
Your application
*

"require": {
},
“require-dev": {
}
"require": {
},
“require-dev": {
}
3rd party library
Your application
*
^2.1

Library Consumers
Composer for

Library Consumer Install or update?
install or update?

Make sure you have
installed the last
updates from other
developers.
?
install updateor

Deploying a new
release of your
application to
production.
?
install updateor

Checked out a new
project and want to
start coding.
?
install updateor

Grab new versions for
the dependencies of
your project.
?
install updateor

Your application
$
Public
Repository
#
composer.lock!
composer install
composer update

Your application
$
Public
Repository
#
composer.lock!
read
composer install
composer update

Your application
$
Public
Repository
#
composer.lock!
read grab version
composer install
composer update

Your application
$
Public
Repository
#
composer.lock!
read grab version
check latest compatible release
composer install
composer update

Your application
$
Public
Repository
#
composer.lock!
read grab version
update
composer install
composer update

Your application
$
Public
Repository
#
composer.lock!
read grab version
update
composer install
composer update
no lock ﬁle? composer update

commit your lock ﬁle*

* always! ignore what Marco says.

* always! ignore what Marco says.
** we will discuss that over beer.

$ composer update —interactive (-i)
Tip
since beta1

Pick the  
correct  
version
Library Consumer Version Selection

Library Consumer Version Selection
dev-master

Composer the Right Way - PHPSRB16

Composer the Right Way - PHPSRB16

More Related Content

What's hot

Viewers also liked

Similar to Composer the Right Way - PHPSRB16

More from Rafael Dohms

Recently uploaded

Composer the Right Way - PHPSRB16