Hoa is a modular, extensible and
structured set of PHP libraries.
Moreover, Hoa aims at being a bridge between industrial and research worlds.
This library allows to manipulate the FastCGI protocol, which ensures the communication between a HTTP server and an external program (such as PHP).
$ composer require hoa/fastcgi '~3.0'
For more installation procedures, please read the Source page.
Before running the test suites, the development dependencies must be installed:
$ composer install
Then, to run all the test suites:
$ vendor/bin/hoa test:run
For more information, please read the contributor guide.
As a quick overview, we propose to execute a PHP file through the FastCGI protocol directly.
Before starting, we need to know that PHP proposes two tools that support
FastCGI Process Manager). We will use
local with the standard port
9000 in TCP:
$ php-cgi -b 127.0.0.1:9000
First, we write the
Echo.php file, the one we are likely to execute:
<?php echo 'foobar';
Second, we need to open a connexion to the FastCGI server and send a query with the following headers:
SCRIPT_FILENAMEwhich represents the absolute path to the PHP file to execute;
REQUEST_METHODwhich represents the HTTP method among
REQUEST_URIwhich represents the identifier of the resource we are trying to access.
$fastcgi = new Hoa\Fastcgi\Responder( new Hoa\Socket\Client('tcp://127.0.0.1:9000') ); var_dump($fastcgi->send([ 'REQUEST_METHOD' => 'GET', 'REQUEST_URI' => '/', 'SCRIPT_FILENAME' => __DIR__ . DS . 'Echo.php' ])); // string(6) "foobar"
We can get the headers from the executed file by calling the
This is a good and fast way to execute PHP files (or other programs that support FastCGI) without worrying about binary locations, subshell calls, error handling, etc.
hack book of
contains detailed information about how to use this library and how it works.
To generate the documentation locally, execute the following commands:
$ composer require --dev hoa/devtools $ vendor/bin/hoa devtools:documentation --open
More documentation can be found on the project's website: hoa-project.net.
There are mainly two ways to get help:
Do you want to contribute? Thanks! A detailed contributor guide explains everything you need to know.
Hoa is under the New BSD License (BSD-3-Clause). Please, see
LICENSE for details.