1. Introduction
PHP_CompatInfo branch 1.x is still compatible with PHP4, that is from an old age now (unmaintained). You can find it on PEAR main site on its project page.
PHP_CompatInfo branch 2.x is a full rewrite with PHP5. Since RC3 the PHP parser engine used is PHP_Reflect. It’s an improved version with callbacks to what ever token you want feature from basic concept version of PHP_TokenStream.
2. Overview
PHP_CompatInfo 2 provides two servers API :
-
a Command Line Interface (CLI) tool named phpci
-
a web browser interface
-
PHP 5.2.0 minimum
-
ezc/Base 1.8 minimum
-
ezc/ConsoleTools 1.6.1 minimum (for progress bar with CLI phpci tool)
-
pear/Console_CommandLine 1.1.3 minimum since RC3 (for CLI phpci tool)
-
bartlett/PHP_Reflect 1.0.0 minimum (PHP parser)
-
tokenizer extension
-
pcre extension
-
SPL extension
-
dom extension
-
libxml extension
-
phpunit/PHP_Timer 1.0.0 (utility class for timing)
-
(optional) pear/Net_Growl 2.3.0 minimum (for growl audit observer)
-
(optional) PHPUnit 3.5.0 minimum (to run unit tests)
-
(optional) an XSLT processor if you want to produce an xHTML report from a phpci xml report
Version 2.0.0 support 61 extensions.
Version 2.1.0 support 63 extensions.
The phpci tool may inform you on what of those extensions are or not loaded on your system.
Run command
$ phpci list-references
Will output results as follow. May differ depending of your extensions loaded.
-------------------------------------------------------------------------------
PHP COMPAT INFO DATABASE REFERENCE
-------------------------------------------------------------------------------
EXTENSIONS EXTENSION VERSION
-------------------------------------------------------------------------------
apc 3.1.7 4.0.0
L bcmath 4.0.0
L bz2 4.0.4
L calendar 4.0.0
Core 4.0.0
L ctype 4.0.4
L curl 4.0.2
L date 4.0.0
L dom 20031129 5.0.0
enchant 1.1.0 5.3.0
ereg 4.0.0 5.3.0
fileinfo 1.0.5-dev 4.0.0
L filter 0.11.0 5.2.0
L ftp 4.0.0
L gd 4.0.0
L gettext 4.0.0
gmp 4.0.4
L hash 1.0 5.1.2
L iconv 4.0.5
L imap 4.0.0
intl 1.1.0 5.2.4
L json 1.2.1 5.2.0
L libxml 5.0.0
L mbstring 4.0.6
L mcrypt 4.0.0
memcache 3.0.6 4.3.3
memcached 1.0.2 5.2.0
L mhash 4.0.0
L mysql 1.0 4.0.0
L mysqli 0.1 5.0.0
L openssl 4.0.4
pcntl 4.1.0
L pcre 4.0.0
L PDO 1.0.4dev 5.1.0
pgsql 4.0.0
Phar 2.0.1 5.2.0
posix 306939 4.0.0
readline 2.0.1 4.0.0
recode 2.0.1 4.0.0
L session 4.0.0
L shmop 4.0.0
L SimpleXML 0.1 5.0.0
snmp 4.0.0
L soap 5.0.0
L sockets 4.1.0
L SPL 0.2 5.0.0
L SQLite 2.0-dev 5.0.0
sqlite3 0.7-dev 5.3.0
ssh2 0.11.0 5.0.0
L standard 4.0.0
sysvmsg 306939 4.3.0
sysvsem 4.0.0
sysvshm 4.0.0
L tidy 2.0 4.0.0
L tokenizer 0.1 4.2.0
L wddx 4.0.0
L xdebug 2.1.0 5.2.0
L xml 4.0.0
L xmlreader 0.1 5.0.0
L xmlrpc 0.51 4.1.0
L xmlwriter 0.1 5.1.2
L xsl 0.1 5.0.0
L zlib 1.1 4.0.0
-------------------------------------------------------------------------------
A TOTAL OF 63 EXTENSIONS WERE FOUND AND 42 LOADED
-------------------------------------------------------------------------------
Time: 2 seconds, Memory: 5.00Mb
-------------------------------------------------------------------------------
3. Features
-
Parse a single file
-
Parse a directory recursively or not
-
Parse a list of files and/or directories
-
Ability to give a list of extensions to ignore when calculating the version needed
-
Ability to give a list of interfaces to ignore when calculating the version needed
-
Ability to give a list of classes to ignore when calculating the version needed
-
Ability to give a list of functions to ignore when calculating the version needed
-
Ability to give a list of constants to ignore when calculating the version needed.
-
Ability to give a list of files to ignore when calculating the version needed
-
Ability to give a list of directories to ignore when calculating the version needed
-
Ability to use a custom extensions list or by default only extensions loaded, to parse PHP code
-
Event driven and listeners system to audit parsing process
4. Documentation
The PHP_CompatInfo manual is available in a selection of formats. Pick a format from the table below to start downloading.
| Language | Single HTML file | Many HTML files | HTML Help file (CHM) | PDF file |
|---|---|---|---|---|
English |
pci-book.html.zip 529Kb |
phpci-book.chunked.zip 464Kb |
phpci-book.chm.zip 469Kb |
phpci-book.pdf 512Kb |
5. Appendix A: Changelog
6. Appendix B: License
Released under the BSD license, you are free to do whatever you want, even in a commercial environment. You are also encouraged to contribute.
7. Appendix C: Credits
I would like to thanks here specially a guy without who this PHP QA tool won’t be born.
Original author, he introduced his proposal in 2004, that gave birth of a PEAR package named PHP_CompatInfo.
I would also like to thanks a guy who help me to enhance support of more than 50 extensions.
Contributor of many extensions reference and unit tests. He has joined the team on version 2.0.0RC2
8. Appendix D: Links
All pages of this site, and user guide were generated with AsciiDoc 8.6.5, assisted by FOP 1.0 (for PDFs). Automated build process uses Phing 2.4.5
Convert the HTML Help source (.hhp and .html) files to HTML Help (.chm) files using the Microsoft HTML Help Compiler.