phpfastcgi/expressive-adapter

A PHPFastCGI adapter for the Zend Expressive framework

PHPFastCGI Zend Expressive Adapter

, _(*1)

A PHP package that allows Zend Expressive applications to reduce overheads by exposing their Request-Response structure to a FastCGI daemon., _(*2)

Visit the project website., _(*3)

Introduction

Using this package, Zend Expressive applications can stay alive between HTTP requests whilst operating behind the protection of a FastCGI enabled web server., _(*4)

Current Status

This project is currently in early stages of development and not considered stable. Importantly, this library currently lacks support for uploaded files., _(*5)

Contributions and suggestions are welcome., _(*6)

Installing

composer require "phpfastcgi/expressive-adapter:^0.1"

Usage

<?php // command.php

// Include the composer autoloader
require_once dirname(__FILE__) . '/../vendor/autoload.php';

use PHPFastCGI\FastCGIDaemon\ApplicationFactory;
use PHPFastCGI\Adapter\Expressive\ApplicationWrapper;
use Zend\Expressive\AppFactory;

// Create your Expressive app
$app = AppFactory::create();
$app->get('/', function ($request, $response, $next) {
    $response->getBody()->write('Hello, World!');
    return $response;
});

// Create the kernel for the FastCGIDaemon library (from the Expressive app)
$kernel = new ApplicationWrapper($app);

// Create the symfony console application
$consoleApplication = (new ApplicationFactory)->createApplication($kernel);

// Run the symfony console application
$consoleApplication->run();

If you wish to configure your FastCGI application to work with the apache web server, you can use the apache FastCGI module to process manage your application., _(*7)

This can be done by creating a FastCGI script that launches your application and inserting a FastCgiServer directive into your virtual host configuration., _(*8)

#!/bin/bash
php /path/to/command.php run

FastCgiServer /path/to/web/root/script.fcgi

By default, the daemon will listen on FCGI_LISTENSOCK_FILENO, but it can also be configured to listen on a TCP address. For example:, _(*9)

php /path/to/command.php run --port=5000 --host=localhost

If you are using a web server such as NGINX, you will need to use a process manager to monitor and run your application., _(*10)

AstroSplash: An Example

The AstroSplash website currently runs using this adapter. If you are looking for an example integration, you may find the source code repository helpful., _(*11)

The two important files:, _(*12)

• fastcgi.php

This PHP script creates and runs a FastCGI application using the Zend Expressive application object., _(*13)

• supervisord.conf

As NGINX is used, supervisord was chosen to manage instances of the FastCGI application. This would not be necessary using Apache as it has a process manager built into the FastCGI module. This configuration file provides instructions for supervising the FastCGI application instances., _(*14)

NGINX Configuration

Below is an example of the changes that were made to the NGINX configuration file for AstroSplash:, _(*15)

upstream workers {
    server localhost:5000;
    server localhost:5001;
    server localhost:5002;
    server localhost:5003;
}

server {
    # ... 

    location # ... {
        include         /etc/nginx/fastcgi_params;
        fastcgi_pass    workers;
        # ...
    }

    # ...
}