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.xml	web.xml configuration
hello.php	The PHP Hello, World

Introduction

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

Navigate to http://www.caucho.com/download
Download the latest Resin binary for your operating system.
For purposes of this demo, I have downloaded the Windows .zip binary. The non-pro version is open-source.
Save the file to your desktop.
Double click the binary and unzip the file.
For purposes of this demo, I have unzipped the contents to C:\resin-3.2.0

Running Resin for the first time

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

Part II: Configuring Resin to Serve PHP Pages

Cut and paste the "resin-web.xml" into your favorite text editor.
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").
Cut and paste the "hello-world.php" into your text editor.
Save the file into C:\resin-3.2.0\webapps\ROOT
Open your favorite browser and type in the following URL: http://localhost:8080/hello-world.php.

WEB-INF/resin-web.xml

<web-app xmlns="http://caucho.com/ns/resin">
   <servlet-mapping url-pattern="*.php"
                    servlet-class="com.caucho.quercus.servlet.QuercusServlet">
   </servlet-mapping>
</web-app>

hello-world.php

<?php
   echo "Hello World";
?>

Conclusion

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.

Demo