sphp

You should now se the example pages.

$3

var express = require('express');
var sphp = require('sphp');

var app = express();
var server = app.listen(8080);

app.use(sphp.express('public/'));
app.use(express.static('public/'));

$3

var express = require('express');
var sphp = require('sphp');

var app = express();
var server = app.listen(8080);
var ws = new require('ws').Server({server: server});

app.use(sphp.express('public/'));
ws.on('connection',sphp.websocket());
app.use(express.static('public/'));

#### Set up with an express server and express-session

var express = require('express');
var expressSession = require('express-session');
var bodyParser = require('body-parser');
var sessionStore = new expressSession.MemoryStore();
var sphp = require('sphp');

var app = express();
var server = app.listen(8080);
var sessionOptions={
store: sessionStore
,secret:'yes :c)'
,resave:false
,saveUninitialized:false
,rolling: true
,name: 'SID'
}

app.use(expressSession(sessionOptions));
app.use(function(request, response, next){
// Save session data
request.session.ip=request.client.remoteAddress;
next();
});
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({extended: true}));

app.use(sphp.express('example/'));
ws.on('connection',sphp.websocket(sessionOptions));
app.use(express.static('example/'));

$3

Set all options:

var sphpOptions = {
cgiEngine: “/usr/bin/php-cgi'
,docRoot: “/home/of/my/pubnlic/files”
,minSpareWorkers: 4
,maxWorkers: 20
,stepDowntime: 1800
,overwriteWSPath: “/ws_serveice.php”
, preLoadScript: “pre_load.php”
,superglobals: {_SERVER.SERVER_NAME: “MyServer.com”}
};

sphp.setOptions(sphpOptions);

or alternatively parsed with the express middleware setup:

app.use(sphp.express(sphpOptions));

To set the server name:

sphp.setOptions({
superglobals: {
_SERVER: {
SERVER_NAME: "MyServer.com"
}
}
});

To load the enviroment variables:

sphp.setOptions({
superglobals: {
_ENV: JSON.parse(JSON.stringify(process.env)
}
});

|variable name | |
|---|---|
|cgiEngine |Default: "php-cgi" Specify which binary file to use to execute PHP script. The executable must be in the environment PATH or use a full path to the executable file.|
|docRoot |(default: "./public" Where to serve script files from. Might be relative or an absolute path. This is the variable set, when sphp.express is called with a parameter.|
|minSpareWorkers |Default: 2. Define the minimum number of workers kept ready.
Note that when calling PHP scripts through websockets, an additional concurrent worker is used. |
|maxWorkers |Default: 10. The maximum number of workers allowed to start. This number will never be exceeded. Requests will instead be rejected. Set this to limit the amount of RAM the server can use, when load is high. The footprint is about 20MB / worker as of php-cgi 5.4 php-gci.
|stepDowntime |Default: 360 seconds. The number of worker are increased dynamically, When the need arises. This is the time it takes before, the number of workers, are reduced by one.|
|overwriteWSPath |Default null. Used to specify which script should serve a websocket request.
If null, the URL of the connection GET request is used. The path is relative to docRoot.|
|preLoadScript |Default null. This can be used to preload libraries, before a page is requested, thus improving reaponcetime. The preLoadScript variable contains a path to a php script, relative to docRoot. Be aware that the script pointet to will be executed when the php engine is loaded eg. before a client has made a page request. non of the super globals are set to usefull values at this point. The script sould contain generic library function that are use system wide, as it will be loaded with all page.|
|superglobals | This can be used to preset PHP superglobals like $_SERVER['SERVER_NAME'] Any variable can be set, but will be overwriten, if the name is one of thouse that is set during request time, except SERVER_NAME.
The following variables are predefined and will be futher populated at request time:
_POST
_GET
_FILES
_SERVER: SERVER_SOFTWARE, SERVER_NAME
_COOKIE|

$3

The responsetime is achieved by sacrificing considerations of resources and performance under load. This is implemented by pre-emptively loading of the PHP-CGI engine and a user PHP script, typically including generic PHP library. The process is then put on hold until needed.

$3

$3

Don't hesitate to submit an issue on github. But please provide a reproducible example.