Yii是PHP的一个高级web应用开发框架，它遵循MVC（模型-视图-控制器）设计模式。Yii框架提供了许多内置的工具和组件，以加快开发速度并减少重复代码。其中一个非常有用的特性就是Widget，它是一种可以重用的代码块，可以用于生成HTML输出。Widget在Yii中扮演的角色相当于小程序，它封装了界面展示和逻辑处理，使得开发者可以在不同的地方轻松地重用相同的代码块。
创建一个自定义的Widget实例包括以下几个步骤：
1. 调用Widget：在视图文件（.php文件）中，可以通过简单地调用`$this->widget('WidgetName');`或`$widget=$this->beginWidget('path.to.WidgetClass');`的方式引入已经存在的Yii内置Widget或者用户自定义的Widget。这里`WidgetName`是内置Widget的名称或者用户自定义Widget的类名。还可以通过数组方式传递参数到Widget类，例如`$this->widget('WidgetName', array('userId' => $userId));`，其中`userId`参数会被自动映射到Widget类的同名属性。
2. 创建Widget类：自定义Widget类需要继承自Yii的基类`CWidget`，并且需要覆盖`run`方法。`run`方法是Widget的入口点，所有的Widget逻辑应该放置在这个方法中。此外，还可以重写`init`方法，该方法在Widget开始运行时由`CController::beginWidget()`调用。一个典型的Widget类定义可能如下所示：
```php
class BannerMagicWidget extends CWidget {
public function init() {
// 初始化代码
}
public function run() {
// Widget的业务逻辑代码
}
}
```
在这个例子中，`BannerMagicWidget`的`run`方法生成了一个随机的广告图片。它首先生成一个1到3之间的随机数，然后根据这个数选择一个广告图片，并使用`render`方法将该图片渲染到一个视图文件`bannermagic.php`中。
3. 视图文件：自定义Widget可能需要与之相关的视图文件，用于生成最终的HTML输出。视图文件通常位于`protected/components/views/`目录下，并且使用与Widget类相同的命名。在我们的例子中，对应的视图文件可能是`protected/components/views/bannermagic.php`，其内容可能如下所示：
```php
<img src="images/adverts/<?php echo $advert; ?>" alt="whatever" />
```
其中`$advert`是通过Widget的`run`方法传递过来的变量。
4. 调用Widget：在需要的视图文件中，使用`$this->widget('BannerMagicWidget');`来调用创建好的Widget。调用Widget后，Yii会自动调用Widget类的`init`和`run`方法，并将`run`方法生成的内容输出到浏览器。
通过这种方式，Yii的Widget可以被轻松地在应用中的不同页面上复用，而无需重复编写相同的代码，极大地提高了开发效率。此外，Yii的Widget也可以在不同的Widget之间嵌套使用，进一步增强了代码的重用性和模块化设计。
