阿里云部署 ThinkPHP,上传代码只是其中一步。PHP 版本和扩展是否匹配、Nginx 是否指向正确入口、PHP-FPM 能不能写入运行目录,都会影响网站能否正常运行。下面以常见的 Ubuntu、Nginx、PHP-FPM 和 MySQL 组合为例,说明部署时需要核对的配置,以及上线后遇到问题时的排查顺序。不同 ThinkPHP 版本的要求并不完全相同,动手前先看项目依赖说明和部署文档。
一、先确认项目和服务器条件
准备服务器时,先列清楚项目使用的 ThinkPHP 版本、PHP 版本和数据库类型,再检查有没有 Redis、队列、定时任务等依赖。旧项目直接运行在较新的 PHP 版本上,可能出现语法兼容问题,也可能因为缺少扩展而无法启动。与其上线后逐个处理报错,不如先在测试环境确认依赖组合。
- 系统:选团队熟悉、仍在维护的 Linux 发行版,并记下具体版本。后续安装 PHP、排查软件包差异时,这些信息很有用。
- 服务器规格:测试或访问量较小的站点可以从较低配置开始;正式业务要结合并发量、后台任务和运行监控再调整,不能只按首页访问情况估算资源。
- 网络端口:在阿里云安全组中只开放实际需要的端口。一般要保留 SSH 管理端口以及网站使用的 80、443 端口;数据库端口不要直接暴露到公网。
- 域名和 HTTPS:提前完成域名解析,并准备好证书配置。上线后还要检查 HTTP 到 HTTPS 的跳转,以及页面中的静态资源是否仍通过正确协议加载。
服务器可以登录,不代表已经满足上线条件。部署前整理依赖清单,并在本地或测试环境实际跑一遍项目,能更早发现版本、配置和数据库方面的问题。
二、安装运行环境并部署代码
登录服务器后更新系统软件包,再安装 Nginx、项目要求的 PHP 版本及 PHP-FPM,以及 MySQL 或项目兼容的数据库。PHP 扩展要按项目依赖逐项核对,常见的有 PDO、OpenSSL、Mbstring 和 CURL。扩展名称与安装方式会随系统和 PHP 版本变化;安装后可以用 php -m 查看命令行环境已加载的扩展。
要留意,命令行 PHP 和 PHP-FPM 使用的配置不一定相同。即使 php -m 中能看到某个扩展,网站请求仍可能报扩展缺失。出现这种情况时,应检查 PHP-FPM 实际使用的版本和配置,并在调整后确认服务已加载新配置。
代码可以通过 Git、CI/CD 或受控的文件传输方式发布。不要把开发机上的所有文件原样搬到线上,尤其要检查本地数据库、日志、缓存和开发环境配置是否混入发布内容。项目使用 Composer 时,按锁定文件安装依赖;生产环境可以采用不安装开发依赖的方式,但要先确认构建流程需要的工具和文件都已准备好。
目录权限也应在部署时规划清楚。Nginx 和 PHP-FPM 需要读取项目代码,应用运行时则可能需要写入特定目录。ThinkPHP 项目常见的可写内容包括缓存和日志,但具体目录以当前版本及项目配置为准。不要为了省事把整个项目设成所有用户都可读写,权限过宽会增加安全风险,也会让真正的权限问题更难定位。
三、配置 Nginx、入口和数据库
Nginx 的网站根目录通常应指向项目的公开入口目录,例如 public,而不是项目根目录。这样可以避免配置文件、依赖代码等内容被直接访问。动态请求需要交给 PHP-FPM,URL 重写规则则负责把符合条件的请求转到项目入口,让不带脚本文件名的路由正常工作。
不同 ThinkPHP 版本的入口文件和伪静态规则可能不同,网上的配置片段不能不加检查就直接套用。先对照项目文档中的 Nginx 示例,再核对 PHP-FPM 的 socket 或监听地址是否与服务器上的实际配置一致。修改完成后运行 nginx -t 检查语法;检查通过,再平滑重载 Nginx,避免配置错误直接影响现有服务。
数据库连接信息应放在生产环境配置中,不要提交到公开代码仓库。核对数据库名称、连接地址、账号密码和字符集后,使用权限受限的应用账号连接。应用一般只需要访问指定数据库,不必拥有管理整个数据库实例的权限。如果数据库与网站部署在同一台服务器,通常也不需要为了应用连接而向公网开放数据库端口。
四、案例:小型预约网站上线
某工作室准备上线一个 ThinkPHP 预约网站,功能包括用户提交预约、后台查看记录和发送邮件通知。团队先确认项目所需的 PHP 版本与扩展,在阿里云测试服务器上安装对应环境,再通过 Git 部署代码。随后创建专用数据库和应用账号,导入检查过的初始化数据,并把 Nginx 根目录设置为项目的 public 目录。
首次访问时首页可以打开,但提交预约表单后出现运行时错误。查看日志后发现,运行时目录的归属用户与 PHP-FPM 的运行用户不一致,应用无法写入缓存和日志。处理时只调整项目要求写入的目录,没有给整个项目开放写权限。修复后,团队重新测试表单提交、后台登录和通知功能。首页能显示,只能说明入口基本可用,不能替代对实际业务流程的验收。
五、上线检查与常见故障排查
- 白屏或 502:先确认 PHP-FPM 是否运行,再核对 Nginx 配置中的连接地址与 FPM 实际监听地址是否一致。结合 Nginx 错误日志和 PHP 日志判断故障发生在哪一层。
- 路由返回 404:检查 Nginx 重写规则是否适用于当前 ThinkPHP 版本,并确认网站根目录指向正确入口。若首页正常、部分路由失败,也要核对项目自己的路由配置。
- 缓存或日志写入失败:查看 PHP-FPM 运行用户,以及项目要求可写的目录权限。不要用递归开放整个项目权限的做法掩盖问题,应只修改需要写入的目录。
- 数据库连接失败:检查连接地址、端口、账号权限和安全组规则。若数据库位于另一台服务器,还要确认两台服务器之间的访问路径;若在同一台服务器,通常无需开放公网数据库端口。
- 页面正常但业务异常:继续检查 PHP 扩展、环境变量、时区、数据库迁移和第三方服务配置,并查看应用日志。页面能加载,不代表表单、文件上传和后台操作都已通过验证。
切换正式域名前,至少走通首页、登录、表单提交、文件上传和后台操作,并检查错误日志。启用 HTTPS 后,再核对证书、续期方式、跳转规则和静态资源加载。部署完成后安排数据库备份、代码回滚和基础监控;备份文件应保存在独立位置,并定期验证是否能够恢复。只看到备份任务显示成功,并不能证明恢复过程没有问题。
部署完成后还要留意什么
阿里云部署 ThinkPHP 时,PHP 版本与扩展、Nginx 入口、数据库账号和目录权限都要与项目实际情况对应。部署前核对依赖,测试环境先验证配置,上线时再逐项检查业务功能,通常比出错后临时放开权限或反复替换配置更稳妥。项目持续更新时,也可以把依赖安装、配置检查和发布步骤纳入自动化流程,减少不同批次部署之间的差异。