cvs: phpdoc /en/chapters install.openbsd.xml /entities global.ent

avsm Sun Nov 23 12:47:00 2003 EDT Modified files: /phpdoc/entities global.ent /phpdoc/en/chapters install.openbsd.xml Log: update with some FAQs for openbsd (apache chroot and the gd package) Index: phpdoc/entities/global.ent diff -u phpdoc/entities/global.ent:1.140 phpdoc/entities/global.ent:1.141 --- phpdoc/entities/global.ent:1.140 Thu Nov 20 12:06:27 2003 +++ phpdoc/entities/global.ent Sun Nov 23 12:46:59 2003 @@ -1,6 +1,6 @@ <!-- -*- SGML -*- - $Id: global.ent,v 1.140 2003/11/20 17:06:27 joey Exp $ + $Id: global.ent,v 1.141 2003/11/23 17:46:59 avsm Exp $ Contains global "macros" for all the XML documents. @@ -169,6 +169,8 @@ <!ENTITY url.omnihttpd "http://www.omnicron.ca/"> <!ENTITY url.openasp "http://www.activescripting.org/"> <!ENTITY url.openbsd "http://www.openbsd.org/"> +<!ENTITY url.openbsd.apachefaq "http://www.openbsd.org/faq/faq10.html#httpdchroot"> +<!ENTITY url.openbsd.chroot "http://www.openbsd.org/cgi-bin/man.cgi?query=chroot"> <!ENTITY url.openbsd.packages "http://www.openbsd.org/cgi-bin/man.cgi?query=packages"> <!ENTITY url.openbsd.ports "http://www.openbsd.org/ports.html"> <!ENTITY url.openlink "http://www.openlinksw.com/"> Index: phpdoc/en/chapters/install.openbsd.xml diff -u phpdoc/en/chapters/install.openbsd.xml:1.5 phpdoc/en/chapters/install.openbsd.xml:1.6 --- phpdoc/en/chapters/install.openbsd.xml:1.5 Sat Nov 15 06:37:50 2003 +++ phpdoc/en/chapters/install.openbsd.xml Sun Nov 23 12:47:00 2003 @@ -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>