update for openbsd 3.2 (released today). i'll flesh it out some more

as the FAQ's come in


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@102257 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Anil Madhavapeddy 2002-11-01 18:31:14 +00:00
parent 58b220b7b7
commit 24b21c6a57

View file

@ -1,45 +1,74 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- $Revision: 1.2 $ -->
<sect1 id="install.openbsd">
<title>Unix/OpenBSD installs</title>
<para>
This section contains notes and hints specific to installing
PHP on <ulink url="&url.openbsd;">OpenBSD</ulink>.
PHP on <ulink url="&url.openbsd;">OpenBSD 3.2</ulink>.
</para>
<sect2 id="install.openbsd.ports">
<title>Using Ports</title>
<sect2 id="install.openbsd.packages">
<title>Using Binary Packages</title>
<simpara>
This is the recommended method of installing PHP on OpenBSD, as it will have
the latest patches and security fixes applied to it by the maintainers. To
use this method, ensure that you have a <ulink url="&url.openbsd.ports;">
recent ports tree</ulink>. Then simply find out which flavors you wish
to install, and issue the <command>make install</command> command. Below
is an example of how to do this.
Using binary packages to install PHP on OpenBSD is the recommended
and simplest method. The core package has been separated from the various
modules, and each can be installed and removed independently from the others.
The files you need can be found on your OpenBSD CD or on the FTP site.
</simpara>
<simpara>
The main package you need to install is <filename>php4-core-4.2.3.tgz</filename>,
which contains the basic engine (plus gettext and iconv). Next, take a look
at the module packages, such as <filename>php4-mysql-4.2.3.tgz</filename>
or <filename>php4-imap-4.2.3.tgz</filename>. You need to use the <command>phpxs</command>
command to activate and deactivate these modules in your <filename>php.ini</filename>
file.
</simpara>
<example id="install.openbsd.ports.example">
<title>OpenBSD Ports Install Example</title>
<title>OpenBSD Package Install Example</title>
<programlisting>
<![CDATA[
$ cd /usr/ports/www/php4
$ make show VARNAME=FLAVORS
(choose which flavors you want from the list)
$ env FLAVOR="imap gettext ldap mysql gd" make install
$ /usr/local/sbin/php4-enable
# pkg_add php4-core-4.2.3.tgz
# /usr/local/sbin/phpxs -s
# cp /usr/local/share/doc/php4/php.ini-recommended /var/www/conf/php.ini
(add in mysql)
# pkg_add php4-mysql-4.2.3.tgz
# /usr/local/sbin/phpxs -a mysql
(add in imap)
# pkg_add php4-imap-4.2.3.tgz
# /usr/local/sbin/phpxs -a imap
(remove mysql as a test)
# pkg_delete php4-mysql-4.2.3
# /usr/local/sbin/phpxs -r mysql
(install the PEAR libraries)
# pkg_add php4-pear-4.2.3.tgz
]]>
</programlisting>
</example>
</sect2>
<sect2 id="install.openbsd.packages">
<title>Using Packages</title>
<simpara>
There are pre-compiled packages available for your release
of <ulink url="&url.openbsd;">OpenBSD</ulink>. These integrate
automatically with the version of Apache installed with the OS.
However, since there are a large number of options (called
<emphasis>flavors</emphasis>) available for this port,
you may find it easier to compile it from source using the ports tree.
<simpara>
Read the <ulink url="&url.openbsd.packages;">packages(7)</ulink>
manual page for more information in what packages are available.
manual page for more information about binary packages on OpenBSD.
</simpara>
</sect2>
<sect2 id="install.openbsd.ports">
<title>Using Ports</title>
<simpara>
You can also compile up PHP from source using the <ulink url="&url.openbsd.ports;">ports tree</ulink>.
However, this is only recommended for users familiar with OpenBSD. The PHP4 port
is split into three sub-directories: core, extensions and pear. The
extensions directory generates sub-packages for all of the supported
PHP modules. If you find you do not want to create some of these modules,
use the <command>no_*</command> FLAVOR. For example, to skip building
the imap module, set the FLAVOR to <command>no_imap</command>.
</simpara>
</sect2>
<sect2 id="install.openbsd.older">
<title>Older Releases</title>
<simpara>
Older releases of OpenBSD used the FLAVORS system to compile up
a statically linked PHP. Since it is hard to generate binary packages using
this method, it is now deprecated. You can still use the old stable
ports trees if you wish, but they are unsupported by the OpenBSD team.
If you have any comments about this, the current maintainer for the port
is <ulink url='mailto:avsm@openbsd.org'>Anil Madhavapeddy</ulink>.
</simpara>
</sect2>
</sect1>
@ -63,4 +92,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->