萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 呼叫 Java 類別實戰(一):Windows 環境 JDK、PHP-Java Bridge 安裝與設定全攻略

架構概覽

PHP 透過 php_java.dll(PHP 4/5 時代)或 Java Bridge(PHP 5.3+,獨立 Servlet 容器)與 JVM 互操作。本文以經典 php_java.dll 為例,說明 Windows 下完整安裝配置流程。

步驟 1:安裝 JDK

  1. 下載 JDK(建議 JDK 8/11/17 LTS 版本),安裝至 C:\jdk。
  2. 設定環境變數:
    • JAVA_HOME=C:\jdk
    • PATH=%PATH%;%JAVA_HOME%\bin
  3. 驗證:java -version、javac -version 正常輸出。

步驟 2:配置 php.ini 啟用 Java 擴充

; php.ini
extension=php_java.dll

[java]
; Java 虛擬機器庫路徑(jvm.dll 所在目錄)
java.library.path = "C:\jdk\jre\bin\server"  ; 或 client 資料夾

; Java 類別搜尋路徑(包含 php_java.jar 及自訂類別目錄)
java.class.path = "C:\php\extensions\php_java.jar;C:\myclasses"

; 可選:JVM 啟動參數
; java.library = C:\jdk\jre\bin\server\jvm.dll
關鍵點:php_java.jar 必須包含在 java.class.path 中,它是 PHP-Java 橋接的核心類別。自訂類別目錄(如 C:\myclasses)同樣需加入此路徑。

步驟 3:重啟 Web 伺服器並驗證

重啟 Apache/IIS。建立 test_java.php:

<?php
try {
    $system = new Java('java.lang.System');
    echo "Java version: " . $system->getProperty('java.version') . "
"; echo "Java vendor: " . $system->getProperty('java.vendor') . "
"; echo "OS: " . $system->getProperty('os.name') . " " . $system->getProperty('os.version') . " on " . $system->getProperty('os.arch') . "
"; $formatter = new Java('java.text.SimpleDateFormat', "EEEE, MMMM dd, yyyy 'at' h:mm:ss a zzzz"); echo "Current Time: " . $formatter->format(new Java('java.util.Date')) . "
"; echo "PHP-Java Bridge 運作正常!"; } catch (JavaException $e) { echo "錯誤: " . $e->getMessage(); } ?>

預期輸出

Java version: 17.0.9
Java vendor:  Eclipse Adoptium
OS:           Windows 11 10.0 on amd64
Current Time: 星期三, 十月 18, 2023 at 10:22:45 上午 CST
PHP-Java Bridge 運作正常!

常見安裝失敗原因

  1. php_java.dll 版本不匹配 PHP 版本/Thread Safety:必須下載對應 PHP 版本(如 5.6, 7.0, 7.1...)、TS/NTS 正確的 dll。
  2. java.library.path 指向錯誤:必須指向包含 jvm.dll 的目錄(通常是 jre\bin\server 或 client)。
  3. java.class.path 路徑分隔符:Windows 用分號 ;,Linux 用冒號 :。
  4. 權限不足:Web 伺服器進程使用者需對 JDK 目錄、自訂類別目錄有讀取/執行權限。
  5. 防火牆/殺毒軟體攔截:JVM 啟動可能建立本地 Socket 通訊,需允許。

Linux 環境快速部署提要

# 1. 安裝 JDK
sudo apt install openjdk-11-jdk-headless

# 2. 安裝 PHP Java Bridge (獨立 WAR 部署方式,推薦)
# 下載 JavaBridge.war 部署至 Tomcat/Jetty
# PHP 端透過 HTTP 連接 Java Bridge Servlet

# 3. 或編譯 php_java.so (較複雜,需 PHP 原始碼、JDK headers)
# 現代專案強烈建議改用 REST/gRPC 微服務架構替代

結語

PHP-Java Bridge 安裝配置涉及 JVM 路徑、類別路徑、DLL/so 版本匹配等細節,極易踩坑。成功建立連線後,可透過 new Java('fully.qualified.ClassName') 實例化任意 Java 類別,呼叫方法、存取屬性。但鑑於維護成本與效能,新專案請優先考慮微服務架構,將 Java 功能獨立部署,PHP 透過標準協議調用。

copyright © 萬盛學電腦網 all rights reserved