在 WebSphere Application Server Community Edition 上運行 PHP：PHP Integration Kit 整合指南

背景與動機

PHP 靈活、Java 強健。PHP Integration Kit 讓 IBM WebSphere AS CE (WAS CE) 支援 PHP 腳本，實現：

• PHP 腳本併入 J2EE 應用 (WAR 包部署)
• 容器管理安全性 (CMS) 保護 PHP 資源
• 管理主控台部署/更新 PHP 應用
• Java Filter 修飾 PHP 輸出

運作原理

1. Servlet 容器配置 FastCGI Filter
2. PHP 請求轉發至 FastCGI Filter
3. Launcher 啟動 PHP-CGI 進程
4. PHP 引擎執行腳本，回傳輸出
5. Filter 將輸出包裝為 Servlet 回應

注意：Kit 不重寫 PHP 引擎，使用系統現有 PHP-CGI，支援多版本切換。

部署打包規範 (WAR 結構)

myphpapp.war/
├── WEB-INF/
│   ├── web.xml          # 定義 FastCGI Filter、PHP 處理對應
│   ├── php.ini          # 可選，覆蓋 PHP 設定
│   └── lib/             # 可選，Java 庫
├── index.php            # PHP 入口
├── scripts/             # PHP 腳本
└── resources/           # 靜態資源

web.xml 關鍵配置

<web-app>
  <filter>
    <filter-name>PhpCgiFilter</filter-name>
    <filter-class>org.apache.php.java.servlet.PhpCgiFilter</filter-class>
    <init-param>
      <param-name>phpExecutable</param-name>
      <param-value>/usr/bin/php-cgi</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>PhpCgiFilter</filter-name>
    <url-pattern>*.php</url-pattern>
  </filter-mapping>
</web-app>

支援平台與限制

• Windows / Linux
• Alpha 階段，不建議生產環境使用
• 來源：IBM alphaWorks

現代替代方案

當前架構下，PHP 與 Java 整合更常見做法：

1. 微服務架構：PHP (Laravel/Symfony) + Java (Spring Boot) 獨立部署，REST/gRPC 通訊
2. API Gateway：Kong、Zuul 統一入口，路由至對應服務
3. 共享資料層：共用 MySQL/Redis，應用層解耦
4. GraalVM Polyglot：同一運行時執行 PHP (Quercus) 與 Java，實驗性

結語

PHP Integration Kit 為早期 Java EE 整合 PHP 提供了創新路徑，但現代架構傾向服務化解耦而非容器級耦合。理解其原理有助於掌握跨語言整合演進脈絡。