phpfastcgi / expressive-adapter
A PHPFastCGI adapter for the Zend Expressive framework
Requires
- php: >=5.5.0
- phpfastcgi/fastcgi-daemon: ^0.7
- zendframework/zend-expressive: ~0.1 | ^1.0
Requires (Dev)
- satooshi/php-coveralls: dev-master
- zendframework/zend-expressive-fastroute: ^1.0
- zendframework/zend-servicemanager: ^2.5
This package is auto-updated.
Last update: 2024-09-19 13:53:07 UTC
README
A PHP package that allows Zend Expressive applications to reduce overheads by exposing their Request-Response structure to a FastCGI daemon.
Visit the project website.
Introduction
Using this package, Zend Expressive applications can stay alive between HTTP requests whilst operating behind the protection of a FastCGI enabled web server.
Current Status
This project is currently in early stages of development and not considered stable. Importantly, this library currently lacks support for uploaded files.
Contributions and suggestions are welcome.
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.
This can be done by creating a FastCGI script that launches your application and inserting a FastCgiServer directive into your virtual host configuration.
#!/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:
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.
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.
The two important files:
This PHP script creates and runs a FastCGI application using the Zend Expressive application object.
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.
NGINX Configuration
Below is an example of the changes that were made to the NGINX configuration file for AstroSplash:
upstream workers {
server localhost:5000;
server localhost:5001;
server localhost:5002;
server localhost:5003;
}
server {
# ...
location # ... {
include /etc/nginx/fastcgi_params;
fastcgi_pass workers;
# ...
}
# ...
}