外网部署PHP项目环境四大分步搭建方法-php教程-PHP中文网

外网能访问php项目不等于环境搭好，真正卡住的是请求进得来、php能执行、数据库连得上、安全不出事四层漏斗；任一层未对齐，就会出现空白页、502、connection refused或phpinfo页面但业务代码不运行。

外网部署php项目环境四大分步搭建方法

外网能访问 PHP 项目，不等于环境搭好了；真正卡住的，是「请求进得来、PHP 能执行、数据库连得上、安全不出事」这四层漏斗。只要其中一层没对齐，浏览器就只会显示空白页、502、Connection refused 或 phpinfo() 页面但业务代码不跑。

CentOS/RHEL 系统用 yum install httpd php 装完，默认不解析 .php 文件，也不加载模块。光重启服务没用。

AddType application/x-httpd-php .php 必须追加到 /etc/httpd/conf/httpd.conf 末尾，否则 Apache 当纯文本返回 .php 源码
DirectoryIndex 行要改成 DirectoryIndex index.php index.html，不然访问目录时不会自动找 index.php
LoadModule php_module modules/libphp.so 这行在新版 httpd 中默认被注释，且路径可能不对；实际路径可用 find /usr -name "libphp.so" 2>/dev/null 查，然后取消注释并修正

改完必须 systemctl restart httpd，不能只 reload —— mod_php 是静态编译进 httpd 的，reload 不触发模块重载。

这不是密码错，是 PHP 根本没连上 MySQL 进程。常见于：MySQL 绑定 127.0.0.1（IPv4）但 PHP 尝试走 ::1（IPv6），或防火墙拦了 3306。

先确认 MySQL 是否监听外网：ss -tlnp | grep :3306，看到 *:3306 才表示监听所有接口；若只显示 127.0.0.1:3306，需改 /etc/my.cnf 中的 bind-address = 0.0.0.0
再检查是否允许远程用户：mysql -u root -p -e "SELECT host,user FROM mysql.user;"，确保对应用户名的 host 是 % 或具体 IP，不是 localhost
最后确认防火墙：firewall-cmd --list-ports 看 3306 是否开放；没开就 firewall-cmd --permanent --add-port=3306/tcp && firewall-cmd --reload

注意：localhost 在 MySQL 客户端里会强制走 socket 连接，而 127.0.0.1 才走 TCP —— 所以 PHP 代码里写 mysqli_connect('127.0.0.1', ...) 才能真实复现网络链路问题。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

框架第一次运行会往 runtime 写缓存、日志；.env 读取失败则全站白屏。但宝塔默认把网站根目录设为 www 用户，而 PHP-FPM 进程可能以 apache 或 nginx 用户运行。

runtime 目录必须可写：chown -R www:www runtime/（宝塔）或 chown -R nginx:nginx runtime/（LNMP）
.env 文件权限不能是 600 —— 某些 PHP 版本下 getenv() 会因权限太严读不到，建议 chmod 644 .env
TP6 的 public 目录才是 Web 入口，别把整个项目放 /www/wwwroot/xxx，而是放 /www/wwwroot/xxx/public，否则路由和静态资源全 404

很多“部署成功但页面空白”的 case，其实只是 runtime/log 下连一个日志文件都没生成出来 —— 先看这个目录有没有被创建，比查 Nginx 错误日志更快定位。

内网穿透工具只解决「外网能连到你本地 80 端口」，但不保证「你的 PHP 服务真在监听那个端口」或「它愿意响应外网请求」。

Apache/Nginx 默认只监听 127.0.0.1:80，需显式改成 0.0.0.0:80 或删掉 Listen 后的 IP 限定
PHP-FPM 若配置了 listen.allowed_clients = 127.0.0.1（默认值），则 frp 转发来的请求会被直接拒绝，必须删掉或改成 0.0.0.0
某些路由器开启 UPnP 后，nat123 可能映射到错误的内网 IP（比如 Docker 容器 IP），实际应映射到宿主机的物理网卡 IP（ip a | grep inet 查）

最简单的验证方式：在另一台局域网电脑上，用内网 IP + 端口直连（如 http://192.168.1.100:8080），能通才说明服务本身没问题；如果局域网都打不开，就别急着调穿透工具。