Working with Java Bridge

Windows

1. From the list of installed programs in your Control Panel, select Zend Server, and click Change.
   
   The Zend Server Installer is displayed.
2. Select Modify, and click Next.
   
   The Custom dialog is displayed.
3. Under PHP, select Zend Java Bridge, and click Next.
   The Zend Jave Bridge is installed.
4. When the setup is completed, click Finish.

5. Open Zend Server, and go to Configurations | Components.
6. From the components list, select the Zend Java Bridge.
7. In the Action bar, click .

8. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.
   For information on restarting in Zend Server, see Server Restart.

Linux

1. Depending on your version of PHP, run the following command:

aptitude install php-5.3-java-bridge-zend-server

aptitude install php-5.4-java-bridge-zend-server

aptitude install php-5.5-java-bridge-zend-server

2. In the UI, go to Configurations | Components.
3. From the components list, select the Zend Java Bridge.
4. In the Action bar, click .

Mac OS X

1. In the UI, go to Configurations | Components.
2. From the components list, select the Zend Java Bridge.
3. In the Action bar, click .
4. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.
   For information on restarting in Zend Server, see Server Restart.

Configuring the runtime environment:

Use the following command to run JavaMW:

java com.zend.javamw.JavaServer

For correct execution, the classpath should include the javamw.jar file in the directory where JavaMW is installed.

Example:

UNIX, Linux, IBM i and Mac <install_dir>/bin/javamw.jar

Windows <install_dir>\bin\javamw.jar

To test the Java Bridge connection:

Create a new PHP script to create a Java object, as in the example below:

<?php
// create Java object
  $formatter = new Java("java.text.SimpleDateFormat",
                        "EEEE, MMMM dd, yyyy 'at' h:mm:ss a zzzz");
  // Print date through the object
  print $formatter->format(new Java("java.util.Date"))."\n";
  // You can also access Java system classes
  $system = new Java("java.lang.System");
  print $system."\n"; // will use toString in PHP5
  print "Java version=".$system->getProperty("java.version")." <br>\n";
  print "Java vendor=".$system->getProperty("java.vendor")." <p>\n\n";
  print "OS=".$system->getProperty("os.name")." ".
	$system->getProperty("os.version")." on ".$system->getProperty("os.arch")." <br>\n"; ?>

If the Java Bridge is correctly installed and running, you should receive the following response:

Friday, June 13, 2008 at 8:45:57 PM U.S Daylight Time class java.lang.System Java version=1.6.0_06 Java vendor=Sun Microsystems Inc.
OS=Linux 2.6.25.3-18.fc9.i686 on i386

This output shows the date, Java version, vendor and operating system and indicates that the connection is complete.
If you receive an error message instead of the expected output information, one of the following problems may have occurred:

1. The Java Bridge is not installed

2. The Java Bridge extension is not running (Configurations | Components)

3. The Java Bridge Server needs to be restarted (Configurations | Components)

4. The requested .jar file does not appear in the environment's classpath.

Once the connection is established, you can start using the API to call Java objects from your PHP.

Example:

If you call a Java method that looks like this:

public void doSomething(int i);

Using what you would expect to work in PHP:

$var = "1" $javaObject->doSomething($var);

The Java Bridge throws an exception. To avoid this, use the following line of code to convert the parameter from a string to a numeric value before the Java Bridge passes it:

$javaObject->doSomething($var + 0);

To configure the component:

1. In the UI, go to Configurations | Components.
2. From the Components list, select the component.
   The Expanded view will display the directives associated with the component.
3. Review the assorted directives and their descriptions, and configure the component according to your personal preferences. For information on how to configure directives, see Working with Components.
4. In the Action bar, click .

5. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.
   For information on restarting in Zend Server, see Server Restart.

For information on configuring the component daemon directives, see Configuring Component Daemon Directives (Zend Session Clustering, Zend Deployment, Zend Java Bridge, Zend Job Queue, and Zend Monitor).