PHP 透過 COM 元件呼叫 .NET (C#) 組件,是跨語言整合的經典方案。適用於:既有 C# 商務邏輯庫復用、呼叫 Windows 系統元件(Word/Excel/Outlook 自動化)、硬體裝置驅動程式多為 .NET 組件等場景。本文完整記錄從 C# 專案建立、強名稱簽名、GAC 註冊、COM 可見設定到 PHP 呼叫的全流程。
php_com_dotnet.dll 擴展(php.ini 啟用 extension=com_dotnet)dotnet new classlib -n HelloWorld -f net48
# 或使用 VS 建立「類別庫 (.NET Framework)」專案
using System.Runtime.InteropServices;
[assembly: ComVisible(true)] // 關鍵:允許 COM 呼叫
[assembly: Guid("YOUR-GUID-HERE")] // 類別庫 GUID
// IHello.cs
using System.Runtime.InteropServices;
[ComVisible(true)]
[InterfaceType(ComInterfaceType.InterfaceIsDual)] // 支援早期/晚期繫結
[Guid("YOUR-INTERFACE-GUID")]
public interface IHello {
string SayHello(string name);
int Add(int a, int b);
string GetSystemInfo();
}
// Hello.cs
[ComVisible(true)]
[ClassInterface(ClassInterfaceType.None)] // 不自動生成介面,強制走 IHello
[Guid("YOUR-CLASS-GUID")]
[ProgId("HelloWorld.Hello")] // ProgID:PHP 端用此字串建立物件
public class Hello : IHello {
public string SayHello(string name) {
return $"Hello, {name}! Current time: {DateTime.Now:yyyy-MM-dd HH:mm:ss}";
}
public int Add(int a, int b) {
return a + b;
}
public string GetSystemInfo() {
return $"OS: {Environment.OSVersion}, CLR: {Environment.Version}, Machine: {Environment.MachineName}";
}
}
或命令列產生:sn -k HelloWorld.snk
# 1. 建置 (Release)
dotnet build -c Release
# 2. 註冊 COM (需管理員權限)
# 使用 .NET Framework 附帶的 RegAsm.exe
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe HelloWorld.dll /codebase /tlb:HelloWorld.tlb
# 3. 安裝到 GAC (全域組件快取) - 強名稱組件必須
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\gacutil.exe /i HelloWorld.dll
# 驗證 GAC
gacutil /l HelloWorld
關鍵參數:
/codebase:允許從非 GAC 路徑載入(開發測試用,生產建議只用 GAC)/tlb:產生類型庫 (.tlb) 供早期繫結參考<?php
// test_com.php
try {
// 使用 ProgID 建立 COM 物件
$obj = new COM("HelloWorld.Hello") or die("無法建立 COM 物件\n");
// 呼叫方法
echo $obj->SayHello("PHP 開發者") . "\n";
echo "10 + 25 = " . $obj->Add(10, 25) . "\n";
echo $obj->GetSystemInfo() . "\n";
// 釋放 COM 物件
$obj = null;
echo "✅ COM 呼叫成功\n";
} catch (com_exception $e) {
echo "❌ COM 錯誤: {$e->getMessage()}\n";
echo "Code: {$e->getCode()}\n";
} catch (Exception $e) {
echo "❌ 一般錯誤: {$e->getMessage()}\n";
}
<?php
// C# 端定義
// void ProcessData(ref int[] numbers, out string summary);
// string[] GetNames();
// PHP 端呼叫
$numbers = [1, 2, 3, 4, 5];
// COM 陣列需用 VARIANT 包裝
$variantNumbers = new VARIANT($numbers, VT_ARRAY | VT_I4); // VT_I4 = 4-byte signed int
$summary = new VARIANT(null, VT_BYREF | VT_BSTR); // out 參數
$obj->ProcessData($variantNumbers, $summary);
// 取得修改後的陣列 (ByRef 會直接修改原 VARIANT)
$modified = $variantNumbers->value; // PHP 陣列
echo "Modified: " . implode(',', $modified) . "\n";
echo "Summary: " . $summary->value . "\n";
// 取得字串陣列
$names = $obj->GetNames();
// COM 回傳 SAFEARRAY 轉 PHP 陣列
if (is_array($names)) {
foreach ($names as $n) echo "- $n\n";
}
| 錯誤 | 原因 | 解決 |
|---|---|---|
| Class not registered | 未註冊 COM / ProgID 錯誤 | RegAsm /codebase、確認 ProgId 屬性 |
| Access denied / 80070005 | DCOM 權限不足 | dcomcnfg → 元件服務 → 電腦 → 我的電腦 → 內容 → COM 安全性 → 啟動與啟用權限 → 加入 IIS_IUSRS / 網路服務 |
| Type mismatch | 參數型別不符 | 使用 VARIANT 指定 VT_* 型別、確認 C# 簽名 |
| PHP 7/8 找不到 com_dotnet | 擴展未啟用 | php.ini: extension=com_dotnet (Windows 內建) |
| 64 位元相容 | IIS 應用程式集區「啟用 32 位元應用程式」 | 若 C# 為 x86,需啟用;若為 Any CPU/x64,勿啟用 |