| 風格 | 格式 | 範例 | 適用語言/場景 |
| snake_case | 小寫+底線 | $user_name, $order_id | **PHP 官方慣例**、PSR-12、核心函數、資料庫欄位 |
| camelCase | 駝峰(首字母小寫) | $userName, $orderId | JavaScript、Java、部分 PHP 框架(Laravel 部分屬性) |
| PascalCase | 大駝峰(首字母大寫) | $UserName | 類別名、介面名、Trait 名(PSR-1/12 規範) |
PHP 官方編碼標準(PSR-12)變數命名規範
- **屬性/變數/參數**:**snake_case**(
$user_name)。
- **常數**:全大寫 + 底線(
MAX_RETRY、DB_HOST)。
- **類別/介面/Trait**:**PascalCase**(
UserService、LoggerInterface)。
- **方法/函式**:**camelCase**(
getUserName())。
- **私有/受保護屬性**:**不建議**加底線前綴(舊慣例
$_name 已棄用)。
- **布林變數**:建議加
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)
| 變數 | 用途 | 備註 |
$GLOBALS | 所有全域變數引用 | 陣列鍵為變數名 |
$_SERVER | 伺服器/執行環境資訊 | REQUEST_URI, HTTP_HOST 等 |
$_GET | URL 查詢字串參數 | 僅 GET 請求 |
$_POST | POST 表單資料 | application/x-www-form-urlencoded 或 multipart/form-data |
$_COOKIE | Cookie 資料 | 唯讀 |
$_FILES | 檔案上傳資訊 | 需 enctype="multipart/form-data" |
$_ENV | 環境變數 | 視 variables_order 設定 |
$_REQUEST | GET/POST/COOKIE 合併 | **不建議直接使用**(順序不確定、安全風險) |
$_SESSION | Session 資料 | 需 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) | 變數存在且非 null | bool |
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'); // 直接修改原變數
團隊命名規範落地清單
- **統一採用 snake_case** 變數/屬性/參數(符合 PSR-12、PHP 核心風格)。
- **語意化命名**:
$user_id 而非 $uid、$id;$created_at 而非 $time。
- **布林加前綴**:
$is_valid, $has_error, $can_edit。
- **避免縮寫**:
$config 而非 $cfg、$temp 而非 $tmp。
- **常數全大寫**:
API_TIMEOUT, MAX_UPLOAD_SIZE。
- **IDE 輔助**:配置 PhpStorm/IntelliJ 命名規範檢查、使用 PHP_CodeSniffer (phpcs) 強制執行 PSR-12。
- **Code Review 關注點**:命名是否揭示意圖、是否與領域術語一致、是否有拼寫錯誤。
總結
PHP 變數語法靈活,但**團隊協作必須以規範為準**。遵循 PSR-12 採用 snake_case、語意化、布林前綴、常數大寫,配合靜態分析工具(Psalm、PHPStan)與 CodeSniffer 自動檢查,能顯著降低認知負荷、減少 Bug、提升程式碼可讀性與可維護性。
copyright ©
萬盛學電腦網 all rights reserved