把 ThinkPHP 项目部署到阿里云,代码传上服务器只是开始。PHP 版本、扩展、目录权限、数据库连接和 Web 服务配置只要有一项不匹配,网站就可能打不开,或上线后某个功能无法使用。本文以 Ubuntu 系统的阿里云 ECS 为例,梳理从准备服务器到配置域名的基本步骤。
不同 ThinkPHP 版本及项目依赖对 PHP 的要求可能不同。动手前先查看项目根目录的 composer.json、环境配置示例和对应版本的部署文档,确认 PHP 版本、所需扩展及数据库类型。先把这些信息核对清楚,比环境装好后再排查兼容问题省事。
一、确认项目与 ECS 条件
先列出项目使用的 ThinkPHP 版本、PHP 版本、扩展和数据库版本。常见扩展包括 PDO、OpenSSL、Mbstring、CURL,实际以项目依赖为准。若项目通过 Composer 管理依赖,确认服务器是否需要执行 composer install;生产环境通常加上 --no-dev,避免安装只用于开发的依赖。
在阿里云控制台创建 ECS 时,根据项目负载选择操作系统和配置。测试站点可以从较低配置开始,正式业务则要把访问量、任务队列和数据库负载一并考虑。安全组只开放实际需要的端口:SSH 管理端口、HTTP 的 80 端口和 HTTPS 的 443 端口。数据库端口一般不应直接开放给公网访问。
二、安装运行环境并部署代码
Ubuntu 服务器上通常需要安装 Nginx、PHP-FPM、项目所需的 PHP 扩展,以及 MySQL 或项目实际使用的数据库。软件包名称和 PHP 版本会随 Ubuntu 版本变化,安装前先确认系统仓库提供的版本是否符合项目要求;如需使用其他来源,按阿里云镜像站或 PHP 官方渠道的说明操作。安装后用 php -v 检查 PHP 版本,用 php -m 查看扩展,并确认 Nginx 和 PHP-FPM 已启动。
项目可以通过 Git 拉取,也可以打包后上传到服务器,例如放在 /var/www/myapp。生产环境配置应在服务器上单独管理,不要把数据库密码、云密钥等敏感信息提交到公开仓库。配置文件的读取权限也要收紧,避免不必要的用户访问。
Nginx 的网站根目录应指向项目的 public 目录,不要直接指向整个项目目录。这样可以降低配置文件和依赖目录被外部访问的风险。ThinkPHP 的伪静态规则会因版本和项目结构而异,应参照当前版本的部署文档配置,让无法直接命中的请求交给应用入口处理。
修改 Nginx 配置后,先运行 nginx -t 检查语法,再平滑重载服务。如果页面返回 502,优先检查 PHP-FPM 是否运行,以及 Nginx 配置中的 socket 路径或监听端口是否与 PHP-FPM 一致。
三、配置数据库与项目参数
为应用创建独立的业务库和数据库账号,只授予项目需要的权限,不要让应用直接使用 root 账号连接。随后按项目说明导入初始化 SQL,或执行数据库迁移脚本。主机地址、库名、用户名和密码要与实际配置一致;数据库若部署在另一台服务器上,还要检查内网连通性和访问白名单。
ThinkPHP 的环境变量和数据库配置位置会因版本、项目结构而不同。先查看项目已有的 .env 示例及配置目录,不要直接套用网上其他版本的配置文件。遇到数据库连接错误时,按顺序检查数据库服务状态、账号权限、密码、端口和字符集,通常比反复改应用代码更容易定位问题。
四、处理权限、域名和 HTTPS
日常部署尽量使用普通部署用户,不要长期用 root 管理项目。应用只需要对缓存、日志和上传等目录写入时,就只开放这些目录的写权限。不要为了消除报错,把整个项目目录改成 777。仍无法写入时,先查看 PHP-FPM 的运行用户、目录所有者和错误日志,再针对具体目录调整权限。
将域名解析到 ECS 公网 IP 后,在 Nginx 中配置对应域名。根据适用要求完成备案,再通过证书服务或可信证书签发渠道配置 HTTPS,并设置 HTTP 自动跳转到 HTTPS。上线前还要检查上传文件类型和大小限制、错误页面是否暴露调试信息,以及日志轮转和备份是否有安排。
五、部署案例:商品展示站
假设一个工作室要上线 ThinkPHP 商品展示站,开发环境使用 PHP 8.1 和 MySQL,代码托管在私有 Git 仓库。部署前先核对 composer.json,确认服务器上的 PHP 版本和扩展满足依赖;然后拉取代码、安装生产依赖,创建商品库和专用账号并导入初始数据,最后把 Nginx 根目录设为项目的 public 目录。
首次访问时,页面提示缓存目录不可写。运维人员查看 PHP-FPM 的运行用户后,只调整缓存和日志目录的所有者,没有把整个项目改成 777。随后首页虽然能打开,图片却无法显示。排查发现图片存放在本地上传目录,而该目录没有随代码发布。补齐上传文件、安排备份后,再验证 HTTPS、后台登录和数据库读写,站点才正式开放。
这个过程也提醒了部署人员:首页能访问,不代表业务已经验收。商品图片、后台登录、表单提交和数据库读写等实际路径,都应逐项测试。
六、上线前检查
- 确认 PHP 版本和扩展满足 ThinkPHP 及 Composer 依赖要求。
- 检查 Nginx 根目录是否指向
public,伪静态规则是否适配当前项目版本。 - 确认数据库账号权限有限,数据库没有暴露到公网。
- 检查缓存、日志和上传目录权限,并关闭生产环境调试模式。
- 实际测试登录、表单提交、文件上传、定时任务和异常页面。
- 安排代码、数据库和上传文件的定期备份,并验证备份能够恢复。
阿里云搭建 ThinkPHP 时,先按项目要求匹配运行环境,再检查 Web 根目录、文件权限和数据库访问。正式上线前,建议在测试环境完整走一遍部署流程,记录软件版本、配置和恢复步骤。这样遇到故障时更容易定位,也方便后续维护或迁移。