服务器搭建PHP网站环境四大规范落地步骤-php教程-PHP中文网

服务器搭建php网站环境不是“装完就跑”，而是web服务器、php解释器、连接机制、验证调优四个强耦合环节必须顺序对齐，缺一不可；apache走mod_php直连，nginx必须配php-fpm进程管理，路径与socket配置须严格一致，phpinfo()需在真实web路径下以www-data权限运行并确认loaded configuration file指向正确ini文件。

服务器搭建php网站环境四大规范落地步骤

直接上结论：服务器搭建PHP网站环境不是“装完就跑”，而是四个强耦合环节必须顺序对齐——Web服务器、PHP解释器、连接机制、验证调优，缺一不可，错一步后续全卡在 502 Bad Gateway 或空白页。

Web服务器选型与基础服务启动必须明确区分Apache和Nginx路径

Apache和Nginx对PHP的集成方式完全不同，不能混用配置。Apache走mod_php（模块直连），Nginx必须走PHP-FPM（独立进程管理）。选错会导致PHP脚本根本不执行，只返回源码或403。

Ubuntu/Debian下装Apache：sudo apt install apache2 -y，启用后默认监听80端口，网页根目录是/var/www/html/
Ubuntu/Debian下装Nginx：sudo apt install nginx -y，启用后同样监听80，但根目录是/var/www/html/（默认一致，但解析逻辑不同）
CentOS/RHEL 8+建议用dnf module enable php:remi-8.1再装Nginx+PHP-FPM，避免系统自带PHP版本过旧
启动后务必用curl -I http://localhost确认返回200 OK，别只靠浏览器看欢迎页——有些防火墙会拦截图形访问但放行curl

PHP安装必须匹配Web服务器类型并验证扩展加载状态

装了PHP不等于能用。Apache需要libapache2-mod-php（Ubuntu）或php-fpm配proxy_fcgi（Nginx），且php -m输出里必须看到mysqlnd、mbstring这些关键扩展，否则项目一连数据库就报Call to undefined function mysqli_connect()。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Ubuntu装PHP 8.1 + FPM + 常用扩展：sudo apt install php8.1-cli php8.1-fpm php8.1-mysql php8.1-mbstring php8.1-xml php8.1-curl php8.1-zip -y
装完立刻运行php -v和php -m | grep -E "(mysql|mbstring)"，两项都得有输出
Apache用户还要执行sudo a2enmod php8.1并sudo systemctl restart apache2，否则PHP文件仍当静态文件处理
Nginx用户必须确认php8.1-fpm服务已启动：sudo systemctl is-active php8.1-fpm返回active才算到位

PHP与Web服务器的连接配置极易写错路径和socket地址

这是最常被跳过的步骤，也是502 Bad Gateway的头号来源。Nginx里fastcgi_pass写成127.0.0.1:9000还是unix:/run/php/php8.1-fpm.sock，取决于PHP-FPM池配置；Apache里DirectoryIndex漏掉index.php会导致打开目录显示403。

Nginx配置段中必须包含类似以下内容（路径需严格对应你的PHP-FPM实际socket）：

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}

检查PHP-FPM池配置：sudo nano /etc/php/8.1/fpm/pool.d/www.conf，确认listen = /run/php/php8.1-fpm.sock与Nginx中一致
Apache用户检查/etc/apache2/mods-enabled/dir.conf，确保DirectoryIndex行包含index.php，例如：DirectoryIndex index.html index.cgi index.pl index.php index.xhtml index.htm
改完配置必须分别执行sudo nginx -t && sudo systemctl reload nginx或sudo apache2ctl configtest && sudo systemctl reload apache2，不能只重启服务

phpinfo()验证必须放在真实Web路径下且权限无误

phpinfo()不是随便建个文件就能跑的。它必须放在Web服务器能访问的目录里（如/var/www/html/），且PHP进程要有读取权限；如果用sudo php -S本地起服务来测试，那跟线上环境完全脱节，测了也白测。

在Web根目录下创建/var/www/html/info.php，内容仅一行：
```
<?php phpinfo(); ?>
```
确保文件属主是www-data:www-data（Ubuntu）或apache:apache（CentOS），命令：sudo chown www-data:www-data /var/www/html/info.php
浏览器访问http://your_server_ip/info.php，页面顶部必须显示PHP版本，并在“Loaded Configuration File”行指出/etc/php/8.1/fpm/php.ini这类真实路径，而不是none
若页面空白但HTTP状态码是200，大概率是display_errors = Off且log_errors = On，去查/var/log/php8.1-fpm.log或/var/log/apache2/error.log