Quercus: Tomcat
From Resin 3.0
(New page: Quercus is implemented primarily as a servlet and it will run in any application server including Tomcat. =Requirements= # Java 1.5 or higher # Quercus WAR download at http://quercus.cauc...) |
|||
| Line 10: | Line 10: | ||
=Quick start= | =Quick start= | ||
| − | The Quercus servlet is just a plain servlet | + | The Quercus WAR is ready to run on Tomcat by placing it inside Tomcat's <code>webapps</code> directory. |
| + | |||
| + | The Quercus servlet is just a plain servlet and it is configured in the web.xml. | ||
==web.xml== | ==web.xml== | ||
| Line 80: | Line 82: | ||
</code> | </code> | ||
| − | + | Quercus will place the compiled files in WEB-INF/work. | |
Latest revision as of 02:21, 21 July 2009
Quercus is implemented primarily as a servlet and it will run in any application server including Tomcat.
Contents |
Requirements
- Java 1.5 or higher
- Quercus WAR download at http://quercus.caucho.com
Optional
- MySQL Connector/J Driver
- Java Mail (javax.mail jar)
Quick start
The Quercus WAR is ready to run on Tomcat by placing it inside Tomcat's webapps directory.
The Quercus servlet is just a plain servlet and it is configured in the web.xml.
web.xml
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5">
<display-name>Quercus on Tomcat</display-name>
<servlet>
<servlet-name>Quercus Servlet</servlet-name>
<servlet-class>com.caucho.quercus.servlet.QuercusServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Quercus Servlet</servlet-name>
<url-pattern>*.php</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.php</welcome-file>
</welcome-file-list>
</web-app>
Compilation
Quercus can compile PHP files down to Java bytecodes for faster performance. However, this feature was only available when Quercus was running inside Resin. Since 4.0.1, this constraint no longer exists and Quercus compilation is now available to all application servers including Tomcat. A valid license is required.
Configuration
Quercus compilation requires a license. In the web.xml, you will need to specify the directory where the license is located:
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5">
<display-name>Quercus on Tomcat</display-name>
<servlet>
<servlet-name>Quercus Servlet</servlet-name>
<servlet-class>com.caucho.quercus.servlet.QuercusServlet</servlet-class>
<init-param>
<param-name>license-directory</param-name>
<param-value>WEB-INF/licenses</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>Quercus Servlet</servlet-name>
<url-pattern>*.php</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.php</welcome-file>
</welcome-file-list>
</web-app>
Quercus will place the compiled files in WEB-INF/work.
