php(1)

NAME

       php - PHP Command Line Interface 'CLI'

SYNOPSIS

       php [options] [ -f ] file [[--] args...]

       php [options] -r code [[--] args...]

       php [options] -- [ args...]

DESCRIPTION

       PHP  is  a widely-used general-purpose scripting language that is espe-
       cially suited for Web development and can be embedded into  HTML.  This
       is the command line interface that enables you to the following:

       You  can  parse and execute files by using parameter -f followed by the
       name of the file to be executed.

       Using parameter -r you can directly execute  PHP  code  simply  as  you
       would do inside a .php file when using the eval() function.

       If  none  of  -r  or -f is present but a single parameter is given then
       this parameter is taken as the filename to parse and execute  (same  as
       with  -f).  If  no parameter is present then the standard input is read
       and executed.

OPTIONS

       -a             Run interactively

       -c path|file   Look for php.ini file in the directory path or  use  the
                      specified file

       -n             No php.ini file will be used

       -d foo[=bar]   Define INI entry foo with value bar

       -e             Generate extended information for debugger/profiler

       -f file        Parse and execute file

       -h             This help

       -i             PHP information and configuration

       -l             Syntax check only (lint)

       -m             Show compiled in modules

       -r code        Run PHP code without using script tags '<?..?>'

       -s             Display colour syntax highlighted source

       -v             Version number

       -w             Display source with stripped comments and whitespace

       -z file        Load Zend extension file

       args...        Arguments  passed  to  script.  Use '--' args when first
                      argument starts with '-' or script is read from stdin

FILES

       php-cli.ini    The configuration file for the CLI version of PHP.

       php.ini        The standard configuration file will only be  used  when
                      php-cli.ini cannot not be found.

EXAMPLES

       php -r 'echo "Hello World\n";'
            This command simply writes the text "Hello World" to standard out.

       php -r 'print_r(gd_info());'
            This shows the configuration of your gd  extension.  You  can  use
            this  to  easily check which imag formats you can use. If you have
            any dynamic modules you may want to use the same ini file that php
            uses  when executed from your webserver. There are more extensions
            which have such a function. For dba use:
            php -r 'print_r(dba_handlers(1));'

TIPS

       You can use a shebang line to automatically invoke  php  from  scripts.
       Only  the  CLI  version  of  PHP will ignore such a first line as shown
       below:

              #!/bin/php
              <?php
               // your script
              ?>

SEE ALSO

       For a more or less complete description of PHP look here:
       http://www.php.net/manual/

       A nice introduction to PHP by Stig Bakken can be found here:
       http://www.zend.com/zend/art/intro.php

BUGS

       You can view the list of known bugs or report any  new  bug  you  found
       here:
       http://bugs.php.net

AUTHORS

       The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Ler-
       dorf, Sam Ruby, Sascha Schumann, Zeev  Suraski,  Jim  Winstead,  Andrei
       Zmievski.

       Additional work for the CLI sapi was done by Edin Kadribasic and Marcus
       Boerger.

       A List of active developers can be found here:
       http://www.php.net/credits.php

       And last but not least PHP was developed with the help of a huge amount
       of contributors all around the world.

VERSION INFORMATION

       This manpage describes php, version 4.4.2.

COPYRIGHT

       Copyright (C) 1997-2006 The PHP Group

       This source file is subject to version 3.01 of the PHP license, that is
       bundled with this package in the file LICENSE, and is available through
       the world-wide-web at the following url:
       http://www.php.net/license/3_01.txt

       If  you  did  not  receive  a copy of the PHP license and are unable to
       obtain  it  through  the  world-wide-web,  please  send   a   note   to
       license@php.net so we can mail you a copy immediately.

The PHP Group                        2006                               PHP(1)