cvs: phpdoc /en/chapters install.openbsd.xml

avsm Fri Nov 1 13:31:14 2002 EDT Modified files: /phpdoc/en/chapters install.openbsd.xml Log: update for openbsd 3.2 (released today). i'll flesh it out some more as the FAQ's come in Index: phpdoc/en/chapters/install.openbsd.xml diff -u phpdoc/en/chapters/install.openbsd.xml:1.1 phpdoc/en/chapters/install.openbsd.xml:1.2 --- phpdoc/en/chapters/install.openbsd.xml:1.1 Wed Jan 9 18:52:08 2002 +++ phpdoc/en/chapters/install.openbsd.xml Fri Nov 1 13:31:14 2002 @@ -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> + 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> - 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. + 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> + <simpara> + Read the <ulink url="&url.openbsd.packages;">packages(7)</ulink> + manual page for more information about binary packages on OpenBSD. + </simpara> </sect2> - <sect2 id="install.openbsd.packages"> - <title>Using Packages</title> + <sect2 id="install.openbsd.ports"> + <title>Using Ports</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. - Read the <ulink url="&url.openbsd.packages;">packages(7)</ulink> - manual page for more information in what packages are available. + 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 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +-->