Bref Extra PHP Extension

This repository has some AWS Lambda layers with PHP extensions. This is useful when you want something "off the shelf". If you ever need more than 2-3 layer you should consider creating your own layer. That is because AWS has a limit of 5 layers per Lambda.

We are happy to get contributions for other extensions. Sky is the limit! (And also your knowledge with Docker...)

Install and configure

composer require bref/extra-php-extensions

# serverless.yml
service: app

provider:
    name: aws
    region: us-east-1
    runtime: provided

plugins:
    - ./vendor/bref/bref
    - ./vendor/bref/extra-php-extensions # <----- Add the extra Serverless plugin

functions:
    console:
        handler: bin/console
        layers:
            - ${bref:layer.php-74} 
            - ${bref:extra.amqp-php-74} # <----- Example for AMQP layer
            - ${bref:layer.console}

;php/conf.d/php.ini
extension=/opt/bref-extra/amqp.so

Available layers

Name	Serverless config (php 7.4)	php.ini config
AMQP	`${bref:extra.amqp-php-74}`	`extension=/opt/bref-extra/amqp.so`
Blackfire	`${bref:extra.blackfire-php-74}`	`extension=/opt/bref-extra/blackfire.so`
GMP	`${bref:extra.gmp-php-74}`	`extension=/opt/bref-extra/gmp.so`
Igbinary	`${bref:extra.igbinary-php-74}`	`extension=/opt/bref-extra/igbinary.so`
Imagick	`${bref:extra.imagick-php-74}`	`extension=/opt/bref-extra/imagick.so`
Mailparse	`${bref:extra.mailparse-php-74}`	`extension=/opt/bref-extra/mailparse.so`
Memcache	`${bref:extra.memcached-php-74}`	`extension=/opt/bref-extra/memcache.so`
Memcached	`${bref:extra.memcached-php-74}`	`extension=/opt/bref-extra/memcached.so`
Pcov	`${bref:extra.pcov-php-74}`	`extension=/opt/bref-extra/pcov.so`
PostgreSQL	`${bref:extra.pgsql-php-74}`	`extension=/opt/bref-extra/pgsql.so`
Xdebug	`${bref:extra.xdebug-php-74}`	`zend_extension=/opt/bref-extra/xdebug.so`

Note that the "Memcached" layer provides both extension for Memcache and Memcached.

Note that you cannot use both the built-in imagick extension and imagick extension from this package. This version of imagick is built against newer version of ImageMagick than the built-in one and provides heic and webp support.

Blackfire installation

The Blackfire layer only have probe installed. You still need to install the agent. The agent is installed on a separate server (not a lambda function). The smallest EC2 instance is sufficient to run the Blackfire agent.

Create a blackfire.ini file for your lambda function where you load the extension and modify the agent_socket.

extension=/opt/bref-extra/blackfire.so

blackfire.agent_socket = tcp://ip-172-40-40-40.eu-central-1.compute.internal:8307
blackfire.agent_timeout = 0.25

Then modify your agent config to make sure you are listening to tcp://0.0.0.0:8307.

This blog post could be helpful as it describes how to install the Blackfire Agent.

Docker images

There are Docker images for every layer. They are updated on every push to master and on every tag. The name of the image is bref/extra-[name]-php-[version]. Find all images on Docker hub.

These are the same docker images that creates the layers. All layer files lives inside the /opt directory in the image.

For contributors and maintainers

Creating a new layer

The idea is to start from bref/build-php-XX, install all libraries and extensions you want, then move all related files to /opt. Those files will be available in the same same location on the Lambda.

Note that one can't just move files/libraries around. Most of them are expected to be in their "standard" location.

Create a new folder in layers and name it to your extension name.
Add your Dockerfile
Update .travis.yml to include your extension
Update the table in the readme

Please refer here for more details.

Deploy new versions

export AWS_PROFILE=my_profile
export AWS_ID=403367587399
make publish
git add checksums.json layers.json
git commit -m "New version of layers"
git push

valentijnscholten/extra-php-extensions