把 PHP 项目部署到服务器端口,核心就三件事:让 PHP 进程(PHP-FPM 或 Swoole/Workerman)在某个端口上跑起来,让 Nginx 或 Apache 把外部请求转发到这个端口,再在系统防火墙和云平台安全组里把这个端口放行。 少做一步,浏览器给你的回报就是 502、连接超时或者一片空白。
先弄清楚:PHP 项目部署到服务器端口到底指什么
很多人第一次接触这个问题会懵,因为 PHP 有两种完全不同的运行形态,端口玩法也完全不同。
FPM 模式,端口藏在 Nginx 后面
这是最常见的部署方式,浏览器访问 http://你的域名,请求打到 Nginx 的 80 端口,Nginx 判断是 PHP 请求,再通过 0.0.1:9000 或 unix socket 交给 PHP-FPM 处理。
在这个过程中,对外暴露的端口是 80 和 443,PHP-FPM 的 9000 端口只在服务器本机内部通信,不需要对外开放,这是行业共识认为最安全的一种安排,因为 9000 端口一旦对公网敞开,等于把 PHP 解析器直接摆到攻击者面前。
常驻内存模式,PHP 自己监听端口
用 Swoole、Workerman、RoadRunner 或者 Laravel Octane 跑的项目,PHP 进程本身就是一个 HTTP 服务器。php think worker:server 会监听 0.0.0:9501,这时端口就是项目自己持有的。
对外访问有两种做法:
- 直接访问
http://服务器IP:9501,需要安全组和防火墙都放行 9501 - 前面挂一层 Nginx,80 端口反向代理到
0.0.1:9501,9501 只监听本机
生产环境推荐第二种,直接暴露应用端口,一是没法和 80/443 统一管理,二是 SSL 证书、限流、日志都得再做一遍。
部署前必须确认的三件事
动手之前先确认环境,能省掉后面一大半排查时间。
- PHP 版本和扩展:项目
composer.json里的php约束是什么版本,有没有依赖redis、gd、bcmath、swoole这些扩展 - Web 服务器选型:Nginx 还是 Apache,两者配置写法和端口转发的语法不一样
- 端口规划:项目用哪个端口,这个端口有没有被 MySQL 的 3306、Redis 的 6379 或者别的服务占掉
查端口占用用一条命令就够:
ss -lntp | grep :9501 # 或者 netstat -tunlp | grep 9501
有输出说明被占了,换一个端口。
宝塔面板部署 PHP 项目并修改端口:新手友好的可视化路径
如果你用的是宝塔面板,整个流程可以完全在图形界面里完成,这种方式适合刚接手服务器、不熟悉 Linux 命令的开发者。
第一步:上传代码并建站点
在「网站」里点「添加站点」,填域名或直接用 IP,PHP 版本选对,数据库按需创建,宝塔会自动生成一个站点目录,把代码解压进去,入口文件指向 public/index.php 这类前端控制器。
第二步:修改站点监听端口
宝塔添加站点默认监听 80,要改成别的端口,进入站点设置,找到「配置文件」,把 listen 80; 改成 listen 8080;,保存,面板会自动重载 Nginx,不用手动重启。
也可以用命令行改,配置文件一般在 /www/server/panel/vhost/nginx/你的域名.conf。
第三步:放行端口
这一步最容易漏,宝塔的「安全」页面放行 8080,同时云厂商控制台的安全组也要加一条入站规则,两边都放行才通。
改完之后访问 http://服务器IP:8080 验证,如果面板本身开了防火墙插件,记得在插件里也放行。
纯命令行部署 PHP 项目到指定端口
不用面板的话,路径更清晰,也更适合做自动化。
安装运行环境
以 Ubuntu 为例,装 Nginx 和 PHP-FPM:
apt update apt install -y nginx php8.2-fpm php8.2-mysql php8.2-curl php8.2-mbstring
检查 PHP-FPM 监听的地址:
grep -r "listen" /etc/php/8.2/fpm/pool.d/www.conf
默认是 listen = /run/php/php8.2-fpm.sock,走 unix socket 比 TCP 快一点,如果你要改成 TCP,写成 listen = 127.0.0.1:9000,然后重启:
systemctl restart php8.2-fpm
配置 Nginx 虚拟主机
在 /etc/nginx/sites-available/ 下新建配置文件:
server {
listen 8080;
server_name 你的域名或IP;
root /var/www/html/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
}
软链接到 sites-enabled,nginx -t 检查语法,通过后 systemctl reload nginx。
关键点:listen 8080 决定了这个站点的入口端口,fastcgi_pass 决定了 PHP 请求交给谁处理,两个端口是独立的,不要混为一谈。
常驻内存项目怎么配
如果项目是 Swoole 这类自己监听端口的,Nginx 只需要做反向代理:
server {
listen 80;
server_name 你的域名;
location / {
proxy_pass http://127.0.0.1:9501;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
然后启动应用进程,注意用 nohup 或 systemd 守护,不然 SSH 一断开进程就没了:
nohup php think worker:server -d > /var/log/swoole.log 2>&1 &
业内专家指出,常驻内存模式下端口写死在本机回环地址比写 0.0.0 更稳妥,这样应用端口天然不对外暴露,攻击面直接少一层。
Nginx 反向代理 PHP 项目端口配置:多站点共用一个入口
一台服务器上跑三五个 PHP 项目是很常见的事,总不能每个项目都占一个公网端口,这时候用 Nginx 做统一入口,靠 server_name 区分站点,对外只开 80 和 443。
结构大概是这样:
- 项目 A:Nginx 反代 →
0.0.1:9501 - 项目 B:Nginx 反代 →
0.0.1:9502 - 项目 C:传统 FPM → unix socket
对外都是 http://a.example.com、http://b.example.com。这样做的代价是多一层转发损耗,好处是端口管理、SSL、访问日志全部收口,出了问题是查一处而不是查五处。
云服务器安全组:端口不通的第一嫌疑人
本地改好了配置,浏览器还是打不开,八成是云平台的网络层没放行,以简米云 ECS 为例,控制台进「安全组」→「配置规则」→「入方向」,手动添加一条:协议类型 TCP,端口范围按需填写(如 8080/8080),授权对象 0.0.0/0 或者限制到具体来源 IP。
酷番云叫「安全组」,华为云也是「安全组」,轻量应用服务器则叫「防火墙」,本质一样。不要图省事直接把 1/65535 全开,那等于把服务器脱光了挂网上,扫描器几小时内就会找上门。
系统层的防火墙也要同步放行:
ufw allow 8080/tcp # Ubuntu firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload # CentOS
端口访问失败的排查对照
| 现象 | 常见原因 | 验证方式 |
|---|---|---|
| 连接被拒绝 | 服务没起、端口没监听 | ss -lntp \| grep 端口号 |
| 连接超时 | 安全组或系统防火墙没放行 | 云控制台查入方向规则 |
| 502 Bad Gateway | PHP-FPM 没跑或 socket 路径错 | systemctl status php-fpm |
| 404 Not Found | root 路径指错,或 try_files 规则缺 | 看 Nginx error.log |
| 403 Forbidden | 目录权限或 SELinux 拦截 | ls -l 查属主属组 |
| 页面空白无报错 | PHP 致命错误被关掉了显示 | 开 display_errors 或看 FPM 日志 |
排查顺序建议从外往里:先 ping 通不通,再 telnet IP 端口 看端口通不通,最后看应用日志。不要一上来就改代码,大部分”项目跑不起来”其实卡在网络层。
云服务器部署 PHP 网站要多少钱:先算清这笔账
部署成本主要分三块:服务器、域名、带宽。
入门级云服务器(如 2 核 2G)年付通常落在几百元区间,用来跑一个中小型 PHP 站点绰绰有余,域名按后缀不同,一年几十到上百元,带宽方面,固定带宽和按流量计费要按站点访问量选,图片和视频多的站按流量算往往更划算。
需要提醒的是,便宜配置能不能扛住,取决于你的项目是 FPM 模式还是常驻内存模式,Swoole 项目常驻内存,内存占用比 FPM 模式高不少,2G 内存跑两个 Swoole 项目就吃紧了,这种情况建议直接上 4G 起步,别硬撑。
PHP 项目部署到服务器端口的常见疑问
PHP 项目部署到服务器端口后,为什么本机 curl 能通、外网访问不了?
基本可以锁定在网络层,本机 curl 127.0.0.1:端口 通,说明应用和 Nginx 配置没问题;外网不通,就是安全组或系统防火墙没放行,两个地方都检查一遍,顺序是先云控制台后系统防火墙。
部署 PHP 项目时端口能随便选吗?
不能,1024 以下的端口属于特权端口,需要 root 权限才能绑定;3306、6379、27017 这些是数据库默认端口,容易被扫描器盯上;还有一部分端口可能已经被面板或监控组件占用。建议在 8000 到 9999 之间挑一个,部署前先用 ss -lntp 确认没被占用。
一个 Nginx 能同时给多个 PHP 项目做端口转发吗?
可以,而且这是标准做法,每个项目写一个独立的 server 块,各自 listen 相同端口但 server_name 不同,fastcgi_pass 或 proxy_pass 指向各自的后端端口即可,Nginx 会根据请求头里的 Host 字段自动匹配到对应站点,互不干扰。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/807084.html


