加入收藏 | 设为首页 | 会员中心 | 我要投稿 我爱制作网_池州站长网 (https://www.0566zz.com/)- 科技、建站、经验、云计算、5G、大数据,站长网!
当前位置: 首页 > 站长学院 > PHP教程 > 正文

php 跳转到指定url_PHP注释标记的整理

发布时间:2022-11-11 10:46:05 所属栏目:PHP教程 来源:
导读:  @deprecated

  标明方法是不建议使用的、已过期的或将要删除的

  /*
   * 语法:
   * @deprecated [版本号] [描述]
   * eg:
   * @see Class::test()
   * @deprecated 2.0 将被弃用
  @deprecated
 
  标明方法是不建议使用的、已过期的或将要删除的
 
  /*
   * 语法:
   * @deprecated [版本号] [描述]
   * eg:
   * @see Class::test()
   * @deprecated 2.0 将被弃用,请使用test方法
   */
  @inheritdoc
 
  会继承父类文档, 且子类出现冲突文档时重写父类文档
 
  @internal
 
  标识此类或方法仅限当前文件使用
 
  @description [描述]
 
  @link
 
  指明外部链接, 必须给出完整url
 
  @link [url] [描述]
 
  @see
 
  此链接不光可以跳转到外部链接, 还可以跳转到内部的指定方法等, 如: class::method
 
  @see [url|内部方法] [描述]
 
  @var
 
  定义数据的类型
 
  @var [类型] [变量名] [描述]
 
  /**
   * 可以指定变量的类型
   * @var array 名称列表
   * 也可以指定变量名, 指定变量时数组或空
   * @var array|null $nameList 名称列表
   */
  类型列表如下:
 
  @throws
 
  抛出异常
 
  @throws [类型] [描述]
 
  @method
 
  类注释, 标明该类可以调用的方法, 可以令IDE自动提示等
 
  /**
   * @method string test(int num) 测试方法
   */
  @param
 
  标识参数信息, 类型可参考 @var
 
  @param [类型] [名称] [描述]
 
  @property
 
  @property [类型] [名称] [描述]
 
  @property-read
 
  @property-write
 
  @return
 
  标识方法的返回值, 类型参考 @var
 
  @return [类型] [描述]
 
  @global
 
  标明用到的全局变量
 
  @global [类型] [名称] [描述]
 
  @ignore
 
  标明生成文档是忽略的值
 
  @users
 
  标明使用到了哪些值
 
  /**
   * @users Class::$num 使用此属性计数
   */
  有一些注释没有给出说明, 是因为个人不是常用, 当然还有一些注释没有总结到, 后面用到了再总结.
 
  以上内容希望帮助到大家,很多PHPer在进阶的时候总会遇到一些问题和瓶颈,业务代码写多了没有方向感,不知道该从那里入手去提升,对此我整理了一些资料php注释,包括但不限于:分布式架构、高可扩展、高性能、高并发、服务器性能调优、TP6,laravel,YII2,Redis,Swoole、Swoft、Kafka、Mysql优化、shell脚本、Docker、微服务、Nginx等多个知识点高级进阶干货需要的可以免费分享给大家,需要戳这里PHP进阶架构师>>>视频、面试文档免费获取。
 

(编辑:我爱制作网_池州站长网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!