29 December 2010
PHP Cross Referencing Documentation Generator
PHPXref is a developer tool that's designed to ease the process of working on large PHP projects by making it very fast and easy to browse the code documentation along with the code itself.
It works by scanning a project directory and translating the files it finds into readable cross-referenced HTML, simultaneously utilizing comments in the code to produce documentation to accompany it.
The result is a collection of plain HTML files that can be read using any browser, with no supporting software required.
PHPXref has very minimal requirements to run; just having a copy of Perl installed is all you need (and the Windows binary supplies that for you). Getting started requires editing two or three lines in the configuration file and running the program.
Released version 0.7.1 - This release just fixes a XSS security issue that was brought to my attention - If you're generating xrefs that are published to the public internet, you'll probably want to upgrade. Changelog.
Released version 0.7 - The "no, really - it's not a dead project" release :-)
I still use PHPXref myself, but at this point it does most of the things I want it to do hence the lack of updates. There has been a growing list of small bugs and omissions though, so this release takes care of some of those issues.
Notably it (should) now parse and cross reference methods declared as static and final, as well as Interfaces that were new in PHP 5. The full list of changes can be found in the Changelog.
Released version 0.6 - Added some basic support for PHP 5 syntax and fixed a few bugs. Checkout the changelog for the full list.
Released version 0.5 - Biggest changelog so far - I've found myself using PHPXref extensively recently, so this release fixes all the things that have been irritating me and adds a number of features that I've been wanting (along with a few that users have requested) including: cross referencing of constants (finally), a search history so you can get back to that function you were looking at 20 minutes ago, a link to the original plain-text version of the source, variable highlighting (mouse over a variable name that occurs on screen multiple times in the source view in IE or Mozilla) plus various updates and bug fixes.
Also added a small FAQ and a mention of the IRC channel in the support section of this page.
Released version 0.4 which makes significant improvements to navigation and layout, including tooltip-style popups for class and function references in the source view which makes jumping from file to file much quicker. Numerous other bug fixes and features, including support for generating compressed output files.
The changelog has a more complete list.
|phpxref-0.7.1.tar.gz:||Linux/*nix version with UNIX style line endings.|
|phpxref-0.7.1.zip:||Windows/DOS style line endings (requires a working version of Perl to be installed).|
|phpxref-0.7.1-win32.zip:||Download this version if you're running Windows and don't already have Perl installed.|
PHPXref is released under the GNU General Public License version 2.
You can receive automatic notifications about new releases of PHPXref by using the subscribe button on the Freshmeat project page.