home client api server api protocol f.a.q. downloads

Installation Guide

Requirements

  1. The PHP/Java Bridge is pure Java JEE application. You need Java 1.4 or above running on any operating system or architecture.
  2. A standard JEE server or servlet engine is recommended to run the Java code. If you don't want to use it, you won't get any support from us. If you prefer a proprietary (non-JEE) application server please visit http://files.zend.com/help/Zend-Server/working_with_the_java_bridge.htm.
  3. Do not search for a PHP extension, java.so or php_java.dll. These extensions are obsolete. Everything needed to communicate with a Java servlet engine is part of PHP 5.

Installation

  • Test your PHP installation with:
    java -classpath JavaBridge.war TestInstallation
    If the test fails due to a missing "php-cgi" FastCGI SAPI, expect step no. 3 to fail, too.
  • Download and install original Apache Tomcat software (or any other supported servlet engine or application server) as a Windows or Unix service and copy JavaBridge.war to its autodeploy folder.
  • Browse to
    http://localhost:8080/JavaBridge
    and run the PHP and JSP examples. If this step fails due to a missing "php-cgi" FastCGI SAPI, run Apache/IIS PHP, see below.
  • Copy or symlink the created webapps/JavaBridge folder to the web server document root.
  • Browse to
    http://yourHost.com/JavaBridge
    and run the PHP examples through Apache/IIS PHP.

For further information please see the INSTALL.J2EE file from the documentation download.

Supported servlet engines and application servers

The following Java Application Server back-ends are supported:

Note for Jetty users: This server returns NULL for getRealPath(PATH). In order to allow PHP scripts to access the file system, you need to deploy an exploded application instead.

Supported HTTP servers

The following HTTP server front-ends are supported:

  • Apache,
  • IIS,
  • any supported Java Application Server listed above.

User contributed guides