PhpStorm 7.1.0 Web Help

PhpStorm creates stubs of PHPDoc blocks on typing the opening tag /** and pressing EnterEnterEnterEnterEnterEnterEnterEnterEnterEnterEnter.

If this feature is applied to a method or a function, @param, @access, @static, @throws, and @abstract tags are created. In any other places PhpStorm adds an empty documentation stub.

If you need additional PHP-specific tags, PhpStorm provides code completion that suggests tag names that are relevant in the current context. If a certain tag has multiple values, the same code completion provides a list of available values.

In PHPDoc comments, PhpStorm supports the following formatting options in compliance with ZEND, PEAR, and other standards:

  • Align parameter names
  • Align tag comments
  • Align key-value pairs
  • Align consecutive assignments

Note

PHPDoc comments in your source code are available for the Quick Documentation Lookup feature and open for review on pressing Ctrl+Q or Alt+Button2 ClickCtrl+Q or Alt+Button2 ClickCtrl+Q or Alt+Button2 ClickCtrl+Q or Alt+Button2 ClickCtrl+Q or Alt+Button2 ClickCtrl+QCtrl+Q or Alt+Button2 ClickAlt+Button2 Click, Ctrl+Shift+Space or F2F1, Control J or Control Button2 ClickControl J or Control Button2 ClickAlt Button2 Click or F2.

On this page:

To enable or disable automatic creation of documentation comments
  1. Open the Settings dialog box and navigate to the Editor. Smart Keys page.
  2. In the Enter section, select or clear Insert documentation comment stub check box.
Creating a PHPDoc block for a method or a function
  1. Place the caret before the method or function declaration.
  2. Type the opening block comment /** and press EnterEnterEnterEnterEnterEnterEnterEnterEnterEnterEnter.
  3. Describe the listed parameters and return values.

    Tip

    PhpStorm checks syntax in the comments and treats it according to the PHP Inspections settings.

Creating tags in a PHPDoc comment block
  1. In a PHPDoc block, select the desired empty line and press Ctrl+SpaceCtrl+SpaceCtrl+SpaceCtrl+SpaceAlt+SlashCtrl+SpaceCtrl+Space or Ctrl+Back SlashCtrl+SpaceControl SpaceControl SpaceControl Space.
  2. Select the relevant tag from the suggestion list.
  3. If the entered tag has several values, press Ctrl+SpaceCtrl+SpaceCtrl+SpaceCtrl+SpaceAlt+SlashCtrl+SpaceCtrl+Space or Ctrl+Back SlashCtrl+SpaceControl SpaceControl SpaceControl Space and select the desired value from the suggestion list.
Inspecting PHPDoc comments

PhpStorm provides a set of predefined code inspections targeted at PHPDoc blocks. These inspections check whether classes, methods, functions, variables, and constants are supplied with a PHPDoc comment and whether the tags in the comment match the documented item.

  • To enable or disable an inspection:
    1. Choose File | Settings on the main menu, and in the Settings dialog box that opens, click Inspections.
    2. On the Inspections page that opens, expand the PHPDoc node under the PHP node. The list of predefined inspections is displayed.
    3. To enable or disable an inspection, select or clear the check box next to it.
  • To have PhpStorm check that PHPDoc comments are provided for all code constructs of a certain type:
    1. Select the check box next to the Missing PHPDoc Comment inspection.
    2. In the Options area, select the check boxes next to the required code construct type: class, method, function, variable, or constant.
    3. To suppress reporting a Missing PHPDoc Comment error if a method or function does not contain any parameters and/or return values, select the Skip if empty.

See Also

Procedures:

Reference:

External Links:

Web Resources: