Yii框架安装教程详解

首先安装PHP 7.4+并配置环境变量，验证php -v；接着安装Apache并配置php模块与处理器；然后安装Composer并设置国内镜像；使用composer create-project创建Yii2项目；最后配置config/db.php连接数据库并执行迁移。

如果您希望在本地搭建Yii框架的开发环境，但对PHP框架部署流程不熟悉，可能会遇到依赖缺失或配置错误的问题。以下是完成Yii框架环境安装的具体操作步骤：

一、安装PHP环境

Yii框架基于PHP语言运行，必须先配置支持其版本要求的PHP环境。建议使用PHP 7.4或更高版本以确保兼容性。

1、访问PHP官方网站下载与操作系统匹配的PHP二进制包。

2、解压文件到指定目录，例如 C:\php 或 /usr/local/php。

3、将PHP主目录添加至系统环境变量PATH中，以便在命令行全局调用php命令。

4、在终端执行 php -v 验证是否正确安装并显示版本信息。

二、配置Web服务器（以Apache为例）

为使Yii应用可通过浏览器访问，需配置支持PHP的Web服务器。Apache是常见选择之一，通过集成模块方式支持PHP解析。

1、下载并安装Apache HTTP Server，推荐从官网获取最新稳定版。

2、编辑 httpd.conf 配置文件，定位到LoadModule区域，添加如下行启用PHP模块：

LoadModule php_module 'C:/php/php8apache2_4.dll'

3、在相同配置文件中添加PHP处理器和默认首页文件：

AddHandler application/x-httpd-php .php

DirectoryIndex index.php index.html

4、重启Apache服务，并在htdocs目录下创建test.php文件测试PHP解析功能。

三、安装Composer依赖管理工具

Yii框架通过Composer管理类库和第三方包，因此必须预先安装该工具才能顺利初始化项目。

1、访问Composer官网下载Windows Installer或Linux脚本安装程序。

2、运行安装向导，确保勾选“Add to PATH”选项以便全局使用。

3、打开新终端窗口，输入 composer --version 检查是否成功安装。

4、若因网络问题导致下载缓慢，可设置国内镜像源加速：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

四、创建Yii项目（以Yii2 Basic Application为例）

使用Composer创建新的Yii2基础应用模板，适用于轻量级Web项目的快速启动。

1、在命令行中执行以下命令创建项目：

composer create-project yiisoft/yii2-app-basic basic

2、等待依赖自动安装完成后，进入项目根目录：cd basic。

3、确认web目录下的index.php具备正确的入口逻辑。

4、可使用内置PHP服务器进行初步测试：

php yii serve --port=8080

五、配置数据库连接（可选）

如需使用Yii提供的Active Record功能操作数据，应提前配置数据库连接参数。

1、打开项目中的 config/db.php 文件。

2、修改dsn、username、password字段以匹配本地数据库设置，示例如下：

'dsn' => 'mysql:host=localhost;dbname=yii2basic',

'username' => 'root',

'password' => 'your_password',

3、确保MySQL或PostgreSQL服务正在运行，并已创建对应数据库实例。

4、可通过执行 php yii migrate 来初始化基本数据表结构。