<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Language" content="en-us" />
<meta name="ROBOTS" content="ALL" />
<meta http-equiv="imagetoolbar" content="no" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="Keywords" content="cherokee web server httpd http" />
<meta name="Description" content="Cherokee is a flexible, very fast, lightweight Web server. It is implemented entirely in C, and has no dependencies beyond a standard C library. It is embeddable and extensible with plug-ins. It supports on-the-fly configuration by reading files or strings, TLS/SSL (via GNUTLS or OpenSSL), virtual hosts, authentication, cache friendly features, PHP, custom error management, and much more." />
<link href="media/css/cherokee_doc.css" rel="stylesheet" type="text/css" media="all" />
</head>
<body>
<h2 id="_a_href_index_html_index_a_8594_a_href_cookbook_html_cookbook_a"><a href="index.html">Index</a> → <a href="cookbook.html">Cookbook</a></h2>
<div class="sectionbody">
</div>
<h2 id="_cookbook_setting_up_zend_framework">Cookbook: Setting up Zend Framework</h2>
<div class="sectionbody">
<div class="paragraph"><p>The <a href="http://framework.zend.com/">Zend Framework</a> is a PHP framework
focused on building more secure, reliable, and modern Web 2.0
applications & web services.</p></div>
<div class="paragraph"><p>It is essential that Cherokee supports PHP before starting with this
recipe. That should not be a problem since it comes preconfigured by
default. However, you can follow the <a href="cookbook_php.html">setting up
PHP</a> recipe for further hints on fine tuning this feature.</p></div>
<div class="paragraph"><p>To make sure the recipe works, we’ll be using the demo provided by the
<a href="http://framework.zend.com/docs/quickstart">Zend Framework
Quickstart</a>. Last time this document was edited, it was
<a href="http://framework.zend.com/demos/ZendFrameworkQuickstart-20090430.tar.gz">demo
20090430</a>.</p></div>
<div class="paragraph"><p>Uncompress its contents to a directory and set up the <tt>public</tt>
subdirectory as your web document root. In our example, it will be
<tt>/var/www/demo/public</tt>.</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>user@cherokee:/var/www/demo$ ls
application data library public scripts</tt></pre>
</div></div>
<div class="paragraph"><p>The <tt>library</tt> directory is empty and should contain the Zend Framework
files. Download it from the
<a href="http://framework.zend.com/download">official page</a> and copy it to
the appropriate location. Follow the Quickstart for more details on
setting up the framework. We will concentrate on the Cherokee side.</p></div>
<div class="paragraph"><p>So now that we have the files in place, we’ll just create the needed
rules for the web server. Specially important will be the rewrite
rules. From the Zend Framework</p></div>
<div class="sidebarblock">
<div class="sidebar-content">
<div class="paragraph"><p>This set of rewrite rules specify that if the file exists under the
document root directory, it should simply be served as a static
resource. Otherwise, the request is for dynamic content and should be
rewritten to our index.php script. Since all requests for non-static
content will be rewritten to it, the index.php script serves as the
entry point to our application.</p></div>
</div></div>
<h3 id="wizard_configuration">Configure Cherokee using the Wizard</h3><div style="clear:left"></div>
<div class="paragraph"><p>Cherokee is shipped with a configuration <tt>Wizard</tt> that can be used
both to deploy the application under a dedicated <tt>Virtual Server</tt> and
under a web folder from one already existent.</p></div>
<div class="paragraph"><p>Launch cherokee-admin, and proceed to the
<a href="config_virtual_servers.html">Virtual servers</a> section.</p></div>
<div class="paragraph"><p>Now you can either enter the chosen one to install under a web folder,
or directly click on the <tt>Add</tt> button of the <tt>Virtual Servers</tt> panel
to create a customised virtual server. In any case you will find the
wizard under the <tt>Platforms</tt> category.</p></div>
<div class="paragraph"><p>After that you will be asked for the minimal information required to
correctly configure your server in a totally transparent way.</p></div>
<div class="paragraph"><p>And that’s it. You are done with the configuration! You can now access
your application.</p></div>
<div class="imageblock">
<div class="content">
<img src="media/images/cookbook_zend1.png" alt="media/images/cookbook_zend1.png" />
</div>
<div class="image-title">Zend-provided demo</div>
</div>
<div class="paragraph"><p>Of course, you’ll have to follow the complete tutorial if you expect
it to work as intended.</p></div>
</div>
<div id="footer">
<div id="footer-text">
</div>
</div>
</body>
</html>
