版本差異
| PHP 版本 | 建構子方法名 | 備註 |
| PHP 4 | 類別同名方法 function ClassName() | |
| PHP 5.0 - 7.3 | __construct() 優先;若無則嘗試同名方法 | 同名方法觸發 E_DEPRECATED (PHP 7.0+) |
| PHP 8.0+ | 僅 __construct() | 同名方法視為普通方法,不再自動呼叫 |
相容寫法 (PHP 4 ~ 7.x)
<?php
class MyClass {
// PHP 5+ 建構子
public function __construct() {
echo "PHP 5+ 建構子執行\n";
$this->init();
}
// PHP 4 相容:同名方法呼叫 __construct()
public function MyClass() {
$this->__construct();
}
protected function init(): void {
// 實際初始化邏輯
}
}
$obj = new MyClass(); // 兩版本皆正常運作
?>
PHP 8.0+ 僅需 __construct()
<?php
class ModernClass {
public function __construct(
private readonly string $name,
private readonly int $id = 0
) {
// PHP 8 建構子屬性提升
}
}
?>
遷移檢查清單
- 全專案搜尋
function\s+\w+\s*\(\s*\)\s*\{ 找出同名建構子。
- 重構為
__construct(),將邏輯移入。
- 移除同名方法,或保留並標註
@deprecated 供靜態分析工具偵測。
- 執行測試套件確認行為一致。
其他魔術方法相容性
__destruct():PHP 5+ 才有,PHP 4 無析構子。
__call(), __get(), __set() 等:PHP 5+ 專屬。
- 舊代碼若大量使用 PHP 4 風格,建議維持在 PHP 5.6 LTS (已 EOL) 或重寫升級。