/usr/share/doc/refdb/refdb-manual/ch04s11.html is in refdb-doc 1.0.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!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"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Install the PHP interface</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="RefDB handbook" /><link rel="up" href="ch04.html" title="Chapter 4. Installation" /><link rel="prev" href="ch04s10.html" title="SRU support" /><link rel="next" href="ch05.html" title="Chapter 5. refdbd administration" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Install the PHP interface</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch04s10.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Installation</th><td width="20%" align="right"> <a accesskey="n" href="ch05.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sect-install-php"></a>Install the PHP interface</h2></div></div></div><p>If you want to provide interactive access to your RefDB databases through the web, consider installing the PHP web interface. This web frontend provides a convenient way to perform the most common user tasks, like running queries or adding datasets.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-php-prerequisites"></a>Prerequisites</h3></div></div></div><p>Please check the following prerequisites on your computer before attempting to install the PHP interface</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">Web server</span></dt><dd><p>Any web server that is capable of running PHP scripts. If you don't run a web server anyway, <a class="ulink" href="http://httpd.apache.org" target="_top">Apache</a> is always a good choice to start with. Both versions 1.3.x and 2.x will work just fine.</p></dd><dt><span class="term">PHP interpreter</span></dt><dd><p>You need <a class="ulink" href="http://www.php.net" target="_top">PHP5</a>, the older PHP4 won't do. When building PHP, make sure to configure the software appropriately so the php5 Apache module gets built. If you install a prebuilt package, you may have to select an extra package that contains the appropriate module for your web server.</p><p>With the exception of session support, the RefDB PHP interface relies solely on core features of PHP5. You may therefore have to install PHP5 session support separately. However, on some systems like FreeBSD, "core" does not mean "it's there". If the PHP5 core is split into several packages, you may also have to install DOM, XML, and XSL support separately.</p></dd></dl></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-php-apacheconfig"></a>Web server configuration</h3></div></div></div><p>The following instructions assume that you use Apache as your web server. The configuration file is usually <code class="filename">/etc/apache/httpd.conf</code> or <code class="filename">/usr/local/etc/apache/httpd.conf</code>.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Locate the section "Dynamic Shared Object (DSO) Support". Check if the php5 module is loaded anyway. If not, add a line like the following:</p><pre class="programlisting">
LoadModule php5_module libexec/apache/libphp5.so
</pre></li><li class="listitem"><p>The subsequent section in the config file needs to be updated too if you had to add the php5 module:</p><pre class="programlisting">
AddModule mod_php5.c
</pre></li><li class="listitem"><p>Further down there should be a section containing Aliases. Create a new one within this section like this:</p><pre class="programlisting">
Alias /refdb/ "/usr/local/share/refdb/www/"
<Directory "/usr/local/share/refdb/www">
AllowOverride None
Order allow,deny
Allow from all
AddType application/x-httpd-php .php .phtml
</Directory>
</pre><p>The paths point to the files that RefDB installs with all other shared files. If you intend to customize or modify the interface, you can copy the files to a directory in your home folder and change the directories in the config file accordingly.</p></li><li class="listitem"><p>Finally you'll have to let the Apache server re-read it's configuration file:</p><pre class="screen"><code class="prompt">~# </code><strong class="userinput"><code>apachectl restart</code></strong></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-php-test"></a>Test your PHP interface</h3></div></div></div><p>To see the PHP interface in action, first make sure that the RefDB application server is running:</p><pre class="screen"><code class="prompt">~# </code><strong class="userinput"><code>refdbctl start</code></strong></pre><p>Now start your web browser and point it to:</p><pre class="screen">localhost/refdb/</pre><p>Please note the trailing slash! Now you should be greeted by the login screen.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch04s10.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch04.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">SRU support </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 5. refdbd administration</td></tr></table></div></body></html>
|