PHP CLI

In many ways, the CLI SAPI works in the same way as the CGI SAPI and other SAPIs. However, it is important to keep track of where it differs and why, because it will directly affect how you write your scripts.

These are the most important differncies between CLI and CGI:

• Unlike the CGI SAPI, CLI writes no headers to the output by default
• There are some php.ini directives which are overridden by the CLI SAPI because they do not make sense in shell environments:
  • html_errors: CLI default is FALSE
  • implicit_flush: CLI default is TRUE
  • max_execution_time: CLI default is 0 (unlimited)
  • register_argc_argv: CLI default is TRUE
• You can have command line arguments with your script! Variable "$argc" provides you with a number of arguments passed to the application. And array "$argv" gives you an array of the actual arguments
• There are 3 new constant defined for the shell enviroment: STDIN, STDOUT, STDERR. All of them are file handlers for correspondent shell devicies. For example STDIN is the handler for fopen('php://stdin', 'r') . So, you can read a line from STDIN like this: $strLine = trim(fgets(STDIN));. STDIN is already defined for you by PHP CLI!
• PHP CLI does not change the current directory to the directory of the executed script. The current directory for the script would be the directory where your type PHP CLI command.
• There are number of USEFUL options avaiable for PHP CLI. Which will allow you to get some valuable information about you php setup, your php script or run it in defferent modes.
• In PHP 5 there were some changes in CLI and CGI filenames. In PHP 5, the CGI version was renamed to php-cgi.exe (previously php.exe) and the CLI version now sits in the main directory (previously cli/php.exe).
• In PHP 5 it was also introduced a new mode: php-win.exe. This is equal to the CLI version, except that php-win doesn't output anything and thus provides no console (no "dos box" appears on the screen). This behavior is similar to PHP GTK.