PHP 函數原型中可選參數方括號語法深度解析

PHP 函數原型中可選參數方括號語法深度解析

初讀 PHP 官方手冊時，常見函數原型如 array explode(string $delimiter, string $string[, int $limit])，可選參數連同前置逗號包在方括號內，乍看之下逗號位置似乎不合直覺。本文釐清此語法設計意圖。

語法規則

// 官方寫法
array explode ( string $delimiter , string $string [, int $limit ] )

// 而非
array explode ( string $delimiter , string $string , [int $limit ] )

設計考量

1. 參數整體可選：方括號包住 , int $limit 表示「從這個逗號開始的所有參數」都是可選的。若有多個可選參數，只需最外層一組括號：
   func(string $a[, string $b[, int $c]]) 意為 $b 與 $c 皆可省略，但若提供 $c 必須先提供 $b。
2. 避免語法歧義：若寫成 , [int $limit]，逗號屬於必填參數部分，括號內只剩型別與變數名，無法表達「逗號也隨參數一起省略」的語意。
3. 與函數定義一致：實際函數宣告為 function explode($delimiter, $string, $limit = null)，呼叫時 explode(',', 'a,b') 省略第三參數，逗號自然也不寫。原型以 [, ...] 精確對應此呼叫形式。
4. 歷史慣例：此標記法沿用自 Unix 手冊頁（man page）慣例，廣泛用於 C 標準庫文檔，PHP 手冊繼承此傳統。

實際範例對照

結論

方括號包含前置逗號，是為了精確表達「參數群整體可選」且「呼叫時逗號隨參數一同省略」的語意。理解此慣例後，閱讀手冊將更無障礙。