php-built-in-server

Node.js PHP built-in Server

A node.js tool to launch PHP built-in servers.

Requirements

• php >= 5.4.0 on your system.

Installation

$ npm install php-built-in-server

Usage

var PHPServer = require('php-built-in-server');

Simple usage

var server = new PHPServer();
 
server.on('listening', function (event) {
    console.log('[LISTENING]', event.host.address + ':' + event.host.port);
});
 
server.on('error', function (event) {
    console.log('[ERROR]', event.error.toString());
});
 
server.listen();

Explicit parameters

var server = new PHPServer('path/to/phpExecutable', '/path/to/php.ini');
 
server.on('listening', function (event) {
    console.log('[LISTENING]', event.host.address + ':' + event.host.port);
});
 
server.on('error', function (event) {
    console.log('[ERROR]', event.error.toString());
});
 
// pathes can be absolute or relatives
server.listen( 'path/to/webRoot', '127.0.0.1', 8000, '/path/to/router.php', {
        max_execution_time: 60,
        error_log: '/path/to/file', // path here is send to php as is
        // etc.
});
 

Show "examples" folder.

TODO

• find solution for partial buffering of stderr:
  fwrite(fopen('php://stderr', 'w'), 'test'); is immediatly receive from PHP but stderr datas coming from server himself is buffured.
  If someone knows how to fix this...

Known issues

• No data is received from the child process to confirm explicitly that the server is listening.
• The stderr of the child process logs all queries, not just errors.
• The stderr seems buffered (show TODO).

Licence

Copyright (c) 2013 Valéry Herlaud. Licensed under the MIT license. See the file LICENSE.md in this distribution for more details.