2.3 运行应用-Yii2框架从入门到精通(上)

当前位置:　首页>> 技术小册>> Yii2框架从入门到精通(上)

### 2.3 运行应用

在Yii2框架的学习旅程中，理解并成功运行你的第一个Yii2应用是至关重要的一步。这不仅标志着框架环境的正确配置，也是你深入探索Yii2强大功能和灵活性的起点。本章将详细指导你如何启动并运行一个基本的Yii2应用，涵盖从环境准备到应用访问的全过程。

#### 2.3.1 环境准备

在开始之前，确保你的开发环境已经安装了以下必需的软件：

1. **PHP**：Yii2框架要求PHP版本至少为5.4.0，但推荐使用PHP 7.1及以上版本以获得最佳性能和安全性。确保PHP CLI（命令行界面）也已安装并配置在系统的环境变量中，以便可以从任何位置访问它。

2. **Composer**：Composer是PHP的依赖管理工具，Yii2通过Composer进行安装和更新。你需要从[Composer官网](https://getcomposer.org/)下载并安装Composer。安装完成后，你可以通过命令行运行`composer -V`来检查是否安装成功并获取版本号。

3. **数据库**：Yii2支持多种数据库系统，但MySQL和PostgreSQL是最常用的。确保你已经安装了其中一种数据库系统，并创建了数据库实例，以及相应的用户权限设置。

4. **Web服务器**：Yii2应用可以在Apache、Nginx或任何其他支持PHP的Web服务器上运行。你可以选择安装一个完整的Web服务器环境，如XAMPP、MAMP（针对Mac用户）、WAMP（针对Windows用户）等，这些环境集成了PHP、MySQL和Web服务器软件，便于快速搭建开发环境。

5. **编辑器或IDE**：选择一个你熟悉的代码编辑器或集成开发环境（IDE），如Visual Studio Code、PhpStorm、Sublime Text等，以提高开发效率。

#### 2.3.2 创建Yii2项目

一旦环境准备就绪，你就可以通过Composer来创建一个新的Yii2项目了。打开你的命令行工具，切换到希望存放项目的目录，然后执行以下命令：

```bash
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
```

这里的`yiisoft/yii2-app-basic`是Yii2官方提供的一个基础应用模板，适合初学者和小型项目。`basic`是项目文件夹的名称，你可以根据需要更改为其他名称。

命令执行完成后，Composer会自动下载Yii2框架及其依赖，并创建一个名为`basic`（或你指定的名称）的目录，其中包含了一个完整的Yii2应用结构。

#### 2.3.3 配置数据库

接下来，你需要配置数据库连接。打开`basic/config/web.php`文件，找到`components`数组中的`db`配置项。这里是你设置数据库连接信息的地方。例如，如果你使用的是MySQL数据库，配置可能看起来像这样：

```php
'components' => [
    'db' => [
        'class' => 'yii\db\Connection',
        'charset' => 'utf8',
        'enableSchemaCache' => true,
        'schemaCacheDuration' => 3600,
        'schemaCache' => 'cache',
        'dsn' => 'mysql:host=localhost;dbname=your_database_name',
        'username' => 'your_username',
        'password' => 'your_password',
    ],
    // 其他组件配置...
],
```

请确保将`your_database_name`、`your_username`和`your_password`替换为你的数据库实际信息。

#### 2.3.4 运行迁移（可选）

Yii2应用通常使用迁移（Migrations）来管理数据库结构的变更。如果你的应用模板或后续开发中包含迁移文件，你需要运行这些迁移以创建或更新数据库表结构。在项目根目录下（即`basic`目录），执行以下命令来应用所有可用的迁移：

```bash
./yii migrate
```

如果一切设置正确，这个命令将会执行所有未应用的迁移，创建或修改数据库表以匹配应用的需求。

#### 2.3.5 访问应用

现在，一切准备就绪，你可以通过Web服务器来访问你的Yii2应用了。如果你使用的是XAMPP、MAMP或WAMP等集成环境，通常只需要将你的项目目录（这里是`basic`目录）设置为Web服务器的根目录或别名目录，然后通过浏览器访问相应的URL即可。

例如，如果你的Web服务器运行在本地机器上，并且`basic`目录被设置为Web根目录，你可以通过`http://localhost/`（或你的服务器配置的域名/IP地址）来访问应用。Yii2的默认首页通常会显示一个欢迎页面，包含一些基本信息和简单的导航链接。

#### 2.3.6 调试与日志

在开发过程中，了解和解决错误是不可避免的。Yii2提供了强大的调试和日志记录功能来帮助你。默认情况下，Yii2的调试工具栏（Debug Toolbar）在开发模式下是启用的，它会显示在页面的底部，提供关于当前请求的各种信息，如性能分析、数据库查询日志等。

此外，Yii2还使用日志系统来记录应用运行时的各种信息，包括错误、警告和调试信息等。你可以在`basic/runtime/logs`目录下找到日志文件，它们对于追踪和解决问题非常有用。

#### 2.3.7 安全性考虑

在将应用部署到生产环境之前，请确保你采取了适当的安全措施。这包括但不限于：

- 禁用调试模式，以防止敏感信息泄露。
- 配置好`.htaccess`（对于Apache服务器）或`nginx.conf`（对于Nginx服务器）文件，以增强安全性。
- 确保所有敏感文件（如数据库配置文件）的权限设置得当，避免未经授权的访问。
- 定期更新Yii2框架及其依赖，以获取最新的安全修复。

#### 结论

通过本章的学习，你应该已经能够成功搭建并运行一个基本的Yii2应用了。这不仅仅是一个简单的“Hello World”示例，而是你深入探索Yii2框架的起点。在接下来的章节中，我们将进一步学习Yii2的MVC架构、路由与控制器、视图与模板、模型与数据库操作等核心概念，帮助你从入门逐渐走向精通。记住，实践是学习编程的最佳方式，所以不妨动手尝试，通过构建自己的项目来加深对Yii2框架的理解。

该分类下的相关小册推荐：

Magento零基础到架构师(目录管理)

Yii2框架从入门到精通(下)

Laravel(10.x)从入门到精通(五)

PHP8入门与项目实战（6）

PHP安全之道

ThinkPHP项目开发实战

Laravel(10.x)从入门到精通(十八)

PHP高性能框架-Swoole

Laravel(10.x)从入门到精通(十一)

PHP8入门与项目实战（7）

PHP程序员的设计模式

PHP程序员面试笔试真题与解析