SlideShare ist ein Scribd-Unternehmen logo
1 von 75
Downloaden Sie, um offline zu lesen
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 1
PHP Dependency
Management with
Composer
Clark Everetts
Sr. Professional Services Consultant
18 October 2016
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 2
Slides, Joind.in, and Stuff
• Rate & comment: https://joind.in/talk/04872
• Slides: https://www.slideshare.net/clarkphp
• Tweets: #ZendCon2016
• @clarkphp
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 3
Why are we here? Our Agenda
• What is it? What problem does it solve?
• What does it actually do?
• Composer.json & composer.lock
• Semantic Versioning, Version Constraints
• Packages, Repositories and Packagist
• Do’s and Don’ts / Best Practices
• Create a Private Repository
Cool logo!
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 4
Assumption: You’ve seen JSON
(JavaScript Object Notation)
Jason is scary.
JSON is not.
*https://en.wikipedia.org/wiki/Jason_Voorhees
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 5
INTRODUCTION/
BACKGROUND
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 6
Composer is …
… a per-project PHP
dependency
manager*
*(plus autoloader)
That’s all.
Any questions?
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 7
… a per-project
PHP
dependency
manager
Let’s break it down.
Composer is …
* Paraphrased from
https://getcomposer.org/doc/00-intro.md
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 8
PHP Package Dependencies
… a per-project PHP dependency manager
• PHP project-related files only
• Can include assets like Javascript, images, XML, CSS, etc.
• But not for managing Javascript or CSS libraries
• Primarily a development - not production – tool (“can” be prod*)
*but generally,
I’m not a fan
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 9
What’s a “dependency?”
… a per-project PHP dependency manager
You wrote these to
reuse across apps.
3rd-Party
ZF2, Laravel, OAuth2,
Symfony
Your Project
DEPENDENCIES,
PACKAGES,
LIBRARIES
“Project” == Application
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 10
Dependencies can have dependencies
… a per-project PHP dependency manager
Your Project “Project” == Application == Library == Package
DEPENDENCIES,
PACKAGES,
LIBRARIES
“I need
A, B, C, D”
A B C D
“I need
E” E F
“I need
E”
Composer obtains all
specified dependencies.
HG
“I need G,
H”
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 11
Want to manage that yourself?
“I need these”
“I need
this”
A B C
E
D
F
G H
“I
need
that”
“I need the
other”
You’d need to:
• Identify the direct dependencies of your project
• Identify their dependencies, and all sub-dependencies
• Locate the source code (PEAR, Git, Subversion, zip/gzip/bz2)
• Download and install all of the source code
• Make sure all the versions are compatible
• Check for updates to any of the dependencies
• Do it all again when updates are available
With your guidance,
Composer does all
this for you.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 12
Different versions of the same package
… a per-project PHP dependency manager
Application
A
Application
B
Lib Y
1.0.1
Lib X
2.4.1
Lib Y
1.0.1
Lib X
1.2.0
Two projects, each using a
different version of the same
dependencies.
Composer is not a global
“package manager”
PEAR, APT, YUM,
Include_path
Why do this?
• Application A is stable, new features or bug fixes not relevant
• Working with development version: Dev, Alpha, Beta, RC
• Update cycle for App A !== App B
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 13
To Reiterate: per-project; not global
… a per-project PHP dependency manager
Application
A
Application
B
Lib Y
1.0.1
Lib X
2.4.1
Lib Y
1.0.1
Lib X
2.4.1
Two projects, each using
same version of the same
dependencies.
Each project has it’s own copy.
• Like a PHAR (PHP Archive) file, all dependencies are available in the application
directory tree.
• Updates to the dependencies of one application do not affect another.
• .gitattribute notwithstanding, potentially many copies of the exact same library
source code on disk.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 14
Composer is…
… a per-project PHP dependency manager
• Knows what packages your application or library
depends upon
• Obtains those packages, and all of their
dependencies, and installs appropriate versions of
them into your project (and local cache)
• When requested, checks for updates compatible
with your project, and downloads them into your
project (and local cache)
• Allows you to pin multiple applications/libraries to
the same or different versions of the packages they
use.
Composer makes it
easier to manage
application
dependencies.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 15
Now What?
Answered some questions, raised others:
• How do we inform Composer what dependencies a
project has?
– composer.json, composer.lock
• Where does it put the dependencies in the project?
– vendor folder
• Where does Composer obtain dependencies?
– repositories
• How does the project access to those
dependencies when it needs them?
– autoloading
• How do we install Composer and start using it?
A closer look…
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 16
INSTALL COMPOSER
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 17
Installation
• Windows
– https://getcomposer.org/Composer-Setup.exe
– https://getcomposer.org/doc/00-intro.md#installation-windows
– Or, GitBash, and follow *nix instructions
• *nix and IBM i PASE
– https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx
– Command line instructions on https://getcomposer.org/download/
• Manual Download on same page https://getcomposer.org/download/
• IBM i
– CALL QP2TERM (or ssh)
– Before installing, check KB article:
– https://support.zend.com/hc/en-us/articles/205679027-Add-a-trusted-
certificate-authority-to-IBM-i-for-PHP-5-6 (though I think downloading via
browser from https://curl.haxx.se/docs/caextract.html is better)
• Once installed, updates are easy:
– $ composer self-update
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 18
Help is available
• Get help
– $ composer help (top-level help)
– $ composer list (list available commands)
– $ composer help <command> (help on specified command)
• Documentation
– https://getcomposer.org/doc/01-basic-usage.md
– https://getcomposer.org/doc/03-cli.md (command line interface)
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 19
COMPOSER.JSON &
COMPOSER.LOCK
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 20
General Tips
• Don’t edit composer.json files. Use the command line tooling!
– $ composer require zendframework/zend-mvc
• Add require entry for the component, specifying the latest stable release that does not
conflict with other requirements
– $ composer require --dev phpunit/phpunit
• Specify development requirements (libraries needed to edit/test the dependency)
– $ composer require --update-no-dev monolog/monolog
• Add package, with no dev dependencies (we’re consuming only, not developing/testing)
– $ composer require "zendframework/zend-mvc:^2.5"
• Specify constraints
– $ composer require "zendframework/zend-mvc:^3.0@dev"
• Specify stability requirements
– $ composer remove zendframework/filp-whoops
• Remove a package; use --update-no-dev to avoid installing all require-dev
dependencies after the removal!
• Benefit: these do the install/update automatically, (generally) ensuring the update is only for the
package specified; unrelated dependencies are left alone. Faster and no unnecessary changes.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 21
Describing Project Dependencies
composer.json file tells Composer about your project’s needs
Composer-Intro
zendframework/
zend-log
>=2.8.0
{
"name" : "Composer-Intro",
"require" : {
"zendframework/zend-log" : “>=2.8.0"
},
"repositories" : [ {
"type" : "composer",
"url" : "https://packagist.org/"
} ]
}
>= is an unbound version constraint,
a general no-no, used here for
illustration only
composer.json
composer.json
? ? ?
Not necessary to edit composer.json manually! Best practice is to use command line!
composer init, composer require, composer remove
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 22
Installing Project Dependencies
First Level (Direct) Deps
composer install
Composer-Intro
zendframework/
zend-log
>=2.8.0
New:
•Vendor Directory
•composer.lock file
AfterBefore
{
"require" : {
"zendframework/zend-log" : “>=2.8.0"
}
}
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 23
Installing Project Dependencies
Further Levels (1 of 3)
zend-log composer.json file contains this:
{ …
"require": {
"php": "^5.5 || ^7.0",
"zendframework/zend-servicemanager": "^2.7.5 || ^3.0.3",
"zendframework/zend-stdlib": "^2.7 || ^3.0",
"psr/log": "^1.0",
},
…
}
zend-log needs three more packages
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 24
Installing Project Dependencies
Further Levels (2 of 3)
zend-stdlib:
{ …
"require": {
"php": "^5.6 || ^7.0"
},
…
}
No further code dependencies
Only PHP constraint (platform package)
zend-servicemanager:
{ …
"require": {
"php": “^5.5 || ^7.0",
“container-interop/container-interop”: “~1.0”
},
…
}
psr-log:
{ …
"require": {
"php": “>=5.3.0"
},
…
}
Still need more
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 25
Installing Project Dependencies
Further Levels (3 of 3)
No further code dependencies
container-interop:
{
"name": "container-interop/container-interop",
"type": "library",
"description": "Promoting the interoperability of container objects (DIC, SL, etc.)",
"license": "MIT",
"autoload": {
"psr-4": {
"InteropContainer": "src/Interop/Container/"
}
}
}
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 26
Where dependencies are stored by default
Application
vendor
zend-stdlib
zend-log
Dependency
Relationship
zend-servicemanager
Application
Directory
Structure
zend-log
zend-servicemanager
zend-stdlib
psr/log
container-interop
container-interop
psr/log
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 27
.json vs. .lock
Think “Design-To” vs. “As-Built”
Application
zendframework/
zend-log
>=2.8.0
composer.json tells Composer
what you want
composer.lock tells you
what you got
Application
zend-
stdlib
3.1.0
zend-log
2.9.1
zend-
servicemanager
3.1.1
psr/log
1.0.2
container-iterop
1.1.0
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 28
“Design-To” vs. “As-Built” Further Example
Application
Composer resolves versions as best it can
actual versions installed recorded in composer.lock
Application
zendframework/
zend-log
>=2.5,<2.7
zend-
stdlib
2.7.7
zend-log
2.6.0
zend-
servicemanager
2.7.7
psr/log
1.0.2
container-iterop
1.1.0
zend-hydrator
1.1.0
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 29
Problems Can Occur
Your Project
“I need E
>=1.0,<1.2”
A B C
E version ?
“I need E
>=1.2,<2.0”
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 30
SEMANTIC VERSIONING
&
COMPOSER VERSION
CONSTRAINTS
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 31
Semantic Versioning http://semver.org/
Version Numbers Have Meaning
• Essentially, it is a promise from the development team
• Not a guarantee, but best effort
• 1.2.3 – numbers increment, can have pre-release suffix
• Major.Minor.Patch
• Patch: bug fixes; no BC breaks! No API changes! Everyone using
the package should be confident in moving from 1.2.3 to 1.2.4
• Minor: introduce new features, but change no prior APIs; no BC
breaks! Changing internals (refactoring) should not affect
package users. Everyone using the package should be confident in
moving from 1.2.3 to 1.3.0.
• Major: API changes; BC breaks (whether intentional or not).
Example: 1.3.14 to 2.0.0
• For developers, not marketing department. (Sorry, Marketing!)
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 32
Semantic Versioning http://semver.org/
Version Number ChangesImplication for Developers
• 0.1.0 #’s change as you see fit,• Initial Development / API Not Stable
• 0.1.1 as long as major # is zero• Public API remains Unstable
• …• …
• 1.0.0• Public API Declared Stable
• 1.0.1 only patch # incremented• Backwards-Compatible Bugfix
• 1.0.2• BC Bugfix
• …• …
• 1.1.0 minor # incremented, patch # reset to zero• New BC Featureor deprecation (API change)
• 1.1.1• BC Bugfix
• …• …
• 2.0.0 major # incremented, minor/patch reset to zero• Any BC Break to Public API
• 2.0.1 only patch # incremented• BC Bugfix
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 33
Semantic Versioning http://semver.org/
MeaningPre-Release Versions & Build Metadata
• Not Stable, might not be compatible as implied
by “normal” version number
• Format: x.y.z-alpha-nums.alpha-nums
• Precedence / Ordering
• 1.0.0-alpha < 1.0.0
• 1.3.0-alpha < 1.3.0-beta
• 1.3.0-rc < 1.3.0-rc.1
• 2.0.0-rc.1 < 2.0.0-rc.11
• 2.1.0-0.2.2 < 2.1.0-0.2.2.a
• Pre-Release Examples
• 1.0.0-alpha
• 1.3.0-beta
• 1.3.0-rc
• 2.0.0-rc.1
• 2.1.0-0.2.2
• Information about the build
• Ignored in precedence comparison
• 1.0.0+001 === 1.0.0+alpha-20161018122346
• Build Metadata
• Format: x.y.z+alpha-nums
• 1.0.0+001
• 1.0.0+alpha-20161018122346
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 34
Semantic Versioning and Composer
Version Constraints
Shortcut notations for version constraints
Caret
• ^1.2.3 is same as >=1.2.3,<2.0.0 and means 1.2.3 <= x < 2.0.0
• Specifies a min version, and all non API-changing updates
• Recommended operator for max interoperability of library code
Tilde (updates in the same series as the rightmost digit*)
• ~1.2.3 is same as >=1.2.3,<1.3.0 and means 1.2.3 <= x < 1.3.0
• Specifies a min version; last number specified can increment
• For this example, we accept only bug-fixes, no new features.
• ~1.2 is same as >=1.2.0,<2.0.0 and means 1.2.0 <= x < 2.0.0
• For this example, we accept all non-breaking changes
• https://getcomposer.org/doc/articles/versions.md *How Matthew
https://mwop.net/
likes to think of it.
Comma or space:
logical and
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 35
Practice: Semver Version Constraints
What range is specified by:
• ^2.0.3 is same as ?
• ~2.0.3 is same as ?
• ^3.7.0 is same as ?
• ~3.7.0 is same as ?
• ^4.4 is same as ?
• ~4.4 is same as ?
• ^3 is same as ?
• ~3 is same as ?
Try out the Semver Checker
http://semver.mwl.be/
>=2.0.3,<3.0.0 means 2.0.3 <= x < 3.0.0
>=2.0.3,<2.1.0 means 2.0.3 <= x < 2.1.0
>=3.7.0,<4.0.0 means 3.7.0 <= x < 4.0.0
>=3.7.0,<3.8.0 means 3.7.0 <= x < 3.8.0
>=4.4.0,<5.0.0 means 4.4.0 <= x < 5.0.0
>=4.4.0,<5.0.0 means 4.4.0 <= x < 5.0.0
>=3.0.0,<4.0.0 means 3.0.0 <= x < 4.0.0
>=3.0.0,<4.0.0 means 3.0.0 <= x < 4.0.0
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 36
Other Composer Version Constraints
Range Operators
• And - comma or space:
• “>=1.2.3,<2.0.0” means 1.2.3 <= x < 2.0.0
• Or – vertical pipes:
• “^2.7.5 || ^3.0.3” means
• >=2.7.5,<3.0.0 || 3.0.3,<4.0.0
• 2.7.5 <= x < 3.0.0 or 3.0.3 <= x < 4.0.0
• <, <=, >, >=, != Best practice: avoid unbound constraints like ”>=1.2.3”
• For great examples, see
https://github.com/Roave/SecurityAdvisories/blob/master/composer.json
• Hyphen
• 1.0-2.0 is same as >=1.0.0,<2.1.0 and means 1.0.0 <= x < 2.1.0
• 1.0.0-2.1.0 is same as >=1.0.0,<=2.1.0 and means 1.0.0 <= x <= 2.1.0
• Wildcards (generally avoid for performance reasonse): 1.0.* I
• same as >=1.0.0,<1.1.0 and means 1.0.0 <= x < 1.1.0
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 37
REPOSITORIES-lite
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 38
Where do dependencies come from?
1. Read
Your
Application
composer.json
Repository
(or cache*)
2. Resolve dependencies &
obtain packages from
code repository (ies)
composer.lock
vendor
folder
4. Create
Initial composer install
With no composer.lock
Composer will …
*Aggressive caching
• Fast installs
• Reduced network fetch
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 39
Initial composer install
1. Read
Your
Application
composer.json
Repository
(or cache*)
2. Resolve dependencies &
Obtain packages from
composer.lock
vendor
folder
4. Create
With no composer.lock
Composer will …
*Aggressive caching
• Fast installs
• Reduced network fetch
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 40
Subsequent composer install
1. Read
Your
Application
composer.json
Repository
(or cache)
3. Write packages into
composer.lock
vendor
folder
With existing composer.lock
Composer will …
2. Obtain lock file versions from
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 41
Any composer update
1. Read
Your
Application
composer.json
Repository
(or cache)
composer.lock
vendor
folder
4. Update
Whether composer.lock
exists or not
Composer will … 2. Obtain packages’ latest
compatible release from
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 42
Development Considerations
Packagist.org,
Local repos
2. composer install
Development
Workstation /
Vhost
B
Development
Workstation /
Vhost
A
1. composer update &
commits to local VCS
General Best Practice: Always commit .lock file
• Allows synchronization between developers
• Helps ensure what was actually tested is what you deploy to production
Development
Workstation /
Vhost
C
install === “synchronize”
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 43
Production Considerations
Production
Server
Packagist.org
composer install
composer update
Please do NOT do this.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 44
Production Considerations
“Build”
Server
Packagist.org
composer install
with composer.lock file
Better.
Production
Server
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 45
Production Considerations
Test
ServerBest
Production
Server
Local
Repository (VCS /
Change Mgt,
Packagist)
Production
Server
Or
Local
Repository (VCS /
Change Mgt,
Packagist)
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 46
PACKAGES & REPOSITORIES
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 47
What are Packages & Repositories?
Composer downloads packages from repositories
Package
• A directory with files in it
• Package description - composer.json
• Name (this is what makes a package an installable library)
• Version (avoid specifying this, inferred from VCS info)
• Source Definition (where Composer gets the package)
• Repository location (URI)
• Repository Type (composer, vcs, pear, package)
• Package Type
• Dist – packaged, usually a stable release
• Source – source code, for development / modification
• Repo can provide both, but one will be preferred
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 48
Package Names
• vendor-name/project-or-library-name
• psr/log
• pear/log
• zendframework/log
• Best practice: use-dashes/as-word-separators
• Vendor names must be unique
• If you are going to publish packages:
• Remember: they persist! You and the world will have to live with them.
• Don’t be cute or cryptic (with vendor or package name)
• Name should reflect package purpose
• evandotpro/edp-superluminal - I like it, clever, but…
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 49
Platform / Virtual Packages
Not Installable by Composer, Used for checking only
• php – PHP version of the server Composer is installing packages to
• hhvm (not applicable for IBM i)
• ext-<name>
• “ext-ibm_db2” : “*”
• lib-<name>
• curl
• iconv
• icu
• libxml
• openssl
• pcre
• uuid
• xsl
• composer show --platform for a list of available platform packages
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 50
Repositories
Repository
• A download source for packages, specified by URI
• A list of packages and versions in a packages.json file
• Visit https://packagist.org/packages.json
• Types of repositories
• Composer – uses Packagist software, can public or private
• VCS – Git, SVN, Hg
• VCS client needed for “regular” git, svn, or hg repos
• Uses APIs for GitHub, BitBucket (no client needed)
• PEAR – public or private
• Package – zip; use only if none of the above are possible
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 51
Repositories: Packagist.org
Packagist.org Package Archivist
Just a Composer Repository…
• … but it is the primary repository for open source packages
• Best Practice for Open Source Projects: register it at packagist.org
• Searchable / Browsable
• Less work for people to find and use your package.
• Many, many, many packages available. There is duplication in
functionality and a wide range of quality. (Important topic for
another day.)
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 52
https://packagist.org/
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 53
Private Repositories – Satis and Toran Proxy
Your
Application
Packagist.org
Proxy
Toran /
Satis
Public
Repositories
Satis – free
ToranProxy.com – license
fees support development
of Composer
Why?
• Speed.
• Happier network
security staff.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 54
Private Repositories – Local Packagist
Your Application
composer.json /
composer.lock
Private
Repository
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 55
Not-Final Word on Repositories
We will create and use a private
repository in part two of today’s tutorial
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 56
COMPOSER BEST PRACTICES
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 57
Some Best Practices
Do’s and Don’ts:
• Command line tooling is your friend
• Building a deployment fileset with
Composer
• Unbound Version Constraints
• Version Constraints combined with
Wildcards
• Wildcards by themselves
• Install or update to the intended directory
Be careful
out there!
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 58
Command line tooling
• Don’t edit composer.json files. Use the command line tooling!
– $ composer require zendframework/zend-mvc
• Add require entry for the component, specifying the latest stable release that does not
conflict with other requirements
– $ composer require --dev phpunit/phpunit
• Specify development requirements (libraries needed to edit/test the dependency)
– $ composer require --update-no-dev monolog/monolog
• Add package, with no dev dependencies (we’re consuming only, not developing/testing)
– $ composer require "zendframework/zend-mvc:^2.5"
• Specify constraints
– $ composer require "zendframework/zend-mvc:^3.0@dev"
• Specify stability requirements
– $ composer remove zendframework/filp-whoops
• Remove a package; use --update-no-dev to avoid installing all require-dev
dependencies after the removal!
• Benefit: these do the install/update automatically, (generally) ensuring the update is only for the
package specified; unrelated dependencies are left alone. Faster and no unnecessary changes.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 59
Don’t install
development requirements
Use lock file
Download Distribution
Packages
composer install - - prefer-dist - - no-dev - - optimize-autoloader
Generate PSR-0/4 classmap
for fast autoloading
Building Deployment Filesets
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 60
Do NOT use unbound version
constraints (>=, no upper bound):
• Example: >=2.3
• Example: >=1.1.* (note that * is not
the problem here, >= is)
• Composer will install new updates,
as long as they become available,
without regard to backwards-
compatibility. (You’ll get 2.3.5,
10.5.23, etc.)
• Example: dev-master
Best Practice
Use ^2.3
Use ^1.1
Best Practices Do’s and Don’ts
Solution: >=2.3,<3.0 or ~2.3 or ^2.3
Solution: >=1.1.0,<1.2 or ~1.1.0
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 61
Do NOT attempt to specify a version
constraint with a wildcard:
• Example: >=2.*
• >=2 means any version at least 2.0.0
• (2.0.5, or 2.9.9, or 3.0.7, 10.3.2, etc.)
• 2.* means any version in the interval
• [2.0.0, 3.0.0), or 2.0.0-2.9.9999
• Composer can’t tell if you want 3.0.0
to be considered, or not.
Composer: “Invalid, I’m
throwing an error”
Solution: use >=2,<3
Best Practice:
^2 (for semantic versioning)
Best Practices Do’s and Don’ts
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 62
Best Practices Do’s and Don’ts
Do NOT use a wildcard (except
for virtual extension packages)
• Example: 1.2.* is bad –
slows composer down
• Looks at all patch level
releases, and all their sub-
dependencies
• Also limits composer to
versions < 1.3 forever
Composer: “Don’t make me work so hard!”
Solution:
(if you really want < 1.3) use ~1.2.0 or
>=1.2.0,<1.3
or
(if you really want >= 1.2)
use ~1.2.0 or >=1.2.0,<2.0.0
or
SemVer Best Practice:
^1.2
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 63
Best Practices Do’s and Don’ts
• Make SURE you’re in the right
folder when issuing composer
install
• Will read composer.json in that
folder, create vendor folder, and
.lock file
• Regardless of existence of .lock
file in project root directory
• Same for composer update!
• Part of your vendor folder
could be updated with
packages not compatible
with other packages
Run composer install /update
from root of your project.
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 64
PART DEUX:
PRIVATE REPOSITORY
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 65
Setting up a Private Composer Repo
• Satis Private Repository Needs
– VCS repository containing our package
– Install Satis
– Make Satis aware of our VCS repository
– Use Satis to build the composer repository
– Host the repository via web server (demo using PHP built-in server)
– Configure an application to use our package
– Test it!
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 66
VCS Repository of Source Code
clark.e@US-114-carle MINGW64 ~/Zend/workspaces/Talks/measurement (master)
$ ls -l
total 67
-rw-r--r-- 1 clark.e 1049089 233 Oct 18 09:41 CHANGELOG.md
-rw-r--r-- 1 clark.e 1049089 917 Oct 18 09:48 composer.json
-rw-r--r-- 1 clark.e 1049089 36864 Dec 30 2015 composer.lock
-rw-r--r-- 1 clark.e 1049089 209 Oct 18 09:49 deployment.properties
-rw-r--r-- 1 clark.e 1049089 381 Apr 13 2016 deployment.xml
drwxr-xr-x 1 clark.e 1049089 0 Dec 27 2015 doc/
-rw-r--r-- 1 clark.e 1049089 157 Jan 1 2016 FAQ.md
-rw-r--r-- 1 clark.e 1049089 6 Dec 26 2015 index.php
-rw-r--r-- 1 clark.e 1049089 2508 Oct 18 09:48 LICENSE.txt
-rw-r--r-- 1 clark.e 1049089 564 Jan 1 2016 phpunit.xml
-rw-r--r-- 1 clark.e 1049089 569 Dec 26 2015 phpunit.xml.dist
drwxr-xr-x 1 clark.e 1049089 0 Jan 1 2016 src/
drwxr-xr-x 1 clark.e 1049089 0 Jan 1 2016 test/
drwxr-xr-x 1 clark.e 1049089 0 Dec 30 2015 vendor/
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 67
Install Satis
$ cd ~
$ composer create-project --stability=dev --keep-vcs composer/satis satis
$ cd ~/satis/bin
$ php satis
• Satis version 1.0.0-dev
• Usage:
• command [options] [arguments]
• Options:
• -h, --help Display this help message
• -q, --quiet Do not output any message
• -V, --version Display this application version
• --ansi Force ANSI output
• --no-ansi Disable ANSI output
• -n, --no-interaction Do not ask any interactive question
• -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
• Available commands:
• add Add repository URL to satis JSON file
• build Builds a composer repository out of a json file
• help Displays help for a command
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 68
Make Satis Aware of our VCS Repo
$ cd ~/satis-repo
$ ../satis/bin/satis init
Welcome to the Satis config generator
This command will guide you through creating your Satis config.
Repository name: Demo Satis Repo
Home page: http://localhost:8000
Your configuration file successfully created!
You are ready to add your package repositories
Use satis add repository-url to add them.
$ cat satis.json
{
"name": "Demo Satis Repo",
"homepage": "http://localhost:8000",
"repositories": [],
"require-all": true
}
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 69
Make Satis Aware of our VCS Repo
$ ../satis/bin/satis add "file:///c/Users/clark.e/Zend/workspaces/Talks/measurement/.git"
Your configuration file successfully updated! It's time to rebuild your repository
$ cat satis.json
{
"name": "Demo Satis Repo",
"homepage": "http://localhost:8000",
"repositories": [
{
"type": "vcs",
"url": "file:///c/Users/clark.e/Zend/workspaces/Talks/measurement/.git"
}
],
"require-all": true
}
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 70
Make Satis Aware of our VCS Repo
$ ../satis/bin/satis build satis.json .
Scanning packages
wrote packages to ./include/all$a95d2027bae57a0d1bb43d5aa4dc7b48cd8b99cd.json
Writing packages.json
Pruning include directories
Writing web view
$ ls -al
total 358
drwxr-xr-x 1 clark.e 1049089 0 Oct 18 10:45 ./
drwxr-xr-x 1 clark.e 1049089 0 Oct 18 10:38 ../
drwxr-xr-x 1 clark.e 1049089 0 Oct 18 10:45 include/
-rw-r--r-- 1 clark.e 1049089 291385 Oct 18 10:45 index.html
-rw-r--r-- 1 clark.e 1049089 192 Oct 18 10:45 packages.json
-rw-r--r-- 1 clark.e 1049089 263 Oct 18 10:38 satis.json
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 71
Host Composer Repo via Webserver
$ php -S localhost:8000
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 72
Configure Application to Use Package
$ cd ~/test-app/
$ ls -al
total 65
drwxr-xr-x 1 clark.e 1049089 0 Oct 18 09:34 ./
drwxr-xr-x 1 clark.e 1049089 0 Oct 18 11:02 ../
-rw-r--r-- 1 clark.e 1049089 383 Oct 18 09:34 example-usage.php
$ cat composer.json
{
"repositories": [ { "type": "composer", "url": "http://localhost:8000" } ]
}
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 73
Resources
• Composer Manual - https://getcomposer.org/doc/
• Semantic Versioning - http://semver.org/
• Autoloading - http://www.php-fig.org/psr/psr-4/
• JSON (JavaScript Object Notation) - http://json.org/
• Help - https://groups.google.com/forum/#!forum/composer-users
• IRC - #composer on freenode irc://irc.freenode.org/composer
• Packagist Semver Checker – http://semver.mwl.be/
• Composer.json Schema
– https://getcomposer.org/doc/04-schema.md
– https://github.com/composer/composer/blob/master/res/compo
ser-schema.json
– http://stackoverflow.com/questions/tagged/composer-php
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 74
So who is this guy?
Clark Everetts, ZCE
• Rogue Wave Software (acquired Zend 1 year ago)
• PHP since 2005
• Professional Services Consultant
– Architecture and Performance Audits
– PHP, Zend Framework Training
– Application Development, Best Practices, etc.
• clark.everetts@roguewave.com @clarkphp +ClarkEveretts
© 2016 Rogue Wave Software, Inc. All Rights Reserved. 75
THANK-YOU
clark.e@roguewave.com
@clarkphp
+ClarkEveretts
Slides for this talk are
at the above Joind.in link
Tweets: #ZendCon2016
Rate & comment on this session
https://joind.in/talk/04872
Your feedback is invaluable!

Weitere ähnliche Inhalte

Was ist angesagt?

Composer for Busy Developers - php|tek13
Composer for Busy Developers - php|tek13Composer for Busy Developers - php|tek13
Composer for Busy Developers - php|tek13
Rafael Dohms
 

Was ist angesagt? (20)

Performance tips for Symfony2 & PHP
Performance tips for Symfony2 & PHPPerformance tips for Symfony2 & PHP
Performance tips for Symfony2 & PHP
 
Zend Framework 1.8 workshop
Zend Framework 1.8 workshopZend Framework 1.8 workshop
Zend Framework 1.8 workshop
 
Composer Helpdesk
Composer HelpdeskComposer Helpdesk
Composer Helpdesk
 
PHP Dependency Management with Composer
PHP Dependency Management with ComposerPHP Dependency Management with Composer
PHP Dependency Management with Composer
 
Composer - Package Management for PHP. Silver Bullet?
Composer - Package Management for PHP. Silver Bullet?Composer - Package Management for PHP. Silver Bullet?
Composer - Package Management for PHP. Silver Bullet?
 
PSR-7 - Middleware - Zend Expressive
PSR-7 - Middleware - Zend ExpressivePSR-7 - Middleware - Zend Expressive
PSR-7 - Middleware - Zend Expressive
 
Seven perilous pitfalls to avoid with Java | DevNation Tech Talk
Seven perilous pitfalls to avoid with Java | DevNation Tech TalkSeven perilous pitfalls to avoid with Java | DevNation Tech Talk
Seven perilous pitfalls to avoid with Java | DevNation Tech Talk
 
Foundations of Zend Framework
Foundations of Zend FrameworkFoundations of Zend Framework
Foundations of Zend Framework
 
Console Apps: php artisan forthe:win
Console Apps: php artisan forthe:winConsole Apps: php artisan forthe:win
Console Apps: php artisan forthe:win
 
Modern Black Mages Fighting in the Real World
Modern Black Mages Fighting in the Real WorldModern Black Mages Fighting in the Real World
Modern Black Mages Fighting in the Real World
 
Composer
ComposerComposer
Composer
 
Becoming A Php Ninja
Becoming A Php NinjaBecoming A Php Ninja
Becoming A Php Ninja
 
Running open source PHP applications on you IBM i
Running open source PHP applications on you IBM iRunning open source PHP applications on you IBM i
Running open source PHP applications on you IBM i
 
PHP Quality Assurance Workshop PHPBenelux
PHP Quality Assurance Workshop PHPBeneluxPHP Quality Assurance Workshop PHPBenelux
PHP Quality Assurance Workshop PHPBenelux
 
Phalcon 2 - PHP Brazil Conference
Phalcon 2 - PHP Brazil ConferencePhalcon 2 - PHP Brazil Conference
Phalcon 2 - PHP Brazil Conference
 
Power shell training
Power shell trainingPower shell training
Power shell training
 
Symfony Under Control by Maxim Romanovsky
Symfony Under Control by Maxim RomanovskySymfony Under Control by Maxim Romanovsky
Symfony Under Control by Maxim Romanovsky
 
Composer for Busy Developers - php|tek13
Composer for Busy Developers - php|tek13Composer for Busy Developers - php|tek13
Composer for Busy Developers - php|tek13
 
Dependency Management with Composer
Dependency Management with ComposerDependency Management with Composer
Dependency Management with Composer
 
Connect2017 DEV-1550 Why Java 8? Or, What's a Lambda?
Connect2017 DEV-1550 Why Java 8? Or, What's a Lambda?Connect2017 DEV-1550 Why Java 8? Or, What's a Lambda?
Connect2017 DEV-1550 Why Java 8? Or, What's a Lambda?
 

Ähnlich wie Php Dependency Management with Composer ZendCon 2016

Dependency management with Composer
Dependency management with ComposerDependency management with Composer
Dependency management with Composer
Jason Grimes
 

Ähnlich wie Php Dependency Management with Composer ZendCon 2016 (20)

Php Dependency Management with Composer ZendCon 2017
Php Dependency Management with Composer ZendCon 2017Php Dependency Management with Composer ZendCon 2017
Php Dependency Management with Composer ZendCon 2017
 
Composer Lightning Talk
Composer Lightning TalkComposer Lightning Talk
Composer Lightning Talk
 
Dependencies and Licenses
Dependencies and LicensesDependencies and Licenses
Dependencies and Licenses
 
Analysis of-quality-of-pkgs-in-packagist-univ-20171024
Analysis of-quality-of-pkgs-in-packagist-univ-20171024Analysis of-quality-of-pkgs-in-packagist-univ-20171024
Analysis of-quality-of-pkgs-in-packagist-univ-20171024
 
Dependency management with Composer
Dependency management with ComposerDependency management with Composer
Dependency management with Composer
 
Composer: Dependency Manager for PHP
Composer: Dependency Manager for PHPComposer: Dependency Manager for PHP
Composer: Dependency Manager for PHP
 
Mastering composer
Mastering composerMastering composer
Mastering composer
 
Prizm Installation Guide
Prizm Installation GuidePrizm Installation Guide
Prizm Installation Guide
 
Composer intro
Composer introComposer intro
Composer intro
 
Composer
ComposerComposer
Composer
 
Composer namespacing
Composer namespacingComposer namespacing
Composer namespacing
 
Aleksandr Kutsan "Managing Dependencies in C++"
Aleksandr Kutsan "Managing Dependencies in C++"Aleksandr Kutsan "Managing Dependencies in C++"
Aleksandr Kutsan "Managing Dependencies in C++"
 
Using Composer to create manageable WordPress websites
Using Composer to create manageable WordPress websitesUsing Composer to create manageable WordPress websites
Using Composer to create manageable WordPress websites
 
Create a PHP Library the right way
Create a PHP Library the right wayCreate a PHP Library the right way
Create a PHP Library the right way
 
Composer JSON kills make files
Composer JSON kills make filesComposer JSON kills make files
Composer JSON kills make files
 
Composer
ComposerComposer
Composer
 
How to migrate SourcePro apps from Solaris to Linux
How to migrate SourcePro apps from Solaris to LinuxHow to migrate SourcePro apps from Solaris to Linux
How to migrate SourcePro apps from Solaris to Linux
 
Habitat Workshop at Velocity London 2017
Habitat Workshop at Velocity London 2017Habitat Workshop at Velocity London 2017
Habitat Workshop at Velocity London 2017
 
Docker module 1
Docker module 1Docker module 1
Docker module 1
 
Composer & Drupal
Composer & DrupalComposer & Drupal
Composer & Drupal
 

Kürzlich hochgeladen

+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
?#DUbAI#??##{{(☎️+971_581248768%)**%*]'#abortion pills for sale in dubai@
 

Kürzlich hochgeladen (20)

Polkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin WoodPolkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin Wood
 
🐬 The future of MySQL is Postgres 🐘
🐬  The future of MySQL is Postgres   🐘🐬  The future of MySQL is Postgres   🐘
🐬 The future of MySQL is Postgres 🐘
 
Top 10 Most Downloaded Games on Play Store in 2024
Top 10 Most Downloaded Games on Play Store in 2024Top 10 Most Downloaded Games on Play Store in 2024
Top 10 Most Downloaded Games on Play Store in 2024
 
Data Cloud, More than a CDP by Matt Robison
Data Cloud, More than a CDP by Matt RobisonData Cloud, More than a CDP by Matt Robison
Data Cloud, More than a CDP by Matt Robison
 
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law DevelopmentsTrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
 
Tata AIG General Insurance Company - Insurer Innovation Award 2024
Tata AIG General Insurance Company - Insurer Innovation Award 2024Tata AIG General Insurance Company - Insurer Innovation Award 2024
Tata AIG General Insurance Company - Insurer Innovation Award 2024
 
HTML Injection Attacks: Impact and Mitigation Strategies
HTML Injection Attacks: Impact and Mitigation StrategiesHTML Injection Attacks: Impact and Mitigation Strategies
HTML Injection Attacks: Impact and Mitigation Strategies
 
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
 
Strategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a FresherStrategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a Fresher
 
Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024
 
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost SavingRepurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
 
Scaling API-first – The story of a global engineering organization
Scaling API-first – The story of a global engineering organizationScaling API-first – The story of a global engineering organization
Scaling API-first – The story of a global engineering organization
 
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
 
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
 
Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)
 
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
 
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
 
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
 
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
 
2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...
 

Php Dependency Management with Composer ZendCon 2016

  • 1. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 1 PHP Dependency Management with Composer Clark Everetts Sr. Professional Services Consultant 18 October 2016
  • 2. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 2 Slides, Joind.in, and Stuff • Rate & comment: https://joind.in/talk/04872 • Slides: https://www.slideshare.net/clarkphp • Tweets: #ZendCon2016 • @clarkphp
  • 3. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 3 Why are we here? Our Agenda • What is it? What problem does it solve? • What does it actually do? • Composer.json & composer.lock • Semantic Versioning, Version Constraints • Packages, Repositories and Packagist • Do’s and Don’ts / Best Practices • Create a Private Repository Cool logo!
  • 4. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 4 Assumption: You’ve seen JSON (JavaScript Object Notation) Jason is scary. JSON is not. *https://en.wikipedia.org/wiki/Jason_Voorhees
  • 5. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 5 INTRODUCTION/ BACKGROUND
  • 6. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 6 Composer is … … a per-project PHP dependency manager* *(plus autoloader) That’s all. Any questions?
  • 7. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 7 … a per-project PHP dependency manager Let’s break it down. Composer is … * Paraphrased from https://getcomposer.org/doc/00-intro.md
  • 8. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 8 PHP Package Dependencies … a per-project PHP dependency manager • PHP project-related files only • Can include assets like Javascript, images, XML, CSS, etc. • But not for managing Javascript or CSS libraries • Primarily a development - not production – tool (“can” be prod*) *but generally, I’m not a fan
  • 9. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 9 What’s a “dependency?” … a per-project PHP dependency manager You wrote these to reuse across apps. 3rd-Party ZF2, Laravel, OAuth2, Symfony Your Project DEPENDENCIES, PACKAGES, LIBRARIES “Project” == Application
  • 10. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 10 Dependencies can have dependencies … a per-project PHP dependency manager Your Project “Project” == Application == Library == Package DEPENDENCIES, PACKAGES, LIBRARIES “I need A, B, C, D” A B C D “I need E” E F “I need E” Composer obtains all specified dependencies. HG “I need G, H”
  • 11. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 11 Want to manage that yourself? “I need these” “I need this” A B C E D F G H “I need that” “I need the other” You’d need to: • Identify the direct dependencies of your project • Identify their dependencies, and all sub-dependencies • Locate the source code (PEAR, Git, Subversion, zip/gzip/bz2) • Download and install all of the source code • Make sure all the versions are compatible • Check for updates to any of the dependencies • Do it all again when updates are available With your guidance, Composer does all this for you.
  • 12. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 12 Different versions of the same package … a per-project PHP dependency manager Application A Application B Lib Y 1.0.1 Lib X 2.4.1 Lib Y 1.0.1 Lib X 1.2.0 Two projects, each using a different version of the same dependencies. Composer is not a global “package manager” PEAR, APT, YUM, Include_path Why do this? • Application A is stable, new features or bug fixes not relevant • Working with development version: Dev, Alpha, Beta, RC • Update cycle for App A !== App B
  • 13. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 13 To Reiterate: per-project; not global … a per-project PHP dependency manager Application A Application B Lib Y 1.0.1 Lib X 2.4.1 Lib Y 1.0.1 Lib X 2.4.1 Two projects, each using same version of the same dependencies. Each project has it’s own copy. • Like a PHAR (PHP Archive) file, all dependencies are available in the application directory tree. • Updates to the dependencies of one application do not affect another. • .gitattribute notwithstanding, potentially many copies of the exact same library source code on disk.
  • 14. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 14 Composer is… … a per-project PHP dependency manager • Knows what packages your application or library depends upon • Obtains those packages, and all of their dependencies, and installs appropriate versions of them into your project (and local cache) • When requested, checks for updates compatible with your project, and downloads them into your project (and local cache) • Allows you to pin multiple applications/libraries to the same or different versions of the packages they use. Composer makes it easier to manage application dependencies.
  • 15. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 15 Now What? Answered some questions, raised others: • How do we inform Composer what dependencies a project has? – composer.json, composer.lock • Where does it put the dependencies in the project? – vendor folder • Where does Composer obtain dependencies? – repositories • How does the project access to those dependencies when it needs them? – autoloading • How do we install Composer and start using it? A closer look…
  • 16. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 16 INSTALL COMPOSER
  • 17. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 17 Installation • Windows – https://getcomposer.org/Composer-Setup.exe – https://getcomposer.org/doc/00-intro.md#installation-windows – Or, GitBash, and follow *nix instructions • *nix and IBM i PASE – https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx – Command line instructions on https://getcomposer.org/download/ • Manual Download on same page https://getcomposer.org/download/ • IBM i – CALL QP2TERM (or ssh) – Before installing, check KB article: – https://support.zend.com/hc/en-us/articles/205679027-Add-a-trusted- certificate-authority-to-IBM-i-for-PHP-5-6 (though I think downloading via browser from https://curl.haxx.se/docs/caextract.html is better) • Once installed, updates are easy: – $ composer self-update
  • 18. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 18 Help is available • Get help – $ composer help (top-level help) – $ composer list (list available commands) – $ composer help <command> (help on specified command) • Documentation – https://getcomposer.org/doc/01-basic-usage.md – https://getcomposer.org/doc/03-cli.md (command line interface)
  • 19. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 19 COMPOSER.JSON & COMPOSER.LOCK
  • 20. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 20 General Tips • Don’t edit composer.json files. Use the command line tooling! – $ composer require zendframework/zend-mvc • Add require entry for the component, specifying the latest stable release that does not conflict with other requirements – $ composer require --dev phpunit/phpunit • Specify development requirements (libraries needed to edit/test the dependency) – $ composer require --update-no-dev monolog/monolog • Add package, with no dev dependencies (we’re consuming only, not developing/testing) – $ composer require "zendframework/zend-mvc:^2.5" • Specify constraints – $ composer require "zendframework/zend-mvc:^3.0@dev" • Specify stability requirements – $ composer remove zendframework/filp-whoops • Remove a package; use --update-no-dev to avoid installing all require-dev dependencies after the removal! • Benefit: these do the install/update automatically, (generally) ensuring the update is only for the package specified; unrelated dependencies are left alone. Faster and no unnecessary changes.
  • 21. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 21 Describing Project Dependencies composer.json file tells Composer about your project’s needs Composer-Intro zendframework/ zend-log >=2.8.0 { "name" : "Composer-Intro", "require" : { "zendframework/zend-log" : “>=2.8.0" }, "repositories" : [ { "type" : "composer", "url" : "https://packagist.org/" } ] } >= is an unbound version constraint, a general no-no, used here for illustration only composer.json composer.json ? ? ? Not necessary to edit composer.json manually! Best practice is to use command line! composer init, composer require, composer remove
  • 22. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 22 Installing Project Dependencies First Level (Direct) Deps composer install Composer-Intro zendframework/ zend-log >=2.8.0 New: •Vendor Directory •composer.lock file AfterBefore { "require" : { "zendframework/zend-log" : “>=2.8.0" } }
  • 23. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 23 Installing Project Dependencies Further Levels (1 of 3) zend-log composer.json file contains this: { … "require": { "php": "^5.5 || ^7.0", "zendframework/zend-servicemanager": "^2.7.5 || ^3.0.3", "zendframework/zend-stdlib": "^2.7 || ^3.0", "psr/log": "^1.0", }, … } zend-log needs three more packages
  • 24. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 24 Installing Project Dependencies Further Levels (2 of 3) zend-stdlib: { … "require": { "php": "^5.6 || ^7.0" }, … } No further code dependencies Only PHP constraint (platform package) zend-servicemanager: { … "require": { "php": “^5.5 || ^7.0", “container-interop/container-interop”: “~1.0” }, … } psr-log: { … "require": { "php": “>=5.3.0" }, … } Still need more
  • 25. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 25 Installing Project Dependencies Further Levels (3 of 3) No further code dependencies container-interop: { "name": "container-interop/container-interop", "type": "library", "description": "Promoting the interoperability of container objects (DIC, SL, etc.)", "license": "MIT", "autoload": { "psr-4": { "InteropContainer": "src/Interop/Container/" } } }
  • 26. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 26 Where dependencies are stored by default Application vendor zend-stdlib zend-log Dependency Relationship zend-servicemanager Application Directory Structure zend-log zend-servicemanager zend-stdlib psr/log container-interop container-interop psr/log
  • 27. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 27 .json vs. .lock Think “Design-To” vs. “As-Built” Application zendframework/ zend-log >=2.8.0 composer.json tells Composer what you want composer.lock tells you what you got Application zend- stdlib 3.1.0 zend-log 2.9.1 zend- servicemanager 3.1.1 psr/log 1.0.2 container-iterop 1.1.0
  • 28. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 28 “Design-To” vs. “As-Built” Further Example Application Composer resolves versions as best it can actual versions installed recorded in composer.lock Application zendframework/ zend-log >=2.5,<2.7 zend- stdlib 2.7.7 zend-log 2.6.0 zend- servicemanager 2.7.7 psr/log 1.0.2 container-iterop 1.1.0 zend-hydrator 1.1.0
  • 29. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 29 Problems Can Occur Your Project “I need E >=1.0,<1.2” A B C E version ? “I need E >=1.2,<2.0”
  • 30. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 30 SEMANTIC VERSIONING & COMPOSER VERSION CONSTRAINTS
  • 31. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 31 Semantic Versioning http://semver.org/ Version Numbers Have Meaning • Essentially, it is a promise from the development team • Not a guarantee, but best effort • 1.2.3 – numbers increment, can have pre-release suffix • Major.Minor.Patch • Patch: bug fixes; no BC breaks! No API changes! Everyone using the package should be confident in moving from 1.2.3 to 1.2.4 • Minor: introduce new features, but change no prior APIs; no BC breaks! Changing internals (refactoring) should not affect package users. Everyone using the package should be confident in moving from 1.2.3 to 1.3.0. • Major: API changes; BC breaks (whether intentional or not). Example: 1.3.14 to 2.0.0 • For developers, not marketing department. (Sorry, Marketing!)
  • 32. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 32 Semantic Versioning http://semver.org/ Version Number ChangesImplication for Developers • 0.1.0 #’s change as you see fit,• Initial Development / API Not Stable • 0.1.1 as long as major # is zero• Public API remains Unstable • …• … • 1.0.0• Public API Declared Stable • 1.0.1 only patch # incremented• Backwards-Compatible Bugfix • 1.0.2• BC Bugfix • …• … • 1.1.0 minor # incremented, patch # reset to zero• New BC Featureor deprecation (API change) • 1.1.1• BC Bugfix • …• … • 2.0.0 major # incremented, minor/patch reset to zero• Any BC Break to Public API • 2.0.1 only patch # incremented• BC Bugfix
  • 33. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 33 Semantic Versioning http://semver.org/ MeaningPre-Release Versions & Build Metadata • Not Stable, might not be compatible as implied by “normal” version number • Format: x.y.z-alpha-nums.alpha-nums • Precedence / Ordering • 1.0.0-alpha < 1.0.0 • 1.3.0-alpha < 1.3.0-beta • 1.3.0-rc < 1.3.0-rc.1 • 2.0.0-rc.1 < 2.0.0-rc.11 • 2.1.0-0.2.2 < 2.1.0-0.2.2.a • Pre-Release Examples • 1.0.0-alpha • 1.3.0-beta • 1.3.0-rc • 2.0.0-rc.1 • 2.1.0-0.2.2 • Information about the build • Ignored in precedence comparison • 1.0.0+001 === 1.0.0+alpha-20161018122346 • Build Metadata • Format: x.y.z+alpha-nums • 1.0.0+001 • 1.0.0+alpha-20161018122346
  • 34. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 34 Semantic Versioning and Composer Version Constraints Shortcut notations for version constraints Caret • ^1.2.3 is same as >=1.2.3,<2.0.0 and means 1.2.3 <= x < 2.0.0 • Specifies a min version, and all non API-changing updates • Recommended operator for max interoperability of library code Tilde (updates in the same series as the rightmost digit*) • ~1.2.3 is same as >=1.2.3,<1.3.0 and means 1.2.3 <= x < 1.3.0 • Specifies a min version; last number specified can increment • For this example, we accept only bug-fixes, no new features. • ~1.2 is same as >=1.2.0,<2.0.0 and means 1.2.0 <= x < 2.0.0 • For this example, we accept all non-breaking changes • https://getcomposer.org/doc/articles/versions.md *How Matthew https://mwop.net/ likes to think of it. Comma or space: logical and
  • 35. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 35 Practice: Semver Version Constraints What range is specified by: • ^2.0.3 is same as ? • ~2.0.3 is same as ? • ^3.7.0 is same as ? • ~3.7.0 is same as ? • ^4.4 is same as ? • ~4.4 is same as ? • ^3 is same as ? • ~3 is same as ? Try out the Semver Checker http://semver.mwl.be/ >=2.0.3,<3.0.0 means 2.0.3 <= x < 3.0.0 >=2.0.3,<2.1.0 means 2.0.3 <= x < 2.1.0 >=3.7.0,<4.0.0 means 3.7.0 <= x < 4.0.0 >=3.7.0,<3.8.0 means 3.7.0 <= x < 3.8.0 >=4.4.0,<5.0.0 means 4.4.0 <= x < 5.0.0 >=4.4.0,<5.0.0 means 4.4.0 <= x < 5.0.0 >=3.0.0,<4.0.0 means 3.0.0 <= x < 4.0.0 >=3.0.0,<4.0.0 means 3.0.0 <= x < 4.0.0
  • 36. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 36 Other Composer Version Constraints Range Operators • And - comma or space: • “>=1.2.3,<2.0.0” means 1.2.3 <= x < 2.0.0 • Or – vertical pipes: • “^2.7.5 || ^3.0.3” means • >=2.7.5,<3.0.0 || 3.0.3,<4.0.0 • 2.7.5 <= x < 3.0.0 or 3.0.3 <= x < 4.0.0 • <, <=, >, >=, != Best practice: avoid unbound constraints like ”>=1.2.3” • For great examples, see https://github.com/Roave/SecurityAdvisories/blob/master/composer.json • Hyphen • 1.0-2.0 is same as >=1.0.0,<2.1.0 and means 1.0.0 <= x < 2.1.0 • 1.0.0-2.1.0 is same as >=1.0.0,<=2.1.0 and means 1.0.0 <= x <= 2.1.0 • Wildcards (generally avoid for performance reasonse): 1.0.* I • same as >=1.0.0,<1.1.0 and means 1.0.0 <= x < 1.1.0
  • 37. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 37 REPOSITORIES-lite
  • 38. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 38 Where do dependencies come from? 1. Read Your Application composer.json Repository (or cache*) 2. Resolve dependencies & obtain packages from code repository (ies) composer.lock vendor folder 4. Create Initial composer install With no composer.lock Composer will … *Aggressive caching • Fast installs • Reduced network fetch
  • 39. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 39 Initial composer install 1. Read Your Application composer.json Repository (or cache*) 2. Resolve dependencies & Obtain packages from composer.lock vendor folder 4. Create With no composer.lock Composer will … *Aggressive caching • Fast installs • Reduced network fetch
  • 40. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 40 Subsequent composer install 1. Read Your Application composer.json Repository (or cache) 3. Write packages into composer.lock vendor folder With existing composer.lock Composer will … 2. Obtain lock file versions from
  • 41. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 41 Any composer update 1. Read Your Application composer.json Repository (or cache) composer.lock vendor folder 4. Update Whether composer.lock exists or not Composer will … 2. Obtain packages’ latest compatible release from
  • 42. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 42 Development Considerations Packagist.org, Local repos 2. composer install Development Workstation / Vhost B Development Workstation / Vhost A 1. composer update & commits to local VCS General Best Practice: Always commit .lock file • Allows synchronization between developers • Helps ensure what was actually tested is what you deploy to production Development Workstation / Vhost C install === “synchronize”
  • 43. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 43 Production Considerations Production Server Packagist.org composer install composer update Please do NOT do this.
  • 44. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 44 Production Considerations “Build” Server Packagist.org composer install with composer.lock file Better. Production Server
  • 45. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 45 Production Considerations Test ServerBest Production Server Local Repository (VCS / Change Mgt, Packagist) Production Server Or Local Repository (VCS / Change Mgt, Packagist)
  • 46. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 46 PACKAGES & REPOSITORIES
  • 47. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 47 What are Packages & Repositories? Composer downloads packages from repositories Package • A directory with files in it • Package description - composer.json • Name (this is what makes a package an installable library) • Version (avoid specifying this, inferred from VCS info) • Source Definition (where Composer gets the package) • Repository location (URI) • Repository Type (composer, vcs, pear, package) • Package Type • Dist – packaged, usually a stable release • Source – source code, for development / modification • Repo can provide both, but one will be preferred
  • 48. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 48 Package Names • vendor-name/project-or-library-name • psr/log • pear/log • zendframework/log • Best practice: use-dashes/as-word-separators • Vendor names must be unique • If you are going to publish packages: • Remember: they persist! You and the world will have to live with them. • Don’t be cute or cryptic (with vendor or package name) • Name should reflect package purpose • evandotpro/edp-superluminal - I like it, clever, but…
  • 49. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 49 Platform / Virtual Packages Not Installable by Composer, Used for checking only • php – PHP version of the server Composer is installing packages to • hhvm (not applicable for IBM i) • ext-<name> • “ext-ibm_db2” : “*” • lib-<name> • curl • iconv • icu • libxml • openssl • pcre • uuid • xsl • composer show --platform for a list of available platform packages
  • 50. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 50 Repositories Repository • A download source for packages, specified by URI • A list of packages and versions in a packages.json file • Visit https://packagist.org/packages.json • Types of repositories • Composer – uses Packagist software, can public or private • VCS – Git, SVN, Hg • VCS client needed for “regular” git, svn, or hg repos • Uses APIs for GitHub, BitBucket (no client needed) • PEAR – public or private • Package – zip; use only if none of the above are possible
  • 51. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 51 Repositories: Packagist.org Packagist.org Package Archivist Just a Composer Repository… • … but it is the primary repository for open source packages • Best Practice for Open Source Projects: register it at packagist.org • Searchable / Browsable • Less work for people to find and use your package. • Many, many, many packages available. There is duplication in functionality and a wide range of quality. (Important topic for another day.)
  • 52. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 52 https://packagist.org/
  • 53. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 53 Private Repositories – Satis and Toran Proxy Your Application Packagist.org Proxy Toran / Satis Public Repositories Satis – free ToranProxy.com – license fees support development of Composer Why? • Speed. • Happier network security staff.
  • 54. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 54 Private Repositories – Local Packagist Your Application composer.json / composer.lock Private Repository
  • 55. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 55 Not-Final Word on Repositories We will create and use a private repository in part two of today’s tutorial
  • 56. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 56 COMPOSER BEST PRACTICES
  • 57. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 57 Some Best Practices Do’s and Don’ts: • Command line tooling is your friend • Building a deployment fileset with Composer • Unbound Version Constraints • Version Constraints combined with Wildcards • Wildcards by themselves • Install or update to the intended directory Be careful out there!
  • 58. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 58 Command line tooling • Don’t edit composer.json files. Use the command line tooling! – $ composer require zendframework/zend-mvc • Add require entry for the component, specifying the latest stable release that does not conflict with other requirements – $ composer require --dev phpunit/phpunit • Specify development requirements (libraries needed to edit/test the dependency) – $ composer require --update-no-dev monolog/monolog • Add package, with no dev dependencies (we’re consuming only, not developing/testing) – $ composer require "zendframework/zend-mvc:^2.5" • Specify constraints – $ composer require "zendframework/zend-mvc:^3.0@dev" • Specify stability requirements – $ composer remove zendframework/filp-whoops • Remove a package; use --update-no-dev to avoid installing all require-dev dependencies after the removal! • Benefit: these do the install/update automatically, (generally) ensuring the update is only for the package specified; unrelated dependencies are left alone. Faster and no unnecessary changes.
  • 59. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 59 Don’t install development requirements Use lock file Download Distribution Packages composer install - - prefer-dist - - no-dev - - optimize-autoloader Generate PSR-0/4 classmap for fast autoloading Building Deployment Filesets
  • 60. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 60 Do NOT use unbound version constraints (>=, no upper bound): • Example: >=2.3 • Example: >=1.1.* (note that * is not the problem here, >= is) • Composer will install new updates, as long as they become available, without regard to backwards- compatibility. (You’ll get 2.3.5, 10.5.23, etc.) • Example: dev-master Best Practice Use ^2.3 Use ^1.1 Best Practices Do’s and Don’ts Solution: >=2.3,<3.0 or ~2.3 or ^2.3 Solution: >=1.1.0,<1.2 or ~1.1.0
  • 61. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 61 Do NOT attempt to specify a version constraint with a wildcard: • Example: >=2.* • >=2 means any version at least 2.0.0 • (2.0.5, or 2.9.9, or 3.0.7, 10.3.2, etc.) • 2.* means any version in the interval • [2.0.0, 3.0.0), or 2.0.0-2.9.9999 • Composer can’t tell if you want 3.0.0 to be considered, or not. Composer: “Invalid, I’m throwing an error” Solution: use >=2,<3 Best Practice: ^2 (for semantic versioning) Best Practices Do’s and Don’ts
  • 62. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 62 Best Practices Do’s and Don’ts Do NOT use a wildcard (except for virtual extension packages) • Example: 1.2.* is bad – slows composer down • Looks at all patch level releases, and all their sub- dependencies • Also limits composer to versions < 1.3 forever Composer: “Don’t make me work so hard!” Solution: (if you really want < 1.3) use ~1.2.0 or >=1.2.0,<1.3 or (if you really want >= 1.2) use ~1.2.0 or >=1.2.0,<2.0.0 or SemVer Best Practice: ^1.2
  • 63. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 63 Best Practices Do’s and Don’ts • Make SURE you’re in the right folder when issuing composer install • Will read composer.json in that folder, create vendor folder, and .lock file • Regardless of existence of .lock file in project root directory • Same for composer update! • Part of your vendor folder could be updated with packages not compatible with other packages Run composer install /update from root of your project.
  • 64. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 64 PART DEUX: PRIVATE REPOSITORY
  • 65. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 65 Setting up a Private Composer Repo • Satis Private Repository Needs – VCS repository containing our package – Install Satis – Make Satis aware of our VCS repository – Use Satis to build the composer repository – Host the repository via web server (demo using PHP built-in server) – Configure an application to use our package – Test it!
  • 66. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 66 VCS Repository of Source Code clark.e@US-114-carle MINGW64 ~/Zend/workspaces/Talks/measurement (master) $ ls -l total 67 -rw-r--r-- 1 clark.e 1049089 233 Oct 18 09:41 CHANGELOG.md -rw-r--r-- 1 clark.e 1049089 917 Oct 18 09:48 composer.json -rw-r--r-- 1 clark.e 1049089 36864 Dec 30 2015 composer.lock -rw-r--r-- 1 clark.e 1049089 209 Oct 18 09:49 deployment.properties -rw-r--r-- 1 clark.e 1049089 381 Apr 13 2016 deployment.xml drwxr-xr-x 1 clark.e 1049089 0 Dec 27 2015 doc/ -rw-r--r-- 1 clark.e 1049089 157 Jan 1 2016 FAQ.md -rw-r--r-- 1 clark.e 1049089 6 Dec 26 2015 index.php -rw-r--r-- 1 clark.e 1049089 2508 Oct 18 09:48 LICENSE.txt -rw-r--r-- 1 clark.e 1049089 564 Jan 1 2016 phpunit.xml -rw-r--r-- 1 clark.e 1049089 569 Dec 26 2015 phpunit.xml.dist drwxr-xr-x 1 clark.e 1049089 0 Jan 1 2016 src/ drwxr-xr-x 1 clark.e 1049089 0 Jan 1 2016 test/ drwxr-xr-x 1 clark.e 1049089 0 Dec 30 2015 vendor/
  • 67. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 67 Install Satis $ cd ~ $ composer create-project --stability=dev --keep-vcs composer/satis satis $ cd ~/satis/bin $ php satis • Satis version 1.0.0-dev • Usage: • command [options] [arguments] • Options: • -h, --help Display this help message • -q, --quiet Do not output any message • -V, --version Display this application version • --ansi Force ANSI output • --no-ansi Disable ANSI output • -n, --no-interaction Do not ask any interactive question • -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug • Available commands: • add Add repository URL to satis JSON file • build Builds a composer repository out of a json file • help Displays help for a command
  • 68. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 68 Make Satis Aware of our VCS Repo $ cd ~/satis-repo $ ../satis/bin/satis init Welcome to the Satis config generator This command will guide you through creating your Satis config. Repository name: Demo Satis Repo Home page: http://localhost:8000 Your configuration file successfully created! You are ready to add your package repositories Use satis add repository-url to add them. $ cat satis.json { "name": "Demo Satis Repo", "homepage": "http://localhost:8000", "repositories": [], "require-all": true }
  • 69. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 69 Make Satis Aware of our VCS Repo $ ../satis/bin/satis add "file:///c/Users/clark.e/Zend/workspaces/Talks/measurement/.git" Your configuration file successfully updated! It's time to rebuild your repository $ cat satis.json { "name": "Demo Satis Repo", "homepage": "http://localhost:8000", "repositories": [ { "type": "vcs", "url": "file:///c/Users/clark.e/Zend/workspaces/Talks/measurement/.git" } ], "require-all": true }
  • 70. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 70 Make Satis Aware of our VCS Repo $ ../satis/bin/satis build satis.json . Scanning packages wrote packages to ./include/all$a95d2027bae57a0d1bb43d5aa4dc7b48cd8b99cd.json Writing packages.json Pruning include directories Writing web view $ ls -al total 358 drwxr-xr-x 1 clark.e 1049089 0 Oct 18 10:45 ./ drwxr-xr-x 1 clark.e 1049089 0 Oct 18 10:38 ../ drwxr-xr-x 1 clark.e 1049089 0 Oct 18 10:45 include/ -rw-r--r-- 1 clark.e 1049089 291385 Oct 18 10:45 index.html -rw-r--r-- 1 clark.e 1049089 192 Oct 18 10:45 packages.json -rw-r--r-- 1 clark.e 1049089 263 Oct 18 10:38 satis.json
  • 71. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 71 Host Composer Repo via Webserver $ php -S localhost:8000
  • 72. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 72 Configure Application to Use Package $ cd ~/test-app/ $ ls -al total 65 drwxr-xr-x 1 clark.e 1049089 0 Oct 18 09:34 ./ drwxr-xr-x 1 clark.e 1049089 0 Oct 18 11:02 ../ -rw-r--r-- 1 clark.e 1049089 383 Oct 18 09:34 example-usage.php $ cat composer.json { "repositories": [ { "type": "composer", "url": "http://localhost:8000" } ] }
  • 73. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 73 Resources • Composer Manual - https://getcomposer.org/doc/ • Semantic Versioning - http://semver.org/ • Autoloading - http://www.php-fig.org/psr/psr-4/ • JSON (JavaScript Object Notation) - http://json.org/ • Help - https://groups.google.com/forum/#!forum/composer-users • IRC - #composer on freenode irc://irc.freenode.org/composer • Packagist Semver Checker – http://semver.mwl.be/ • Composer.json Schema – https://getcomposer.org/doc/04-schema.md – https://github.com/composer/composer/blob/master/res/compo ser-schema.json – http://stackoverflow.com/questions/tagged/composer-php
  • 74. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 74 So who is this guy? Clark Everetts, ZCE • Rogue Wave Software (acquired Zend 1 year ago) • PHP since 2005 • Professional Services Consultant – Architecture and Performance Audits – PHP, Zend Framework Training – Application Development, Best Practices, etc. • clark.everetts@roguewave.com @clarkphp +ClarkEveretts
  • 75. © 2016 Rogue Wave Software, Inc. All Rights Reserved. 75 THANK-YOU clark.e@roguewave.com @clarkphp +ClarkEveretts Slides for this talk are at the above Joind.in link Tweets: #ZendCon2016 Rate & comment on this session https://joind.in/talk/04872 Your feedback is invaluable!