萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 變數宣告風格比較:逐行宣告 vs 合併宣告的優缺點分析

兩種風格對比

風格程式碼範例優點缺點
逐行宣告 (推薦)
$level = 0; // 縮進層級
$size  = 0; // 由 tab 決定
易於加註解、易閱讀、易維護、版本控制 diff 清楚行數較多
合併宣告$level = 0; $size = 0; 或 $level = $size = 0;行數少、緊湊難加個別註解、diff 雜訊大、易忽略型別差異

核心原則

  1. 每行一個宣告:方便加上行尾註解說明用途。
  2. 不同型別不可合併:int $foo, $bar[]; // 錯誤:混合標量與陣列
  3. 型別與變數間保留一空格(或 tab 對齊),增強可讀性。
  4. 區域變數宣告於區塊頂端:不要在首次使用時才宣告(C89 風格),現代 PHP 無此限制但建議集中宣告。

現代 PHP 型別宣告 (PHP 7.4+)

<?php
// 型別屬性
class Config {
    public int $level = 0;
    public int $size = 0;
    public array $tags = [];
    public ?string $description = null;
}

// 函數參數與回傳型別
function calculate(int $a, int $b): int {
    $result = $a + $b;  // 區域變數型別推斷
    return $result;
}
?>

避免的反模式

  • $a = $b = $c = 0; 連結賦值:難除錯、難加註解、掩蓋型別意圖。
  • 在迴圈/條件區塊中宣告變數(除非為迴圈專用索引)。
  • 區域變數遮蔽外層同名變數:function() { $count = 0; if(...) { $count = 0; } } → 易混淆作用域。

程式碼風格工具強制執行

# PHP_CodeSniffer 規則集 (PSR-12 擴充)
# 禁止合併宣告
"Squiz.Variables.DisallowMultipleAssignments": true
# 強制型別提示
"SlevomatCodingStandard.TypeHints.ParameterTypeHint": true
"SlevomatCodingStandard.TypeHints.ReturnTypeHint": true
# 宣告對齊
"Generic.WhiteSpace.ScopeIndent": true

總結

雖然 PHP 允許彈性宣告,但逐行宣告、明確型別、附加說明註解是團隊協作、長期維護的最佳選擇。配合靜態分析工具(PHPStan/Psalm)與代碼風格檢查(PHP_CodeSniffer),能在提交前攔截風格違規,維持程式碼庫整潔一致。

copyright © 萬盛學電腦網 all rights reserved