Yii Framework 教程 (1)：建立第一個 Hello World 應用

教程定位

本系列面向 Windows 桌面/ASP.NET 開發者，以 Visual Studio + VS.PHP 為 IDE，從 C++/C# 視角解析 Yii，助你快速跨平台開發（Linux/Windows/Mac 通用）。

環境準備

1. 下載 Yii Framework 1.1.12：官方下載頁
2. 解壓至 C:\yiiframework\（或任意路徑）
3. 安裝 VS.PHP（內建 Apache），或 XAMPP + MySQL

建立第一個專案

1. 開啟 VS.PHP，選擇 New Project → PHP Web Application
2. 專案名稱：HelloWorld
3. 建立入口腳本 index.php：

<?php
// 修改為實際 Yii 路徑
$yii = 'C:/yiiframework/yii.php';

// 開發模式開啟除錯
defined('YII_DEBUG') or define('YII_DEBUG', true);

require_once($yii);
Yii::createWebApplication()->run();

建立控制器與視圖

控制器：protected/controllers/SiteController.php

<?php
class SiteController extends CController {
    public function actionIndex() {
        $this->render('index');
    }
}

視圖：protected/views/site/index.php

<h1>Hello World!</h1>
<p>Welcome to Yii Framework!</p>

配置預設控制器

建立 protected/config/main.php：

<?php
return array(
    'name' => 'Hello World',
    'defaultController' => 'site',
);

修改 index.php 載入配置：

$config = dirname(__FILE__) . '/protected/config/main.php';
Yii::createWebApplication($config)->run();

執行結果

瀏覽器訪問 https://localhost/HelloWorld/ 即可看到輸出。

關鍵概念回顧

• 入口腳本：所有請求的起點，建立應用實例並運行
• CWebApplication：應用單例，Yii::app() 隨處可取得
• 控制器：處理請求、協調模型與視圖
• 視圖：純輸出模板，由控制器 render() 呼叫