PHP 參考 (`&`) 讓**多個名稱指向同一個變數容器** (zval)。不同於 C 指標存儲記憶體位址,PHP 參考是符號表別名,修改任一別名皆影響同一資料。
<?php
$a = 'ABC';
$b = &$a; // $b 成為 $a 的別名
echo $a; // ABC
echo $b; // ABC
$b = 'EFG';
echo $a; // EFG (受影響)
echo $b; // EFG
// 取消參考
unset($b); // 僅移除別名,$a 保留值
$a = 'XYZ';
echo $b; // Notice: Undefined variable
<?php
$arr = [1, 2, 3];
foreach ($arr as &$v) { $v *= 2; }
unset($v); // 關鍵!否則 $v 仍參考最後元素
$arr2 = $arr; // 複製陣列 (複製值,含參考關係)
$arr2[0] = 99;
echo $arr[0]; // 99 ! 因為 $arr[0] 和 $arr2[0] 共享同一 zval
// 正確複製:先解除參考
unset($v);
$arr3 = $arr; // 現在是真正獨立複製
<?php
function add100(int &$num): void {
$num += 100;
}
$value = 1;
add100($value);
echo $value; // 101
// ❌ 錯誤:字面值無法傳址
// add100(1); // Fatal error: Only variables can be passed by reference
// call_user_func_array 需顯式參考
function increment(&$n) { $n++; }
$c = 0;
call_user_func_array('increment', [&$c]); // 注意 &$c
echo $c; // 1
<?php
function &getStaticCounter() {
static $count = 0;
$count++;
return $count;
}
$a = getStaticCounter(); // 普通賦值:複製值 (1)
$a = 5;
$a = getStaticCounter(); // 2 (static 變數未變)
$b = &getStaticCounter(); // 參考回傳:$b 綁定 static $count
$b = 5; // 修改 static $count 為 5
$a = getStaticCounter(); // 6 (受影響!)
echo $a; // 6
<?php
function &findUser(array &$users, int $id): ?array {
foreach ($users as &$user) {
if ($user['id'] === $id) return $user;
}
$null = null;
return $null; // 必須回傳變數參考
}
$users = [['id'=>1,'name'=>'A'], ['id'=>2,'name'=>'B']];
$userRef = &findUser($users, 1);
$userRef['name'] = 'A+';
print_r($users[0]['name']); // 'A+'
// PHP 4
$obj = new StdClass();
$obj->val = 1;
$copy = $obj; // 複製物件
$copy->val = 2;
echo $obj->val; // 1 (獨立)
<?php
class A { public $abc = 'ABC'; }
$b = new A();
$c = $b; // 指向同一物件實例
echo $b->abc; // ABC
echo $c->abc; // ABC
$b->abc = 'DEF';
echo $c->abc; // DEF (共享狀態)
// 建立真正副本需用 clone
$d = clone $b;
$d->abc = 'GHI';
echo $b->abc; // DEF (不受影響)
<?php
class Foo {
protected $name;
public function __construct($str) { $this->name = $str; }
public function __toString() { return "my name is \"$this->name\""; }
public function setName($str) { $this->name = $str; }
}
$bar = new Foo('bar');
$baz = &$bar; // 顯式參考
$bar->setName('baz');
echo $baz; // my name is "baz" (共享)
// 多物件共享同一實例
$m1 = new class($bar) { public function __construct(public Foo $foo) {} };
$m2 = new class($bar) { public function __construct(public Foo $foo) {} };
$m2->foo->setName('MasterTwo');
echo $m1->foo; // my name is "MasterTwo" (共享)
<?php
class Talker {
private $data = 'Hi';
public function &get(): string { // 參考回傳私有屬性
return $this->data;
}
public function out() { echo $this->data; }
}
$aa = new Talker();
$d = &$aa->get(); // $d 直接綁定 $aa->data
$aa->out(); // Hi
$d = 'How';
$aa->out(); // How
$d = 'Are';
$aa->out(); // Are
$d = 'You';
$aa->out(); // You
// 輸出: HiHowAreYou
| 操作 | 記憶體影響 | 速度 | 建議 |
|---|---|---|---|
| 變數參考賦值 | 不增加 zval,增加符號表條目 | 極快 | 大字串/陣列傳遞避免複製 |
| 函數參考參數 | 避免複製 | 快 | 需修改原值時使用 |
| 參考回傳 | 共享 zval | 快 | 慎用,增加耦合 |
| foreach 參考 | 元素變參考 | 快 | 循環後必須 unset($v) |
| 物件傳遞 | 傳遞 handle (約 8 bytes) | 極快 | 預設即為參考語意 |
<?php
// 檢查是否為參考
function isRef(&$var) { return true; } // 能傳入即為參考或可被參考
$x = 1; $y = &$x;
var_dump(isRef($x)); // true
var_dump(isRef($y)); // true
// debug_zval_dump 顯示 refcount (含內部引用)
$a = 'test';
$b = &$a;
debug_zval_dump($a); // string(4) "test" refcount(3) (含呼叫端、$a、$b、函數參數)
理解參考機制,能寫出高效且正確的 PHP 代碼,避免「神秘的值被修改」等難以追蹤的 Bug。