Hey!
I’m Thibault
🐇 🇫🇷 💻
Hey!
1
I’m Thibault
🐇 🇫🇷 💻
2
A practical guide to PHP serverless applications
Using symfony/demo as an example
3
What is Serverless?
4
Serverless is about managing less infrastructure.
5
S3
6
Lambda, a developer’s dream
7
8
9
10
11
12
13
14
15
Hosting the symfony/demo serverlessly in AWS Lambda
16
Let’s go 🚀
$ symfony new --demo leeds-talk$ symfony new --demo leeds-talk
17
Why the Symfony Demo?
- Complete sample project
- Symfony
- Twig
- Database
- Users & sessions
- Webpack Encore
- Console Commands
- …
- Self-contained by default
- Pre-built assets
- Seeded SQLite database
18
Install Bref
$ composer require bref/bref bref/symfony-bridge$ composer require bref/bref bref/symfony-bridge
19
What is Bref?
Bref provides
- PHP runtimes for AWS Lambda
- Helpers to integrate with AWS services
- Deployment utilities
- Framework bridges
- Documentation
20
A few config tweaks 🔧
// src/Kernel.php namespace App; + use Bref\SymfonyBridge\BrefKernel; use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait; use Symfony\Component\Config\Loader\LoaderInterface; use Symfony\Component\Config\Resource\FileResource; use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\HttpKernel\Kernel as BaseKernel; use Symfony\Component\Routing\RouteCollectionBuilder; - class Kernel extends BaseKernel + class Kernel extends BrefKernel { // ...// src/Kernel.php namespace App; + use Bref\SymfonyBridge\BrefKernel; use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait; use Symfony\Component\Config\Loader\LoaderInterface; use Symfony\Component\Config\Resource\FileResource; use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\HttpKernel\Kernel as BaseKernel; use Symfony\Component\Routing\RouteCollectionBuilder; - class Kernel extends BaseKernel + class Kernel extends BrefKernel { // ...
21
A few config tweaks 🔧
# config/packages/framework.yaml framework: trusted_proxies: '127.0.0.1' trusted_headers: [ 'x-forwarded-for', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-host' ]# config/packages/framework.yaml framework: trusted_proxies: '127.0.0.1' trusted_headers: [ 'x-forwarded-for', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-host' ]
22
A few config tweaks 🔧
# config/packages/prod/monolog.yaml monolog: handlers: # ... nested: type: stream path: php://stderr# config/packages/prod/monolog.yaml monolog: handlers: # ... nested: type: stream path: php://stderr
23
The Serverless Framework
24
serverless.yml
service: symfony provider: name: aws region: us-east-1 stage: dev runtime: provided.al2 environment: APP_ENV: prod plugins: - ./vendor/bref/bref functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28service: symfony provider: name: aws region: us-east-1 stage: dev runtime: provided.al2 environment: APP_ENV: prod plugins: - ./vendor/bref/bref functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28
25
serverless.yml
service: leeds-talk-blog provider: name: aws region: us-east-1 stage: dev runtime: provided.al2 environment: APP_ENV: prod plugins: - ./vendor/bref/bref functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28service: leeds-talk-blog provider: name: aws region: us-east-1 stage: dev runtime: provided.al2 environment: APP_ENV: prod plugins: - ./vendor/bref/bref functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28
26
serverless.yml
service: leeds-talk-blog provider: name: aws region: eu-west-2 # London stage: dev runtime: provided.al2 environment: APP_ENV: prod plugins: - ./vendor/bref/bref functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28service: leeds-talk-blog provider: name: aws region: eu-west-2 # London stage: dev runtime: provided.al2 environment: APP_ENV: prod plugins: - ./vendor/bref/bref functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28
27
Doing our first deploy 🙈
$ serverless deploy$ serverless deploy
28
Maybe it should be a bit more like…
$ composer install --no-dev --optimize-autoloader $ bin/console cache:clear --env=prod $ serverless deploy$ composer install --no-dev --optimize-autoloader $ bin/console cache:clear --env=prod $ serverless deploy
29
Doing our first deploy 🙈
$ serverless deploy$ serverless deploy
30
The current infrastructure
31
32
We need an efficient and reliable way of delivering assets
33
Install Lift
$ serverless plugin install -n serverless-lift$ serverless plugin install -n serverless-lift
34
What is Lift?
- Serverless Framework plugin
- Abstraction layer for AWS infrastructure
- Focused on use-cases, not infrastructure
35
Server-side website
# serverless.yml service: leeds-talk-blog provider: ... plugins: - ./vendor/bref/bref - serverless-lift functions: ... constructs: website: type: server-side-website assets: '/build/*': public/build '/favicon.ico': public/favicon.ico '/apple-touch-icon.png': public/apple-touch-icon.png '/robots.txt': public/robots.txt# serverless.yml service: leeds-talk-blog provider: ... plugins: - ./vendor/bref/bref - serverless-lift functions: ... constructs: website: type: server-side-website assets: '/build/*': public/build '/favicon.ico': public/favicon.ico '/apple-touch-icon.png': public/apple-touch-icon.png '/robots.txt': public/robots.txt
36
Exclude assets from Lambda
# serverless.yml service: leeds-talk-blog ... package: patterns: - '!assets/**' - '!node_modules/**' - '!public/build/**' - '!tests/**' - '!var/**' - 'var/cache/prod/**' - 'public/build/entrypoints.json' - 'public/build/manifest.json'# serverless.yml service: leeds-talk-blog ... package: patterns: - '!assets/**' - '!node_modules/**' - '!public/build/**' - '!tests/**' - '!var/**' - 'var/cache/prod/**' - 'public/build/entrypoints.json' - 'public/build/manifest.json'
37
And we deploy again 🤓
$ serverless deploy$ serverless deploy
38
$ serverless deploy$ serverless deploy
39
The current infrastructure
40
41
And what about the Database?
42
SQL Database construct 🗄
# serverless.yml service: leeds-talk-blog provider: ... environment: APP_ENV: prod # replaced by postgres://user:pass@host/dbName DATABASE_URL: ${construct:database.databaseUrl} plugins: ... functions: ... constructs: website: ... database: type: database/sql engine: postgres password: ${env:DB_PASSWORD}# serverless.yml service: leeds-talk-blog provider: ... environment: APP_ENV: prod # replaced by postgres://user:pass@host/dbName DATABASE_URL: ${construct:database.databaseUrl} plugins: ... functions: ... constructs: website: ... database: type: database/sql engine: postgres password: ${env:DB_PASSWORD}
43
Enable pdo_pgsql PHP extension ⚙
# php/conf.d/php.ini extension=pdo_pgsql # you can configure more INI stuff here# php/conf.d/php.ini extension=pdo_pgsql # you can configure more INI stuff here
44
Deploying is so simple it becomes boring 😴 😪
$ serverless deploy$ serverless deploy
45
Not so boring apparently, we broke everything 😕
46
Not so boring apparently, we broke everything 😕
47
See the logs 📜
$ serverless logs -f web$ serverless logs -f web
48
See the logs 📜
SQLSTATE[42P01]: Undefined table: 7 ERROR: relation "symfony_demo_post" does not exist
49
We need to execute migrations after deploying
50
The console function 🎮
# serverless.yml ... functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28 console: handler: bin/console layers: - ${bref:layer.php-80} - ${bref:layer.console} timeout: 120# serverless.yml ... functions: web: events: - httpApi: '*' handler: public/index.php layers: - ${bref:layer.php-80-fpm} timeout: 28 console: handler: bin/console layers: - ${bref:layer.php-80} - ${bref:layer.console} timeout: 120
51
Back to our deployment script
$ serverless deploy $ vendor/bin/bref cli leeds-talk-blog-dev-console -- doctrine:migration:migrate --no-interaction$ serverless deploy $ vendor/bin/bref cli leeds-talk-blog-dev-console -- doctrine:migration:migrate --no-interaction
52
It works again! 🌈
53
We’re done! 🎉
- Deployed our code
- Served assets from a CDN
- Created a Database
- Executed migrations
54
An application doesn’t need more, right!?
- Wait, I use sessions!
- What about queues?
- And HTTP cache?
- Where is my beloved
crontab? - I need dev, staging & prod environments!
- I can’t keep those ugly domains!
55
How about we do all that?
56
Wait, I use sessions!
Store them in a shared store like the Database or DynamoDB
# config/services.yaml services: # ... Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler: arguments: - '%env(DATABASE_URL)%'# config/services.yaml services: # ... Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler: arguments: - '%env(DATABASE_URL)%'
57
Wait, I use sessions!
Store them in a shared store like the Database or DynamoDB
# config/packages/framework.yaml framework: session: # ... handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler# config/packages/framework.yaml framework: session: # ... handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler
58
What about queues?
I want to use Symfony Messenger!
$ composer require bref/symfony-messenger$ composer require bref/symfony-messenger
59
What about queues?
I want to use Symfony Messenger!
# serverless.yml service: leeds-talk-blog provider: name: aws environment: ... MESSENGER_TRANSPORT_DSN: ${construct:jobs.queueUrl} constructs: ... jobs: type: queue alarm: thibault@widop.com worker: handler: bin/consumer.php timeout: 20 layers: - ${bref:layer.php-80}# serverless.yml service: leeds-talk-blog provider: name: aws environment: ... MESSENGER_TRANSPORT_DSN: ${construct:jobs.queueUrl} constructs: ... jobs: type: queue alarm: thibault@widop.com worker: handler: bin/consumer.php timeout: 20 layers: - ${bref:layer.php-80}
60
What about queues?
I want to use Symfony Messenger!
61
What about queues?
I want to use Symfony Messenger!
# bin/consumer.php <?php declare(strict_types=1); use Bref\Symfony\Messenger\Service\Sqs\SqsConsumer; use Symfony\Component\Dotenv\Dotenv; require dirname(__DIR__).'/vendor/autoload.php'; (new Dotenv())->bootEnv(dirname(__DIR__).'/.env'); $kernel = new \App\Kernel($_SERVER['APP_ENV'], (bool)$_SERVER['APP_DEBUG']); $kernel->boot(); // Return the Bref consumer service return $kernel->getContainer()->get(SqsConsumer::class);# bin/consumer.php <?php declare(strict_types=1); use Bref\Symfony\Messenger\Service\Sqs\SqsConsumer; use Symfony\Component\Dotenv\Dotenv; require dirname(__DIR__).'/vendor/autoload.php'; (new Dotenv())->bootEnv(dirname(__DIR__).'/.env'); $kernel = new \App\Kernel($_SERVER['APP_ENV'], (bool)$_SERVER['APP_DEBUG']); $kernel->boot(); // Return the Bref consumer service return $kernel->getContainer()->get(SqsConsumer::class);
62
What about queues?
I want to use Symfony Messenger!
# config/packages/messenger.yaml framework: messenger: transports: async: dsn: '%env(MESSENGER_TRANSPORT_DSN)%' options: auto_setup: false routing: 'Symfony\Component\Mailer\Messenger\SendEmailMessage': async# config/packages/messenger.yaml framework: messenger: transports: async: dsn: '%env(MESSENGER_TRANSPORT_DSN)%' options: auto_setup: false routing: 'Symfony\Component\Mailer\Messenger\SendEmailMessage': async
63
And HTTP cache?
It already works thanks to the Server-side construct!
class BlogController extends AbstractController { /** * @Route("/", defaults={"page": "1", "_format"="html"}, methods="GET", name="blog_index") * @Route("/rss.xml", defaults={"page": "1", "_format"="xml"}, methods="GET", name="blog_rss") * @Route("/page/{page<[1-9]\d*>}", defaults={"_format"="html"}, methods="GET", name="blog_index_paginated") * @Cache(smaxage="10") */ public function index(Request $request, int $page, string $_format, PostRepository $posts, TagRepository $tags): Response { ... } }class BlogController extends AbstractController { /** * @Route("/", defaults={"page": "1", "_format"="html"}, methods="GET", name="blog_index") * @Route("/rss.xml", defaults={"page": "1", "_format"="xml"}, methods="GET", name="blog_rss") * @Route("/page/{page<[1-9]\d*>}", defaults={"_format"="html"}, methods="GET", name="blog_index_paginated") * @Cache(smaxage="10") */ public function index(Request $request, int $page, string $_format, PostRepository $posts, TagRepository $tags): Response { ... } }
64
Where is my beloved crontab ?
# serverless.yml ... functions: ... console: handler: bin/console layers: - ${bref:layer.php-80} - ${bref:layer.console} timeout: 120 events: - schedule: # cron(minutes hours day month weekday year) rate: cron(0 12 ? * MON-FRI *) # Monday to Friday at noon input: '"app:list-users --send-to=thibault@widop.com"'# serverless.yml ... functions: ... console: handler: bin/console layers: - ${bref:layer.php-80} - ${bref:layer.console} timeout: 120 events: - schedule: # cron(minutes hours day month weekday year) rate: cron(0 12 ? * MON-FRI *) # Monday to Friday at noon input: '"app:list-users --send-to=thibault@widop.com"'
65
I need dev, staging & prod environments!
service: leeds-talk-blog provider: name: aws region: eu-west-2 # London stage: dev runtime: provided.al2 environment: ...service: leeds-talk-blog provider: name: aws region: eu-west-2 # London stage: dev runtime: provided.al2 environment: ...
66
I need dev, staging & prod environments!
$ serverless deploy --stage=dev $ serverless deploy --stage=staging $ serverless deploy --stage=production $ serverless deploy --stage=marketing-demo $ serverless deploy --stage=acme-corp-tenant$ serverless deploy --stage=dev $ serverless deploy --stage=staging $ serverless deploy --stage=production $ serverless deploy --stage=marketing-demo $ serverless deploy --stage=acme-corp-tenant
67
I can’t keep those ugly domains!
# serverless.yml ... constructs: website: # ... domain: blog.leedsphp.org certificate: arn:aws:acm:us-east-1:123456615250:certificate/0a28e63d-d3a9-4578-9f8b-14347bfe8123# serverless.yml ... constructs: website: # ... domain: blog.leedsphp.org certificate: arn:aws:acm:us-east-1:123456615250:certificate/0a28e63d-d3a9-4578-9f8b-14347bfe8123
68
I can’t keep those ugly domains!
# serverless.yml ... constructs: website: # ... domain: - www.leedsphp.org - leedsphp.org redirectToMainDomain: true certificate: arn:aws:acm:us-east-1:123456615250:certificate/0a28e63d-d3a9-4578-9f8b-14347bfe8123# serverless.yml ... constructs: website: # ... domain: - www.leedsphp.org - leedsphp.org redirectToMainDomain: true certificate: arn:aws:acm:us-east-1:123456615250:certificate/0a28e63d-d3a9-4578-9f8b-14347bfe8123
69
I can’t keep those ugly domains!
# serverless.yml ... constructs: website: # ... domain: - www.${env:DOMAIN_NAME} - ${env:DOMAIN_NAME} redirectToMainDomain: true certificate: ${env:CERTIFICATE_ARN}# serverless.yml ... constructs: website: # ... domain: - www.${env:DOMAIN_NAME} - ${env:DOMAIN_NAME} redirectToMainDomain: true certificate: ${env:CERTIFICATE_ARN}
70
We’re done! 🎉
- Deployed our code
- Served assets from a CDN
- Created a Database
- Executed migrations
- Stored sessions in the database
- Added Symfony Messenger
- Scheduled CRON jobs
- Enabled HTTP caching
- Deployed to multiple environments
- Configured domains
71
✅ Benefits
- Autoscaling built-in
- Paying for usage, not uptime
- High security and availability
- Less infrastructure to manage yourself
- Easy deployment and replication
- Quick ramp-up thanks to Bref, Serverless framework and Lift
- Fast major/minor/patch PHP updates
72
73
❌ Constraints
- Platform constraints
- 28 seconds HTTP timeout
- 15 minutes event timeout
- Readonly & ephemeral filesystem
- Cold-starts
- Database is still a fixed resource
- Paradigm shift
- Best suited for greenfield projects
74
Just give it a try!
75
Thank you so much for coming tonight 🤩
It’s question time!
@t__richard
Symfony & Bref Slack
💌 thibault@widop.com
⭐ github.com/brefphp/bref
⭐ github.com/getlift/lift
76