PHP hello world module (jar version)

Introduction

One of the advantages of using Resin's implementation of PHP is that you can create your own library of functions written in Java and access them from within PHP. The following article provides a brief tutorial on how to do this.

The article assumes that you have already properly installed Resin on your computer. Please see the related article PHP Hello World for more information on installing Resin for the first time.

Step 1: Create Example.jar and place it in the appropriate directory

Create your development environment

The steps that follow assume you are working in a Windows environment. If you are working within Unix (or Linux or Mac), the same steps will work. Just be sure to modify the commands where necessary.

c:\Documents and Settings\Charles >cd c:\
c:\> md sandbox
c:\sandbox> md src
c:\sandbox> md classes
c:\sandbox> cd src
c:\sandbox\src> md example
c:\sandbox\src> md META-INF
c:\sandbox\src> cd META-INF
c:\sandbox\src\META-INF> md services

Create HelloWorldSampleClass.java

Copy the following file into your favorite text editor (notepad will do) and save it to the c:\sandbox\src\example directory.

HelloModule.java

package example;

import com.caucho.quercus.module.AbstractQuercusModule;

public class HelloModule extends AbstractQuercusModule {

  public String hello_test(String name)
  {
    return "Hello, " + name;
  }
}

Create com.caucho.quercus.QuercusModule

Copy the following one line file and save it to the c:\sandbox\src\META-INF\services directory. Make sure that the file name is exactly "com.caucho.php.PhpModule"

com.caucho.quercus.QuercusModule

example.HelloModule

Compile and Jar the files

Navigate to c:\sandbox

C:\sandbox>javac -d classes -classpath c:\resin-3.0.13\lib\quercus.jar src\example\*.java

Note: In my installation of Resin, the file httpd.exe is located in c:\resin-3.0.13. If you have installed Resin in a different directory change the above classpath appropriately.

Create a META-INF\services directory within classes and copy com.caucho.quercus.QuercusModule.

c:\sandbox> cd classes
c:\sandbox\classes> md META-INF
c:\sandbox\classes> cd META-INF
c:\sandbox\classes\META-INF> md services
c:\sandbox\classes\META-INF> cd services
c:\sandbox\classes\META-INF\services> copy ..\..\..\src\META-INF\services\com.caucho.quercus.QuercusModule .

Change directory to c:\sandbox and run the jar utility.

c:\sandbox\classes\META-INF\services> cd c:\sandbox
c:\sandbox> jar cvf example.jar classes

Step 2: Create and browse the PHP page

javahello.php

<?php

$name = say_hello("Charles");
echo $name;

?>

Conclusion

Enjoy