PHP如何优雅地在PHP里写注释 | PHP的注释PHPDoc

Posted 2022-09-03 小雨青年

目录

• • 一、没有注释的代码就像是吃饭不给筷子
  • 二、PHP的注释方式
  • • 1. 行内注释
    • 2. 多行注释
  • 三、PHPDoc的注释
  • • 1. PHPDoc是什么
    • 2. 注释的基本格式
    • 3. 完整的注释标签
  • 四、为什么我们需要注释
  • • 1. 代码首先是最好的注释
    • 2. 注释可能没有跟随代码变更
    • 3. 必要并且不繁琐的注释才是好注释
  • 五、总结

一、没有注释的代码就像是吃饭不给筷子

你好，我是小雨青年，一名知道如何写注释的程序员。

注释，字面上的意思，就是解释性质的文字，而代码上的注释，说是一种艺术也不为过。

本篇内容你将会学到：

• php的注释格式以及应用范围
• 如何规范注释

二、PHP的注释方式