新加坡服务器如何配置PHP运行环境,并验证网站能正常执行脚本?

发布人:A5数据发布时间:2026-11-03 11:40阅读量:84

在新加坡 Linux 服务器上首次部署 PHP 网站,可以用 Nginx 接收 HTTP 请求,再由 PHP-FPM 执行 PHP 脚本。下面以 Ubuntu 22.04/24.04、Nginx 和 PHP-FPM 为例,完成安装、站点配置及脚本验证;其他发行版的包名、服务名和配置路径可能不同,应先按系统实际情况核对。

根据全文核心主题形成自然、专业、克制的技术文章主题场景

开始前准备一个有 sudo 权限的账号,并确认服务器能访问软件源。若服务器已有网站或 Nginx 配置,先备份相关文件,避免覆盖现有站点。示例使用 example.com,操作时请替换为自己的域名和网站目录。验证阶段可以先在服务器本机测试,不要求域名解析已经生效。

A5idc数据提供新加坡物理服务器,覆盖网站、业务后台及数据库等场景所需的CPU、内存、存储和网络资源,可承载Nginx、PHP-FPM等常见运行环境。针对不同访问区域与程序负载,A5idc数据还提供多地区服务器及不同线路、SSD或NVMe存储组合,为建站和应用部署提供相应的硬件与网络基础。

1. 检查系统并备份现有配置

先确认发行版与版本:

cat /etc/os-release

输出中应能看到 Ubuntu 及版本信息。以下命令适用于 Ubuntu 使用的 APT 包管理器。检查是否已有 Nginx 或 PHP 服务:

nginx -v 2>&1
php -v
systemctl list-unit-files 'php*-fpm.service'

如果提示命令不存在,通常表示对应软件尚未安装;如果服务已存在,不要假定可以直接覆盖其配置。针对已有 Nginx 配置,可先备份主配置和站点配置:

sudo cp -a /etc/nginx /etc/nginx.backup.$(date +%Y%m%d-%H%M%S)

备份目录会生成在 /etc 下。若系统尚无 /etc/nginx,该命令会报错,可以跳过。

2. 安装 Nginx、PHP 与 PHP-FPM

更新软件包索引并安装基础组件:

sudo apt update
sudo apt install -y nginx php-fpm php-cli

如果应用需要数据库连接、XML 处理或文件压缩等功能,再安装对应扩展。例如:

sudo apt install -y php-mysql php-xml php-mbstring php-curl php-zip

扩展应按应用实际依赖选择,不必全部安装。安装后检查 PHP 命令行版本和已加载模块:

php -v
php -m

php -v 应显示 PHP 版本;php -m 会列出已加载的模块。PHP-FPM 的服务名通常包含版本号,先查询实际名称:

systemctl list-unit-files 'php*-fpm.service'

例如结果中出现 php8.3-fpm.service,后续服务操作就使用 php8.3-fpm。不要直接照搬示例版本号。确认服务状态:

sudo systemctl status php8.3-fpm --no-pager

将命令中的服务名替换成查询到的名称。若服务未启动,可启用并启动它:

sudo systemctl enable --now php8.3-fpm

成功时状态应为 active (running)。如果系统没有对应服务,先核对 PHP-FPM 是否安装成功,而不是继续配置 Nginx。

3. 创建网站目录与最小测试脚本

为示例站点创建目录:

sudo mkdir -p /var/www/example.com/public

写入一个用于验证 PHP 执行能力的脚本:

sudo tee /var/www/example.com/public/check.php >/dev/null <<'PHP'
<?php
header('Content-Type: text/plain; charset=utf-8');
echo "PHP_OK\n";
PHP

检查语法:

php -l /var/www/example.com/public/check.php

预期结果为 No syntax errors detected。设置目录和文件的可读权限:

sudo chown -R www-www-data /var/www/example.com
sudo find /var/www/example.com -type d -exec chmod 755 {} \;
sudo find /var/www/example.com -type f -exec chmod 644 {} \;

这些命令只作用于示例网站目录。不要为了排障把目录权限改成 777;Nginx 与 PHP-FPM 通常以 www-data 身份运行,目录可遍历、文件可读即可。

4. 配置 Nginx 将 PHP 请求交给 PHP-FPM

先查找 PHP-FPM 的 Unix socket:

ls -l /run/php/

常见结果会包含类似 php8.3-fpm.sock 的文件。若目录里没有 socket,先检查 FPM 服务状态及日志,不要把不存在的路径填入 Nginx 配置。

创建站点配置,示例中的 socket 路径需按上一步结果替换:

sudo tee /etc/nginx/sites-available/example.com >/dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    root /var/www/example.com/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    location ~ /\. {
        deny all;
    }
}
NGINX

将 server_name 改成自己的域名,并将 fastcgi_pass 中的 socket 文件名改成服务器上的实际路径。try_files $uri =404; 可避免把不存在的 PHP 路径交给 FPM 执行;隐藏文件规则用于拒绝访问以点开头的路径。

启用站点:

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com

如果提示链接已存在,先检查该链接指向的文件,不要直接删除或覆盖。验证配置语法:

sudo nginx -t

预期结果包含 syntax is ok 和 test is successful。只有检查通过后再重载 Nginx:

sudo systemctl reload nginx
sudo systemctl status nginx --no-pager

若 nginx -t 报错,先根据错误信息修正配置;不要在语法检查失败时重启或重载服务。

5. 验证 PHP 脚本能否执行

先在服务器本机通过 Nginx 请求站点。即使域名尚未解析,只要配置里的 server_name 已替换,也可以用 Host 请求头匹配虚拟主机:

curl -i -H 'Host: example.com' http://127.0.0.1/check.php

正常结果应包含 HTTP 200 状态以及正文:

PHP_OK

这说明请求经过 Nginx 后由 PHP-FPM 执行,而不是仅把 PHP 文件当作静态文件返回。若看到 PHP 源码、空白响应或 502 Bad Gateway,不要把该结果当作验证通过,按后文排查。

再测试首页路由。当前目录中还没有首页文件时,访问根路径返回 404 是正常的,不代表 PHP-FPM 故障。可临时创建首页脚本:

sudo tee /var/www/example.com/public/index.php >/dev/null <<'PHP'
<?php
echo "Home PHP_OK\n";
PHP

请求首页:

curl -i -H 'Host: example.com' http://127.0.0.1/

预期正文包含 Home PHP_OK。如果服务器启用了防火墙,且需要外部访问,还要确认 TCP 80 端口允许入站;若使用 UFW,先核对 SSH 规则,避免启用或调整防火墙时中断远程管理。HTTP 配置通过本机测试后,外部访问还取决于域名解析、云平台安全组及服务器防火墙规则。

常见失败处理

按从配置、服务到网络的顺序排查,可以先避免不必要地改动权限或防火墙。

现象优先检查判断与处理
nginx -t 报错Nginx 配置文件行号、括号、socket 路径修正语法或实际路径,再次运行 nginx -t;未通过前不要重载
返回 502 Bad GatewayPHP-FPM 服务状态、socket 是否存在、fastcgi_pass 路径服务未运行则启动;路径不一致时修改配置并重新测试、重载
返回 404 Not Foundserver_name、站点目录、请求文件是否存在用带 Host 请求头的本机命令测试;确认文件位于 root 指定目录
下载或显示 PHP 源码Nginx 是否命中 PHP 处理规则、FPM 是否正确配置检查站点配置中的 PHP location 和 fastcgi_pass;此时不要继续公开该站点
本机正常、外部无法访问域名解析、云平台安全组、主机防火墙先确认本机服务正常,再逐项检查外部入站路径和端口

需要查看日志时,可以使用:

sudo journalctl -u nginx -n 50 --no-pager
sudo journalctl -u php8.3-fpm -n 50 --no-pager
sudo tail -n 50 /var/log/nginx/error.log

将 php8.3-fpm 换成实际服务名。日志中的 socket 不存在、连接被拒绝等信息,通常指向 FPM 服务状态或 Nginx 与 FPM 的 socket 配置不一致。

完成检查与回滚

确认脚本可以执行后,删除公开可访问的测试脚本。正式站点若不需要示例首页,也应一并移除:

sudo rm -f /var/www/example.com/public/check.php
sudo rm -f /var/www/example.com/public/index.php

以上删除只针对本示例创建的文件;执行前确认路径,避免误删已有页面。随后复查 Nginx 配置并重载:

sudo nginx -t
sudo systemctl reload nginx

验收时逐项确认:

  • PHP-FPM 服务处于 active (running),socket 文件存在。
  • nginx -t 检查通过,Nginx 服务运行正常。
  • PHP 语法检查无错误,带 Host 请求头的测试请求曾返回 200 和预期正文。
  • 测试脚本已删除,站点目录权限没有放宽到 777。
  • 若需外网访问,域名、云平台入站规则和服务器防火墙已分别核对。

如果部署后需要回退站点配置,可先禁用新建的配置并检查其链接目标:

sudo rm /etc/nginx/sites-enabled/example.com
sudo nginx -t
sudo systemctl reload nginx

这里的删除对象是新建的站点启用链接,不是网站目录。若后续不再需要对应配置,再单独备份并移除 /etc/nginx/sites-available/example.com。不建议为回滚而直接卸载 PHP 或 Nginx,以免影响其他站点及依赖它们的服务。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7289.html

相关推荐