首页 > 编程语言 >PHP Linux环境搭建教程

PHP Linux环境搭建教程

来源：互联网 2026-07-20 08:08:14

在Linux系统搭建PHP环境主要有LAMP和LEMP两种方案，需先更新系统包并安装必要工具，再安装PHP及MySQL、GD等扩展，随后配置Apache或Nginx与PHP-FPM协同，集成MySQL或MariaDB数据库并完成安全设置，最后调整PHP参数、安装Composer及配置防火墙，即可构建稳定可用的Web开发环境。

在Linux系统上搭建PHP环境，对新手而言可能颇具挑战。实际上，主流方案只有两种：LAMP（Linux+Apache+MySQL+PHP）和LEMP（Linux+Nginx+MySQL+PHP）。下面将详细讲解每一步。

PHP Linux环境搭建教程

长期稳定更新的攒劲资源： >>>点此立即查看<<<

一、环境准备

动手之前，扎实的准备工作能避免后续许多麻烦。

1. 更新系统软件包
这是基础步骤，确保系统包列表最新，避免依赖冲突。根据发行版选择对应命令：

Ubuntu/Debian： sudo apt update && sudo apt upgrade -y
CentOS/RHEL： sudo yum update -y

2. 安装必要工具
部分PHP扩展编译时依赖开发库，提前安装可防患于未然。

Ubuntu/Debian： sudo apt install build-essential libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libmcrypt-dev libreadline-dev
CentOS/RHEL： sudo yum groupinstall "Development Tools" -y

二、安装PHP及核心扩展

接下来安装PHP，同时建议安装常用扩展，如MySQL、GD、MBString等，Web开发基本都会用到。

Ubuntu/Debian： 一条命令即可完成。

sudo apt install php php-cli php-fpm php-mysql php-gd php-mbstring php-curl php-xml php-zip

CentOS/RHEL： 需先启用EPEL和Remi仓库，才能获取较新版本PHP。

sudo yum install epel-release -y
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm -y  # CentOS 7
sudo yum-config-manager --enable remi-php82  # 启用PHP 8.2仓库，版本按需调整
sudo yum install php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-curl php-xml php-zip -y

安装完成后，运行 php -v 验证，若显示PHP版本号和编译信息，说明安装成功。

三、配置Web服务器

这一步让PHP与Web服务器协同工作，根据所选组合配置略有差异。

1. Apache配置（LAMP）

安装Apache：
Ubuntu/Debian: sudo apt install apache2 -y
CentOS/RHEL: sudo yum install httpd -y
启用PHP模块：
Ubuntu/Debian下需手动启用：sudo a2enmod php8.2（替换为实际版本号）。CentOS/RHEL默认集成，无需额外操作。
配置PHP处理：
编辑Apache配置文件（Ubuntu: /etc/apache2/sites-a vailable/000-default.conf，CentOS: /etc/httpd/conf/httpd.conf），确保包含以下内容，使Apache能处理.php文件：
```
    SetHandler application/x-httpd-php
```
重启Apache：
Ubuntu/Debian: sudo systemctl restart apache2
CentOS/RHEL: sudo systemctl restart httpd

2. Nginx配置（LEMP）

安装Nginx：
Ubuntu/Debian: sudo apt install nginx -y
CentOS/RHEL: sudo yum install nginx -y

配置PHP-FPM：
Nginx本身不处理PHP，需将请求转发给PHP-FPM。编辑站点配置文件（/etc/nginx/sites-a vailable/default 或 /etc/nginx/conf.d/default.conf），在 server 块中添加：

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    # Ubuntu/Debian
    # include fastcgi_params; # CentOS/RHEL（需手动指定路径）
    fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 替换为实际PHP-FPM socket路径
}

重启Nginx和PHP-FPM：
Ubuntu/Debian: sudo systemctl restart nginx php8.2-fpm
CentOS/RHEL: sudo systemctl restart nginx php-fpm

四、集成MySQL/MariaDB数据库

动态网站离不开数据库，接下来安装数据库。

安装数据库：
Ubuntu/Debian选择MySQL: sudo apt install mysql-server -y
CentOS/RHEL推荐MariaDB，兼容性高：sudo yum install mariadb-server -y
安全配置：
运行 sudo mysql_secure_installation，该脚本会引导设置root密码、移除匿名用户、禁止远程root登录等，属于必备安全步骤。

创建数据库和用户：
登录MySQL: sudo mysql -u root -p，然后执行以下SQL语句，创建新数据库和用户并赋予权限。

CREATE DATABASE your_database_name;
CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';
FLUSH PRIVILEGES;
EXIT;

测试PHP与MySQL连接：
在Web根目录（通常为 /var/www/html/）下创建测试文件 test_db.php，内容如下：
```
connect_error) {
    die("连接失败: " . $conn->connect_error);
}
echo "MySQL连接成功";
?>
```
在浏览器中访问 http://your_server_ip/test_db.php，若显示“MySQL连接成功”，则数据库配置完成。

五、环境优化与安全

能运行只是第一步，优化和安全配置能让环境更稳定。

调整PHP配置：
编辑 php.ini 文件（路径因版本和Web服务器而异，如 /etc/php/8.2/apache2/php.ini 或 /etc/php/8.2/fpm/php.ini），根据需求修改以下关键参数，然后重启Web服务器生效。

memory_limit = 256M          # 脚本最大内存
upload_max_filesize = 64M    # 上传文件大小限制
post_max_size = 64M          # POST数据大小限制
date.timezone = Asia/Shanghai # 时区设置
display_errors = Off         # 生产环境关闭错误显示，避免泄露敏感信息

安装Composer：
Composer是PHP依赖管理工具，现代PHP开发几乎离不开。安装命令如下：

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

配置防火墙：
开放80端口（HTTP），使外部能访问Web服务。
Ubuntu (UFW): sudo ufw allow 80/tcp
CentOS (Firewalld): sudo firewall-cmd --add-port=80/tcp --permanent && sudo firewall-cmd --reload

六、常见问题排查

搭建过程中可能遇到问题，以下整理了几个常见情况。

PHP页面不解析： 检查Web服务器是否加载了PHP模块（如Apache的 libapache2-mod-php），并确认配置文件中 SetHandler 指令正确。
502 Bad Gateway（Nginx）： 通常由PHP-FPM服务未运行或配置错误导致。检查PHP-FPM状态（sudo systemctl status php-fpm），并确认 fastcgi_pass 后的socket路径与PHP-FPM实际路径一致。
扩展未加载： 使用 php -m 查看已加载模块。若某扩展未安装，Ubuntu下可运行 sudo phpenmod 扩展名 启用；CentOS下可尝试 sudo yum reinstall php-扩展名 重新安装。