I wanted to create documentation for my most recent PHP project.  My code was all set and in a form that it should be in – I just needed a way to generate the docs.  I considered two options:

Ended up going with phpDocumentor because it looks like it has a library of templates and I’d have a better chance of finding something that feels like it belongs with my project.  I followed the phpDoc instructions by using PEAR to install phpDocumentor.  One note – I came across an issue during this step:

$ pear install php/phpDocumentor

After a bit of downloading/waiting, I saw this message in the console:

ERROR: failed to mkdir C:\php\pear\data\phpDocumentor\ansible\roles\phpdocumentor.common\handlers

Not sure why I was hitting that.  There should be no special permissions on the C drive for creating that folder.  To get around it, I manually created the folder using Windows Explorer.  Ran the command again and it appears to have been installed properly – I could tell because I had a new phpdoc.bat file and pear/phpDocumentor folder in my local WampServer bin/php/… folder.