Code reference information
Definitions
In PhpStorm, you can see where and how symbols, such as tags, classes, fields, methods, or functions are defined in your project. For this purpose, the IDE features the Quick Definition popup.
To view definition of a symbol, select it in the editor and press Ctrl+Shift+I (or click
).
Alternatively, with the Ctrl key pressed, hover the cursor over any symbol. PhpStorm displays the symbol as a link and shows its definition in a tooltip. Click this link to jump to the definition of the symbol.
You can open a definition in the Find tool window. To do so, click the icon in the top-right corner of the popup and click Open in Find Tool Window.
To open the source code of the definition for editing and close the popup, click the icon and then click Edit Source (F4).
Type definitions
The Quick Type Definition feature allows you to view the type definition of variables, properties, methods, or any other symbols in a popup without switching from the code you're editing.
Place the caret at the symbol for which you want to view the type definition and select
.To open the source code of the definition for editing and close the popup, click the icon and then click Edit Source (F4).
PhpStorm doesn't have a default keyboard shortcut for this action, but you can manually configure it in the settings. For more information on how to configure custom shortcuts, refer to Configure keyboard shortcuts.
Parameter info
The Parameter Info popup shows the names of parameters in method and function calls. PhpStorm automatically shows a popup with all available method signatures within 1 second (1000 milliseconds) after you type an opening bracket in the editor, or select a method from the suggestions list.
You can explicitly invoke the popup if it has closed or if your IDE is configured not to show the popup automatically. To do so, press Ctrl+P (or click ).
Show full method or function signatures
By default, the parameter info popup shows simple signatures. You can configure the IDE to show full signatures that include method names and returned types.
In the Settings/Preferences dialog Ctrl+Alt+S, go to , and select the Show full method signatures checkbox.
Make sure to include the required third-party JavaScript libraries and PHP-related items in the project source path. Otherwise, the names of parameters will not be displayed.
Configure the parameter info popup
In the Settings/Preferences dialog Ctrl+Alt+S, go to .
In the Show the parameter info popup in ... milliseconds field, specify the time in milliseconds after which the popup should appear.
If you don't want the popup to appear automatically, clear the Show the parameter info popup in ... milliseconds checkbox.
Inlay hints
Inlay hints are special markers that appear in the editor and provide you with additional information about your code, like the names of the parameters that a called method expects. Other types of hints inform you about annotations, method parameters, usages, and so on (depending on the language).
Some of the hints are enabled by default.
You can fine-tune inlay hints in Inlay Hints.
. For detailed explanation of what each type does, seeIn the PHP context, you can choose the following options:
Show name for all arguments: if selected, parameter name hints are displayed for all arguments. Otherwise, parameter hints are displayed only for literals or
null
values but not for named objects.Always show pass by reference: if selected, the
&
parameter hints are shown for arguments that are passed by reference. The names of the arguments that match the parameters' names are omitted if the Show name for all arguments checkbox is cleared.
Configure the parameter hints exception list
If you don't want to see parameter hints for specific methods, you can configure the list with exceptions. By default, the exception list contains a number of pre-defined methods. You can remove a method from the list to see the hints for it, or add new methods to hide their hints in the editor.
In the Settings/Preferences dialog Ctrl+Alt+S, select and click the necessary language.
Select Parameter hints in the list in the middle section.
The options for configuring hints become available on the right.
Add methods for which you don't want to see the hints to the Exclude list section.
Add cases for which you do not want to see the hints to the Exclude list section. To add a case, click the inline hint in your code, press Alt+Enter and select Do not show hints for current method.
Apply the changes and close the dialog.
Quick documentation
You can get quick information for any symbol or method signature by means of the Quick Documentation popup.
For markup languages, PhpStorm retrieves reference from the language specification according to the Document Type setting.
For information on retrieving inline documentation in the JavaScript or PHP context, refer to JavaScript documentation look-up and PHPDoc Comments respectively.
Documentation look-up is also available for Drupal hooks, see Drupal.
View quick documentation
Hover the mouse over the necessary symbol to view its documentation, or place the caret at the symbol, and press Ctrl+Q (
).Press Ctrl+Q again to switch between the popup and the toolbar.
Click in the popup to change the font size, display the quick documentation toolbar, or go to the source code.
Disable quick documentation on hover
In the Settings/Preferences dialog Ctrl+Alt+S, go to and clear the Show quick documentation on hover checkbox.
You can also click in the popup and disable the Show on Mouse Move option.
In this case, to view documentation for a symbol at caret, press Ctrl+Q or select
from the main menu.External documentation
External documentation opens the necessary information in a web browser so that you can navigate to related symbols and keep the information for further reference at the same time.
View external documentation
To view documentation for a symbol at the caret in a browser, press Shift+F1 or select
from the main menu.
Type Info
In PhpStorm, you can identify the type of a variable or expression in the following way:
Place the caret at the necessary code element and press Ctrl+Shift+P (or select
from the main menu).If several expressions are available, select the desired one from the popup menu and press Enter.
Productivity tips
- Copy tooltip text to the clipboard
To copy tooltip text to the clipboard, hold Alt (on Linux, hold Ctrl+Alt) and click the tooltip.
- View context information
If the current method or class declaration is not visible, you can view it in the tooltip by pressing Alt+Q.