cli: Automatically execute Closures returned from primary script

sapi/cli/php_cli.c

@@ -23,6 +23,7 @@
 #include "zend_hash.h"
 #include "zend_modules.h"
 #include "zend_interfaces.h"
+#include "zend_closures.h"
 
 #include "ext/reflection/php_reflection.h"
 
@@ -930,7 +931,21 @@ static int do_cli(int argc, char **argv) /* {{{ */
 			if (interactive) {
 				EG(exit_status) = cli_shell_callbacks.cli_shell_run();
 			} else {
-				php_execute_script(&file_handle);
+				zval retval;
+				ZVAL_UNDEF(&retval);
+				php_execute_script_ex(&file_handle, &retval);
+
+				/* Check if the primary script returned a Closure and execute it: This allows
+				 * a script to act both as a library and as an executable when executed directly.
+				 */
+				if (Z_TYPE(retval) == IS_OBJECT && Z_OBJCE(retval) == zend_ce_closure) {
+					zend_fcall_info_cache fcc = {0};
+					Z_OBJ_HANDLER(retval, get_closure)(Z_OBJ(retval), &fcc.calling_scope, &fcc.function_handler, &fcc.object, /* check_only */ false);					
+					fcc.called_scope = fcc.calling_scope;
+					fcc.closure = Z_OBJ(retval);
+					zend_call_known_fcc(&fcc, /* retval */ NULL, /* param_count */ 0, /* params */ NULL, /* named_params */ NULL);
+				}
+				zval_ptr_dtor(&retval);
 			}
 			break;
 		case PHP_CLI_MODE_LINT:

sapi/cli/tests/primary_script_closure.inc

@@ -0,0 +1,7 @@
+<?php
+
+return function () {
+	echo "Called", PHP_EOL;
+};
+
+?>

sapi/cli/tests/primary_script_closure_001.phpt

@@ -0,0 +1,16 @@
+--TEST--
+Execute closures returned by the primary script
+--SKIPIF--
+<?php
+include "skipif.inc";
+?>
+--FILE--
+<?php
+
+return function () {
+	echo "Called", PHP_EOL;
+};
+
+?>
+--EXPECT--
+Called

sapi/cli/tests/primary_script_closure_002.phpt

@@ -0,0 +1,18 @@
+--TEST--
+Execute closures returned by the primary script (First Class Callable)
+--SKIPIF--
+<?php
+include "skipif.inc";
+?>
+--FILE--
+<?php
+
+function main() {
+	echo "Called", PHP_EOL;
+}
+
+return main(...);
+
+?>
+--EXPECT--
+Called

sapi/cli/tests/primary_script_closure_003.phpt

@@ -0,0 +1,14 @@
+--TEST--
+Execute closures returned by the primary script (From different file)
+--SKIPIF--
+<?php
+include "skipif.inc";
+?>
+--FILE--
+<?php
+
+return include "primary_script_closure.inc";
+
+?>
+--EXPECT--
+Called

sapi/cli/tests/primary_script_closure_004.phpt

@@ -0,0 +1,13 @@
+--TEST--
+Execute closures returned by the primary script (Included file returns closure, but primary script does not)
+--SKIPIF--
+<?php
+include "skipif.inc";
+?>
+--FILE--
+<?php
+
+$closure = include "primary_script_closure.inc";
+
+?>
+--EXPECT--