部署Yii2 API需先配置PHP 7.4+及扩展、Composer、Nginx和MySQL，再上传项目代码并安装依赖，设置目录权限，配置Nginx指向web目录，最后导入数据库并更新db.php连接信息。
将 PHP 项目部署到 Yii2 API 环境，关键在于正确配置服务器环境、迁移代码、设置 Web 服务并确保数据库和安全策略就位。以下是详细的部署与运行环境配置方法。
1. 准备运行环境
Yii2 对 PHP 版本有明确要求，通常需要 PHP 7.4 或更高版本（推荐 8.0+）。确保服务器满足以下基础依赖：
-
• 安装 PHP 及必要扩展：pdo_mysql, mbstring, openssl, gd, curl, xml, intl
• 安装 Composer（PHP 依赖管理工具）
• 安装并配置 Web 服务器（Nginx 或 Apache）
• 安装 MySQL 或兼容数据库
以 Ubuntu 为例，执行以下命令安装基本环境：
sudo apt updatesudo apt install php-fpm php-mysql php-mbstring php-xml php-curl php-intl nginx mysql-server composer
2. 部署 Yii2 API 项目代码
将本地开发的 yii2api 项目上传到服务器指定目录，例如 /var/www/yii2api：
立即学习“PHP免费学习笔记（深入）”；
-
• 使用 git clone 拉取代码（推荐）
• 或通过 scp、rsync 上传打包文件
• 进入项目根目录执行 composer install --no-dev 安装生产依赖
设置正确的文件权限，确保 Web 服务可读写 runtime 和 assets 目录：
sudo chown -R www-data:www-data /var/www/yii2api
sudo chmod -R 755 /var/www/yii2api/runtime
3. 配置 Web 服务器（以 Nginx 为例）
创建 Nginx 配置文件 /etc/nginx/sites-available/yii2api，内容如下：
server {listen 80;
server_name api.example.com;
root /var/www/yii2api/web;
index index.php;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}
}
启用站点并重启 Nginx：
sudo ln -s /etc/nginx/sites-available/yii2api /etc/nginx/sites-enabled/sudo nginx -t && sudo systemctl reload nginx
4. 数据库与应用配置
导入数据库结构和数据：
-
• 修改 config/db.php 中的数据库连接信息
• 使用 mysql -u user -p dbname
• 如使用迁移，运行 php yii migrate
调整应用配置以适应生产环境：
-
• 设置 YII_ENV 为 'prod'，YII_DEBUG 为 false
• 在入口文件 index.php 前添加：defined('YII_ENV') or define('YII_ENV', 'prod');
• 配置日志路径和错误处理机制
基本上就这些。只要环境装好、路径配对、权限设准，yii2api 就能稳定运行。注意定期更新依赖和备份数据，避免安全漏洞。
