linux 下如何搭建php環境

# 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 字，可根據需要擴展具體配置示例或添加可視化流程圖）