目錄
這篇文章介紹了六種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: 微软雅黑, "Microsoft YaHei"; font-size: 14px;"><?php<br/>echo "Blabla.cn"; // 这是单行注释?><br/></span>
登入後複製

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

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

PHP 多行註解語法

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

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

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

區塊註解

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

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

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


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


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

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

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

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





#尾端註解

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

行末注释

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


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


文档注释

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


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


注意

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

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

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

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

【相关课程:PHP视频教程

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

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

熱AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序,用於創建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Clothoff.io

Clothoff.io

AI脫衣器

Video Face Swap

Video Face Swap

使用我們完全免費的人工智慧換臉工具,輕鬆在任何影片中換臉!

熱工具

記事本++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

PHP 8.4 帶來了多項新功能、安全性改進和效能改進,同時棄用和刪除了大量功能。 本指南介紹如何在 Ubuntu、Debian 或其衍生版本上安裝 PHP 8.4 或升級到 PHP 8.4

我後悔之前不知道的 7 個 PHP 函數 我後悔之前不知道的 7 個 PHP 函數 Nov 13, 2024 am 09:42 AM

如果您是經驗豐富的PHP 開發人員,您可能會感覺您已經在那裡並且已經完成了。操作

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

Visual Studio Code,也稱為 VS Code,是一個免費的原始碼編輯器 - 或整合開發環境 (IDE) - 可用於所有主要作業系統。 VS Code 擁有大量針對多種程式語言的擴展,可以輕鬆編寫

在PHP API中說明JSON Web令牌(JWT)及其用例。 在PHP API中說明JSON Web令牌(JWT)及其用例。 Apr 05, 2025 am 12:04 AM

JWT是一種基於JSON的開放標準,用於在各方之間安全地傳輸信息,主要用於身份驗證和信息交換。 1.JWT由Header、Payload和Signature三部分組成。 2.JWT的工作原理包括生成JWT、驗證JWT和解析Payload三個步驟。 3.在PHP中使用JWT進行身份驗證時,可以生成和驗證JWT,並在高級用法中包含用戶角色和權限信息。 4.常見錯誤包括簽名驗證失敗、令牌過期和Payload過大,調試技巧包括使用調試工具和日誌記錄。 5.性能優化和最佳實踐包括使用合適的簽名算法、合理設置有效期、

php程序在字符串中計數元音 php程序在字符串中計數元音 Feb 07, 2025 pm 12:12 PM

字符串是由字符組成的序列,包括字母、數字和符號。本教程將學習如何使用不同的方法在PHP中計算給定字符串中元音的數量。英語中的元音是a、e、i、o、u,它們可以是大寫或小寫。 什麼是元音? 元音是代表特定語音的字母字符。英語中共有五個元音,包括大寫和小寫: a, e, i, o, u 示例 1 輸入:字符串 = "Tutorialspoint" 輸出:6 解釋 字符串 "Tutorialspoint" 中的元音是 u、o、i、a、o、i。總共有 6 個元

您如何在PHP中解析和處理HTML/XML? 您如何在PHP中解析和處理HTML/XML? Feb 07, 2025 am 11:57 AM

本教程演示瞭如何使用PHP有效地處理XML文檔。 XML(可擴展的標記語言)是一種用於人類可讀性和機器解析的多功能文本標記語言。它通常用於數據存儲

解釋PHP中的晚期靜態綁定(靜態::)。 解釋PHP中的晚期靜態綁定(靜態::)。 Apr 03, 2025 am 12:04 AM

靜態綁定(static::)在PHP中實現晚期靜態綁定(LSB),允許在靜態上下文中引用調用類而非定義類。 1)解析過程在運行時進行,2)在繼承關係中向上查找調用類,3)可能帶來性能開銷。

什麼是PHP魔術方法(__ -construct,__destruct,__call,__get,__ set等)並提供用例? 什麼是PHP魔術方法(__ -construct,__destruct,__call,__get,__ set等)並提供用例? Apr 03, 2025 am 12:03 AM

PHP的魔法方法有哪些? PHP的魔法方法包括:1.\_\_construct,用於初始化對象;2.\_\_destruct,用於清理資源;3.\_\_call,處理不存在的方法調用;4.\_\_get,實現動態屬性訪問;5.\_\_set,實現動態屬性設置。這些方法在特定情況下自動調用,提升代碼的靈活性和效率。

See all articles