7：Yii中的Gii与Url处理(Yii权威指南)
return array( ...... 'modules'=>array( 'gii'=>array( 'class'=>'system.gii.GiiModule', 'password'=>'pick up a password here', 'ipFilters'=>array('127.0.0.1','::1'), // 'newFileMode'=>0666, // 'newDirMode'=>0777, ), ), );
http://hostname/path/to/index.php?r=gii
. 来进入gii。
http://hostname/path/to/index.php/gii
. 进入Gii。但是我们需要增加以下 Url 规则在url rules里面：
'components'=>array( ...... 'urlManager'=>array(
'urlFormat'=>'path', 'rules'=>array(
'gii'=>'gii', 'gii/<controller:\w+>'=>'gii/<controller>', 'gii/<controller:\w+>/<action:\w+>'=>'gii/<controller>/<action>', ...existing rules... ), ), )
model/ the model generator root folder
ModelCode.php the code model used to generate code
ModelGenerator.php the code generation controller
views/ containing view scripts for the generator
index.php the default view script
templates/ containing code template sets
default/ the 'default' code template set
model.php the code template for generating model class code
return array(
'modules'=>array(
'gii'=>array(
'class'=>'system.gii.GiiModule', 'generatorPaths'=>array(
'application.gii', // a path alias
), ), ), );
虽然URL可被硬编码在控制器的视图（view）文件，但往往可以很灵活地动态创建它们：
$url=$this->createUrl($route,$params);
$this指的是控制器实例; $route指定请求的route 的要求;$params 列出了附加在网址中的GET参数。
默认情况下，URL以get格式使用createUrl 创建。例如，提供$route='post/read'和$params=array('id'=>100) ，我们将获得以下网址：
/index.php?r=post/read&id=100
我们可以使上述网址看起来更简洁，更不言自明，通过采用所谓的'path格式，省去查询字符串和把GET参数加到路径信息，作为网址的一部分：
/index.php/post/read/id/100
要更改URL格式，我们应该配置urlManager应用元件，以便createUrl可以自动切换到新格式和应用程序可以正确理解新的网址：
array( ...... 'components'=>array( ...... 'urlManager'=>array(
'urlFormat'=>'path', ), ), );
请注意，我们不需要指定的urlManager元件的类，因为它在CWebApplication预声明为CUrlManager。
当用path格式URL，我们可以指定某些URL规则使我们的网址更用户友好性。例如，我们可以产生一个短短的URL/post/100 ，而不是冗长/index.php/post/read/id/100。网址创建和解析都是通过CUrlManager指定网址规则。
array( ...... 'components'=>array( ...... 'urlManager'=>array(
'urlFormat'=>'path', 'rules'=>array(
'pattern1'=>'route1', 'pattern2'=>'route2', 'pattern3'=>'route3', ), ), ), );
这些规则以一系列的路线格式对数组指定，每对对应于一个单一的规则。路线（route）的格式必须是有效的正则表达式，没有分隔符和修饰语。它是用于匹配网址的路径信息部分。还有route应指向一个有效的路线控制器。
规则可以绑定少量的GET参数。这些出现在规则格式的GET参数，以一种特殊令牌格式表现如下：
'pattern1'=>array('route1', 'urlSuffix'=>'.xml', 'caseSensitive'=>false)
-
urlSuffix: Url路径的后缀.，默认是NULL，使用这个选项 CUrlManager::urlSuffix.
-
caseSensitive: 是否是大小写敏感，默认是空，使用这个选项CUrlManager::caseSensitive.
-
defaultParams:rules默认提供的GET 参数(name => value).当这个选项设置后，对请求的URL，会把这个指定的值注入$_GET中。
-
matchValue:在创建一个URL的时候，是否这个GET参数的值在rule里面符合相应的子规则。默认是NULL。
<ParamName:ParamPattern>
ParamName表示GET参数名字，可选项ParamPattern表示将用于匹配GET参数值的正则表达式。当生成一个网址（URL）时，这些参数令牌将被相应的参数值替换；当解析一个网址时，相应的GET参数将通过解析结果来生成。
我们使用一些例子来解释网址工作规则。我们假设我们的规则（在urlManager的rules里面设置）包括如下三个：
array(
'posts'=>'post/list', 'post/<id:\d+>'=>'post/read', 'post/<year:\d{4}>/<title>'=>'post/read', )
-
调用
$this->createUrl('post/list')生成/index.php/posts。第一个规则适用。 -
调用
$this->createUrl('post/read',array('id'=>100))生成/index.php/post/100。第二个规则适用。 -
调用
$this->createUrl('post/read',array('year'=>2008,'title'=>'a sample post'))生成/index.php/post/2008/a%20sample%20post。第三个规则适用。 -
调用
$this->createUrl('post/read')产生/index.php/post/read。请注意，没有规则适用。
如果GET参数传递到createUrl是以上所要求的一项规则，其他参数将出现在查询字符串。例如，如果我们调用$this->createUrl('post/read',array('id'=>100,'year'=>2008)) ，我们将获得/index.php/post/100?year=2008。为了使这些额外参数出现在路径信息的一部分，我们应该给规则附加/*。 因此，该规则post/<id:\d+>/* ，我们可以获取网址/index.php/post/100/year/2008 。
/index.php/post/100 ，上面例子的第二个规则将适用来解析路线
post/read和GET参数
array('id'=>100)（可通过
$_GET获得） 。
还有一点，我们可以做进一步清理我们的网址，即在URL中藏匿index.php入口脚本。这就要求我们配置Web服务器，以及urlManager应用程序元件。
.htaccess
文件里实现。下面是一个示例：(注意，前提是请确定服务器的AllowOverride All)
Options +FollowSymLinks
IndexIgnore */*
RewriteEngine on
# if a directory or a file exists, use it directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# otherwise forward it to index.php
RewriteRule . index.php
false
。
Faking URL Suffix(伪造URL后缀)
/post/100.html
来替代
/post/100
。这使得它看起来更像一个静态网页URL。为了做到这一点，只需配置 urlManager
元件的 urlSuffix
属性为你所喜欢的后缀。
使用自定义URL规则设置类
注意: Yii从1.1.8版本起支持自定义URL规则类
默认情况下，每个URL规则都通过CUrlManager来声明为一个CUrlRule对象，这个对象会解析当前请求并根据具体的规则来生成URL。 虽然CUrlRule可以处理大部分URL格式，但在某些特殊情况下仍旧有改进余地。
比如，在一个汽车销售网站上，可能会需要支持类似/Manufacturer/Model这样的URL格式， 其中Manufacturer 和 Model 都各自对应数据库中的一个表。此时CUrlRule就无能为力了。
我们可以通过继承CUrlRule的方式来创造一个新的URL规则类。并且使用这个类解析一个或者多个规则。 以上面提到的汽车销售网站为例，我们可以声明下面的URL规则。
array(
// 一个标准的URL规则，将 '/' 对应到 'site/index'
'' => 'site/index', // 一个标准的URL规则，将 '/login' 对应到 'site/login', 等等
'<action:(login|logout|about)>' => 'site/<action>', // 一个自定义URL规则，用来处理 '/Manufacturer/Model'
array(
'class' => 'application.components.CarUrlRule', 'connectionID' => 'db', ), // 一个标准的URL规则，用来处理 'post/update' 等
'<controller:\w+>/<action:\w+>' => '<controller>/<action>', ),
从以上可以看到，我们自定义了一个URL规则类CarUrlRule来处理类似/Manufacturer/Model这样的URL规则。 这个类可以这么写：
class CarUrlRule extends CBaseUrlRule{
public $connectionID = 'db'; public function createUrl($manager,$route,$params,$ampersand)
{
if ($route==='car/index')
{
if (isset($params['manufacturer'], $params['model']))
return $params['manufacturer'] . '/' . $params['model']; else if (isset($params['manufacturer']))
return $params['manufacturer']; }
return false; // this rule does not apply
}
public function parseUrl($manager,$request,$pathInfo,$rawPathInfo)
{
if (preg_match('%^(\w+)(/(\w+))?$%', $pathInfo, $matches))
{
// check $matches[1] and $matches[3] to see
// if they match a manufacturer and a model in the database
// If so, set $_GET['manufacturer'] and/or $_GET['model']
// and return 'car/index'
}
return false; // this rule does not apply
}}
自定义URL规则类必须实现在CBaseUrlRule中定义的两个接口。
- CBaseUrlRule::createUrl()
- CBaseUrlRule::parseUrl()