IntelliJ IDEA:PHPDoc注释

2019-03-15 17:13 更新

PHPDoc注释

此功能仅在Ultimate版本中受支持。
以下内容仅在安装并启用PHP插件时有效!

对于文档注释,IntelliJ IDEA提供默认启用的完成。当您键入/ **开始标记并按Enter键,或按下Alt+Insert并指定要编写的代码构造(类,方法,函数等)进行文档记录时,IntelliJ IDEA会创建PHPDoc块的存根。根据您的选择,IntelliJ IDEA将创建所需的标签或添加空的文档存根。

如果您需要其他特定于PHP的标记,IntelliJ IDEA会提供代码完成功能,以建议与当前上下文相关的标记名称。如果某个标记具有多个值,则代码完成会提供可用值列表。

在PHPDoc注释中,IntelliJ IDEA支持符合ZEND,PEAR和其他编码标准的格式选项。

源代码中的PHPDoc注释可用于快速文档查找,这有助于您快速获取任何已记录符号的信息。您可以通过按Ctrl+Q在“文档”工具窗口中打开它们以供查看。

启用文档注释

  1. 打开:编辑器|通用|IntelliJ IDEA设置的智能键页面(Ctrl+Alt+S)。

  2. 在“输入” 部分,选择或清除“插入文档注释存根”复选框。

  3. 以下内容仅在安装并启用Python插件时有效!

    对于Python,请滚动到文档注释存根选项中的插入类型占位符,然后根据需要选中或清除该复选框。

为代码构造生成PHPDoc块

  1. 要调用PHPDoc块的生成,请执行以下操作之一:

    • 将插入符放在所需的代码构造(类,方法,函数等)之前,键入空心块注释/**,然后按下Enter键。

    • 在编辑器上下文菜单中,选择:生成|生成PHPDoc块并选择代码构造以生成PHPDoc注释。

    • 按下Alt+Insert,然后选择“生成PHPDoc块”,并选择代码构造以生成PHPDoc注释。

    afccfd88-4471-499b-a869-be5d55014e4f

    IntelliJ IDEA分析指定的代码构造,在可能的情况下提取参数数据,返回值,变量或字段,并在此基础上生成文档块的存根。

  2. 必要时描述列出的参数和返回值。IntelliJ IDEA根据“PHP检查”设置检查和处理注释中的语法 。

在PHPDoc注释块中创建标记

IntelliJ IDEA分析指定的代码构造,在可能的情况下提取参数数据,返回值,变量或字段,并在此基础上生成文档块的存根。如有必要,您可以填写遗漏的信息。

  1. 在PHPDoc块中,选择所需的空行,然后按下Ctrl+Space。

  2. 从建议列表中选择相关标签。

  3. 如果输入的标签有多个值,请按Ctrl+Space,然后从建议列表中选择所需的值。

在PHPDoc注释中配置格式

您可以配置PHPDoc注释的外观和类名的显示。请注意,属性的标记不再可配置,默认的@var标记会自动插入。有关详细信息,请参阅https://github.com/phpDocumentor/fig-standards/pull/55。

  1. 在“设置/首选项”对话框(Ctrl+Alt+S)中,转到:编辑器|代码风格|PHP。

  2. 切换到PHPDoc选项卡,通过选中或清除复选框来配置对齐。

  3. 通过选中或清除“使用完全限定类名”复选框, 指定IntelliJ IDEA如何为属性,函数参数,返回值和引发值等呈现类名 。

使用PHPDoc代码检查

IntelliJ IDEA提供了一组针对PHPDoc块的预定义代码检查。这些检查检查类,方法,函数,变量和常量是否随PHPDoc注释一起提供,以及注释中的标记是否与记录的项匹配。

启用或禁用PHPDoc检查

  1. 在“设置/首选项”对话框(Ctrl+Alt+S)中,选择:编辑器|检查。

  2. 在打开的“检查”页面上,展开PHP下的PHPDoc节点。

  3. 在打开的预定义检查列表中,通过选中或清除检查旁边的复选框来启用或禁用检查。

检查是否为某种类型的代码构造提供了PHPDoc注释

  1. 启用缺少PHPDoc注释检查。

  2. 在“选项”区域中,选中所需元素类型旁边的复选框:类,方法,函数,变量或常量。

    如果方法或函数不包含任何参数或返回值, 要禁止报告缺少PHPDoc注释错误,请选中“忽略PHPDoc而不使用@param/@return”复选框。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号