version 1.x
Guide
Reference
Command line interface
Cherrycake apps can run as command line applications that are invoked from an operating system prompt like the Linux shell.
1
$e->Actions->mapAction(
2
"helloWorldCli",
3
new \Cherrycake\Actions\ActionCli([
4
"moduleType" => \Cherrycake\ACTION_MODULE_TYPE_APP,
5
"moduleName" => "HelloWorld",
6
"methodName" => "sayHi"
7
])
8
);
Copied!
And in your method, you use the ResponseCli class instead of the usual ResponseTextHtml or ResponseTextPlain:
1
function sayHi() {
2
global $e;
3
$e->Output->setResponse(new \Cherrycake\Actions\ResponseCli([
4
"payload" => "Hello World from the Cli interface"
5
]));
6
}
Copied!
Executing CLI Actions
If you remember how we created the
index.php file in the Getting started guide, you'll remember that the method we called to make Cherrycake starting working on the received request actions was Engine:attendWebRequest. When creating an app that works in the command line, the method to use is Engine:attendCliRequest instead, like this:1
<?php
2
​
3
namespace CherrycakeApp;
4
​
5
require "vendor/autoload.php";
6
​
7
$e = new \Cherrycake\Engine;
8
​
9
if ($e->init(__NAMESPACE__, [
10
"isDevel" => true
11
]))
12
$e->attendCliRequest();
13
​
14
$e->end();
Copied!
Apps that both attend web requests and CLI actions
Sometimes you'll want your app to attend web requests like a normal web application, but also attend some CLI actions that you'll use to perform maintenance work, run batch processes or similar tasks that are triggered by an admin from the command line, and not by a client using a browser.
A common solution is to create a
cli.php file additionally to the index.php file. This cli.php will look more or less equal to your existing index.php, but it will call the Engine:attendCliRequest instead of Engine:attendWebRequest method.Running an app from the command line
Following our example above, to run
helloWorldCli Action, we would call Cherrycake from the Linux command line like this:1
php -f ./cli.php helloWorldCli
Copied!
1
Hello World from the Cli interface
Copied!
Passing parameters to CLI actions
Just like regular Actions can receive GET and POST parameters, CLI actions can receive command line parameters. To map an ActionCli that receives parameters, you pass the
parameters array when creating the Request object just like you already did in the Accept GET or POST parameters of the Actions Guide, except this time you use the REQUEST_PARAMETER_TYPE_CLI parameter type instead of REQUEST_PARAMETER_TYPE_GET or REQUEST_PARAMETER_TYPE_POST, like this:1
$e->Actions->mapAction(
2
"userFlushCache",
3
new \Cherrycake\Actions\ActionCli([
4
"moduleType" => \Cherrycake\ACTION_MODULE_TYPE_APP,
5
"moduleName" => "Users",
6
"methodName" => "flushUserCacheCli",
7
"parameters" => [
8
new \Cherrycake\Actions\RequestParameter([
9
"type" => \Cherrycake\REQUEST_PARAMETER_TYPE_CLI,
10
"name" => "userId",
11
"securityRules" => [
12
\Cherrycake\SECURITY_RULE_TYPICAL_ID
13
]
14
])
15
]
16
])
17
);
Copied!
And you receive the parameters just like you do with GET or POST:
1
function flushUserCacheCli($request) {
2
global $e;
3
$user = new User([
4
"loadMethod" => "fromId",
5
"id" => $request->id
6
]);
7
$user->clearCache();
8
$e->Output->setResponse(new \Cherrycake\Actions\ResponseCli([
9
"payload" => "Cache for user ".$request->userId." flushed"
10
]));
11
}
Copied!
Now, to call a CLI action that accepts parameters from the command line, you use the regular UNIX parameters syntax after the action name, like this:
1
php -f ./cli.php userFlushCache --userId=832
Copied!
1
Cache for user 832 flushed
Copied!
Last modified 11mo ago