1. Yii框架概述与环境准备Yii是一个高性能的PHP框架特别适合开发大型Web应用。作为一个全栈框架它提供了MVC、DAO/ActiveRecord、缓存、身份验证和授权等全套功能。最新稳定版本Yii 2.0采用模块化设计通过Composer管理依赖使扩展安装和更新变得异常简单。在开始安装前请确保系统满足以下最低要求PHP 5.4或更高版本推荐PHP 7.4启用的PDO扩展如需数据库支持Web服务器Apache/Nginx/IIS2GB以上可用磁盘空间提示可通过php -v命令检查PHP版本使用php -m查看已加载扩展。若缺少必要扩展在Ubuntu中可通过sudo apt-get install php-mysql等命令安装。2. 通过Composer安装Yii2.1 Composer安装与配置Composer是PHP的依赖管理工具也是安装Yii的推荐方式。在Linux/macOS终端执行php -r copy(https://getcomposer.org/installer, composer-setup.php); php composer-setup.php php -r unlink(composer-setup.php); sudo mv composer.phar /usr/local/bin/composerWindows用户可直接下载Composer-Setup.exe安装。安装后运行composer -V验证是否成功。常见问题若遇到SSL证书错误尝试执行composer config -g disable-tls true临时关闭TLS验证但完成安装后应立即恢复。2.2 创建Yii项目在项目目录执行以下命令安装基础模板composer create-project --prefer-dist yiisoft/yii2-app-basic myproject安装过程可能持续5-15分钟具体取决于网络速度。关键步骤包括下载Yii核心包约15MB解析依赖关系树安装必要组件如bootstrap、jQuery等前端资源性能优化添加--profile参数可显示详细耗时如composer create-project --profile yiisoft/yii2-app-basic myproject3. 项目结构与配置调整3.1 目录结构解析安装完成后项目主要目录结构如下myproject/ ├── assets/ # 前端资源编译目录 ├── commands/ # 控制台命令 ├── config/ # 应用配置 │ ├── console.php # 控制台配置 │ └── web.php # Web应用配置 ├── controllers/ # 控制器 ├── mail/ # 邮件模板 ├── models/ # 数据模型 ├── runtime/ # 运行时文件 ├── tests/ # 测试用例 ├── vendor/ # Composer依赖包 ├── views/ # 视图文件 └── web/ # Web可访问目录 ├── assets/ # 发布的前端资源 └── index.php # 入口脚本3.2 关键配置修改数据库配置config/db.phpreturn [ class yii\db\Connection, dsn mysql:hostlocalhost;dbnamemydatabase, username root, password yourpassword, charset utf8, ];应用参数config/params.phpreturn [ adminEmail adminexample.com, supportEmail supportexample.com, user.passwordResetTokenExpire 3600, ];安全提醒务必在.gitignore中添加config/db.php防止敏感信息泄露。4. 本地开发环境搭建4.1 内置Web服务器Yii提供快速启动的开发服务器php yii serve默认监听8080端口可通过--port参数修改php yii serve --port88884.2 虚拟主机配置Apache示例对于长期项目建议配置虚拟主机。在Apache的httpd-vhosts.conf中添加VirtualHost *:80 ServerName myproject.test DocumentRoot /path/to/myproject/web Directory /path/to/myproject/web RewriteEngine on RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . index.php /Directory /VirtualHost然后在hosts文件添加127.0.0.1 myproject.test4.3 验证安装访问http://localhost:8080应看到Yii欢迎页面。若出现错误检查PHP版本是否符合要求web/assets目录是否可写必要的PHP扩展是否加载mbstring, openssl等可通过内置检查脚本验证环境php requirements.php5. 生产环境部署要点5.1 性能优化配置启用OPcachephp.iniopcache.enable1 opcache.memory_consumption128 opcache.max_accelerated_files4000配置Yii缓存组件config/web.phpcomponents [ cache [ class yii\caching\FileCache, // 生产环境建议使用Redis或Memcached // class yii\redis\Cache, // redis [ // hostname localhost, // port 6379, // ] ], ]5.2 安全加固措施禁用调试模式config/web.phpdefined(YII_DEBUG) or define(YII_DEBUG, false); defined(YII_ENV) or define(YII_ENV, prod);设置CSRF保护components [ request [ cookieValidationKey 你的随机密钥, enableCsrfValidation true, ], ]目录权限设置chmod -R 755 myproject/web/assets chmod -R 644 myproject/config5.3 Nginx推荐配置server { listen 80; server_name yourdomain.com; root /path/to/myproject/web; location / { try_files $uri $uri/ /index.php?$args; } location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/run/php/php7.4-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param HTTPS off; } location ~ /\.(ht|svn|git) { deny all; } }6. 常见问题解决方案6.1 Composer安装失败问题现象[Composer\Downloader\TransportException]解决方案临时切换国内镜像composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/或配置Github tokencomposer config -g github-oauth.github.com your_token6.2 资产包安装问题问题现象bower-asset/jquery not found解决方案安装asset-plugincomposer global require fxp/composer-asset-plugin:^1.4.0或在composer.json添加repositories: [ { type: composer, url: https://asset-packagist.org } ]6.3 数据库连接错误典型错误PDOException: could not find driver排查步骤检查PDO扩展是否安装php -m | grep pdo安装对应数据库驱动# MySQL示例 sudo apt-get install php-mysql7. 进阶配置与扩展7.1 多环境配置管理通过环境变量区分配置// config/web.php $config require __DIR__ . /web.php; if (YII_ENV_DEV) { $config[bootstrap][] debug; $config[modules][debug] [ class yii\debug\Module, ]; } return $config;7.2 定时任务配置使用Yii控制台命令创建命令php yii console/create-command example添加crontab* * * * * /usr/bin/php /path/to/yii example /var/log/yii-cron.log 217.3 邮件系统集成配置SwiftMailer组件mailer [ class yii\swiftmailer\Mailer, transport [ class Swift_SmtpTransport, host smtp.example.com, username userexample.com, password password, port 587, encryption tls, ], ],8. 项目维护与升级8.1 版本升级流程备份关键文件cp composer.json composer.json.bak更新依赖composer update yiisoft/yii2 --with-dependencies检查破坏性变更php yii migrate/up --interactive08.2 性能监控建议安装调试工具栏composer require --dev yiisoft/yii2-debug配置日志组件log [ targets [ [ class yii\log\FileTarget, levels [error, warning], logFile runtime/logs/app.log, ], ], ],8.3 备份策略推荐备份以下内容数据库定期dumpconfig/目录web/uploads/用户上传文件runtime/logs/日志文件示例备份脚本mysqldump -u user -p database backup_$(date %F).sql tar -czf config_backup_$(date %F).tar.gz config/