Caucho Technology
  • resin 4.0
  • 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.2.0

      Running Resin for the first time

      1. Browse to the directory into which you unzipped the resin download (ie: C:\resin-3.2.0)
      2. Double-click resin.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.2.0\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.2.0\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-2011 Caucho Technology, Inc. All rights reserved.
      Resin ® is a registered trademark, and Quercustm, Ambertm, and Hessiantm are trademarks of Caucho Technology.