PHP in GlassFish using Caucho Quercus

Quercus is
Caucho Technology's 100% Java implementation of
PHP 5. Ludo

described the steps to deploy PHP web applications on
GlassFish. Caucho has released a new
version of Quercus since then. This blog
entry is an update to the

steps described earlier.

1. First, PHP-enable GlassFish.
   1. Unjar
      quercus-3.1.1.war and copy the JAR files in "WEB-INF/lib"
      directory to "GLASSFISH_HOME/domains/domain/lib" directory. That's it!
      Although the original entry requires to copy the JARs in "GLASSFISH_HOME/lib/addons"
      directory but that
      didn't work.
2. Create a PHP web application
   1. Create a new Web application project, lets say "hellophp",
      using NetBeans IDE and choose
      GlassFish as the server.
   2. Replace the contents of "web.xml" with the following fragment:
      
      
      
      

      <samp>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;<br>
      		&lt;web-app xmlns=&quot;http://java.sun.com/xml/ns/javaee&quot;<br>
      &nbsp; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;<br>
      &nbsp; xsi:schemaLocation=&quot;http://java.sun.com/xml/ns/javaee 
      		http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd&quot;<br>
      &nbsp; version=&quot;2.5&quot;&gt; <br>
      &nbsp; &lt;description&gt;Caucho Technology's PHP Implementation, Running on GlassFish 
      		Java EE 5&lt;/description&gt; <br>
      &nbsp; &lt;servlet&gt;<br>
      &nbsp;&nbsp;&nbsp; &lt;servlet-name&gt;Quercus Servlet&lt;/servlet-name&gt;<br>
      &nbsp;&nbsp;&nbsp; &lt;servlet-class&gt;com.caucho.quercus.servlet.QuercusServlet&lt;/servlet-class&gt;<br>
      &nbsp; &lt;/servlet&gt; <br>
      &nbsp; &lt;servlet-mapping&gt;<br>
      &nbsp;&nbsp;&nbsp; &lt;servlet-name&gt;Quercus Servlet&lt;/servlet-name&gt;<br>
      &nbsp;&nbsp;&nbsp; &lt;url-pattern&gt;*.php&lt;/url-pattern&gt;<br>
      &nbsp; &lt;/servlet-mapping&gt; <br>
      &nbsp; &lt;welcome-file-list&gt;<br>
      &nbsp;&nbsp;&nbsp; &lt;welcome-file&gt;index.php&lt;/welcome-file&gt;<br>
      &nbsp; &lt;/welcome-file-list&gt;<br>
      		&lt;/web-app&gt;</samp>

      
      
      
      
      This will declare PHP engine as the servlet.
   3. Add a new page "index.php" in "Web pages"
      folder. The contents of the page are:
      
      
      
      

      &lt;?php<br>
      		echo &quot;Hello World!&quot;;<br>
      		phpinfo();<br>
      		?&gt;<br>
      		<br>
      		

      This page prints "Hello World!" on the browser and some
      configuration settings of PHP. The directory structure of the created project looks like:
      
      
      
      

      META-INF/<br>
      		META-INF/MANIFEST.MF<br>
      		WEB-INF/<br>
      		WEB-INF/classes/<br>
      		WEB-INF/sun-web.xml<br>
      		WEB-INF/web.xml<br>
      		index.jsp<br>
      		index.php<br>
      		<br>
      		

      Notice, "index.jsp" is only a template
      file to get started with JSPs and "sun-web.xml"
      is GlassFish-specific deployment descriptor. These files are
      not required for this PHP application although it does not hurt to leave
      them in the webapp as well.
3. Deploy the application by right-clicking on the project and selecting "

   Deploy 
   	Project

   ". Your first PHP application in GlassFish is now deployed at
   "http://localhost:8080/hellophp/index.php".

Now that you have verified that your GlassFish is ready to host PHP
applications, try the different applications that are described in

Ludo's blog.

Technorati:
php
glassfish
caucho
quercus