Well I was wondering if there is a website that does PHPdocumentor service. The idea is, well, you upload a PHP file with correct format of documentation comments in your script, and the website generates a document for you to download after processing it internally. This can avoid the tedious installation and configuration process of PHPdocumentor on your local machine or hosting service, none of the linux commands make any sense to me anyway.

Please let me know if you know a website that does this for programmers, thanks.

    Tedious installation? The last time I tried to install phpDocumentator, it took between 0 and 3 minutes - including the time it took to download the files.

      Lord Yggdrasill;11012085 wrote:

      none of the linux commands make any sense to me anyway...

      that's your problem, right there 🙂

      although it is an intimidating name... [font=monospace]terminal[/font]...

        Not to mention the fact that the "linux[sic] commands" are really just "commands" - e.g. you'd be executing the exact same command line instructions if you're on Windows or even Mac (shudder, gasp, scream, etc.).

          Umm are you saying such a website does not exist? Weird, thought it should be available... I have a local machine using Windows 7, I also have a dedicated hosting account on a Linux CentOS system. No idea how to run Linux command though, that's why I'm trying to find an easier and more convenient way to accomplish this task.

            Lord Yggdrasill;11012101 wrote:

            Umm are you saying such a website does not exist?

            I'm saying I doubt it, given how easy it is to simply install phpDocumentator on the same server you're developing on. A cursory Google search didn't seem to turn up any immediate results either.

              Well this is really confusing. I opened cmd from start/run and entered the command $ pear channel-discover pear.phpdoc.org but got this error:

              '$' is not recognized as internal or external command, operable program or batch file

              You see? It is not simple at all, unless you are running a linux operation system in a local machine...
              🙁

                Lord Yggdrasill wrote:

                I opened cmd from start/run and entered the command $ pear channel-discover pear.phpdoc.org but got this error:

                '$' is not recognized as internal or external command, operable program or batch file

                The $ symbol denotes the command prompt (for a normal user), i.e., the command is:

                pear channel-discover pear.phpdoc.org

                not:

                $ pear channel-discover pear.phpdoc.org

                but running on a *nix machine, you should see:

                something$

                which becomes:

                something$ pear channel-discover pear.phpdoc.org

                after you have entered the command. So on Windows, you just pretend that the $ in command line related documentation means "C:>" or something along those lines.

                  I see, thanks for the explanation. I am downloading Cygwin now, hopefully it will solve my problem.

                    Well I did that, but it told me something like 'Dependency installation fails' and other weird errors...

                      Well this is so frustrating, the installer wont work for me if I run it manually. It shows this error message:

                      Installing dependencies
                      Error: Unable to install dependencies; Composer returned: Loading composer repos
                      itories with package information
                      Installing dependencies from lock file
                      Your requirements could not be resolved to an installable set of packages.

                      Problem 1
                      - Installation request for phpdocumentor/template-abstract == 1.0.2.0 -> sat
                      isfiable by phpdocumentor/template-abstract 1.0.2.
                      - phpdocumentor/template-abstract 1.0.2 requires ext-xsl -> no matching pa
                      ckage found.
                      Problem 2
                      - Installation request for phpdocumentor/template-checkstyle == 1.0.1.0 -> s
                      atisfiable by phpdocumentor/template-checkstyle 1.0.1.
                      - phpdocumentor/template-checkstyle 1.0.1 requires ext-xsl                       -> no matching
                      package found.
                      Problem 3
                      - Installation request for phpdocumentor/template-new-black == 1.0.3.0 -> sa
                      tisfiable by phpdocumentor/template-new-black 1.0.3.
                      - phpdocumentor/template-new-black 1.0.3 requires ext-xsl -> no matching p
                      ackage found.
                      Problem 4
                      - Installation request for phpdocumentor/template-old-ocean == 1.0.1.0 -> sa
                      tisfiable by phpdocumentor/template-old-ocean 1.0.1.
                      - phpdocumentor/template-old-ocean 1.0.1 requires ext-xsl                       -> no matching p
                      ackage found.
                      Problem 5
                      - Installation request for phpdocumentor/template-responsive == 1.0.6.0 -> s
                      atisfiable by phpdocumentor/template-responsive 1.0.6.
                      - phpdocumentor/template-responsive 1.0.6 requires ext-xsl -> no matching
                      package found.
                      Problem 6
                      - Installation request for phpdocumentor/template-zend == 1.0.1.0 -> satisfi
                      able by phpdocumentor/template-zend 1.0.1.
                      - phpdocumentor/template-zend 1.0.1 requires ext-xsl                       -> no matching packag
                      e found.

                      Potential causes:
                      - A typo in the package name
                      - The package is not available in a stable-enough version according to your min
                      imum-stability setting
                      see https://groups.google.com/d/topic/composer-dev/_g3ASeIFlrc/discussion for
                      more details.

                      D:\Business\Apache\htdocs\phpdocumentor>

                      I thought it was because I had not got pear yet, so I attempted to install pear on my computer. I ran the command 'php go-pear.phar', and received error message again:

                      Could not open input file: go-pear.phar

                      I then searched through internet to find possible causes of this problem, and this link seemed to have provided some insights:
                      http://blog.pear.php.net/2009/07/01/php-53-windows-and-pear/

                      So a non-pharred version? It wouldnt work either, another error message displayed after I ran it:

                      Sorry your PHP version is too new(5.3.5) for this go-pear. Instead use http://pear.php.net/go-pear.phar for a more stable and current version of go-pear, more suited to your php version.

                      And it is telling me to go back to run go-pear.phar again... And this cycle just keeps repeating...

                      So am I just screwed for this? I already tried my best, it just wont work in any way. I thought it was because of my poor skills at running prompt commands before, but now its getting a lot more complex. Is there really no way I could hope to run phpdocumentor from my local machine then? 🙁

                        Have you checked that you have the XSL extension installed (there should be a section for it in phpinfo)? All of the error messages say something about it being required, and the documentation says something about XSL being required.

                          I see, that looks like a possibility to me. I do not have xsl installed on the local machine for now, guess I have to reinstall PHP with all custom packaged selected to fix this problem. Anyway it wont hurt to upgrade from PHP 5.3.5 to 5.4.6...

                            Lord Yggdrasill;11012181 wrote:

                            ...Anyway it wont hurt to upgrade from PHP 5.3.5 to 5.4.6...

                            Sounds like famous last words to me. 🙂

                              it didn't hurt when I did it

                              ...much

                                lol... I am able to get PHPdocumentor to work now, thanks goodness. I was quite confused at how private properties did not displaying in the documentation, turned out that they aint showing up by default.
                                :p

                                  Lord Yggradsill wrote:

                                  turned out that they aint showing up by default.

                                  Well, they are private - anyone who needs to know about them is already looking at the code....

                                    Write a Reply...