PHP 無法直接編譯為 EXE，但可通過打包工具實現桌面應用分發

PHP 是解釋型腳本語言，無法像 C/C++ 那樣直接編譯為原生機器碼 EXE。但可以通過打包工具將 PHP 解釋器、擴展、腳本文件打包成單一可執行文件，實現「類 EXE」分發。本文梳理主流方案與避坑指南。

主流打包工具對比

方案選型建議

1. 內部 CLI 工具：composer require box-project/box 打包 PHAR，配合 PHP 便攜版 分發（解壓即用）。
2. GUI 桌面應用：ExeOutput for PHP（商業）或 PHP-GTK（舊、難維護）或 WebView2 + PHP 內置服務器（自研輕量方案）。
3. 高性能/原生 EXE：評估 PeachPie，將核心邏輯遷移至 .NET，前端用 WPF/MAUI/Blazor。
4. 舊項目維護：若必須用 PHPCompiler，準備好應對 PHP 4/5 時代的兼容性坑（如 dl()、線程安全）。

PHAR 打包實戰（推薦 CLI 方案）

// 1. 安裝 Box
composer global require box-project/box --dev

// 2. 編寫 box.json.dist
{
    "chmod": "0755",
    "directories": ["src", "vendor"],
    "files": ["config.php"],
    "main": "src/app.php",
    "output": "myapp.phar",
    "stub": "cli-stub.php",
    "compression": "GZ",
    "algorithm": "SHA256"
}

// 3. 構建
php -d phar.readonly=0 $(which box) compile

// 4. 分發：將 myapp.phar + PHP 便攜版目錄打包成 zip
// 用戶解壓後運行：php myapp.phar 或 ./myapp.phar (Linux/macOS + chmod +x)

關鍵避坑提醒

• 動態擴展加載：打包後無法動態 dl() 加載擴展，所需擴展必須編譯進 PHP 運行時或預先在 php.ini 啟用。
• 文件系統訪問：PHAR 默認只讀，寫入需用真實路徑 __DIR__ 而非 phar://。
• 路徑解析：__FILE__ 在 PHAR 中指向封存內部，需用 Phar::running() 獲取真實路徑。
• Windows 執行策略：PowerShell 執行策略可能阻腳本，分發時建議提供 .bat 啟動腳本。

總結：PHP 不能「編譯成 EXE」，但成熟的打包工具已能滿足絕大多數分發需求。選型核心看目標場景（CLI/GUI/Web）、性能要求、維護成本三個維度。