<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Installation on Unix systems</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="install.general.html">General Installation Considerations</a></div>
<div class="next" style="text-align: right; float: right;"><a href="install.unix.apache.html">Apache 1.3.x on Unix systems</a></div>
<div class="up"><a href="install.html">Installation and Configuration</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="install.unix" class="chapter">
<h1>Installation on Unix systems</h1>
<h2>Table of Contents</h2><ul class="chunklist chunklist_chapter"><li><a href="install.unix.apache.html">Apache 1.3.x on Unix systems</a></li><li><a href="install.unix.apache2.html">Apache 2.x on Unix systems</a></li><li><a href="install.unix.nginx.html">Nginx 1.4.x on Unix systems</a></li><li><a href="install.unix.lighttpd-14.html">Lighttpd 1.4 on Unix systems</a></li><li><a href="install.unix.sun.html">Sun, iPlanet and Netscape servers on Sun Solaris</a></li><li><a href="install.unix.litespeed.html">LiteSpeed Web Server/OpenLiteSpeed Web Server on Unix systems</a></li><li><a href="install.unix.commandline.html">CGI and command line setups</a></li><li><a href="install.unix.hpux.html">HP-UX specific installation notes</a></li><li><a href="install.unix.openbsd.html">OpenBSD installation notes</a></li><li><a href="install.unix.solaris.html">Solaris specific installation tips</a></li><li><a href="install.unix.debian.html">Debian GNU/Linux installation notes</a></li></ul>
<p class="para">
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 class="para">
As our manual outlines in the <a href="install.general.html" class="link">General
Installation Considerations</a> section, we are mainly dealing with
web centric setups of PHP in this section, although we will cover
setting up PHP for command line usage as well.
</p>
<p class="para">
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. Many Unix like systems
have some sort of package installation system. This can assist in
setting up a standard configuration, but if you need to have a
different set of features (such as a secure server, or a different
database driver), you may need to build PHP and/or your web server.
If you are unfamiliar with building and compiling your own software,
it is worth checking to see whether somebody has already built a
packaged version of PHP with the features you need.
</p>
<p class="para">
Prerequisite knowledge and software for compiling:
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
Basic Unix skills (being able to operate "make" and a C
compiler)
</span>
</li>
<li class="listitem">
<span class="simpara">
An ANSI C compiler
</span>
</li>
<li class="listitem">
<span class="simpara">
A web server
</span>
</li>
<li class="listitem">
<span class="simpara">
Any module specific components (such as <acronym title="Graphics Draw">GD</acronym>,
<acronym title="Portable Document Format">PDF</acronym> libs, etc.)
</span>
</li>
</ul>
</p>
<p class="para">
When building directly from Git sources or after custom modifications you
might also need:
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
autoconf: 2.13+ (for PHP < 5.4.0), 2.59+ (for PHP >= 5.4.0), 2.64+ (for PHP >= 7.2.0)
</span>
</li>
<li class="listitem">
<span class="simpara">
automake: 1.4+
</span>
</li>
<li class="listitem">
<span class="simpara">
libtool: 1.4.x+ (except 1.4.2)
</span>
</li>
<li class="listitem">
<span class="simpara">
re2c: Version 0.13.4 or newer
</span>
</li>
<li class="listitem">
<span class="simpara">
flex: Version 2.5.4 (for PHP <= 5.2)
</span>
</li>
<li class="listitem">
<span class="simpara">
bison:
</span>
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
PHP 5.4: 1.28, 1.35, 1.75, 1.875, 2.0, 2.1, 2.2, 2.3, 2.4, 2.4.1,
2.4.2, 2.4.3, 2.5, 2.5.1, 2.6, 2.6.1, 2.6.2, 2.6.4
</span>
</li>
<li class="listitem">
<span class="simpara">
PHP 5.5: 2.4, 2.4.1, 2.4.2, 2.4.3, 2.5, 2.5.1, 2.6, 2.6.1, 2.6.2,
2.6.3, 2.6.4, 2.6.5, 2.7
</span>
</li>
<li class="listitem">
<span class="simpara">
PHP 5.6: >= 2.4, < 3.0
</span>
</li>
<li class="listitem">
<span class="simpara">
PHP 7.0: 2.4 or later (including Bison 3.x)
</span>
</li>
</ul>
</li>
</ul>
</p>
<p class="para">
The initial PHP setup and configuration process is controlled by the
use of the command line options of the <strong class="command">configure</strong>
script. You could get a list of all available options along with short
explanations running <strong class="command">./configure --help</strong>.
Our manual documents the different options separately. You will
find the <a href="configure.about.html" class="link">core options in the appendix</a>,
while the different extension specific options are descibed on the
reference pages.
</p>
<p class="para">
When PHP is configured, you are ready to build the module and/or
executables. The command <strong class="command">make</strong> should
take care of this. If it fails and you can't figure out why, see
the <a href="install.problems.html" class="link">Problems section</a>.
</p>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
Some Unix systems (such as OpenBSD and SELinux) may disallow mapping pages
both writable and executable for security reasons, what is called PaX
MPROTECT or W^X violation protection. This kind of memory mapping is,
however, necessary for PCRE's JIT support, so either PHP has to be built
<a href="pcre.installation.html" class="link">without PCRE's JIT support</a>, or the
binary has to be whitelisted by any means provided by the system.
</p>
</p></blockquote>
<blockquote class="note"><p><strong class="note">Note</strong>:
<span class="simpara">
Cross-compiling for ARM with the Android toolchain is currently not supported.
</span>
</p></blockquote>
</div>
<hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="install.general.html">General Installation Considerations</a></div>
<div class="next" style="text-align: right; float: right;"><a href="install.unix.apache.html">Apache 1.3.x on Unix systems</a></div>
<div class="up"><a href="install.html">Installation and Configuration</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
