目錄
這篇文章介紹了六種PHP的註解方式,大家一起來學習吧! " >這篇文章介紹了六種PHP的註解方式,大家一起來學習吧!
PHP 單行註解語法" >PHP 單行註解語法
PHP 多行註解語法" >PHP 多行註解語法
首頁 後端開發 php教程 PHP規範的註解方法有哪些?

PHP規範的註解方法有哪些?

Apr 17, 2019 pm 05:57 PM
php 註解


這篇文章介紹了六種PHP的註解方式,大家一起來學習吧!

PHP 單行註解語法

#在一行中所有DE>//DE> 符號右邊的文字都被視為註釋, 因為PHP解析器忽略該行 DE>//DE> 右面的所有內容。如下:

<span style="font-family: 微软雅黑, &quot;Microsoft YaHei&quot;; font-size: 14px;">&lt;?php<br/>echo &quot;Blabla.cn&quot;; // 这是单行注释?&gt;<br/></span>
登入後複製

你也這樣寫,一行只寫註釋,不寫程式碼,如下:

<span style="font-family: 微软雅黑, &quot;Microsoft YaHei&quot;; font-size: 14px;">&lt;?php// 这是单行注释echo &quot;Blabla.cn&quot;; <br/>// 这是单行注释?&gt;<br/></span>
登入後複製

PHP 多行註解語法

PHP 多行註解以DE>/*DE> 開頭,以 DE>*/DE> 結束。在 DE>/*DE> 和 DE>*/DE> 之間,可以寫多行註解。

範例如下,紅色部分就是多行註解的內容。

<span style="font-family: 微软雅黑, &quot;Microsoft YaHei&quot;; font-size: 14px;">&lt;?php<br/>echo &quot;Blabla.cn&quot;;/*<br/>这是多行注释<br/>这是多行注释<br/>*/?&gt;<br/></span>
登入後複製

區塊註解

區塊註解通常用於提供對文件,方法,資料結構和演算法的描述。區塊註解被置於每個文件的開始處以及每個方法之前。它們也可以被用於其他地方,例如方法內部。在函數和方法內部的區塊註解應該和它們所描述的程式碼具有一樣的縮排格式。

區塊註解之首應該有一個空白行,用來把區塊註解和程式碼分割開來,例如: 

/*
 
* 这里是块注释
*/
登入後複製


區塊註解可以以/*-開頭,讓indent(1)可以將之辨識為一個程式碼塊的開始,而不會重排它。


#
/*-
 
* 如果想被忽略,可是使用特别格式的块注释
*
* one
*   two
*     three
*/
登入後複製

注意:如果你不使用indent (1),就不必在程式碼中使用/*-,或為他人可能對你的程式碼執行indent(1)作讓步。
單行註解

短註解可以顯示在一行內,並與其後的程式碼具有相同的縮排層級。如果一個註解不能在一行內寫完,就該採用區塊註解。單行註解之前應該有一個空白行。以下是一個程式碼中單行註解的範例:

#
if (condition) {
 
/* 以下代码运行的条件 */
 
...
}
登入後複製





#尾端註解

######極短的註解可以與它們所要描述的程式碼位於同一行,但是應該有足夠的空白來分開代碼和註釋。若有多個短註釋出現於大段程式碼中,它們應該具有相同的縮排。 ###以下是一個程式碼中尾端註解的範例: #########################
if ($a == 2) {
 
return TRUE; /* 对单一条件的说明 */
} else {
return isPrime($a); /* 其余的条件 */
}
登入後複製

行末注释

注释界定符"//",可以注释掉整行或者一行中的一部分。它一般不用于连续多行的注释文本;然而,它可以用来注释掉连续多行的代码段。以下是所有三种风格的例子:


if ($foo &gt; 1) {
 
// 第二种用法.
 
...
}
else {
return false; // 说明返回值的原因
}
//if ($bar &gt; 1) {
 
//
//  // 第三种用法
//  ...
//}
//else {
// return false;
//}
登入後複製


文档注释

文档注释描述php的类、构造器,方法,以及字段(field)。每个文档注释都会被置于注释定界符/**...*/之中,一个注释对应一个类或成员。该注释应位于声明之前:


/**
 
* 说明这个类的一些 ...
*/
class Example { ...
登入後複製


注意

顶层(top-level)的类是不缩进的,而其成员是缩进的。

描述类的文档注释的第一行(/**)不需缩进;随后的文档注释每行都缩进1格(使星号纵向对齐)。

成员,包括构造函数在内,其文档注释的第一行缩进4格,随后每行都缩进5格。

文档注释不能放在一个方法或构造器的定义块中,因为程序会将位于文档注释之后的第一个声明与其相关联。

【相关课程:PHP视频教程

以上是PHP規範的註解方法有哪些?的詳細內容。更多資訊請關注PHP中文網其他相關文章!

本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn

熱門文章

R.E.P.O.能量晶體解釋及其做什麼(黃色晶體)
2 週前 By 尊渡假赌尊渡假赌尊渡假赌
倉庫:如何復興隊友
3 週前 By 尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island冒險:如何獲得巨型種子
3 週前 By 尊渡假赌尊渡假赌尊渡假赌

熱門文章

R.E.P.O.能量晶體解釋及其做什麼(黃色晶體)
2 週前 By 尊渡假赌尊渡假赌尊渡假赌
倉庫:如何復興隊友
3 週前 By 尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island冒險:如何獲得巨型種子
3 週前 By 尊渡假赌尊渡假赌尊渡假赌

熱門文章標籤

記事本++7.3.1

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

SublimeText3漢化版

中文版,非常好用

禪工作室 13.0.1

禪工作室 13.0.1

強大的PHP整合開發環境

Dreamweaver CS6

Dreamweaver CS6

視覺化網頁開發工具

SublimeText3 Mac版

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

適用於 Ubuntu 和 Debian 的 PHP 8.4 安裝和升級指南 適用於 Ubuntu 和 Debian 的 PHP 8.4 安裝和升級指南 Dec 24, 2024 pm 04:42 PM

適用於 Ubuntu 和 Debian 的 PHP 8.4 安裝和升級指南

CakePHP 專案配置 CakePHP 專案配置 Sep 10, 2024 pm 05:25 PM

CakePHP 專案配置

CakePHP 日期和時間 CakePHP 日期和時間 Sep 10, 2024 pm 05:27 PM

CakePHP 日期和時間

CakePHP 檔案上傳 CakePHP 檔案上傳 Sep 10, 2024 pm 05:27 PM

CakePHP 檔案上傳

CakePHP 路由 CakePHP 路由 Sep 10, 2024 pm 05:25 PM

CakePHP 路由

討論 CakePHP 討論 CakePHP Sep 10, 2024 pm 05:28 PM

討論 CakePHP

如何設定 Visual Studio Code (VS Code) 進行 PHP 開發 如何設定 Visual Studio Code (VS Code) 進行 PHP 開發 Dec 20, 2024 am 11:31 AM

如何設定 Visual Studio Code (VS Code) 進行 PHP 開發

CakePHP 快速指南 CakePHP 快速指南 Sep 10, 2024 pm 05:27 PM

CakePHP 快速指南

See all articles