PHP 變數由兩部分組成:符號表條目 (變數名 → zval*) 和 zval 結構 (值、型別、引用計數、是否引用)。理解「寫時複製」 (Copy-on-Write, COW) 機制是掌握傳值/參考行為的關鍵。
<?php
$a = 'hello';
$b = $a; // 傳值賦值
// 記憶體狀態:
// 符號表: $a → zval1, $b → zval1 (共享同一 zval)
// zval1: value='hello', refcount=2, is_ref=false
$b = 'world'; // 修改 $b
// 觸發 COW:複製 zval1 → zval2
// 符號表: $a → zval1(value='hello', refcount=1), $b → zval2(value='world', refcount=1)
echo $a; // hello
echo $b; // world
?>
<?php
$a = 'hello';
$b = &$a; // 參考賦值 (& 符號)
// 記憶體狀態:
// 符號表: $a → zval1, $b → zval1 (共享同一 zval)
// zval1: value='hello', refcount=2, is_ref=true
$b = 'world'; // 修改 $b
// is_ref=true,直接修改共享 zval,不複製
// 符號表: $a → zval1, $b → zval1
// zval1: value='world', refcount=2, is_ref=true
echo $a; // world (受影響!)
echo $b; // world
?>
| 宣告方式 | 呼叫方式 | 行為 | 適用場景 |
|---|---|---|---|
function($x) | foo($a) | 傳值 (COW) | 預設,唯讀參數 |
function(&$x) | foo($a) | 參考傳遞 | 需修改原變數、大陣列避免複製 |
function($x) | foo(&$a) | ⚠️ 已棄用 (PHP 5.4+) | 呼叫端強制參考,不推薦 |
<?php
// 需修改原變數:交換兩值
function swap(&$a, &$b): void
{
$tmp = $a;
$a = $b;
$b = $tmp;
}
$x = 1; $y = 2;
swap($x, $y);
echo "$x, $y"; // 2, 1
// 累加器:保持狀態
function counter(&$count): int
{
return ++$count;
}
$count = 0;
echo counter($count); // 1
echo counter($count); // 2
echo counter($count); // 3
// 大陣列避免複製 (PHP 7+ COW 已優化,通常不需參考)
function processLargeArray(array &$data): void
{
// 直接修改原陣列
$data[] = 'new_item';
}
?>
<?php
$arr = [1, 2, 3];
// ⚠️ 危險:foreach 參考迴圈後,$value 仍保持參考
foreach ($arr as &$value) {
$value *= 2;
}
// $arr = [2, 4, 6]
// 此時 $value 仍參考 $arr[2] (值為 6)
foreach ($arr as $value) { // 無 & 符號,但 $value 仍是參考!
// $value 會依序覆寫 $arr[0], $arr[1], $arr[2]
// 最後 $arr[2] 被覆寫為 $arr[1] 的值 (4)
}
// 結果: $arr = [2, 4, 4] 💥
// ✅ 正確做法:迴圈後立即 unset
foreach ($arr as &$value) {
$value *= 2;
}
unset($value); // 斷開參考關鍵!
// 或 PHP 7.0+ 使用非參考迴圈配合索引修改
foreach ($arr as $key => $value) {
$arr[$key] = $value * 2;
}
?>
<?php
class User {
public string $name;
public function __construct(string $name) { $this->name = $name; }
}
$user1 = new User('Alice');
$user2 = $user1; // 物件「傳值」實為複製識別符
// 兩個變數指向同一物件實例
$user2->name = 'Bob';
echo $user1->name; // Bob (屬性修改互相影響)
// 但重新賦值不影響對方
$user2 = new User('Charlie');
echo $user1->name; // Bob (未變)
echo $user2->name; // Charlie
// 函數參數同理
function rename(User $user, string $name): void
{
$user->name = $name; // 修改屬性:影響原物件
$user = new User('New'); // 重新賦值:不影響原變數
}
$user = new User('Original');
rename($user, 'Changed');
echo $user->name; // Changed
// 若需在函數中替換物件實例,必須用參考
function replace(User &$user, string $name): void
{
$user = new User($name); // 替換實例
}
$user = new User('Original');
replace($user, 'Replaced');
echo $user->name; // Replaced
?>
<?php
$arr1 = [1, 2, 3];
$arr2 = $arr1; // 陣列傳值賦值
// 陣列也是 COW:修改時才複製
$arr2[0] = 99;
// 此時才發生實際複製
echo $arr1[0]; // 1
echo $arr2[0]; // 99
// 巢狀陣列:淺拷貝
$nested1 = ['a' => [1, 2], 'b' => 3];
$nested2 = $nested1;
$nested2['a'][0] = 99; // 修改巢狀陣列元素
echo $nested1['a'][0]; // 99 💥 巢狀陣列仍共享!
// 深拷貝方案
$deepCopy = unserialize(serialize($nested1)); // 簡單但較慢
// 或遞歸複製
function deepCopy(array $arr): array
{
$copy = [];
foreach ($arr as $k => $v) {
$copy[$k] = is_array($v) ? deepCopy($v) : $v;
}
return $copy;
}
$nested3 = deepCopy($nested1);
$nested3['a'][0] = 88;
echo $nested1['a'][0]; // 99 (未受影響)
?>
| 場景 | 建議 | 理由 |
|---|---|---|
| 一般函數參數 | 傳值 | PHP 7+ COW 極佳,可讀性高 |
| 需修改原標量/陣列 | 參考參數 &$var | 明確意圖,避免返回值傳遞 |
| 大陣列只讀 | 傳值 | COW 不會真正複製 |
| 物件方法調用 | 傳值 (物件識別符) | 標準 OOP 行為 |
| 需替換物件實例 | 參考參數 &$obj | 修改呼叫端變數綁定 |
| foreach 修改陣列 | 索引修改或 unset($ref) | 避免參考殘留污染 |
| 遞歸資料結構複製 | 自訂深拷貝或 serialize | 淺拷貝不處理巢狀結構 |
<?php
function debugRef(mixed $var, string $name): void
{
// 使用 debug_zval_dump 觀察 refcount 與 is_ref
// 注意:呼叫函數本身會增加 refcount
echo "--- $name ---\n";
debug_zval_dump($var);
}
$a = 'test';
$b = $a;
$c = &$a;
debugRef($a, 'a (傳值給 b, 參考給 c)');
// 輸出: string(4) "test" refcount(3) is_ref=1
// refcount=3: $a, $b, $c + 函數參數
// is_ref=1: 因 $c 是參考,導致整組變為參考集合
debugRef($b, 'b (傳值)');
// 同樣輸出,因已成為參考集合一員
?>
& 標記 zval is_ref=true,所有綁定變數共享同一 zval,修改即時生效unset($ref) 清理,否則污染後續迴圈理解底層 zval 機制,就能預測所有變數操作行為,避免難以重現的 Bug。