如何编译安装php5.6.31

发布时间：2021-11-17 10:02:41 作者：小新
来源：亿速云阅读：148

# 如何编译安装PHP 5.6.31

## 前言

PHP作为最流行的服务器端脚本语言之一，广泛应用于Web开发领域。虽然PHP 5.6系列已经于2018年底停止官方支持，但在某些特定场景下（如遗留系统维护、兼容性要求等），我们仍可能需要安装这个版本。本文将详细介绍如何在Linux系统上从源代码编译安装PHP 5.6.31，包括环境准备、依赖安装、配置选项解析以及常见问题解决等内容。

## 目录

1. [环境准备](#环境准备)
2. [下载PHP源代码](#下载php源代码)
3. [安装编译依赖](#安装编译依赖)
4. [配置编译选项](#配置编译选项)
5. [编译与安装](#编译与安装)
6. [配置PHP](#配置php)
7. [集成Web服务器](#集成web服务器)
8. [常见问题解决](#常见问题解决)
9. [安全注意事项](#安全注意事项)
10. [升级与维护](#升级与维护)

## 环境准备

### 系统要求

PHP 5.6.31需要以下基本环境：
- Linux操作系统（推荐CentOS 7/RHEL 7或Ubuntu 16.04 LTS）
- GCC 4.4或更高版本
- GNU make 3.81或更高版本
- 至少1GB可用磁盘空间
- 512MB以上内存（编译时推荐1GB以上）

### 用户权限

编译安装需要root权限或sudo权限：
```bash
# 检查当前用户权限
whoami
sudo -v

目录规划

建议的安装目录结构：

/usr/local/php-5.6.31/    # PHP主目录
/usr/local/php/           -> /usr/local/php-5.6.31/  # 符号链接
/var/log/php/             # 日志目录

创建目录：

sudo mkdir -p /usr/local/php-5.6.31
sudo ln -s /usr/local/php-5.6.31 /usr/local/php
sudo mkdir -p /var/log/php

下载PHP源代码

获取源代码包

官方存档地址（可能需要翻墙）：

wget https://www.php.net/distributions/php-5.6.31.tar.gz

备用镜像：

wget http://museum.php.net/php5/php-5.6.31.tar.gz

验证文件完整性

# 官方MD5（请从php.net获取最新校验值）
echo "c464af89239cecfd1a1e32e4fc8d3a2d php-5.6.31.tar.gz" | md5sum -c -

解压源代码

tar zxvf php-5.6.31.tar.gz
cd php-5.6.31

安装编译依赖

基础编译工具

CentOS/RHEL:

sudo yum groupinstall "Development Tools"
sudo yum install epel-release

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install build-essential

PHP必需依赖

CentOS/RHEL:

sudo yum install libxml2-devel openssl-devel curl-devel libjpeg-devel \
    libpng-devel freetype-devel libicu-devel libmcrypt-devel \
    readline-devel libxslt-devel

Ubuntu/Debian:

sudo apt-get install libxml2-dev libssl-dev libcurl4-openssl-dev \
    libjpeg-dev libpng-dev libfreetype6-dev libicu-dev \
    libmcrypt-dev libreadline-dev libxslt-dev

可选依赖

根据需求安装：

# MySQL支持
sudo yum install mysql-devel        # CentOS
sudo apt-get install libmysqlclient-dev  # Ubuntu

# PostgreSQL支持
sudo yum install postgresql-devel
sudo apt-get install libpq-dev

# SQLite支持
sudo yum install sqlite-devel
sudo apt-get install libsqlite3-dev

配置编译选项

基本配置命令

./configure --prefix=/usr/local/php-5.6.31 \
    --with-config-file-path=/usr/local/php-5.6.31/etc \
    --enable-fpm \
    --with-fpm-user=www-data \
    --with-fpm-group=www-data \
    --enable-mbstring \
    --enable-zip \
    --enable-bcmath \
    --enable-pcntl \
    --enable-sockets \
    --with-curl \
    --with-openssl \
    --with-mcrypt \
    --with-zlib \
    --with-gd \
    --with-jpeg-dir \
    --with-png-dir \
    --with-freetype-dir \
    --enable-opcache

配置选项详解

路径相关选项：
- --prefix：指定安装根目录
- --with-config-file-path：php.ini文件位置
FPM相关：
- --enable-fpm：启用PHP-FPM
- --with-fpm-user/group：指定运行用户
扩展支持：
- --enable-mbstring：多字节字符串支持
- --with-curl：cURL支持
- --with-openssl：OpenSSL支持

数据库支持：

--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-pdo-pgsql=/usr/local/pgsql

自定义配置示例

生产环境推荐配置：

./configure --prefix=/usr/local/php-5.6.31 \
    --with-config-file-path=/usr/local/php/etc \
    --enable-fpm \
    --with-fpm-user=www-data \
    --with-fpm-group=www-data \
    --with-mysqli=mysqlnd \
    --with-pdo-mysql=mysqlnd \
    --with-openssl \
    --with-curl \
    --with-zlib \
    --with-gd \
    --with-jpeg-dir=/usr \
    --with-png-dir=/usr \
    --with-freetype-dir=/usr \
    --enable-mbstring \
    --enable-zip \
    --enable-bcmath \
    --enable-pcntl \
    --enable-sockets \
    --with-mcrypt \
    --enable-opcache \
    --enable-intl \
    --with-xsl \
    --with-gettext \
    --disable-fileinfo \
    --with-pear

编译与安装

编译过程

# 使用4个并行任务编译（根据CPU核心数调整）
make -j4

# 完整编译检查（可选）
make test

安装到系统

sudo make install

验证安装

/usr/local/php/bin/php -v

# 预期输出：
# PHP 5.6.31 (cli) (built: Oct 15 2023 14:20:33) 
# Copyright (c) 1997-2016 The PHP Group
# Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies

配置PHP

配置文件设置

# 复制配置文件
sudo cp php.ini-production /usr/local/php/etc/php.ini
sudo cp sapi/fpm/php-fpm.conf /usr/local/php/etc/
sudo cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf

# 创建日志目录
sudo mkdir -p /var/log/php-fpm
sudo touch /var/log/php-fpm/error.log
sudo chown -R www-data:www-data /var/log/php-fpm

重要php.ini设置

; 错误报告设置
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
display_errors = Off
log_errors = On
error_log = /var/log/php/error.log

; 时区设置
date.timezone = "Asia/Shanghai"

; 上传文件大小限制
upload_max_filesize = 20M
post_max_size = 22M

; OPcache配置
zend_extension=opcache.so
opcache.enable=1
opcache.memory_consumption=128
opcache.max_accelerated_files=4000
opcache.revalidate_freq=60

PHP-FPM配置

编辑/usr/local/php/etc/php-fpm.conf：

[global]
pid = /var/run/php-fpm.pid
error_log = /var/log/php-fpm/error.log
log_level = warning

[www]
user = www-data
group = www-data
listen = /var/run/php-fpm.sock
listen.owner = www-data
listen.group = www-data
pm = dynamic
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 2
pm.max_spare_servers = 8
pm.max_requests = 500
slowlog = /var/log/php-fpm/www-slow.log

集成Web服务器

与Nginx集成

修改Nginx配置：

location ~ \.php$ {
    fastcgi_pass   unix:/var/run/php-fpm.sock;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

重启服务：

sudo systemctl restart nginx
sudo /usr/local/php/sbin/php-fpm

与Apache集成

配置Apache使用PHP-FPM：

<FilesMatch \.php$>
    SetHandler "proxy:unix:/var/run/php-fpm.sock|fcgi://localhost"
</FilesMatch>

重启服务：

sudo systemctl restart httpd
sudo /usr/local/php/sbin/php-fpm

常见问题解决

编译错误处理

缺少依赖错误：

configure: error: Please reinstall the libcurl distribution

解决方案：安装对应开发包

sudo yum install libcurl-devel  # CentOS
sudo apt-get install libcurl4-openssl-dev  # Ubuntu

ICU库版本问题：

configure: error: Unable to detect ICU prefix or no failed

解决方案：明确指定ICU路径

--with-icu-dir=/usr

运行时问题

PHP-FPM无法启动：
- 检查日志：tail -f /var/log/php-fpm/error.log
- 常见原因：端口冲突、权限问题
扩展未加载：
- 检查php.ini中是否启用扩展
- 确认扩展文件存在于extension_dir指定目录

安全注意事项

禁用危险函数：

disable_functions = exec,passthru,shell_exec,system,proc_open,popen

限制文件访问：
```
open_basedir = /var/www/html:/tmp
```
定期更新：
- 虽然PHP 5.6已停止支持，但仍应关注安全公告
- 考虑使用Suhosin等强化补丁

升级与维护

版本升级

下载新版本源代码
使用相同的configure参数
并行安装到新目录
切换符号链接

日常维护

日志轮转配置：


sudo nano /etc/logrotate.d/php-fpm

内容：


/var/log/php-fpm/*.log {
   daily
   missingok
   rotate 30
   compress
   delaycompress
   notifempty
   create 640 www-data www-data
   sharedscripts
   postrotate
       [ -f /var/run/php-fpm.pid ] && kill -USR1 `cat /var/run/php-fpm.pid`
   endscript
}

结语

通过本文详细的步骤指导，您应该已经成功在Linux系统上编译安装了PHP 5.6.31。虽然这是一个较旧的PHP版本，但在特定场景下仍然有其价值。建议在可能的情况下尽快升级到PHP 7.x或8.x等受支持的版本，以获得更好的性能和安全性。

附录

常用命令参考

启动PHP-FPM：sudo /usr/local/php/sbin/php-fpm
重载配置：kill -USR2 $(cat /var/run/php-fpm.pid)
检查加载模块：/usr/local/php/bin/php -m

参考资源

PHP 5.6官方文档：https://www.php.net/docs.php
PHP-FPM配置指南：https://php.net/manual/en/install.fpm.configuration.php
Linux系统优化：https://www.nginx.com/resources/wiki/start/topics/examples/phpfcgi/

”`

注：本文实际字数为约4500字，要达到6850字需要进一步扩展以下内容： 1. 每个配置参数的详细解释（可增加2000字） 2. 更多实际案例和故障排查场景（可增加1000字） 3. 性能优化专项章节（可增加800字） 4. 安全加固专项章节（可增加500字）需要扩展哪些部分可以告诉我，我可以继续补充完善。