PHP Java Bridge：在 PHP 中調用 Java 類庫完整指南

2. php.ini 配置

[java]
extension=php_java.dll
java.home = "C:/Program Files/Java/jdk-17"
java.library = "C:/Program Files/Java/jdk-17/bin/server/jvm.dll"
java.library.path = "C:/php/ext"
java.class.path = "C:/php/ext/php_java.jar;C:/java-bridge/lib/*;C:/my-java-libs/*"

; 生產環境建議 Servlet 模式，不需上述配置，改用：
; java.host = 127.0.0.1
; java.port = 8080
; java.servlet = On

3. Servlet 模式部署（推薦）

1. 下載 JavaBridge.war（SourceForge php-java-bridge 專案）
2. 部署到 Tomcat 9+：webapps/JavaBridge.war
3. 啟動 Tomcat，訪問 https://localhost:8080/JavaBridge/ 驗證
4. PHP 端配置：

   [java]
   extension=php_java.dll
   java.host = 127.0.0.1
   java.port = 8080
   java.servlet = On
   java.context = /JavaBridge

基礎調用範例

<?php
// 測試連線
$system = new Java('java.lang.System');
echo "Java 版本: " . $system->getProperty('java.version') . "<br>";
echo "廠商: " . $system->getProperty('java.vendor') . "<br>";
echo "OS: " . $system->getProperty('os.name') . " " . $system->getProperty('os.version') . "<br>";

// 日期格式化
$formatter = new Java('java.text.SimpleDateFormat', 'yyyy-MM-dd HH:mm:ss z');
echo "當前時間: " . $formatter->format(new Java('java.util.Date')) . "<br>";

// 使用自定義類（需在 java.class.path 中）
try {
    $myUtil = new Java('com.mycompany.utils.StringUtils');
    $result = $myUtil->encrypt('sensitive-data', 'AES/ECB/PKCS5Padding');
    echo "加密結果: $result";
} catch (JavaException $e) {
    echo "Java 異常: " . $e->getMessage();
}
?>

進階用法

陣列與集合互轉

<?php
// PHP 陣列 → Java List
$phpArray = ['apple', 'banana', 'orange'];
$javaList = new Java('java.util.ArrayList');
foreach ($phpArray as $item) {
    $javaList->add($item);
}

// Java List → PHP 陣列
$javaArrayList = $someJavaObj->getStringList();
$phpArray = [];
for ($i = 0; $i < $javaArrayList->size(); $i++) {
    $phpArray[] = $javaArrayList->get($i);
}

// Java Map ↔ PHP 關聯陣列
$javaMap = new Java('java.util.HashMap');
$javaMap->put('key1', 'value1');
$javaMap->put('key2', 123);

// 遍歷
$iterator = $javaMap->entrySet()->iterator();
while ($iterator->hasNext()) {
    $entry = $iterator->next();
    echo $entry->getKey() . ' = ' . $entry->getValue() . "<br>";
}
?>

異常處理

<?php
try {
    $obj = new Java('com.example.RiskyClass');
    $obj->dangerousMethod();
} catch (JavaException $e) {
    // Java 異常包裝為 PHP 異常
    error_log("Java Error: {$e->getMessage()}\nStack: {$e->getTraceAsString()}");
    // 可獲取 Java 異常類名
    echo "Java 異常類: " . $e->getJavaClassName();
} catch (Exception $e) {
    // PHP 端異常（如類不存在、通訊失敗）
    error_log("PHP Error: {$e->getMessage()}");
}
?>

效能優化建議

• 連線池：Servlet 模式下 Bridge 內部維護連線池，避免頻繁建立連線
• 批量調用：設計粗粒度 Java 方法，減少跨語言調用次數
• 序列化：大量資料傳輸考慮 JSON/Protobuf 序列化後傳字串，再反序列化
• 異步模式：耗時 Java 操作提交到 Java 端線程池，PHP 輪詢或回調獲取結果

常見問題排查

替代方案對比

建議：現代架構優先考慮 REST/gRPC 微服務，將 Java 能力封裝為獨立服務。僅在遷移期、極強耦合場景、或無法拆分服務時使用 PHP-Java Bridge。生產環境務必使用 Servlet 模式隔離進程，並建立完善監控（JVM 指標、Bridge 連線池狀態、調用延遲/錯誤率）。