Version 0.7.1
29 December 2010

PHPXref

PHP Cross Referencing Documentation Generator


Screenshots

Screenshot Screenshot

Try it for yourself by browsing the Xaraya source code and taking a look at the phpxref.cfg file used to generate the output.

Rate It

Like PHPXref? You can rate it at
Freshmeat:
Hotscripts.com:

Links

  • PHP
    The web scripting language that PHPXref was written for.
  • PHPDoc
    Generates attractive documentation from your PHP code.
  • TinyPerl
    Neat utility for turning Perl scripts into standalone Windows executables.
  • PHPXref.com
    Library of cross referenced open source projects.

About PHPXref

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.

Features

News

29/December/2010
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.

2/January/2007
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.

26/October/2004
Released version 0.6 - Added some basic support for PHP 5 syntax and fixed a few bugs. Checkout the changelog for the full list.

16/March/2004
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.

8/December/2003
Released version 0.4.1 - This version fixes a few comment handling bugs, improves code parsing and adds support for cross referencing class variables, pretty-printing code from the browser, faster access to required or included source files via a popup and one or two other minor tweaks. The Windows archives have also been correctly built this time (hopefully); some important files were missing in the previous build which resulted in the javascript file explorer not functioning.

2/September/2003
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.

Download

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.

Support

Please file bug reports and feature requests using the tools on the SourceForge project page.

Feedback is welcome and can be sent to gareth@omnipotent.net.

You might also be able to find me on IRC at irc.oftc.net / #phpxref.


©2000-2010 Gareth Watts