Caucho maker of Resin Server | Application Server (Java EE Certified) and Web Server


Resin Documentation

home company docs 
app server 
 Resin Server | Application Server (Java EE Certified) and Web Server

quercus: hello, world installation

The Hello, World tutorial covers the basic steps to start Resin and run a trivial php script in Quercus.


Files in this tutorial

WEB-INF/resin-web.xmlweb.xml configuration
hello.phpThe PHP Hello, World


This short article is intended for PHP programers who are interested in trying Caucho's PHP implementation. The download and unzipping instructions are intended for windows users. However, the implementation will work just as well in UNIX.

Part I: Installing Resin

Downloading and unzipping Resin

  1. Navigate to
  2. Download the latest Resin binary for your operating system.
  3. For purposes of this demo, I have downloaded the Windows .zip binary. The non-pro version is open-source.
  4. Save the file to your desktop.
  5. Double click the binary and unzip the file.
  6. For purposes of this demo, I have unzipped the contents to C:\resin-3.0.14

Running Resin for the first time

  1. Browse to the directory into which you unzipped the resin download (ie: C:\resin-3.0.14)
  2. Double-click httpd.exe. At this point the resin web server should start.
  3. Open your favorite browser and type in the following URL: http://localhost:8080
  4. You will now see Resin's Default Home Page

Part II: Configuring Resin to Serve PHP Pages

  1. Cut and paste the "resin-web.xml" into your favorite text editor.
  2. Save the file into C:\resin-3.0.14\webapps\ROOT\WEB-INF (NB: if you use Notepad, then be careful to either save as "all files" or just put the file name in double quotes. IE: "resin-web.xml").
  3. Cut and paste the "hello-world.php" into your text editor.
  4. Save the file into C:\resin-3.0.14\webapps\ROOT
  5. Open your favorite browser and type in the following URL: http://localhost:8080/hello-world.php.
<web-app xmlns="">
   <servlet-mapping url-pattern="*.php"
   echo "Hello World";


If all went well with the above steps, you have installed Resin correctly. Congratulations!

You can now create your own PHP pages and store them in the same directory as the hello-world.php file.


Copyright © 1998-2015 Caucho Technology, Inc. All rights reserved. Resin ® is a registered trademark. Quercustm, and Hessiantm are trademarks of Caucho Technology.

Cloud-optimized Resin Server is a Java EE certified Java Application Server, and Web Server, and Distributed Cache Server (Memcached).
Leading companies worldwide with demand for reliability and high performance web applications including, CNET, DZone and many more are powered by Resin.

home company docs 
app server