PHP_CompatInfo : The Definitive Guide |
The PHP_CompatInfo_Cli class, also known under its wrapper name "pcicmd", get the compatibility info from PHP Command Line Interpreter, on existing script or folder.
pcicmd [options] -f FILE | -d DIR
Usage is to run pcicmd with at least the -f (--file) or -d (--dir) switch and perharps some
additional and optional options.
-d |
--dir
Identify the directory to parse to get compatibility info of its files contents.
-f |
--file
Identify the file name (path) to parse to get compatibility info.
-n |
--no-recurse
Do not recursively parse files into subdirectories when using
--dir.
-v |
--verbose
Set the verbose level. From 0 (no extra information) to 7 (full extra details).
In level 0, pcicmd give only results related to -d or -f. See first line of the console table. If there are more than one line, next ones are details for each file of a directory/branch.
+------------------------+---------+------------+------------------+
| Path | Version | Extensions | Constants/Tokens |
+------------------------+---------+------------+------------------+
| [...]\* | 4.3.0 | bcmath | __FILE__ |
| | | pcre | |
+------------------------+---------+------------+------------------+
| [...]\math.php | 3.0.9 | bcmath | |
| | | pcre | |
+------------------------+---------+------------+------------------+
| [...]\errorHandler.php | 4.3.0 | | |
+------------------------+---------+------------+------------------+
In level 1, pcicmd give results of level 0 plus a resume of command line arguments. For example
pcicmd -v 1 -d \wamp\www\pci
give table of level 0 (see previous), plus :
Command Line resume :
+---------+---------------+
| Option | Value |
+---------+---------------+
| dir | \wamp\www\pci |
| verbose | 1 |
+---------+---------------+
In level 2, pcicmd give results of level 0 plus the list of options PHP_CompatInfo used to parse file or directory. For example
pcicmd -d \wamp\www\pci -v 2
give table of level 0 (see previous), plus :
Parser options :
+--------+-------+
| Option | Value |
+--------+-------+
| | |
+--------+-------+
|
Note |
|---|---|
| Even when none option are used, the resume table is displayed. |
In level 3, pcicmd give results of level 0, 1 and 2. For example
pcicmd -d \wamp\www\pci -n -v 3
give table of level 0 (see previous), plus :
Command Line resume :
+------------+---------------+
| Option | Value |
+------------+---------------+
| dir | \wamp\www\pci |
| no-recurse | 1 |
| verbose | 3 |
+------------+---------------+
Parser options :
+-------------+-------+
| Option | Value |
+-------------+-------+
| recurse_dir | FALSE |
+-------------+-------+
In level 4, useless when using --dir, pcicmd give results of
level 0 plus a list of functions implemented with their
versions. For example
pcicmd -f \wamp\www\pci\math.php -v4
give :
+----------------+---------+------------+------------------+
| File | Version | Extensions | Constants/Tokens |
+----------------+---------+------------+------------------+
| [...]\math.php | 3.0.9 | bcmath | |
| | | pcre | |
+----------------+---------+------------+------------------+
Debug:
+---------+------------+------------+
| Version | Function | Extension |
+---------+------------+------------+
| 3.0.9 | preg_match | ext_pcre |
| 3.0.0 | bcsub | ext_bcmath |
+---------+------------+------------+
Level 5 is equivalent to level 4 + level 1.
Level 6 is equivalent to level 4 + level 2.
And finally, level 7 is equivalent to level 4 + level 2 + level 1.
-if
| --ignore-files
Identify the file name (path) to a text file that contains on each line the name of each file to ignore when parsing a directory/branch.
-id
| --ignore-dirs
Identify the file name (path) to a text file that contains on each line the name of each sub-directory to ignore when parsing a directory/branch.
-in
| --ignore-functions
Identify the file name (path) to a text file that contains on each line the name of each PHP function to ignore when parsing a directory or a single file.
-ic
| --ignore-constants
Identify the file name (path) to a text file that contains on each line the name of each PHP constant to ignore when parsing a directory or a single file.
-ie
| --ignore-extensions
Identify the file name (path) to a text file that contains on each line the name of each PHP extension to ignore (all extension.functions) when parsing a directory or a single file.
-iv
| --ignore-versions
Expect one or two values that identify which PHP version (and all its related functions) to ignore.
|
Tip |
|---|---|
For example: ignore all PHP 5 functions (minor releases
0 thru 2), or only PHP 5.0.0 functions.
pcicmd -f FILE | -d DIR -iv 5.0.0 5.2.0
pcicmd -f FILE | -d DIR -iv 5.0.0
|
-h |
--help
Show full help usage with all switchs explained.
| PHP_CompatInfo : The Definitive Guide | v 1.4.1 : February 12, 2007 |