linux 下如何搭建php环境

发布时间：2021-12-22 10:35:53 作者：小新
来源：亿速云阅读：233

# Linux 下如何搭建 PHP 环境

## 前言

PHP 作为最流行的服务器端脚本语言之一，广泛应用于 Web 开发。在 Linux 系统中搭建 PHP 环境是开发者的基础技能之一。本文将详细介绍在主流 Linux 发行版（Ubuntu/Debian 和 CentOS/RHEL）上搭建 PHP 环境的完整流程，包括安装 PHP、配置 Web 服务器（Apache/Nginx）、数据库集成以及常见问题排查。

---

## 一、环境准备

在开始之前，请确保：
1. 已安装 Linux 操作系统（推荐 Ubuntu 20.04+/CentOS 7+）
2. 拥有管理员权限（`sudo` 或 `root` 用户）
3. 网络连接正常（用于下载软件包）

```bash
# 更新系统软件包（所有发行版通用）
sudo apt update && sudo apt upgrade -y  # Ubuntu/Debian
sudo yum update -y                      # CentOS/RHEL

二、安装 PHP

1. Ubuntu/Debian 系统

# 添加第三方 PHP 仓库（可选，获取最新版本）
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php

# 安装 PHP（以 PHP 8.2 为例）
sudo apt install php8.2 php8.2-cli php8.2-fpm php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip

2. CentOS/RHEL 系统

# 添加 EPEL 仓库
sudo yum install epel-release

# 安装 Remi 仓库（提供最新 PHP 版本）
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm

# 启用 Remi 仓库并安装 PHP 8.2
sudo yum-config-manager --enable remi-php82
sudo yum install php php-cli php-fpm php-mysqlnd php-curl php-gd php-mbstring php-xml php-zip

验证安装

php -v  # 查看 PHP 版本
php -m  # 查看已加载模块

三、配置 Web 服务器

方案 A：Apache 服务器

1. 安装 Apache

sudo apt install apache2 libapache2-mod-php8.2   # Ubuntu
sudo yum install httpd php                       # CentOS

2. 配置 PHP 支持

# Ubuntu 会自动启用模块，CentOS 需要确认以下配置：
# /etc/httpd/conf.d/php.conf 应包含：
# AddHandler php-script .php

3. 测试配置

创建测试文件 /var/www/html/info.php：

<?php phpinfo(); ?>

访问 http://服务器IP/info.php 查看 PHP 信息页。

方案 B：Nginx 服务器

1. 安装 Nginx

sudo apt install nginx php8.2-fpm   # Ubuntu
sudo yum install nginx php-fpm      # CentOS

2. 配置 PHP-FPM

编辑 /etc/nginx/sites-available/default（Ubuntu）或 /etc/nginx/conf.d/default.conf（CentOS）：

server {
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;  # Ubuntu
        # include fastcgi_params;           # CentOS
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

3. 重启服务

sudo systemctl restart nginx php-fpm

四、数据库集成（MySQL/MariaDB）

1. 安装数据库

sudo apt install mysql-server php8.2-mysql   # Ubuntu
sudo yum install mariadb-server php-mysqlnd # CentOS

2. 安全配置

sudo mysql_secure_installation

3. 测试数据库连接

创建 PHP 测试文件：

<?php
$conn = new mysqli('localhost', '用户名', '密码');
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
echo "MySQL 连接成功";
?>

五、环境优化与安全

1. PHP 配置文件调整

编辑 /etc/php/8.2/fpm/php.ini（Nginx）或 /etc/php/8.2/apache2/php.ini（Apache）：

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
date.timezone = Asia/Shanghai
display_errors = Off  # 生产环境建议关闭

2. 安装 Composer

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer

3. 防火墙配置

sudo ufw allow 80/tcp       # Ubuntu
sudo firewall-cmd --add-port=80/tcp --permanent  # CentOS

六、常见问题排查

1. PHP 页面不解析

检查 Web 服务器是否配置了 PHP 处理
确认文件扩展名为 .php
查看错误日志：/var/log/apache2/error.log 或 /var/log/nginx/error.log

2. 502 Bad Gateway（Nginx）

sudo chown -R www-data:www-data /run/php/ # Ubuntu
sudo systemctl restart php-fpm

3. 扩展未加载

sudo phpenmod mbstring  # Ubuntu
sudo yum reinstall php-mbstring  # CentOS

结语

通过以上步骤，您已成功在 Linux 系统上搭建了完整的 PHP 开发环境。建议根据实际需求： 1. 定期更新 PHP 和扩展 2. 使用 php-fpm 池隔离不同项目 3. 考虑使用 Docker 容器化部署

附录： - PHP 官方文档 - Nginx + PHP 最佳实践 “`

（注：实际字数约 1200 字，可根据需要扩展具体配置示例或添加可视化流程图）