Go Back   CodingForums.com > :: Server side development > PHP

Before you post, read our: Rules & Posting Guidelines

Reply
 
Thread Tools Rate Thread
Enjoy an ad free experience by logging in. Not a member yet? Register.
Old 08-17-2012, 05:52 PM   PM User | #1
blizeH
New to the CF scene

 
Join Date: Oct 2008
Posts: 6
Thanks: 0
Thanked 0 Times in 0 Posts
blizeH is an unknown quantity at this point
Automatically generating PHP documentation - without using the command line?

Hi,

I've just spent hours trying to generate PHP documentation for our systems, probably around 800 pages in total and very well commented so figured it'd be a good idea to have it generated automatically. Unfortunately anything I've tried (namely APIgen and phpDocumentor) have required either weird access permissions or internet connections which aren't available on the server - basically every single thing I've tried results in some kind of error.

Is there any alternative I've overlooked, preferably something that can just scan a directory and generate documentation accordingly? I've already spent hours on it I know, but if I can get something that'll work it'll save me weeks, potentially even longer in not having to re-write and collate all of my code and comments.

Thank you
blizeH is offline   Reply With Quote
Old 08-17-2012, 09:09 PM   PM User | #2
Fumigator
UE Antagonizer


 
Fumigator's Avatar
 
Join Date: Dec 2005
Location: Utah, USA, Northwestern hemisphere, Earth, Solar System, Milky Way Galaxy, Alpha Quadrant
Posts: 7,687
Thanks: 42
Thanked 637 Times in 625 Posts
Fumigator is a glorious beacon of lightFumigator is a glorious beacon of lightFumigator is a glorious beacon of lightFumigator is a glorious beacon of lightFumigator is a glorious beacon of light
I have to ask, why must you not use the command line? Is it because you are using shared hosting? If that is the case I would recommend you install XAMPP, copy your code library to your c: drive and run phpDocumentor there.
__________________
Fumigator is offline   Reply With Quote
Old 08-17-2012, 09:58 PM   PM User | #3
blizeH
New to the CF scene

 
Join Date: Oct 2008
Posts: 6
Thanks: 0
Thanked 0 Times in 0 Posts
blizeH is an unknown quantity at this point
Thank you, unfortunately it's the server at work and seems to be quite locked down, any of the files that phpDocumentator tried to write wouldn't work, and any time it tried to connect to the internet the firewall blocked it.

I can see if I can install xampp (again, the computers at work are quite fussy) and copy the code across, that's actually a neat idea, thank you - I think ideally I was hoping for something I could install on my machine (without the need for services, registry changes etc) which could then scan the folders on the server for the files
blizeH is offline   Reply With Quote
Old 08-20-2012, 11:02 AM   PM User | #4
blizeH
New to the CF scene

 
Join Date: Oct 2008
Posts: 6
Thanks: 0
Thanked 0 Times in 0 Posts
blizeH is an unknown quantity at this point
Trying to run phpDocumentor on my local machine now and getting exactly the same errors as I was getting on the server - the firewall blocks both the PEAR and manual installations, I've tried downloading directly from GitHub and installing, I get as far as it trying to generate the documentation but it fails because important files (such as phpDocumentor.ini) are not part of the GitHub install.

Really not sure what to try next - I've asked and I can't take my code away from work, but I cannot generate any documentation from any of the methods online... why has no one made a GUI documenter that doesn't require messing with services, paths etc etc?
blizeH is offline   Reply With Quote
Old 08-20-2012, 11:17 AM   PM User | #5
blizeH
New to the CF scene

 
Join Date: Oct 2008
Posts: 6
Thanks: 0
Thanked 0 Times in 0 Posts
blizeH is an unknown quantity at this point
This is my path, and I'm still receiving 'php.exe is not recognised' errors...!

C:\xampp\php;C:\xampp\php\phpDocumentor\bin;C:\xampp\php\apigen;
blizeH is offline   Reply With Quote
Reply

Bookmarks

Jump To Top of Thread


Thread Tools
Rate This Thread
Rate This Thread:

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump


All times are GMT +1. The time now is 06:34 AM.


Advertisement
Log in to turn off these ads.