Ejecutar codigo Java en PHP y viceversa

La interoperabilidad entre lenguajes Java y PHP es muy deseable para cualquier desarrollador, y sería ideal contar con alguna manera de hacer que estos dos lenguajes trabajen juntos de manera transparente ¿y para que queremos esto? bueno, hay muchísimas opciones, entre las que podemos destacar:

• reuso de componente ya existentes, pero en otro lenguaje
• le agregamos funcionalidad a nuestras aplicaciones mediante herramientas que nos dan otros lenguajes. Por ejemplo, podemos tener código PHP con multithreading (gracias a Java) o usar la enorme potencia de las excepciones de java, no disponible en versiones más viejas de PHP.
• Aprovechamos la eficiencia para ejecutar código PHP desde dentro de Java.

Para realizar esto utilizaremos PHP/Java Bridge,  una potente herramienta que nos permite ejecutar instanciar clases java y ejecutar su código desde PHP, y viceversa. Esto lo hace de manera muy sencilla, e incluso no es necesario conocer Java (o php, dependiendo del caso) para utilizarlo.

La página oficial tiene guías para instalarlo desde el código fuente, o utilizando un rmp, o incluso sobre Windows. Más información aquí: http://php-java-bridge.sourceforge.net/doc/installation.php

En distribuciones derivadas de Debian, como Ubuntu, que utilizan .deb como sistema de paquetes, la instalación es también muy sencilla. Asumiendo que ya tenemos apache y php5 instalado, instalamos los siguiente programas para tener todas las dependencias satisfechas:

sudo apt-get install libitext-java liblucene-java php5-cli

Luego, descargamos el  archivo php-java-bridge_5.2.2-1_i386.deb (recomiendo ir a la página de descargas para ver si hay una versión más nueva). Luego abrimos una consola y escribimos:

cd DIRECTORIO_DONDE_DESCARGAMOS_EL_ARCHIVO

sudo dpkg -i php-java-bridge_5.2.2-1_i386.deb

Listo, con esto ya lo tenemos instalado. ¿cómo se usa?

Supongamos que tenemos la siguiente clase Java:

import java.util.*;
import java.text.*;
 
public class HolaMundo {
 
public String saludarAlMundo() {
  Date hoy = new Date();
  return "Hola amigos, hoy es " + hoy;
}

 }

Desde PHP, podemos usarla asi:

<?phpjava_require ("/var/classes");  //directorio donde tenemos las clases Java
$java_obj = new Java("HolaMundo");
// llamamos al metodo saludarAlMundo
$str = $java_obj->saludarAlMundo();
echo $str;


?>

¿fácil no?

Updates:

que pasa si obtenemos un Call to undefined function java_require() in… o un Call to undefined function Java in … . Bueno, aparentemente, no esta todo bien instalado. Veamos la configuracion de php en java. Nos hacemos un phpinfo() y nos fijamos que dice la seccion de Java:

java

java support	Enabled
java bridge	5.2.2
java.java_home	no value
java.java	java
java.log_file	<stderr>
java.log_level	no value (use back-end’s default level)
java.security_policy	Off

no tenemos seteado el java_home! Tendremos q editar el archivo de configuracion de java. Abrimos una consola y escribimos:

sudo mcedit /etc/php5/apache2/conf.d/java.ini

buscamos la linea donde dice java_home, la decomentamos y escribimos la ruta completa hasta el directorio java, en mi caso /usr/lib/jvm/java-6-sun . Guardamos y reiniciamos el apache:

sudo /etc/init.d/apache2 restart

Ahora probamos nuevamente a ver si nos anda 😀 .

¿sigue sin andar? Bueno, vamos por la segura entonces…. Es muy probable que PHP no esté viendo el Java.inc y por eso esté rompiéndose. Vamos a buscar el archivo JavaBridge.jar y vamos a descomprimirlo dentro del include_path. Por ejemplo, mi include_path es /var/lib , con lo cual ahora tendré /var/lib/java y allí tendré dos directorios:

• META-INF
• php

Ahora, vamos a decirle al sr. PHP que incluya sí o sí el JavaBridge, y luego vamos a probarlo. Les dejo otro ejemplito, pero esta vez mas completito:

<?
require_once(«JavaBridge/META-INF/java/Java.inc»);$system = new Java(‘java.lang.System’);echo ‘Java version=‘ . $system->getProperty(‘java.version’) . ‘ <br />’;
echo ‘Java vendor=‘ . $system->getProperty(‘java.vendor’) . ‘<br />’;
echo ‘OS=’ . $system->getProperty(‘os.name’) . ‘ ‘ .
$system->getProperty(‘os.version’) . ‘ on ‘ .
$system->getProperty(‘os.arch’) . ‘<br />’;

$formater = new Java(‘java.text.SimpleDateFormat’,
«EEEE, MMMM dd, yyyy ‘at’ h:mm:ss a zzzz»);
echo $formater->format(new Java(‘java.util.Date’));

?>

Edit. 10/9/08

Les agrego un par de datos que creo que les pueden servir:

– muchas veces tira un error tipo: Exception: Invoke failed:[…] . ¿a qué se debe esto? Bueno, los motivos pueden ser varios, pero lo más común es que intentemos crear objetos y / o ejecutar métodos que se encuentran en otras clases (incluso dentro de archivos .jar ). Y si, muchas veces sucede que no los encuentra.

Una solucion es listar TODOS los jars en la funcion java_require (o java_autoload), separadas con punto y coma, y con el path completo. Ej: java_require(«/home/gonetil/lib.jar1;/home/gonetil/lib/jar2»); A veces son demasiados jars y esto puede ser un problema, ya que el código puede quedar muy extenso y atenta enormemente contra la extensibilidad (cada jar que se incorpore al proyecto Java requerirá que se modifique el proyeco php). Pero bueno, servir, sirve. Es importante que reinicien el servidor web para asegurarse que los cambios sean efectivos.

Otra solución es hacer que el classpath incluya al directorio donde estan los jars o las clases adicionales (los .class). Y por practicidad, yo pondría todo lo que es «java» allí (las clases que yo hice, y las que necesito). ¿cómo lo hago? Vamos a suponer que todas mis clases Java (archivos class, jar y war) se encuentran en /var/www/clases:

En Linux, tienen que fijarse con que usuario se ejecuta el Apache y editar su archivo de profile:

• si lo ejecutan con su usuario, tendran que editar el /home/usuario/.bash_profile
• si lo ejecutan como root, tendran que editar el archivo /root/.bashrc
• sino, tambien pueden editar el archivo /etc/environment

Más allá de cuál archivo modifiquen, lo que tienen que poner es:

CLASSPATH = /var/www/clases

export CLASSPATH

¡Listo! Si editaron el profile de su usuario, simplemente cierren y abran la sesion nuevamente. Sino, deberán reiniciar el sistema. Pueden verificar si esto les anduvo abriendose una terminal y ejecutando el comando env | grep CLASSPATH, (si editaron el classpath del usuario roor, ejecuten primero un sudo su y luego tiren el comando env | grep CLASSPATH ).

En Windows, la cosa es muy parecida. Hacemos clic en Mi PC con el boton derecho, y vamos a propiedades. Allí vamos a avanzadas-> variables de entorno. Y agregamos (o editamos) la variable CLASSPATH del sistema (para asegurarnos que cualquier usuario la verá). Si las clases están en c:wwwclasses, ese mismo valor deberá contener nuestra variable CLASSPATH.

Un último dato.

Apache (y asumo que la mayoría de los servidores web) mantiene las clases Java en una cache propia. Esto significa que por más que hagamos cambios en los archivos java y los recompilemos (o sea, cambiemos los .class, .jar o .war), no veremos los cambios. La única solución viable que encontré para este problema es reiniciar el Apache (si les tira un error, intenten varias veces).

• En Linux, con el comando /etc/init.d/apache2 restart . Quizás necesiten hacerlo con sudo.
• En Windows, vamos a ejecutar y escribimos: net stop apache2 y luego net start apache2 .

De todos modos, ambos sistemas poseen herramientas gráficas para controlar estos servicios (he escrito un post por aquí al respecto).

Edit 19/06/2009:

En esta semana instale el JavaBridge en otro servidor, esta vez con Debian 64 en vez de Ubuntu. Esta vez instale el php-java-bridge 5.4.4.2, pero  bajando los fuentes y compilandolo. El tema es bastante simple:

Lo descomprimimos

tar xzfv php-java-bridge_5.xxx.tar.gz

lo preparamos para php:
phpize
y lo instalamos, a la vieja usanza:
En Ubuntus viejos: ./configure –with-java=/usr/lib/jvm/java-6-sun-1.6.0.03,/usr/lib/jvm/java-6-sun-1.6.0.03
En Hardy/Interpid o Debian: ./configure –with-java=/usr/lib/jvm/java-6-sun,/usr/lib/jvm/java-6-sun

En otras distros, tendran que ver donde tienen instalado java ( con el comando whereis java)

(en realidad, /usr/lib/jvm/java-6-sun es un enlace simbolico a /usr/lib/jvm/java-6-sun-1.6.0.07 o el que corresponda)

Luego,
make
chmod +x install.sh
./install.sh

Nos hace dos preguntas, a la primera le damos yes y a la segunda no. Una vez instalado, reiniciamos el apache.

Ahora, si tiramos un phpinfo(), veremos que tenes el PhpJavaBridge andando, pero no nos va a andar de todo. ¿por que no? Porque PHP intenta conectarse con el JavaBridge en el puerto 8080, y obviamente no hay nada escuchando alli). Lo que yo hice fue personalizar un script en bash que levanta el deamon en el puerto 8080 automaticamente en el inicio (y que me permite controlarlo mediante stop, start, status, etc…). Es bastante simple, solo tienen que copiar y pegar, y bueno, asegurarse que las variables de configuracion de las primeras lineas se ajustan a sus necesidades:

#! /bin/sh

#Este archivo inicia el JavaBridge. Hay que ponerlo en /etc/init.d en el servidor. Hecho esto,
# hay que hacerlo ejecutable:
# chmod +x /etc/init.d/JavaBridge-Loader.sh
# y finalmente, decile al sistema que lo levante al inicio
# update-rc.d JavaBridge-Loader.sh defaults 
#Original /etc/init.d/skeleton modified for http://mydebian.blogdns.org

# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="JavaBridge para ejecutar Java dentro de PHP"
NAME="JavaBridge"
DAEMON=/usr/bin/java
DAEMON_ARGS="-jar /usr/share/java/JavaBridge.jar SERVLET:8080 3 /var/log/JavaBridge.log"
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/javabridge
#Lo ejecuto con el mismo usuario de Apache
USER=www-data

# No tocar aqui abajo!!!!

# Load the VERBOSE setting and other rcS variables
. /lib/init/vars.sh

# Define LSB log_* functions.
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
. /lib/lsb/init-functions

#
# Function that starts the daemon/service
#
do_start()
{

 start-stop-daemon -b --start --quiet --chuid $USER -m -p $PIDFILE --exec $DAEMON -- $DAEMON_ARGS \
 || return 2
}

#
# Function that stops the daemon/service
#
do_stop()
{
 start-stop-daemon --stop --quiet --oknodo --pidfile $PIDFILE
 RETVAL="$?"
 rm -f $PIDFILE
 return "$RETVAL"
}

case "$1" in
 start)
 [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
 do_start
 case "$?" in
 0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
 2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
 esac
 ;;
 stop)
 [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
 do_stop
 case "$?" in
 0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
 2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
 esac
 ;;
 restart)
 #
 # If the "reload" option is implemented then remove the
 # 'force-reload' alias
 #
 log_daemon_msg "Restarting $DESC" "$NAME"
 do_stop
 case "$?" in
 0|1)
 do_start
 case "$?" in
 0) log_end_msg 0 ;;
 1) log_end_msg 1 ;; # Old process is still running
 *) log_end_msg 1 ;; # Failed to start
 esac
 ;;
 *)
 # Failed to stop
 log_end_msg 1
 ;;
 esac
 ;;
 *)
 echo "Usage: $SCRIPTNAME {start|stop|restart}" >&2
 exit 3
 ;;
esac

:

Un par de datos importantes:

Primero le decimos al script donde encontrar el binario java (DAEMON=/usr/bin/java), y luego le indicamos como levantar el deamon ( DAEMON_ARGS=»-jar /usr/share/java/JavaBridge.jar SERVLET:8080 3 /var/log/JavaBridge.log» ). Si prestan atencion, veran qe alli se indica el puerto (8080), el nivel de Log (3), donde encontrar el Jar de JavaBridge y donde poner los logs (muy utiles!!!) . Tambien se indica con que usuario debe correrse el script (USER=www-data).

Bueno, listo! Copiamos el script en /etc/init.d y le decimos al sistema que lo levante automaticamente:

sudo cp JavaBridge-loader.sh /etc/init.d

sudo update-rc.d JavaBridge-Loader.sh defaults

En mi corta experiencia, esta solucion hace al JavaBridge mucho mas estable y mas facil de controlar, y la verdad lo recomiendo. Saludos.

DAEMON=/usr/bin/java
DAEMON_ARGS="-jar /usr/share/java/JavaBridge.jar SERVLET:8080 3 /var/log/JavaBridge.log"