phploc is a tool for quickly measuring the size of a PHP project.
The goal of phploc is not not to replace more sophisticated tools such as phpcs, pdepend, or phpmd, but rather to provide an alternative to them when you just need to get a quick understanding of a project's size.
- The tokenizer extension is required to count the Comment Lines of Code (CLOC) and Non-Comment Lines of Code (NCLOC) as well as the number of interfaces, classes, methods, and functions of a project.
- The bytekit extension is an optional requirement and is used to count the Executable Lines of Code (ELOC) of a project.
phploc should be installed using the PEAR Installer. This installer is the backbone of PEAR, which provides a distribution system for PHP packages, and is shipped with every release of PHP since version 4.3.0.
The PEAR channel (
pear.phpunit.de) that is used to distribute phploc needs to be registered with the local PEAR environment:
sb@ubuntu ~ % pear channel-discover pear.phpunit.de Adding Channel "pear.phpunit.de" succeeded Discovery of channel "pear.phpunit.de" succeeded
This has to be done only once. Now the PEAR Installer can be used to install packages from the PHPUnit channel:
sb@ubuntu ~ % pear install phpunit/phploc downloading phploc-1.1.0.tgz ... Starting to download phploc-1.1.0.tgz (6,591 bytes) .....done: 6,591 bytes install ok: channel://pear.phpunit.de/phploc-1.1.0
After the installation you can find the phploc source files inside your local PEAR directory; the path is usually
sb@ubuntu ~ % phploc /usr/local/src/ezcomponents/trunk/Workflow/src phploc 1.1.0 by Sebastian Bergmann. Directories: 11 Files: 82 Lines of Code (LOC): 9576 Executable Lines of Code (ELOC): 2962 Comment Lines of Code (CLOC): 4923 Non-Comment Lines of Code (NCLOC): 4653 Interfaces: 7 Classes: 74 Non-Static Methods: 274 Static Methods: 22 Functions: 0