update with some FAQs for openbsd (apache chroot and the gd package)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@144791 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Anil Madhavapeddy 2003-11-23 17:47:00 +00:00
parent d36711c134
commit 31ea0382c0

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<sect1 id="install.openbsd">
<title>Unix/OpenBSD installs</title>
<para>
@ -21,13 +21,6 @@
or <filename>php4-imap-4.3.3.tgz</filename>. You need to use the <command>phpxs</command>
command to activate and deactivate these modules in your &php.ini;.
</simpara>
<simpara>
Due to an error in the OpenBSD 3.4 packages, the <filename>php4-gd-4.3.3-no_x11</filename>
package was not generated. You can still use the <filename>php4-gd-4.3.3</filename>
package, but it requires <filename>xbase34.tgz</filename> to be installed. The -stable
branch of the ports tree has corrected this error, and a replacement package is being
generated.
</simpara>
<example id="install.openbsd.ports.example">
<title>OpenBSD Package Install Example</title>
<programlisting>
@ -66,6 +59,33 @@
the imap module, set the FLAVOR to <command>no_imap</command>.
</simpara>
</sect2>
<sect2 id="install.openbsd.faq">
<title>Common Problems</title>
<itemizedlist>
<listitem>
<simpara>The default install of Apache runs inside a
<ulink url="&url.openbsd.chroot;">chroot(2) jail</ulink>, which will restrict PHP scripts to
accessing files under <filename>/var/www</filename>. You will therefore need to create a
<filename>/var/www/tmp</filename> directory for PHP session files to be stored, or use an
alternative session backend. In addition, database sockets need to be placed inside the
jail or listen on the <filename>localhost</filename> interface. If you use network functions,
some files from <filename>/etc</filename> such as <filename>/etc/resolv.conf</filename> and
<filename>/etc/services</filename> will need to be moved into <filename>/var/www/etc</filename>.
The OpenBSD PEAR package automatically installs into the correct chroot directories, so
no special modification is needed there. More information on the OpenBSD Apache is available
in the <ulink url="&url.openbsd.apachefaq;">OpenBSD FAQ</ulink>.
</simpara>
</listitem>
<listitem>
<simpara>
The OpenBSD 3.4 package for the <ulink url="&url.gd;">gd</ulink> extension requires
XFree86 to be installed. If you do not wish to use some of the font features that
require X11, install the <filename>php4-gd-4.3.3-no_x11.tgz</filename> package instead.
</simpara>
</listitem>
</itemizedlist>
</sect2>
<sect2 id="install.openbsd.older">
<title>Older Releases</title>
<simpara>