Add a simple CLI script.

Author: cscott

CHANGELOG.md

@@ -4,6 +4,7 @@
   requests from node's http server.
 * Support passing "command-line arguments" to allow the embedded PHP
   to execute scripts using PHP's CLI interface.
+* Add a simple `php-embed` CLI script for easy testing.
 * Allow PHP to invoke asynchronous JavaScript functions synchronously
   by passing a `Js\Wait` object where the callback would go.  This
   blocks the PHP event loop (naturally) but not the JavaScript one.

README.md

@@ -54,6 +54,19 @@ php.request({
 }).done();
 ```
 
+## Running command-line PHP scripts
+
+The `php-embed` package contains a binary which can be used as a
+drop-in replacement for the `php` CLI binary:
+
+```sh
+npm install -g php-embed
+php-embed some-file.php argument1 argument2....
+```
+
+Not every feature of the PHP CLI binary has been implemented; this
+is currently mostly a convenient testing tool.
+
 # API
 
 ## php.request(options, [callback])

bin/php-embed.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+'use strict';
+// Very simple CLI wrapper, to allow php-embed to be used as a replacement
+// for the `php` binary.
+var php = require('../');
+
+// XXX here we might eventually do some preprocessing of the command line
+// like the PHP CLI does.
+// For now assume the first argument is the script to run.
+
+var args = process.argv.slice(0);
+if (args.length < 3) {
+  console.error('PHP filename needed.');
+  process.exit(1);
+}
+args.shift(); // Remove the path to the node interpreter
+args.shift(); // Remove the path to this script
+var phpfile = args[0];
+
+// XXX an `exit(2)` in the PHP script will cause the request to bailout
+// and throw a JS exception, which will then cause a non-zero exit
+// code from node as well -- but with a lot of extra noise on the
+// console.  We should figure out how to catch this case in PHP,
+// wrap the exit code appropriately, then catch the exception here
+// and unwrap the exit code.
+php.request({
+  file: phpfile,
+  args: args,
+}).done();

package.json

@@ -5,6 +5,9 @@
   "homepage": "http://github.com/cscott/node-php-embed",
   "author": "C. Scott Ananian <cscott@cscott.net>",
   "main": "lib/index",
+  "bin": {
+    "php-embed": "./bin/php-embed.js"
+  },
   "keywords": [
     "php",
     "hhvm"