PHP 編碼規範4

4.1 塊註釋php 塊註釋一般用於提供對文件，方法，數據結構和算法的描述。塊註釋被置於每一個文件的開始處以及每一個方法以前。它們也能夠被用於其餘地方，好比方法內部。在功能和方法內部的塊註釋應該和它們所描述的代碼具備同樣的縮進格式。算法 塊註釋之首應該有一個空行，用於把塊註釋和代碼分割開來，好比：數據結構 /* 　* 這裏是塊註釋 */數據結構和算法 塊註釋能夠以/*-開頭，這樣indent(1)

>>阅读原文<<