Manuel Pichler

Today I released PHP_Depend 0.9.6, which contains many bug fixes and improvements, but the main feature of this release is behind the scene, I have started to migrate PHP_Depend's internal system from plain Token object to an Abstract Syntax Tree.

• Closed #57: Display caption for abbreviations in overview pyramid, implemented in svn revision #947.
• Closed #80: Store default value for class properties.
• Fixed #81: PHP_Depend does not support comma separated property declarations, fixed in svn revision #916.
• Fixed #82: PHP_Depend does not support comma separated constant definitions, fixed in svn revision #931.
• Closed #83: Make ClassOrInterfaceReference an ASTNode, implemented in svn revision #917.
• Fixed #87: The parent keyword is not accepted as parameter type hint, fixed in svn revision #925.
• Fixed #89: Coupling analyzer reports wrong results, fixed in svn revision #939
• Fixed #90: Coupling analyzer does not handle PHP 5.3 function chains, fixed in svn revision #943.
• Fixed #91: Parser throws an exception when __CLASS__ as default value of an array property, fixed in svn revision #944.
• Closes #92: Use class constants as analyzer identifiers, implemented in svn revision #950.

You can get the latest PHP_Depend version from its PEAR channel: pear.pdepend.org

mapi@arwen ~ $ pear channel-discover pear.pdepend.org
mapi@arwen ~ $ pear install pdepend/PHP_Depend-beta

Today I released PHP_Depend 0.9.5, which contains many bug fixes and improvements. The main features of this release are PHP 5.3 namespace support and a more robust parser that ignores most kinds of syntax errors,

• Closed #2 Support PHP 5.3 namespace syntax, implemented since svn revision #789.
• Closed #61 Catch parser errors and continue processing, implemented in svn revision #880.
• Closed #63 Make ResultPrinter a configurable option, implemented in svn revision #668.
• Fixed #64 The single cache directory causes permission denied on *NIX systems, fixed in svn revision #667.
• Fixed #65 Endless loop for class and interface declarations without body, fixed in svn revision #672.
• Closed #66 Dependency wiring should be done at the end of the parsing process, implemented in svn revision #855.
• Fixed #69 Parser does not handle PHP 5.3 class names in function and method bodies, fixed in svn revision #688.
• Fixed #70 Parser throws an unexpected token exception for closure, fixed in svn revision #726.
• Fixed #71 Parser throws an unexpected token exception for signed default values, fixed in svn revision #740.
• Fixed #73 Inconsistent state when an interface and a class with the same name exists, fixed in svn revision #776.
• Fixed #76 Tokenizer keyword detection is broken, fixed in svn revision #871.

You can get the latest PHP_Depend version from its PEAR channel: pear.pdepend.org

mapi@arwen ~ $ pear channel-discover pear.pdepend.org
mapi@arwen ~ $ pear install pdepend/PHP_Depend-beta

Today I released PHP_Depend 0.9.4, which contains many bug fixes and improvements.

• Fixed #92: Handling of types within instanceof-operator fixed.
• Closed #90: Support for single file parsing/analyzing implemented.
• Closed #88: Tokens provide information about the start and end column.
• Closed #87: Support for type definitions within comments implemented.
• Closed #40: Cli debug flag added. PHP_Depend will print additional debug information to STDERR when this cli switch is set.
• The ProjectAwareI and NodeAwareI interfaces extend the AnalyzerI interface, which makes analyzer mocking easier.
• Switch from PHP_Depend specific constants for public, protected, private methods & properties to modifiers compatible with PHP's reflection-extension.
• Support for static modifier for properties&methods and final for methods added.
• Support for class final modifier added.
• Support for chained types like "false|Iterator" or "array(false|Iterator)" in doc comments added.

You can get the latest PHP_Depend version from its PEAR channel: pear.pdepend.org

mapi@arwen ~ $ pear channel-discover pear.pdepend.org
mapi@arwen ~ $ pear install pdepend/PHP_Depend

Just now I released PHP_Depend 0.9.3, the primary goal for this release was focused on less memory consumption. A run of PHP_Depend 0.9.2 against eZ Publish took up to 1GB and PHP_Depend 0.9.3 analyzes the same source with a memory limit of 160Mb.

• Fixed #89: The source file is never set for methods, properties and constants.
• Closed #82: Tokenizer cache added, reduces runtime up to 25%.
• Closed #83: Storage layer for node tokens added, reduces memory consumption. .
• Closed #85: TextUI displays the execution time and the memory usage(linux only).
• Code restructured, input filters and iterator moved to package "Input".
• Test suite restructured to reflect the actual project structure.

From now on you will get the latest PHP_Depend version through the new pear channel pear.pdepend.org, for a few weeks I will keep the old pear channel. Enter the following pear commands to upgrade PHP_Depend's channel.

mapi@arwen ~ $ pear channel-discover pear.pdepend.org
mapi@arwen ~ $ pear uninstall xplib/PHP_Depend
mapi@arwen ~ $ pear install pdepend/PHP_Depend

Or checkout version 0.9.3 from the PHP_Depend subversion repository.

mapi@arwen ~ $ svn co http://svn.pdepend.org/tags/0.9.3

This is a bug fix release of PHP_Depend. Version 0.9.2 fixes bug #84, which could result in a failure for all PHP versions lower than 5.3.0alpha2.

You can get the latest PHP_Depend version through its PEAR channel pear.xplib.de or as a subversion checkout of the 0.9.2 tag.
Please do not checkout "trunk", it is totally unstable at the moment and I will not provide any support for it.

mapi@arwen ~ $ svn co http://svn.pdepend.org/tags/0.9.2

Just now I released PHP_Depend 0.9.1, the major feature in this new version is an implementation of the NPath Complexity metric, beside that feature the main focus for this release was on performance improvements of the current implementation.

• Closed #21: Support for the NPath Complexity metric.
• Fixed #78: Parser fails for comment in function signature.
• Closed #79: Token objects instead of arrays.

An additional test concept was introduced with the 0.9.* branch of PHP_Depend. Nightly builds test PHP_Depend against a series of open source projects to detect deadlocks like endless loop or similar issues. This procedure is also used to test each release candidate of PHP_Depend. The tested project are:

• Arbit
• eZ Components
• eZ Publish
• PHPUnit
• TYPO3
• Zend Framework

You can get the latest PHP_Depend version through its PEAR channel pear.xplib.de or as a subversion checkout of the 0.9.1 tag.
Please do not checkout "trunk", it is totally unstable at the moment and I will not provide any support for it.

mapi@arwen ~ $ svn co http://svn.pdepend.org/tags/0.9.1

Today I released version 0.9.0 of PHP_Depend. Beside bugfixes this release contains new features like a PHPUnit compatible xml-log.

• Closed #43: An image file name "jdepend" now results in "jdepend.svg" instead of ".svg".
• Closed #42: Print a warning when the analyzed directory does not contain source files.
• Closed #35: Support for custom svg font-family and font-size added.
• Closed #32: Support for function and method parameters added.
• Fixed #30: Approximated Lines Of Code improved.
• Closed #20: Support for class constants implemented.
• Closed #19: PHPUnit compatible logger added.
• Fixed #17: Detect class names in catch statements.
• Fixed #16: Detect class names in instanceof expressions.
• Fixed #46: Default package is broken.

You can get the latest PHP_Depend version through its PEAR channel

mapi@arwen ~ $ pear channel-discover pear.xplib.de
mapi@arwen ~ $ pear install xplib/php_depend

or as a subversion checkout of the 0.9.0 branch or tag.
Please do not checkout "trunk", it is totally unstable at the moment and I will not provide any support for it.

mapi@arwen ~ $ svn co http://svn.pdepend.org/branches/0.9.0
mapi@arwen ~ $ svn co http://svn.pdepend.org/tags/0.9.0

Feel free to report issues, bugs or just leave a comment here.

• Bug fix: CC is compatible with Java 1.5, but the phpUnderControl 0.4.6 sources were compiled against Java 1.6.

Visit phpUnderControl's download page for release packages.

• Fixed #621: phpUnderControl dashboard is broken with CruiseControl 2.8 - [4085]
• Closed #609: Use artifacts directory for artifacts - [4118]
• Closed #611: opera: code coverage not visible - [4119]
• Closed #622: phpUnderControl needs a custom error page - [4116]

I recently released a bugfix version of phpUnderControl. Beside some minor view errors like the odd/even rows problem, the 0.4.4 release of phpUnderControl fixes a bug in the new merged phpunit logs feature, which doesn't cause CruiseControl to fail for such builds.

I currently released a new version of phpUnderControl. Beside some minor fixes this release comes with a new feature to aggregate test results of multiple PHPUnit runs.

Use the new cli command merge-phpunit of phpUnderControl to merge multiple log files produced with PHPUnit, as shown in the following example build file for ant.

phpUnderControl merged phpunit log view

Today I released the stable 0.8.0 version of PHP_Depend.

• Fixed: Endless loop for inline html.
• Fixed: Handle class and interface names case insensitive.
• Fixed: PHP_Depend should print an error if no @package information is available.
• The Logger interface should not force a default ctor-signature.
• Remove Logger <-> XML Config dependency.
• Support for pattern based package filter.
• Tooltip for the Overview Pyramid.
• Add option --bad-documentation.
• Handle internal classes and interfaces.
• Use an SVG-Template for the jdepend chart.
• Introduce a CodeAware interface for loggers.

The previous list was taken from the PHP_Depend issue tracker. Feel free to report issues, bugs or just leave a comment here.

This should be the final beta release for PHP_Depend 0.8.0. Beside some minor bugfixes, it contains a last API change for the log sub component. This change removes constraints to the ctor signature of a logger implementation, which is now part of a separate interface.

The following list shows all changes in this version. A detailed description of all issues can be found in the PHP_Depend issue tracker!

• #29 Tooltip for the Overview Pyramid.
• #34 Support for pattern based package filter.
• #37 Remove Logger - XML Config dependency.
• #38 The Logger interface should not force a default ctor-signature.

As always you can use PHP_Depend's pear channel or its svn repository, to check out this new version. And feel free to discuss and follow the PHP_Depend development on its dedicated mailing list.

This new release of PHP_Depend took some time to be finished. This is because the initial idea of a simple adaption of JDepend evolved (supported thru this blog-post by Sebastian), and so PHP_Depend has become a complete software metric application. Many new features and enhancements have found their way into this version. One of the key features is the pluggable architecture for custom Loggers and Metric-Analyzers. This opens the possibility to hook own Logger- and Analyzer-implementations into the execution chain of PHP_Depend. Beside these architectural changes this PHP_Depend version is shipped with a large set of implemented software metrics.

ClassLevel (Class)

• dit: Depth of Inheritance Tree
• impl: Number of implemented interfaces
• cis: Class Interface Size
• csz: Class SiZe
• vars: Number of defined class properties
• varsi: Number of own and inherited class properties
• varsnp: Number of public class properties
• wmc: Weighted Method per Class(Sum of method Cyclomatic Complexity)
• wmci: Weighted Method per Class + inherited WMC
• wmcnp: Weighted Method per Class for all public class methods

CodeRank (Class, Package)

An adaption of google's PageRank algorithm for classes and packages.

• cr: Forward CodeRank (based on incoming edges)
• rcr: Reverse CodeRank (based on outgoing edges)

Coupling (Project)

• calls: Number of called methods and functions
• fanout: Number of referenced types

Cyclomatic Complexity (Project, Method, Function)

• ccn: Cyclomatic Complexity
• ccn2: Extended Cyclomatic Complexity

Dependency (Package)

For details see the following entry.

• ca: Afferent coupling
• ce: Efferent coupling
• a: Abstraction
• i: Instability
• d: Distance

Hierarchy (Project)

• clsa: Number of abstract classes.
• clsc: Number of concrete classes.
• roots: Number of root classes within the analyzed system.
• leafs: Number of leaf classes.
• maxDIT: Max Depth of Inheritance Tree value

Inheritance (Project)

• andc: Average Number of Derived Classes.
• ahh: Average Hierarchy Height

NodeCount (Project, Package, Class, Interface)

• nop: Number Of Packages
• noc: Number Of Classes
• noi: Number Of Interfaces
• nom: Number Of Methods
• nof: Number Of Functions

NodeLOC (Project, Package, Class, Interface, Method, Function)

• loc: Lines Of Code
• cloc: Comment Lines Of Code
• ncloc: Non Comment Lines Of Code

Due to the fact that PHP is a loosely typed programming language, PHP_Depend can only approximate some values. But the measured results can be improved with a good and complete source code documentation, because PHP_Depend takes advantage of different doc comment annotations (@throws, @var, @return). So I suggest the use of a tool like PHP_CodeSniffer, to achieve better results.

Beside all these metrics, PHP_Depend also provides a new chart type, the "Overview Pyramid". The Overview Pyramid can be a handy tool to analyze legacy code. If you have read the book Object-Oriented Metrics in Practice you should know howto interpret the Overview Pyramid, all others have to wait for a detailed description.

PHP_Depend Overview Pyramid for PHP_Depend

This new version can be installed with the PEAR-Installer. Just discover the pear.xplib.de channel and install the latest PHP_Depend release. After PHP_Depend has been installed successfully, the new command line tool pdepend should exist.

 mapi@arwen ~ $ pear channel-discover pear.xplib.de
 mapi@arwen ~ $ pear install xplib/PHP_Depend-beta
 mapi@arwen ~ $ pdepend --help
 PHP_Depend 0.8.0beta1 by Manuel Pichler

 Usage: pdepend [options] [logger] <dir[,dir[,...]]>

   --jdepend-chart=<file>    Generates a diagram of the analyzed packages.
   --jdepend-xml=<file>      Generates the package dependency log.

   --overview-pyramid=<file> Generates a chart with an Overview Pyramid for the
                             analyzed project.

   --summary-xml=<file>      Generates a xml log with all metrics.

   --coderank-mode=<*[,...]> Used CodeRank strategies. Comma separated list of
                             'inheritance'(default), 'property' and 'method'.

   --suffix=<ext[,...]>      List of valid PHP file extensions.
   --ignore=<dir[,...]>      List of exclude directories.
   --exclude=<pkg[,...]>     List of exclude packages.

   --without-annotations     Do not parse doc comment annotations.

   --help                    Print this help text.
   --version                 Print the current PHP_Depend version.

There is also a Subversion repository at http://svn.pdepend.org/, where the latest development version can be found.

Please test this beta release and file bug-reports and feature-requests in the PHP_Depend bug tracker.