Situation
I have a PHP project with lots of classes with lots of relationships in lots of folders following the Zend Naming Convention.
I use the NetBeans IDE 7.1. I work under Windows 7.
Goal
I need to see a graphical representation of the class relationships, possibly in varying depths and varying degrees of complexity. Also, it would be nice if the classes in the diagram are clickable. I do not necessarily need to generate documentation.
Attempts
1. Within NetBeans
NetBeans is an awesome IDE with lots of features. In fact, it recognizes class dependencies, and it would be wise to assume that it has some sort of way to graphically view this relationship, natively, or through a plugin. Such a plugin exists, but is for version 5.5. I have 7.1, and it's not compatible. Fail.
2. Enterprise Architect
A simple google search brings up Enterprise Architect as an all-capable, completely comprehensive tool for solving such problems. So, I download and install. I'm not going to go to the detail of how I couldn't understand how to do anything, and how the tutorials are bragging about what the software can do, but rarely say how.
So, I imported the source. It generated many different classes and parsed all the members. Also, it generated the class diagrams. "Perfect!", I though, but alas. The class diagrams only show relationships between classes, the files of which were in the same source folder, despite the relationships being visibly registered in the classes' properties. A search for documentation on how I could merge all these diagrams into one was unsuccessful. Fail.
NOTE: I created a parallel thread before this one here.
3. PHP_UML
Found this PEAR tool. Looked good. So, I read through documentation on how to install it for my setup from various sources, and ran it. First, I used the html output format. Great! Lots of documentation with an index, bla bla bla. However, the best it could do in the direction I want was this: Needless to say, I guess, that this is a very poor, super simplified version of what I actually need. Conclusion: fail.
4. Enterprise Architect + PHP_UML
However, PHP_UML can also generate XMI. Wow. Very nice. I can store my relationships and view them in different ways and exchange with other people.
So, I imported it into Enterprise Architect. Result: same as before with Enterprise Architect alone, only no class diagrams. Just the classes. As far as I've read about it, I can now manually create the relationships. Epic fail.
5. ArgoUML + PHP_UML
Somewhere through my search for solution I stumbled upon someone's comment that said they use ArgoUML. Downloaded and installed. XMI imported with some hassle (had to change version explicitly to 1). Fail (see Attempt 3).
Conclusion
Such a seemingly trivial task, and yet, so difficult. Do I have to go through this whole list, trying out each application?
(Edit : This answer is an alternative for people that want to generate UML class diagram from a PHP project, it doesn't explains how to read XMI files)
If your goal was to generate a class diagram from a PHP project, I found a better solution than use PHP_UML. What you probably want is BoUML, with this software, you can select a PHP project folder and reverse engineering it. Then create a class diagram. When you drag&drop the class on it, the relations are there unlike AlgoUML (If I'm not wrong). XMI files are no longer useful in this case.
One of the ways to do this would be to take the approach illustrated in my attempt 2 or 4, and then follow instructions given here for Enterprise Architect.
To generate an XMI file using PHP_UML:
extension=php_xsl.dll
.pear install PHP_UML
.phpuml -f xmi -o name_of_output_dir
. If you're planning to use the generated XMI with some older programs later, you may need to specify XMI version 1 by adding-x 1
.data
folder right under your PEAR directory.This XMI can later be used with Enterprise Architect, ArgoUML and other XMI tools.