`
mapdigit
  • 浏览: 250267 次
文章分类
社区版块
存档分类
最新评论

Yii Framework 开发教程(4) Hangman 猜单词游戏实例

 
阅读更多

有了前面“Hello,World”的例子和对Yii Framework Web应用基础的介绍,可以开始介绍一个简单而相对而有比较完整的Web应用-Hangman(猜单词游戏),这个例子是随Yii 开发包发布的。通过这个例子可以了解开发Yii应用的基本步骤.

说起“Hangman”,让我想起80年代末期高中时在CPC464计算机上完过的“猜单词游戏”-Hangman,每猜错一次,就把一个小人离绞刑架前进一步。当时DOS才刚刚出来:-)。

开发一个Web应用,首先是进行需求分析,这个不在本教程之内,但为完整起见,还是把“猜单词游戏”的规则列在下面

猜单词游戏英文:Hangman,“上吊的人”之意)是一个双人游戏。一位玩家想一个字,另一位尝试猜该玩家所想的字中的每一个字母

要猜的字以一列横线表示,让玩家知道该字有多少个字母。如果猜字的玩家猜中其中一个字母,另一位便须于该字母出现的所有位置上写上该字母。如果猜的字母没有于该字中出现,另一位玩家便会画吊颈公仔的其中一笔。游戏会在以下情况结束:

“我要t字。”“有, 在第八和第十一位。”

  • 猜字的玩家猜完所有字母,或猜中整个字
  • 另一位玩家画完整幅图:

今天给出的例子就不画出“上吊人”了,猜对了显示“You Win”,猜错了显示“You Lose”。 因此我们可以设计四个页面:

20121213001

这四个页面对应到Yii Framework为 四个View,可以分别取名为play, guess, win,lose ,每个页面都显示了“Hangman Game”的标题,因此可以设计一个”MasterPage”,在Yii中成为Layout布局的模板以供四个View共享。Yii应用采用了MVC设计模式,因此我们可以为四个View设计一个Controller–>GameController.

前面的教程说过Yii应用使用缺省的目录结构来存放应用的不同部分,可以使用Yii提供的工具来参加一个缺省的项目目录。不过我个人还是比较喜欢自己创建各个目录,因此根据上面的需求和界面设计,可以创建项目的目录结构如下:

20121213002

  • 创建的GameController.php 放在 protected/controller 目录下。
  • 创建的四个View guess.php, lose.php, play.php, win.php 放在 protected/views/game 目录下 。目录名game 对应到所使用到GameController.
  • 创建的共享的Layout放在 protected/views/layout 目录下,缺省的布局名称为main.php
  • 应用的配置文件放在 protected/config ,缺省配置文件为main.php
  • 应用的入口脚本为 index.php
  • 此外,供猜单词的文本文件为 word.txt

1. 首先来看看配置文件protected/config/main.php

return array(
	'name'=>'Hangman Game',
	'defaultController'=>'game',
	'components'=>array(
		'urlManager'=>array(
			'urlFormat'=>'path',
			'rules'=>array(
				'game/guess/<g:\w>'=>'game/guess',
			),
		),

	),
);

CWebApplication应用的所有可写的属性都可以通过配置文件来定义,我们看到配置文件定义了应用的名称为”Hangman Game” ,然后修改Web应用缺省的Controller名字为game 对应到 GameController, 如果没有重新定义defaultController,则缺省的Controller名字为SiteController,这样对于的View就要存放到 protected/views/site 目录下。另外这个Yii应用打开了urlManager组件,这个组件的功能就在后面介绍,主要是用来定义用户可以访问的URL的格式(路由格式)。

2. 有了这个配置文件,就可以在入口脚本中使用它,每个Yii应用的入口脚本index.php都是大同小异的,大部分情况下都是Copy & Paste:-)

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

3. 然后定义View使用的布局文件 protected/views/layout/main.php main.php 为缺省的布局模板,应用可以修改View使用的布局,本例就是要缺省的布局名称main.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Hangman Game</title>
</head>

<body>
<h1>Hangman Game</h1>

<?php echo $content; ?>

</body>
</html>

布局基本上就是HTML文件,其中作为 view 的placeholder ,也就是在显示具体的View时,比如play.php 就用 play.php 的内容来替代 $content。从而实现了类似“MasterPage” 的功能。
4. 下面就可以逐一定义四个View,这里就不一一列出了,以play.php 为例:

<p>This is the game of Hangman.
You must guess a word, a letter at a time.
If you make too many mistakes, you lose the game!</p>

<?php echo CHtml::beginForm(); ?>

<?php echo CHtml::radioButtonList('level', null, $levels); ?>

<br/>
<?php echo CHtml::submitButton('Play!'); ?>

<?php if($error): ?>
<span style="color:red">You must choose a difficulty level!</span>
<?php endif; ?>

<?php echo CHtml::endForm(); ?>

可以看到基本上也是HTML ,其中CHtml 为Yii 框架支持的一个辅助类,用来帮助生成HTML代码。 Hangman比较简单,因此没有使用单独的Model,而是通过render推送的方式传入参数。

需通过传递视图的名称调用CController::render()。这个方法将在protected/views/ControllerID目录下寻找对应的视图文件.

在视图脚本内部,我们可以通过$this来访问控制器实例.我们可以在视图里以$this->propertyName的方式拉取控制器的任何属性.

我们也可以用以下推送的方式传递数据到视图里:

$this->render('edit', array(
    'var1'=>$value1,
    'var2'=>$value2,
));

在以上的方式中,render()方法将提取数组的第二个参数到变量里.其产生的结果是,在视图脚本里,我们可以直接访问变量$var1$var2.

5. 定义好布局和View之后,就可以写GameController了,

class GameController extends CController
{
	/**
	 * @var string sets the default action to be 'play'
	 */
	public $defaultAction='play';

	/**
	 * The 'play' action.
	 * In this action, users are asked to choose a difficulty level
	 * of the game.
	 */
	public function actionPlay()
	{
		...
	}

	/**
	 * The 'guess' action.
	 * This action is invoked each time when the user makes a guess.
	 */
	public function actionGuess()
	{
		...
	}

	/**
	 * The 'guess' action.
	 * This action is invoked when the user gives up the game.
	 */
	public function actionGiveup()
	{
		...
	}

	...
}

一般情况下Controller缺省的action 为 index ,可以通过$defaultAction修改缺省的Action,本例修改为play. 因此如果本例的 url 为 http://127.0.0.1:8888/yii/demos/hangman/
那么使用 http://127.0.0.1:8888/yii/demos/hangman/index.php 和使用 http://127.0.0.1:8888/yii/demos/hangman/index.php?game/play的效果是一样的。缺省的Controller为GameController,GameController缺省的action为play.

Action (动作),动作可以被定义为一个以 action 单词作为前缀命名的方法。Hangman定义了三个action ,actionPlay ,actionGuess, actionGiveup ,GameController 其它方法和属性和生成单词,判断是否猜对等为具体的游戏逻辑和Yii框架关系不大,就不介绍了。

6. 首先看看缺省的playAction ,这是用户调用的缺省方法,也就是说当用户组地址栏输入http://127.0.0.1:8888/yii/demos/hangman/index.php (或http://127.0.0.1:8888/yii/demos/hangman/index.php?game/play)所调用的Action。

public function actionPlay()
{
	static $levels=array(
		'10'=>'Easy game; you are allowed 10 misses.',
		'5'=>'Medium game; you are allowed 5 misses.',
		'3'=>'Hard game; you are allowed 3 misses.',
	);

	// if a difficulty level is correctly chosen
	if(isset($_POST['level'])
	   && isset($levels[$_POST['level']]))
	{
		$this->word=$this->generateWord();
		$this->guessWord=str_repeat('_',strlen($this->word));
		$this->level=$_POST['level'];
		$this->misses=0;
		$this->setPageState('guessed',null);
		// show the guess page
		$this->render('guess');
	}
	else
	{
		$params=array(
			'levels'=>$levels,
			// if this is a POST request,
			//it means the level is not chosen
			'error'=>Yii::app()->request->isPostRequest,
		);
		// show the difficulty level page
		$this->render('play',$params);
	}
}

这个方法定义了游戏的三个难度等级$levels, 有两个分支,如果没有选择难易等级,则调用$this->render(‘play’,$params),显示Play页面,就$params (Array)推送到对应的View ,protected/views/play.php,参考上面View的定义:

<?php echo CHtml::radioButtonList('level', null, $levels); ?>

View使用Radiobutton来显示 $levels 定义的列表。

如果用户选择了难易等级,在把Level,单词等存放到GameController所定义的属性中,如word,level等。GameController拍手与CController 也是CComponent的子类,CComponent支持了类似C#,Java的属性功能。具体后面再介绍。
然后调用$this->render(‘guess’); 显示Guess页面。
Guess页面 guess.php 定义如下:

<h2>Please make a guess</h2>

<h3 style="letter-spacing: 4px;">
  <?php echo $this->guessWord; ?></h3>

<p>You have made
  <?php echo $this->misses; ?>
  bad guesses out of a maximum of
  <?php echo $this->level; ?>.</p>

<?php echo CHtml::statefulForm(); ?>

<p>Guess:
<?php
for($i=ord('A');$i<=ord('Z');++$i)
{
	if(!$this->isGuessed(chr($i)))
		echo "\n".CHtml::linkButton(chr($i),
		array('submit'=>array('guess','g'=>chr($i))));
}
?>
</p>

<p><?php echo CHtml::linkButton('Give up?',
array('submit'=>array('giveup'))); ?></p>

</form>

在View中可以直接通过$this 来访问对应的Controller实例对象的方法和属性。 如$this->guessWord,$this->isGuessed(chr($i))等。
其中点击26个字母触发guessAction (array(‘submit’=>array(‘guess’,'g’=>chr($i))))).

7. 下面为guessAction 的定义

public function actionGuess()
{
	// check to see if the letter is guessed correctly
	if(isset($_GET['g'][0]) && ($result=$this->guess($_GET['g'][0]))!==null)
		$this->render($result ? 'win' : 'lose');
	else // the letter is guessed correctly, but not win yet
	{
		$guessed=$this->getPageState('guessed',array());
		$guessed[$_GET['g'][0]]=true;
		$this->setPageState('guessed',$guessed,array());
		$this->render('guess');
	}
}

其中参数 ‘g’由 guess 页面提交是传入, 如果单词全部猜对在显示”You win” 或用完所有次数猜错显示“You lose” , $this->render($result ? ‘win’ : ‘lose’),
如果还有机会猜还是回到guess 页面$this->render(‘guess’);

8. 在Guess页面上还有一个“Give up” 按钮,用户点击则触发giveupAction.这个方法比较简单,直接显示lose 页面

public function actionGiveup()
{
	$this->render('lose');
}

至此Hangman游戏基本就完成了。游戏虽然简单,但说明了使用Yii开发应用的基本流程,下面给出Yii开发文档给出的开发流程,Hangman比较简单,没有用到数据库和国际化等。

此处的开发流程假设我们已经完成了对应用的需求分析和必要的设计分析。

  1. 创建目录结构骨架。创建第一个Web应用中讲到的yiic工具可以快速实现此步骤。
  2. 配置此应用。这是通过修改应用配置文件实现的。 此步骤可能也需要编写一些应用组件(例如用户组件)。
  3. 为所管理的每个类型的数据创建一个模型类。Creating First Yii ApplicationAutomatic Code Generation中讲述的Gii工具可以用于快速为每个数据表创建active record类。4.为每个类型的用户请求 创建一个控制器类。 具体如何对用户请求归类要看实际需求。总体来说,如果一个模型类需要被用户访问,他就应该有一个相应的控制器类。Gii工具也可以自动实现这一步骤。
  4. 实现动作和他们相应的视图。 这是真正所需要做的工作。
  5. 在控制器类中配置必要的动作过滤器
  6. 如果需要主题功能,创建主题
  7. 如果需要国际化(I18N),创建翻译信息。
  8. 对可缓存的数据点和视图点应用适当的缓存技术。
  9. 最终调整与部署。

上述的每个步骤中,可能需要创建并执行测试用例。


分享到:
评论

相关推荐

    Yii Framework API手册

    Yii Framework API手册是针对开发者的一款详尽参考资料,它包含了Yii框架的所有核心组件、类库以及扩展的使用方法和接口信息。Yii是一个高性能、基于组件的PHP框架,用于开发Web 2.0应用。API(Application ...

    YII Framework框架教程之使用YIIC快速创建YII应用详解

    主要介绍了YII Framework框架教程之使用YIIC快速创建YII应用的方法,详细分析说明了YII Framework框架使用YIIC命令行创建应用的相关技巧与注意事项,需要的朋友可以参考下

    yii framework框架 + yii app模板(基本、高级).zip

    yii framework框架 + yii app模板(基本、高级)

    PHP实例开发源码-Yii Framework php框架.zip

    PHP实例开发源码—Yii Framework php框架.zip PHP实例开发源码—Yii Framework php框架.zip PHP实例开发源码—Yii Framework php框架.zip

    YII Framework框架教程之日志用法详解

    YII Framework是一个基于PHP的高级Web应用开发框架,它提供了一套日志系统,以便开发者追踪和记录应用程序运行时的状态和潜在问题。本文将详细介绍YII中日志的配置、使用方法及相关注意事项,通过实例阐述如何在YII...

    Yii Framework框架中事件和行为的区别及应用实例分析

    主要介绍了Yii Framework框架中事件和行为的区别及应用,结合实例形式分析了Yii Framework框架中事件和行为的相关概念、原理、区别及应用操作技巧,需要的朋友可以参考下

    yii framework 中文完全手册

    这个“yii framework 中文完全手册”提供了详尽的指南,帮助开发者理解和利用Yii的强大功能。在深入探讨之前,我们先简单介绍一下Yii框架的基本概念。 Yii,发音为"易",寓意“简易”,是一个快速、安全且专业的...

    Yii Framework 1.1.6

    Yii Framework 1.1.6 是一个高效、可扩展的 PHP 开发框架,它为开发者提供了构建大型Web应用所需的工具和功能。这个版本是Yii框架的稳定版本之一,发布于2011年,旨在提高开发效率并降低维护成本。 在Yii 1.1.6中,...

    YII Framework框架教程之缓存用法详解

    首先,Yii框架的缓存是通过组件方式定义的,位于/yii_dev/yii/framework/caching目录下。该目录包括了多种缓存组件实现,例如CApcCache、CCache、CDbCache等,它们分别对应不同的缓存存储媒介,如APC、文件、数据库...

    Yii Framework v2.0.8.rar

    Yii Framework是一个高性能的PHP5的web应用程序开发框架。通过一个简单的命令行工具 yiic 可以快速创建一个web应用程序的代码框架,开发者可以在生成的代码框架基础上添加业务逻辑,以快速完成应用程序的开发。

    Yii Framework v1.1.19

    Yii是一个高性能的PHP5的web应用程序开发框架。通过一个简单的命令行工具 yiic 可以快速创建一个web应用程序的代码框架,开发者可以在生成的代码框架基础上添加业务逻辑,以快速完成应用程序的开发。

    YII Framework框架使用YIIC快速创建YII应用之migrate用法实例详解

    主要介绍了YII Framework框架使用YIIC快速创建YII应用之migrate用法,详细分析了migrate的功能与用法,并给出创建登录后台的实例讲述了migrate的相关使用技巧,需要的朋友可以参考下

    yii framework 1.1.14 chm文档

    yii framework 1.1.14 chm文档,从官方html文档编译,展示效果很好.

    Yii Framework v1.10 Class Reference

    Yii Framework 1.10的API手册

    Yii2.0打造京东商城平台PHP电商实战Yii2.0视频教程

    教程名称:Yii2.0 打造京东商城平台 PHP电商实战 Yii2.0视频教程 教程内容: 包含了电商的所有功能模块:商品展示、购物车功能、下单支付、发货、确认收获、商品管理、订单管理。电商API接口开发。Yii2.0级基于Yii...

    YiiFramework

    4. **Yii的开发工具**: - Gii是一个内置的代码生成工具,能快速生成CRUD(创建、读取、更新、删除)操作代码,减少开发时间。 - Debug Toolbar和Profiler组件用于调试和性能分析,帮助优化代码。 5. **Yii的扩展...

    PhpStorm6 创建yii framework项目

    在本篇文档中,我们将深入了解如何使用PhpStorm6这款集成开发环境(IDE)来创建基于Yii框架的项目。Yii框架是一个高性能的现代PHP框架,适用于开发Web 2.0应用程序。PhpStorm6是由JetBrains公司开发的一个专门为PHP...

Global site tag (gtag.js) - Google Analytics