萬盛學電腦網

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

PHP 變數宣告與命名規範完整指南:從基礎語法到團隊規範最佳實踐

PHP 變數基礎語法

  • 以 $ 開頭,後接字母或底線,再接字母、數字、底線:$var、$_var、$var123。
  • **區分大小寫**:$name ≠ $Name ≠ $NAME。
  • **不能以數字開頭**:$123var ❌,$var123 ✅。
  • **不需宣告類型**:PHP 為弱型別、動態型別,賦值時自動推斷。
  • **賦值即建立**:首次賦值即隱式宣告,無需 var/let/int 等關鍵字。

變數命名三大主流風格

PHP 官方編碼標準(PSR-12)變數命名規範

  1. **屬性/變數/參數**:**snake_case**($user_name)。
  2. **常數**:全大寫 + 底線(MAX_RETRY、DB_HOST)。
  3. **類別/介面/Trait**:**PascalCase**(UserService、LoggerInterface)。
  4. **方法/函式**:**camelCase**(getUserName())。
  5. **私有/受保護屬性**:**不建議**加底線前綴(舊慣例 $_name 已棄用)。
  6. **布林變數**:建議加 is_/has_/can_/should_ 前綴($is_active、$has_permission)。

特殊變數類型與作用域

1. 可變變數

<?php
$a = 'hello';
$$a = 'world';      // 建立 $hello = 'world'
echo "$a ${$a}";    // hello world
echo "$a $hello";   // hello world

// 陣列情況需用大括號消除歧義
$arr = ['foo', 'bar'];
${$arr[1]} = 'baz'; // $bar = 'baz'
// 或
${$arr}[1] = 'baz'; // $arr[1] = 'baz'

2. 靜態變數

<?php
function counter() {
    static $count = 0; // 僅初始化一次
    $count++;
    echo $count . "\n";
}
counter(); // 1
counter(); // 2
counter(); // 3
// 僅存在於函數區域,但生命週期贯穿整個腳本執行

3. 全域變數與 $GLOBALS

<?php
$globalVar = 'outside';

function test() {
    global $globalVar;           // 引入全域符號表引用
    $globalVar = 'modified';     // 修改外部變數
    
    // 或直接用超全域陣列
    $GLOBALS['another'] = 'value';
}
test();
echo $globalVar; // modified

4. 超全域變數(Superglobals)

風格格式範例適用語言/場景
snake_case小寫+底線$user_name, $order_id**PHP 官方慣例**、PSR-12、核心函數、資料庫欄位
camelCase駝峰(首字母小寫)$userName, $orderIdJavaScript、Java、部分 PHP 框架(Laravel 部分屬性)
PascalCase大駝峰(首字母大寫)$UserName類別名、介面名、Trait 名(PSR-1/12 規範)
變數用途備註
$GLOBALS所有全域變數引用陣列鍵為變數名
$_SERVER伺服器/執行環境資訊REQUEST_URI, HTTP_HOST 等
$_GETURL 查詢字串參數僅 GET 請求
$_POSTPOST 表單資料application/x-www-form-urlencoded 或 multipart/form-data
$_COOKIECookie 資料唯讀
$_FILES檔案上傳資訊需 enctype="multipart/form-data"
$_ENV環境變數視 variables_order 設定
$_REQUESTGET/POST/COOKIE 合併**不建議直接使用**(順序不確定、安全風險)
$_SESSIONSession 資料需 session_start()

5. 參考賦值(引用傳遞)

<?php
$a = 10;
$b = &$a;     // $b 是 $a 的別名
$b = 20;
echo $a;      // 20

// 函數參數傳址
function addOne(&$num) { $num++; }
$val = 5;
addOne($val); // $val 變 6

// foreach 參考修改陣列元素
foreach ($arr as &$v) { $v *= 2; }
unset($v);    // 重要:解除引用,避免後續誤用

變數檢測與銷毀函式

函式用途回傳值
isset($var)變數存在且非 nullbool
empty($var)不存在、0、""、null、false、[] 視為空bool
unset($var)銷毀變數(釋放符號表綁定)void
gettype($var)取得型別字串string
var_dump($var)除錯輸出型別+值+長度void

型別轉換與強制轉型

<?php
// 自動轉型(弱型別特性)
$foo = "10" + 5;      // 15 (字串轉整數)
$foo = "10.5" + 1.3;  // 11.8 (字串轉浮點數)
$foo = 5 + "10 Pigs"; // 15 (字串前導數字部分)

// 強制轉型
$int    = (int) $val;      // 或 (integer)
$float  = (float) $val;    // 或 (double), (real)
$str    = (string) $val;
$arr    = (array) $val;
$obj    = (object) $val;
$bool   = (bool) $val;     // 或 (boolean)

// 函式轉型
$int = intval($val);
$float = floatval($val);
$str = strval($val);
settype($var, 'integer');  // 直接修改原變數

團隊命名規範落地清單

  1. **統一採用 snake_case** 變數/屬性/參數(符合 PSR-12、PHP 核心風格)。
  2. **語意化命名**:$user_id 而非 $uid、$id;$created_at 而非 $time。
  3. **布林加前綴**:$is_valid, $has_error, $can_edit。
  4. **避免縮寫**:$config 而非 $cfg、$temp 而非 $tmp。
  5. **常數全大寫**:API_TIMEOUT, MAX_UPLOAD_SIZE。
  6. **IDE 輔助**:配置 PhpStorm/IntelliJ 命名規範檢查、使用 PHP_CodeSniffer (phpcs) 強制執行 PSR-12。
  7. **Code Review 關注點**:命名是否揭示意圖、是否與領域術語一致、是否有拼寫錯誤。

總結

PHP 變數語法靈活,但**團隊協作必須以規範為準**。遵循 PSR-12 採用 snake_case、語意化、布林前綴、常數大寫,配合靜態分析工具(Psalm、PHPStan)與 CodeSniffer 自動檢查,能顯著降低認知負荷、減少 Bug、提升程式碼可讀性與可維護性。

copyright © 萬盛學電腦網 all rights reserved