Slide 1
Slide 1 text
Bernhard Schussek · webmozart.io 1/119
https://commons.wikimedia.org/wiki/File:View_from_Volcano_Pacaya,_Guatemala.jpg (CC BY-SA 4.0)
PHP's Next Package Revolution
Bernhard Schussek (@webmozart) · PHPBenelux 2016, Antwerp
Slide 2
Slide 2 text
Bernhard Schussek · webmozart.io 2/119
Shcusek Schuseck
Shusek
Schuhsek
Shuhseck
Shushek
Shuseck
Shusec
Shushek
Shushek
Shushec
Sussek
Shussec
Schußeck
Scusek
Shußec
Schuhsec
Shußec
Schushek
Schusheck
Not:
Bernard
Bernhart
Bernardt
Bernharth
Also Wrong:
Schusseck
Schusek
Shusseck
Scussek
Bernhard Schussek
Slide 3
Slide 3 text
Bernhard Schussek · webmozart.io 3/119
@webmozart
Slide 4
Slide 4 text
Bernhard Schussek · webmozart.io 4/119
Bernhard Schussek
Symfony Core Developer
since 2009
Slide 5
Slide 5 text
Bernhard Schussek · webmozart.io 5/119
Bernhard Schussek
Symfony FIG Representative
since 2013
Slide 6
Slide 6 text
Bernhard Schussek · webmozart.io 6/119
Bernhard Schussek
Puli Core Developer
since 2014
Slide 7
Slide 7 text
Bernhard Schussek · webmozart.io 7/119
Bernhard Schussek
PHP Trainer and Coach
Symfony
Architecture
Coding Practices
webmozart.io
Slide 8
Slide 8 text
Bernhard Schussek · webmozart.io 8/119
Puli?
Slide 9
Slide 9 text
Bernhard Schussek · webmozart.io 9/119
https://www.flickr.com/photos/puliarfanita/7167723539 (CC BY 2.0)
Slide 10
Slide 10 text
Bernhard Schussek · webmozart.io 10/119
https://www.flickr.com/photos/puliarfanita/6117985856 (CC BY 2.0)
Slide 11
Slide 11 text
Bernhard Schussek · webmozart.io 11/119
https://www.flickr.com/photos/karenhorton/4931092112 (CC BY-NC 2.0)
Slide 12
Slide 12 text
Bernhard Schussek · webmozart.io 12/119
https://www.flickr.com/photos/picturesfromwords/9539461080 (CC BY-NC 2.0)
Slide 13
Slide 13 text
Bernhard Schussek · webmozart.io 13/119
Puli is a Module System
for PHP
Slide 14
Slide 14 text
Bernhard Schussek · webmozart.io 14/119
Bundles
Packages
Modules
Modules
✘
✘
✘
✘
Slide 15
Slide 15 text
Bernhard Schussek · webmozart.io 15/119
Modules
Slide 16
Slide 16 text
Bernhard Schussek · webmozart.io 16/119
What is a Puli Module?
Slide 17
Slide 17 text
Bernhard Schussek · webmozart.io 17/119
PHP Library ✔
Slide 18
Slide 18 text
Bernhard Schussek · webmozart.io 18/119
Symfony Bundle✔
Slide 19
Slide 19 text
Bernhard Schussek · webmozart.io 19/119
Your Application✔
Slide 20
Slide 20 text
Bernhard Schussek · webmozart.io 20/119
PHP Code
Resource Files
puli.json
Module Configuration
composer.json
Installation Instructions
Puli Module
Slide 21
Slide 21 text
Bernhard Schussek · webmozart.io 21/119
Puli is Not the
Next Composer
Slide 22
Slide 22 text
Bernhard Schussek · webmozart.io 22/119
Composer Installs Packages and
Resolves their Dependencies
Slide 23
Slide 23 text
Bernhard Schussek · webmozart.io 23/119
PHP Code
Resource Files
puli.json
Module Configuration
composer.json
Installation Instructions
Autoloading PHP Classes
Module
Batman\Blog\BlogController
Slide 24
Slide 24 text
Bernhard Schussek · webmozart.io 24/119
Puli Integrates Modules
and Your Application
Slide 25
Slide 25 text
Bernhard Schussek · webmozart.io 25/119
Your Application
Slide 26
Slide 26 text
Bernhard Schussek · webmozart.io 26/119
Puli Has 3 Target Audiences
Slide 27
Slide 27 text
Bernhard Schussek · webmozart.io 27/119
Framework Developers
Slide 28
Slide 28 text
Bernhard Schussek · webmozart.io 28/119
Library/Module Developers
Slide 29
Slide 29 text
Bernhard Schussek · webmozart.io 29/119
Application Developers
Slide 30
Slide 30 text
Bernhard Schussek · webmozart.io 30/119
Puli for Framework Developers
Slide 31
Slide 31 text
Bernhard Schussek · webmozart.io 31/119
Stop Inventing Module Systems
Slide 32
Slide 32 text
Bernhard Schussek · webmozart.io 32/119
Packagist
Libraries
Symfony
Bundles
Laravel
Packages
Drupal
Modules Silex
Providers
Slide 33
Slide 33 text
Bernhard Schussek · webmozart.io 33/119
For Symfony Developers
Libraries
Symfony
Bundles
Laravel
Packages
Drupal
Modules Silex
Providers
Slide 34
Slide 34 text
Bernhard Schussek · webmozart.io 34/119
For Drupal Developers
Libraries
Symfony
Bundles
Laravel
Packages
Drupal
Modules Silex
Providers
Slide 35
Slide 35 text
Bernhard Schussek · webmozart.io 35/119
Vanilla PHP Projects
Libraries
Symfony
Bundles
Laravel
Packages
Drupal
Modules Silex
Providers
Slide 36
Slide 36 text
Bernhard Schussek · webmozart.io 36/119
High Community
Fragmentation
Slide 37
Slide 37 text
Bernhard Schussek · webmozart.io 37/119
Puli Reduces Your Code Base
Slide 38
Slide 38 text
Bernhard Schussek · webmozart.io 38/119
Puli Modules Reach a
Larger Target Audience
Slide 39
Slide 39 text
Bernhard Schussek · webmozart.io 39/119
Puli for Library/Module
Developers
Slide 40
Slide 40 text
Bernhard Schussek · webmozart.io 40/119
PHP Code
Resource Files
Provide/Use Services
by Interface
Http\Client\HttpClient
=
Guzzle\GuzzleClient
React\HttpClient\ReactClient
Http\Curl\CurlClient
…
Module
PHP Code
Resource Files
Module
Slide 41
Slide 41 text
Bernhard Schussek · webmozart.io 41/119
Module
Module
PHP Code
Resource Files
PHP Code
Resource Files
Provide/Use Resources
by Type
thor/translations-yml
=
path/to/trans/messages.en.yml
path/to/trans/messages.de.yml
path/to/trans/messages.fr.yml
…
Slide 42
Slide 42 text
Bernhard Schussek · webmozart.io 42/119
PHP Code
Resource Files
Access Resources
by Puli Path
/batman/blog/config.yml
=
path/to/module/res/config.yml
Module
Slide 43
Slide 43 text
Bernhard Schussek · webmozart.io 43/119
Accessing Resources
Slide 44
Slide 44 text
Bernhard Schussek · webmozart.io 44/119
$twig->render('/batman/blog/views/index.html.twig');
Accessing Resources
Slide 45
Slide 45 text
Bernhard Schussek · webmozart.io 45/119
Puli Path
/batman/blog/views/index.html.twig
Slide 46
Slide 46 text
Bernhard Schussek · webmozart.io 46/119
batman/blog
/res
/batman/blog/views/index.html.twig
Path Prefix
Physical Location
Path Mapping
Slide 47
Slide 47 text
Bernhard Schussek · webmozart.io 47/119
/res/views/index.html.twig
Resolved Path
/batman/blog/views/index.html.twig
Physical Location
Path Prefix
batman/blog
Slide 48
Slide 48 text
Bernhard Schussek · webmozart.io 48/119
puli.json
{
"resources": {
"/batman/blog": "res"
}
}
preview
Slide 49
Slide 49 text
Bernhard Schussek · webmozart.io 49/119
{% extend '/batman/blog/views/layout.html.twig' %}
{% include '../sidebar.html.twig' %}
{% use 'macros.html.twig' %}
Tool Integration: Twig
Slide 50
Slide 50 text
Bernhard Schussek · webmozart.io 50/119
Accessing Resources
in Other Modules
Slide 51
Slide 51 text
Bernhard Schussek · webmozart.io 51/119
{% extend '/thor/theme/views/layout.html.twig' %}
Resource Access
composer.json
{
"require": {
"thor/theme": "^1.0"
}
}
Slide 52
Slide 52 text
Bernhard Schussek · webmozart.io 52/119
Overriding Resources
in Other Modules
Slide 53
Slide 53 text
Bernhard Schussek · webmozart.io 53/119
batman/blog
page.html.twig
thor/theme
✔ Within Your Control ✘ Outside Your Control
layout.html.twig
{% extends %}
How to customize?
Slide 54
Slide 54 text
Bernhard Schussek · webmozart.io 54/119
page.html.twig
✔ Within Your Control ✘ Outside Your Control
layout.html.twig
{% extends %}
layout.html.twig
copy
batman/blog thor/theme
Slide 55
Slide 55 text
Bernhard Schussek · webmozart.io 55/119
post.html.twig
✔ Within Your Control ✘ Outside Your Control
layout.html.twig
{% extends %}
layout.html.twig
overrides
batman/blog thor/theme
Slide 56
Slide 56 text
Bernhard Schussek · webmozart.io 56/119
thor/theme
batman/blog
puli.json
/thor/theme → res
puli.json
/batman/blog → res
Slide 57
Slide 57 text
Bernhard Schussek · webmozart.io 57/119
puli.json
/thor/theme res
→
/batman/blog res
→
puli.json
/thor/theme → res/theme
override
thor/theme
batman/blog
Slide 58
Slide 58 text
Bernhard Schussek · webmozart.io 58/119
puli.json
{
"resources": {
"/batman/blog": "res",
"/thor/theme": "res/theme"
},
"override": ["thor/theme"]
}
Overridden Packages
preview
Slide 59
Slide 59 text
Bernhard Schussek · webmozart.io 59/119
Override Graph
Slide 60
Slide 60 text
Bernhard Schussek · webmozart.io 60/119
Accessing Different Versions
$versions = $repo->getVersions('/thor/theme/config.yml')
// res/theme/config.yml
echo $versions->getCurrent()->getBody();
// vendor/thor/theme/res/config.yml
echo $versions->getFirst()->getBody();
Slide 61
Slide 61 text
Bernhard Schussek · webmozart.io 61/119
Use Services
Provided by Other Modules
Slide 62
Slide 62 text
Bernhard Schussek · webmozart.io 62/119
react/http-client
http/discovery
Users Providers
Http\Client\HttpClient
Define Binding Type
ReactClient
Slide 63
Slide 63 text
Bernhard Schussek · webmozart.io 63/119
Users Providers
Discover
ReactClient
HttpDiscovery
react/http-client
http/discovery Http\Client\HttpClient
Slide 64
Slide 64 text
Bernhard Schussek · webmozart.io 64/119
puli.json
{
"define": {
"Http\\Client\\HttpClient": "class"
}
}
preview
Slide 65
Slide 65 text
Bernhard Schussek · webmozart.io 65/119
Service Discovery
$bindings = $discovery->findBindings(HttpClient::class);
foreach ($bindings as $binding) {
$className = $binding->getClassName();
$httpClient = new $className();
// ...
}
Slide 66
Slide 66 text
Bernhard Schussek · webmozart.io 66/119
Provide Services
to Other Modules
Slide 67
Slide 67 text
Bernhard Schussek · webmozart.io 67/119
Users Providers
Provide
ReactClient
react/http-client
http/discovery Http\Client\HttpClient
Slide 68
Slide 68 text
Bernhard Schussek · webmozart.io 68/119
puli.json
{
"provide": {
"React\\Client": "Http\\Client\\HttpClient"
}
}
preview
Slide 69
Slide 69 text
Bernhard Schussek · webmozart.io 69/119
Use Resources
Provided by Other Modules
Slide 70
Slide 70 text
Bernhard Schussek · webmozart.io 70/119
Users Providers
messages.en.yml
thor/translations-yml
Define Binding Type
batman/blog
thor/translator
Slide 71
Slide 71 text
Bernhard Schussek · webmozart.io 71/119
Users Providers
Find Resources
MessageLoader
thor/translator thor/translations-yml
messages.en.yml
batman/blog
Slide 72
Slide 72 text
Bernhard Schussek · webmozart.io 72/119
puli.json
{
"define": {
"thor/translations-yml": "resource"
}
}
preview
Slide 73
Slide 73 text
Bernhard Schussek · webmozart.io 73/119
Resource Discovery
$bindings = $discovery->findBindings('thor/translations-
foreach ($bindings as $binding) {
foreach ($binding->getResources() as $resource) {
$yaml = $routing->getBody();
// ...
}
}
Slide 74
Slide 74 text
Bernhard Schussek · webmozart.io 74/119
Provide Resources
to Other Modules
Slide 75
Slide 75 text
Bernhard Schussek · webmozart.io 75/119
Users Providers
Provide
thor/translator thor/translations-yml
messages.en.yml
batman/blog
Slide 76
Slide 76 text
Bernhard Schussek · webmozart.io 76/119
puli.json
{
"provide": {
"/batman/blog/trans/*.yml":
"thor/translations-yml"
}
}
preview
Slide 77
Slide 77 text
Bernhard Schussek · webmozart.io 77/119
Puli Provides Everything You
Need to Integrate your Module
with Other Modules
Slide 78
Slide 78 text
Bernhard Schussek · webmozart.io 78/119
Puli for Application Developers
Slide 79
Slide 79 text
Bernhard Schussek · webmozart.io 79/119
Your Code
Your Application
Old-School Development
Slide 80
Slide 80 text
Bernhard Schussek · webmozart.io 80/119
Package Reuse
Your Code
3rd-Party Code
Your Application
Slide 81
Slide 81 text
Bernhard Schussek · webmozart.io 81/119
Your Application
Your Code
3rd-Party Code
Your Application
More Efficient
Slide 82
Slide 82 text
Bernhard Schussek · webmozart.io 82/119
Reuse of Existing
High-Quality 3rd-Party Code
is Key to Success
Slide 83
Slide 83 text
Bernhard Schussek · webmozart.io 83/119
Libraries
Symfony
Bundles
Laravel
Packages
Drupal
Modules Silex
Providers
Without Puli
Slide 84
Slide 84 text
Bernhard Schussek · webmozart.io 84/119
Modules
With Puli
Slide 85
Slide 85 text
Bernhard Schussek · webmozart.io 85/119
$loader = new TranslationLoader(array(
__DIR__.'/res/trans/messages.en.yml',
__DIR__.'/res/trans/messages.de.yml',
__DIR__.'/vendor/batman/blog/trans/blog.en.yml',
__DIR__.'/vendor/batman/blog/trans/blog.de.yml',
__DIR__.'/vendor/batman/blog/trans/blog.fr.yml',
// ...
));
$translator = new Translator($loader);
Application Bootstrapping Without Puli
Slide 86
Slide 86 text
Bernhard Schussek · webmozart.io 86/119
Lots of Work Necessary
to Wire Up Libraries
Slide 87
Slide 87 text
Bernhard Schussek · webmozart.io 87/119
Worst Case: Quadratic Effort
Science Talk for "A Lot"
Slide 88
Slide 88 text
Bernhard Schussek · webmozart.io 88/119
$loader = new PuliLoader($discovery);
$translator = new Translator($loader);
Application Bootstrapping With Puli
Slide 89
Slide 89 text
Bernhard Schussek · webmozart.io 89/119
(almost) Plug 'n Play
Slide 90
Slide 90 text
Bernhard Schussek · webmozart.io 90/119
PHP Code
Resource Files
Provide/Use Services
by Interface
Http\Client\HttpClient
=
Guzzle\GuzzleClient
React\HttpClient\ReactClient
Http\Curl\CurlClient
…
Module
PHP Code
Resource Files
Module
Slide 91
Slide 91 text
Bernhard Schussek · webmozart.io 91/119
Module
Module
PHP Code
Resource Files
PHP Code
Resource Files
Use Resources
by Type
symfony/translations-yml
=
path/to/trans/messages.en.yml
path/to/trans/messages.de.yml
path/to/trans/messages.fr.yml
…
Slide 92
Slide 92 text
Bernhard Schussek · webmozart.io 92/119
PHP Code
Resource Files
Access Resources
by Puli Path
/batman/blog/config.yml
=
path/to/module/res/config.yml
Module
Slide 93
Slide 93 text
Bernhard Schussek · webmozart.io 93/119
PHP Code
Resource Files
Publish Assets
public/
css/
style.min.css
images/
background.png
Module
Document Root
PHP Code
Resource Files
Module
Slide 94
Slide 94 text
Bernhard Schussek · webmozart.io 94/119
Repository JSON URL Generator
JSON
Gulp/Grunt
+
puli.js
Alternative 1: JavaScript
Slide 95
Slide 95 text
Bernhard Schussek · webmozart.io 95/119
Gulpfile.js
var gulp = require('gulp'),
puli = require('puli').load('.puli/path-mappings.jso
urls = require('puli-urls');
gulp.task('vendor', function () {
puli.src('/batman/blog/public/**/*')
.pipe(urls())
.dest('res/public/blog')
.pipe(urls.mapping())
.dest('.puli/urls.json');
});
preview
Slide 96
Slide 96 text
Bernhard Schussek · webmozart.io 96/119
Repository URL Generator
JSON
Alternative 2: Asset Component
Asset
Slide 97
Slide 97 text
Bernhard Schussek · webmozart.io 97/119
puli.json
{
"config": {
"assets.root-dir": "res/public"
},
"publish": {
"/batman/blog/public": "res/public/blog/"
},
"urls": {
"*": "/{$path}",
"*.jpg":
"{$scheme}://my.cdn.com/{$path}"
}
}
preview
Slide 98
Slide 98 text
Bernhard Schussek · webmozart.io 98/119
Resource Installation
$ puli publish
Installing /batman/blog/public in at res/public/blog/
via symlink...
Done!
preview
Slide 99
Slide 99 text
Bernhard Schussek · webmozart.io 99/119
(in the Module)
Slide 100
Slide 100 text
Bernhard Schussek · webmozart.io 100/119
%20}})
Slide 101
Slide 101 text
Bernhard Schussek · webmozart.io 101/119
body {
background-image: asset_url("/res/public/bg.png");
// Relative paths
background-image: asset_url("bg.png");
}
CSS Post-Processing
preview
Slide 102
Slide 102 text
Bernhard Schussek · webmozart.io 102/119
https://commons.wikimedia.org/wiki/File:View_from_Volcano_Pacaya,_Guatemala.jpg (CC BY-SA 4.0)
PHP Community of Modules
Slide 103
Slide 103 text
Bernhard Schussek · webmozart.io 103/119
batman/blog
Request Response
FIG and PSR-7
Slide 104
Slide 104 text
Bernhard Schussek · webmozart.io 104/119
Router Controller
/hello/world
PSR for Routing?
Slide 105
Slide 105 text
Bernhard Schussek · webmozart.io 105/119
services.xml
php-fig/di-config symfony/routing
my/application
DI Container
PSR for DI Configuration?
Slide 106
Slide 106 text
Bernhard Schussek · webmozart.io 106/119
$container = new Container($discovery);
$router = $container->get(Router::class);
$controller = $router->getController('/hello/world');
$response = $controller->handle($request);
PHP Applications with Puli
Slide 107
Slide 107 text
Bernhard Schussek · webmozart.io 107/119
Current Status
Slide 108
Slide 108 text
Bernhard Schussek · webmozart.io 108/119
1.0.0-beta10
Slide 109
Slide 109 text
Bernhard Schussek · webmozart.io 109/119
Stable Release in 2016
Slide 110
Slide 110 text
Bernhard Schussek · webmozart.io 110/119
Extensive Documentation
docs.puli.io
Slide 111
Slide 111 text
Bernhard Schussek · webmozart.io 111/119
Successfully in Production
Slide 112
Slide 112 text
Bernhard Schussek · webmozart.io 112/119
Working Symfony Bundle
puli/symfony-bundle
Slide 113
Slide 113 text
Bernhard Schussek · webmozart.io 113/119
Symfony Distribution
puli/symfony-puli-edition
Slide 114
Slide 114 text
Bernhard Schussek · webmozart.io 114/119
Potential Projects Supporting
Puli Out-of-the-Box
Drupal?
Slide 115
Slide 115 text
Bernhard Schussek · webmozart.io 115/119
Feedback Wanted
puli.io
Twitter: @PuliPHP
Chat: gitter.im/puli/issues
Slide 116
Slide 116 text
Bernhard Schussek · webmozart.io 116/119
Get Involved!
github.com/puli/issues
Slide 117
Slide 117 text
Bernhard Schussek · webmozart.io 117/119
@webmozart
Slide 118
Slide 118 text
Bernhard Schussek · webmozart.io 118/119
joind.in/talk/9785b
Slide 119
Slide 119 text
Bernhard Schussek · webmozart.io 119/119
Questions?
Questions?
Bernhard Schussek
Bernhard Schussek
@webmozart
@webmozart
https://www.flickr.com/photos/puliarfanita/7167723539 (CC BY 2.0)
webmozart.io