把 Yii2 项目部署到阿里云,代码能上传、首页能打开,只算完成了一部分。PHP 版本不匹配会导致依赖安装失败,站点根目录设错可能暴露项目文件,目录权限不当则会让上传或缓存功能失效。以下按上线顺序检查 7 项配置,适用于运行 Linux 的云服务器。
1. 确认服务器规格与运行环境
先核对项目的 PHP 版本、Yii2 版本和扩展要求,再选择匹配的服务器镜像。打开 composer.json,检查 PHP 版本约束以及 PDO、OpenSSL、Mbstring 等扩展是否齐全。不要只看服务器能否安装 PHP,还要确认版本符合项目依赖。
云服务器 ECS 用于运行 Nginx、PHP-FPM 和应用。测试环境可以先从较小规格开始,正式环境则应结合访问量、任务负载和监控数据调整。小型项目可以暂时使用同机数据库;生产环境通常更适合将数据库放在 RDS,减少与应用争用资源,也便于管理备份。用户上传的图片和附件较多时,可考虑使用 OSS,避免长期占用服务器磁盘。
2. 检查地域、安全组和网络访问
服务器、数据库的地域应结合业务用户分布和网络架构选择。安全组只开放业务需要的端口,网站通常需要 80 和 443;SSH 管理端口应限制来源 IP,不要为了省事对所有公网地址开放。若使用 RDS,应用服务器优先通过私网连接,数据库端口不应直接暴露到公网。
3. 安装项目依赖并选对站点目录
建议从代码仓库拉取已经测试的版本,避免直接在服务器上手工修改业务代码。进入项目目录后,可使用 composer install –no-dev –prefer-dist –optimize-autoloader 安装生产依赖。安装前确认服务器 PHP 版本与锁定的依赖兼容。
Yii2 基础模板和高级模板的目录结构不同,站点根目录不能一概而论。基础模板通常使用 web 目录作为入口;高级模板则应指向前端应用对应的 web 目录。不要把整个项目根目录交给 Web 服务,否则配置文件、依赖清单等内容可能被外部访问。
4. 设置生产配置、数据库和目录权限
生产环境要关闭调试模式。数据库密码、云访问密钥和第三方服务密钥不要提交到公开代码仓库,可通过环境变量或服务器上的独立配置文件提供,并限制文件读取权限。数据库组件中的连接地址、库名、用户名和字符集也要逐项核对。使用 RDS 时,还需在白名单或网络访问控制中加入应用服务器的私网地址。
检查 runtime、web/assets 等目录能否由 PHP-FPM 运行用户写入,只给确实需要写入的目录授权。不要图省事把整个项目目录设成可写。首次部署涉及数据库迁移时,先在测试环境执行 Yii2 控制台命令并确认结果,再应用到生产库。
5. 配置 Nginx 与 PHP-FPM
Nginx 站点根目录应指向 Yii2 的 web 目录,并将 PHP 请求交给 PHP-FPM。配置中需要支持 Yii2 路由重写,同时限制对隐藏文件、配置文件及其他非公开目录的访问。不同模板和 Nginx 版本的写法可能不同,修改后先执行配置检查,再平滑重载服务。
PHP-FPM 使用的 PHP 版本、扩展和运行用户也要与项目配置一致。遇到 502 时,先查看 PHP-FPM 是否运行,再检查套接字或端口配置及错误日志。首页能打开、内部路由却返回 404,通常要核对 Nginx 重写规则和 Yii2 URL 管理器配置。
6. 验证业务流程、域名和 HTTPS
以使用 Yii2 高级模板的小型服装商城为例,前台展示商品,后台维护库存和订单。前台站点指向对应的 web 目录,商品图片存入 OSS,数据库使用 RDS,应用服务器通过私网连接数据库。这样更换应用服务器时,图片和业务数据不会跟着单机文件一起丢失。
上线测试不能只看首页。至少要登录后台、创建商品、上传图片、提交订单并查看订单状态,也要确认邮件或短信等外部服务正常。图片上传成功但页面无法显示时,先检查 OSS 访问权限、对象路径和域名配置,不要直接把存储桶改成完全公开。
域名解析到服务器公网 IP 后,为站点配置 HTTPS,并确认 HTTP 请求会按预期跳转到 HTTPS。上线前移除测试账号和示例页面,检查错误日志是否泄露服务器路径、SQL 或敏感参数。
7. 安排备份、监控和后续发布
- 数据库账号只授予应用实际需要的权限,服务器和 Yii2 依赖及时更新;重要改动先在测试环境验证。
- 定期备份数据库,并抽查备份能否恢复。只生成备份文件,不代表故障时一定能恢复。
- 监控磁盘空间、CPU、内存、响应时间和错误日志,按需要设置告警。
- 每次发布前备份数据库和当前版本,使用可回滚的部署流程;升级依赖或执行迁移前,先确认兼容性。
访问量增长后,再依据监控结果考虑负载均衡、独立缓存、CDN 或更高规格实例。项目初期不必一次堆上所有服务。把入口目录、权限、网络访问和恢复流程检查清楚,Yii2 阿里云部署的日常维护会更有把握。