<HTML ><HEAD ><TITLE >Installation on UNIX systems</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Installation" HREF="installation.html"><LINK REL="PREVIOUS" TITLE="Unix/Solaris installs" HREF="install.solaris.html"><LINK REL="NEXT" TITLE="Installation on Windows systems" HREF="install.windows.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="sect1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="install.solaris.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >Chapter 3. Installation</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="install.windows.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="sect1" ><H1 CLASS="sect1" ><A NAME="install.unix" ></A >Installation on UNIX systems</H1 ><P > This section will guide you through the general configuration and installation of PHP on Unix systems. Be sure to investigate any sections specific to your platform or web server before you begin the process. </P ><P > Prerequisite knowledge and software: <P ></P ><UL ><LI ><P > Basic UNIX skills (being able to operate "make" and a C compiler, if compiling) </P ></LI ><LI ><P > An ANSI C compiler (if compiling) </P ></LI ><LI ><P > flex (for compiling) </P ></LI ><LI ><P > bison (for compiling) </P ></LI ><LI ><P > A web server </P ></LI ><LI ><P > Any module specific components (such as gd, pdf libs, etc.) </P ></LI ></UL > </P ><P > There are several ways to install PHP for the Unix platform, either with a compile and configure process, or through various pre-packaged methods. This documentation is mainly focused around the process of compiling and configuring PHP. </P ><P > The initial PHP setup and configuration process is controlled by the use of the commandline options of the <TT CLASS="filename" >configure</TT > script. This page outlines the usage of the most common options, but there are many others to play with. Check out the <A HREF="install.configure.html" >Complete list of configure options</A > for an exhaustive rundown. There are several ways to install PHP: <P ></P ><UL ><LI ><P > As an <A HREF="install.apache.html" >Apache module</A > </P ></LI ><LI ><P > As an <A HREF="install.fhttpd.html" >fhttpd module</A > </P ></LI ><LI ><P > For use with <A HREF="install.otherhttpd.html" >AOLServer, NSAPI, phttpd, Pi3Web, Roxen, thttpd, or Zeus.</A > </P ></LI ><LI ><P > As a <A HREF="install.commandline.html" >CGI executable</A > </P ></LI ></UL > </P ><DIV CLASS="sect2" ><H2 CLASS="sect2" ><A NAME="install.unix.apache-module" ></A >Apache Module Quick Reference</H2 ><P > PHP can be compiled in a number of different ways, but one of the most popular is as an Apache module. The following is a quick installation overview. </P ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="install.unix.apache-module.quick" ></A ><P ><B >Example 3-4. Quick Installation Instructions for PHP 4 (Apache Module Version) </B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="shell" >1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar 3. gunzip php-x.x.x.tar.gz 4. tar xvf php-x.x.x.tar 5. cd apache_1.3.x 6. ./configure --prefix=/www 7. cd ../php-x.x.x 8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars 9. make 10. make install 11. cd ../apache_1.3.x 12. ./configure --activate-module=src/modules/php4/libphp4.a 13. make 14. make install 15. cd ../php-x.x.x 16. cp php.ini-dist /usr/local/lib/php.ini 17. Edit your httpd.conf or srm.conf file and add: AddType application/x-httpd-php .php 18. Use your normal procedure for restarting the Apache server. (You must stop and restart the server, not just cause the server to reload by use a HUP or USR1 signal.)</PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ></DIV ><DIV CLASS="sect2" ><H2 CLASS="sect2" ><A NAME="install.building" ></A >Building</H2 ><P > When PHP is configured, you are ready to build the CGI executable. The command <B CLASS="command" >make</B > should take care of this. If it fails and you can't figure out why, see the <A HREF="install.problems.html" >Problems section</A >. </P ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="install.solaris.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="install.windows.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Unix/Solaris installs</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="installation.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Installation on Windows systems</TD ></TR ></TABLE ></DIV ></BODY ></HTML >