node-php-awesome-server v1.5.0

Node PHP Awesome Server

npm install node-php-awesome-server --save-dev

Update

1.5.0 :

• Updated dependencies
• Minor adjustments

1.4.0 :

• Dependencies were upgraded in this update !
• Note: A major upgrade will be issued in the following months, the project was refactored, many bugs were fixed, and will come with some big features which will allow you more control over the environment.

1.3.1 :

• Added new option middlewareAfter, same as middleware, but registered after the request to php is done.
• Exposed objects res.locals.phpBody (Buffer) and res.locals.phpHeaders . Available only in middlewares registered in middlewareAfter.

1.3.0 :

• Fixed an issue where cookies were not kept between master and workers.

1.2.12 :

• Fixed an issue where cookies where not kept.

1.2.9 :

• Fixed an issue where Apache/Nginx would take over if the worker would target an undefined port.

1.2.4 :

• added middleware support
• added php instances to workers ( see phpPerCluster )
• added to output the following options : reqTime and port,
• now you can cURL on the same project
• changed strategy for request distribution
• added option ini_config so you can load your own php.ini

Use it if you want:

1. A fast local development PHP Server benefiting the advantages from php-built-in-web-server-router
2. Multiple workers for a faster serving time.
3. A colorful output.

Options

Events

Middleware:

The middleware option supports the following formats:

• a function
• an array with path, function
• an array with the above formats

MiddlewareAfter:

Bellow there are two examples that change output, both of them use cheerio to edit the markup:

Keep in mind that res.locals.phpBody is a Buffer and in the end it is the output you will see.

Example 1 - Alter body and end all (any middlewares after this won't get processed):

function(req,res){
 
     /**
      * Get the body
      */
     var body = res.locals.phpBody;
     
     /**
      * Target only content-type text/html
      */
     if (res.locals.phpHeaders.hasOwnProperty('content-type') && res.locals.phpHeaders['content-type'].indexOf('text/html') !== -1) {
    
         var baseUrl = req.protocol + '://' + req.headers['host'] + "/";
         
         /**
          * Convert body to string => body.toString() , and pass it to cheerio
          */
         var $ = require('cheerio').load(body.toString());
    
         $("body").append('<div>this tag is from node : '+baseUrl+'</div>')
        
         body = $.html();
    
     }
    
     /**
      * End request
      */
     res.end(body);

}

Example 2 - Alter body and continue:

function(req,res,next){
 
     /**
      * Get the body
      */
     var body = res.locals.phpBody;
     
     /**
      * Target only content-type text/html
      */
     if (res.locals.phpHeaders.hasOwnProperty('content-type') && res.locals.phpHeaders['content-type'].indexOf('text/html') !== -1) {
    
         var baseUrl = req.protocol + '://' + req.headers['host'] + "/";
         
         /**
          * Convert body to string => body.toString() , and pass it to cheerio
          */
         var $ = require('cheerio').load(body.toString());
    
         $("body").append('<div>this tag is from node : '+baseUrl+'</div>')
                
         body = $.html();
    
     }
    
     /**
      * Continue with the next middleware
      */
     res.locals.phpBody = body
     
     next();
     
}

Use the default Router if you:

• want caching ( see the output bellow for 304 status )
• want to point the router to another 'index.php' file
• don't have any router files

Caveats

Using multiple instances of the same CMS(Wordpress, Drupal, etc. - usually those that use cookies) on the same PORT may show you some 403 (Forbidden) status codes. You can fix this by deleting your cookies.

Example

const simpleMiddleware = (req, res, next) => {

    if (!req.app.hasOwnProperty('output_once')) {

        req.app['output_once'] = true;
        console.log("Simple Middleware - I trigger once before the first request")

    }

    next();

};

const fontsMiddleware = (req, res, next) => {

    console.log("I'll appear only when you're locating the /fonts/ url");

    next();
};

const nodePhpAwesomeServer = require('node-php-awesome-server');

const php = nodePhpAwesomeServer({

    port: 9012,
    env: {
        'SOMEKEY': 'some value',
        'customObject': JSON.stringify({'test':0,'name':'yes'})
    },
    middleware: [
            /**
             * Just the middleware
             */
            simpleMiddleware,
    
            /**
             * Path and middleware
             */
            ["/fonts/*", fontsMiddleware]
        ],
    //ini_config: "/path/to/your/custom.ini",
    ini_set: {
        max_execution_time: 280
    },
    output: {
        os: true,
        browser: true,
        device: true,
        reqTime: true
    },
    clustersSet: 'auto',
    phpPerCluster: 2

});

php.on('close', () => {
    console.log('php server closed');
});

php.on('connect', () => {

    console.log('All up and running');

    //php.close();

});

//php.close();

Run

node ./YOUR_FILE_WITH_THE_ABOVE_CODE.js

Output:

> node ./test/example.js

Worker 3 hired - PID 16096
Worker 1 hired - PID 240
Worker 2 hired - PID 19924
DOCUMENT ROOT: D:/Projects/Home/Workspace/Sites/node-php-awesome-server/public
ROUTER: default
LINK: http://localhost:9012
EXTERNAL: http://192.168.0.35:9012
Simple Middleware - I trigger once before the first request
[W2] [Thu Dec 07 2017 18:28:31 2017] 127.0.0.1:57268 [Windows 10] [Firefox] [Other] [200][GET] [58ms]: /
[W2] [Thu Dec 07 2017 18:28:31 2017] 127.0.0.1:57272 [Windows 10] [Firefox] [Other] [304][GET] [38ms]: /polyfills.bundle.js
[W1] [Thu Dec 07 2017 18:28:31 2017] 127.0.0.1:57273 [Windows 10] [Firefox] [Other] [304][GET] [40ms]: /vendor.bundle.js
[W2] [Thu Dec 07 2017 18:28:31 2017] 127.0.0.1:57271 [Windows 10] [Firefox] [Other] [304][GET] [48ms]: /style.css
[W3] [Thu Dec 07 2017 18:28:31 2017] 127.0.0.1:57275 [Windows 10] [Firefox] [Other] [304][GET] [63ms]: /app.bundle.js
[W2] [Thu Dec 07 2017 18:28:31 2017] 127.0.0.1:57283 [Windows 10] [Firefox] [Other] [304][GET] [25ms]: /images/icon.php5.e030bb780de676e424e3a975ea89e83c.png
[W2] [Thu Dec 07 2017 18:29:32 2017] 127.0.0.1:57289 [Windows 10] [Firefox] [Other] [200][GET] [34ms]: /
[W2] [Thu Dec 07 2017 18:29:32 2017] 127.0.0.1:57296 [Windows 10] [Firefox] [Other] [200][GET] [38ms]: /app.bundle.js
[W2] [Thu Dec 07 2017 18:29:32 2017] 127.0.0.1:57294 [Windows 10] [Firefox] [Other] [200][GET] [77ms]: /polyfills.bundle.js
[W2] [Thu Dec 07 2017 18:29:32 2017] 127.0.0.1:57292 [Windows 10] [Firefox] [Other] [200][GET] [174ms]: /style.css
I'll appear only when you're locating the /fonts/ url
[W3] [Thu Dec 07 2017 18:29:32 2017] 127.0.0.1:57304 [Windows 10] [Firefox] [Other] [200][GET] [47ms]: /fonts/Roboto-Light.46e48ce0628835f68a7369d0254e4283.ttf
[W2] [Thu Dec 07 2017 18:29:32 2017] 127.0.0.1:57295 [Windows 10] [Firefox] [Other] [200][GET] [394ms]: /vendor.bundle.js
[W1] [Thu Dec 07 2017 18:29:33 2017] 127.0.0.1:57307 [Windows 10] [Firefox] [Other] [200][GET] [25ms]: /images/icon.php5.e030bb780de676e424e3a975ea89e83c.png

You will see each request starts with W3...Wx), these are the Workers serving requests

Open the server link on multiple browsers if you wanna see different workers, or you can just spam with some ajax the server link