PhpStorm displays your own code documentation in the code assist. But what if you wanted to create a separate documentation you can hand out or integrate into your website? Then you should use phpDocumentor. You can configure and run phpDocumentor directly from PhpStorm as an external tool. Here is what you have to do:
File -> Settings -> Select External Tools -> Add…
Provide the following data:
Name: phpDocumentor
This name will show up in your Tools Menu. If you fill in a group such as PHP, then the entry will become a submenu of PHP.
Program: <pathToPhp.exe>
Fill in the path to your PHP executable, e.g. C:Program FilesPHPphp.exe
Parameters: phpdoc -d “<pathToSourceDirectory>” -t “<pathToDestinationDirectory>” -o HTML:Smarty:PHP
The source directory is the one you want to document, e.g. where your php files reside in. The destination directory is where you want the documentation to be created in. Please note, that paths are given without th a trailing slash and in case your paths contain spaces it is important to enclose the parameter in quotes. For more information about the parameters see the phpDocumentor tutorial.
Working Directory: <pathToPhpDocumentor>
Fill in the path to your phpDocumentor directory, e.g. “C:\Documents and Settings\Speich\My Documents\Website Tools\PhpDocumentor”
In case you also wanted to create documentation for your JavaScript code, you should read the blog entry ‘How to create JavaScript documentation in PhpStorm‘.
Thank you for good post
How do i can exlcusive special folder from doc?
You can exclude files and folders with the -i option:
http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html#using.command-line.ignore
Thank you, this installation guide for documentor is very useful. I was looking for detailed instructions like this.
I’ve also found the following is more transportable across projects (and with modification across OS’s?) by using the simplified “configuration” file parameter (-c config) found with the most recent versions of PHPDocumentor. You can find configuration examples in the ‘PHPDocumentor/user’ folder…just modify one and save it to your root project folder.
Program: $PhpExecutable$Parameters: C:xamppphpphpdoc -c "$ProjectFileDir$"phpdoc.ini
Working directory: $ProjectFileDir$
If you’re using Windows and XAMPP (Apache, MySQL, etc…), you may run into a problem with phpdoc being unable to find it’s .ini file. You’ll find a fix here. Of course you’ll need to have already installed PhpDocumentor via Pear. Start in xampp root xampp_shell.bat
cd php
pear channel-update pear.php.net
pear install --alldeps PHPDocumentor