Yii 프레임워크 공식 가이드 시리즈 43 - 특별 주제: URL(생성, 라우팅, 미화 및 사용자 정의)

웹 애플리케이션의 완전한 URL 관리에는 두 가지 측면이 포함됩니다. 첫째, 사용자가 동의한 URL을 요청하면 애플리케이션은 이를 이해할 수 있는 매개변수로 구문 분석해야 합니다. 둘째, 애플리케이션은 생성된 URL을 애플리케이션에서 이해할 수 있도록 URL을 생성하는 방법을 제공해야 합니다. Yii 애플리케이션의 경우 CUrlManager를 사용하여 이 작업을 수행합니다.

1. URL 생성

URL은 컨트롤러의 뷰 파일에 하드 코딩될 수 있지만 종종 유연성이 뛰어나 동적으로 생성될 수 있습니다.

$url=$this->createUrl($route,$params);

$this는 컨트롤러 인스턴스를 나타냅니다. $route는 요청된 경로 요구 사항을 지정합니다. $params는 . GET

기본적으로 URL은 get 형식의 createUrl을 사용하여 생성됩니다. 예를 들어, $route='post/read' 및 $params=array('id'=>100) 을 제공하면 다음 URL을 얻게 됩니다:

/index.php?r=post/read&id=100

매개변수는 일련의 이름으로 연결됩니다. =값 기호 요청 문자열에 나타나는 r 매개변수는 요청된 경로를 나타냅니다. 이 URL 형식은 단어가 아닌 문자가 필요하기 때문에 사용자에게 친숙하지 않습니다.

소위 '경로 형식'을 사용하여 쿼리 문자열을 생략하고 GET 매개변수를 URL의 일부로 경로 정보에 추가하면 위의 URL을 더 깔끔하고 설명이 더 쉽게 만들 수 있습니다.

/index.php/post/read/id/100

URL 형식을 변경하려면 createUrl이 자동으로 새 형식으로 전환되고 애플리케이션이 새 URL을 올바르게 이해할 수 있도록 urlManager 애플리케이션 요소를 구성해야 합니다.

array(
    ......
    'components'=>array(
        ......
        'urlManager'=>array(
            'urlFormat'=>'path',
        ),
    ),
);

urlManager 요소의 클래스는 CWebApplication에서 CUrlManager로 미리 선언되어 있으므로 이를 지정할 필요가 없습니다.

createurl 메소드는 상대 주소를 생성합니다. 절대 URL을 얻으려면 yii">

접두사를 사용할 수 있습니다. 팁: 이 URL은 createurl 메소드에 의해 생성된 상대 주소입니다. 절대 URL을 얻으려면 yii 접두사를 사용할 수 있습니다.: app()->hostInfo 또는 createAbsoluteUrl을 호출합니다.

2. 사용자 친화적인 URL(사용자 친화적인 URL)

경로 형식 URL을 사용할 때 특정 URL 규칙을 지정하면 URL을 더욱 사용자 친화적으로 만들 수 있습니다. 예를 들어 긴 /index.php/post/read/id/100 URL 생성 및 CUrlManager를 통한 구문 분석 대신 짧은 URL /post/100을 생성할 수 있습니다.

URL 규칙을 지정하려면 urlManager 애플리케이션 요소의 속성 규칙을 설정해야 합니다.

array(
    ......
    'components'=>array(
        ......
        'urlManager'=>array(
            'urlFormat'=>'path',
            'rules'=>array(
                'pattern1'=>'route1',
                'pattern2'=>'route2',
                'pattern3'=>'route3',
            ),
        ),
    ),
);

이러한 규칙은 경로 형식 쌍의 배열로 지정되며, 각 쌍은 단일 규칙에 해당합니다. 경로(경로) 형식은 일치하는 URL의 경로 정보 부분에 대해 구분 기호 및 수정자가 없는 유효한 정규식이어야 합니다.

규칙은 소수의 GET 매개변수를 특수 토큰에 바인딩할 수 있습니다. 형식은

'pattern1'=>array('route1', 'urlSuffix'=>'.xml', 'caseSensitive'=>false)

위 배열에는 일련의 사용자 정의 옵션 설정이 포함되어 있으며 버전 1.1.0에서는 다음 옵션이 유효합니다.

urlSuffix: URL에서 사용되는 접미사 설정 규칙 기본값은 null이며 CUrlManager::urlSuffix 설정이 사용됩니다.
caseSensitive: 규칙이 크고 작은 학교에 민감한지 여부, 기본값은 null이며 CUrlManager::caseSensitive의 기본값이 사용됩니다.
defaultParams: 규칙에서 제공하는 GET 매개변수의 기본값(name=>value)을 사용하는 경우. 들어오는 요청을 구문 분석하면 이 속성에 선언된 값이 $_GET에 주입됩니다.
matchValue: 생성 시 URL의 GET 매개변수 값이 해당 하위 패턴과 일치하는지 여부 기본값은 null입니다. 이는 CUrlManager::matchValue의 값이 사용됨을 의미합니다. 속성 값이 false이면 경로와 매개변수 이름이 지정된 일치 항목과 일치하면 규칙이 사용된다는 의미입니다. URL. 이 속성이 true로 설정되면 지정된 매개변수 값은 해당 하위 패턴 매개변수 값과도 일치해야 합니다. 이 속성의 값이 true로 설정되면 성능이 저하됩니다.
명명된 매개변수 사용

규칙은 일부 GET 매개변수를 연결할 수 있습니다. 이러한 GET 매개변수는 다음과 같이 규칙 패턴에서 특수 토큰으로 나타납니다.

<ParamName:ParamPattern>;

는 GET 매개변수 이름을 나타내고, 선택 사항인

는 일치하는 데 사용될 정규식을 나타냅니다. GET 매개변수 값. 웹 주소(URL)가 생성되면 이러한 매개변수 토큰은 해당 매개변수 값으로 대체됩니다. URL이 구문 분석되면 해당 GET 매개변수가 구문 분석된 결과에서 생성됩니다. ParamNameParamPattern몇 가지 예를 사용하여 URL의 작동 방식을 설명합니다. 규칙에는 다음 세 가지가 포함되어 있다고 가정합니다.

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))

• 调用$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。请注意，没有规则适用。

总之，当使用createUrl生成网址，路线和传递给该方法的GET参数被用来决定哪些网址规则适用。如果关联规则中的每个参数可以在GET参数找到的，将被传递给createUrl ，如果路线的规则也匹配路线参数，规则将用来生成网址。

如果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 。

正如我们提到的，URL规则的其他用途是解析请求网址。当然，这是URL生成的一个逆过程。例如， 当用户请求/index.php/post/100 ，上面例子的第二个规则将适用来解析路线post/read和GET参数array('id'=>100) （可通过$_GET获得） 。

createurl方法所产生的是一个相对地址。为了得到一个绝对的url ，我们可以用前缀<code>yii">注：使用的URL规则将降低应用的性能。这是因为当解析请求的URL ，[ CUrlManager ]尝试使用每个规则来匹配它，直到某个规则可以适用。因此，高流量网站应用应尽量减少其使用的URL规则。

参数化路由

从版本1.0.5开始, 我们可能会用到命名参数作为路由规则的一部分. 这就允许一个规则可以基于匹配规范被用来匹配多个路由，这也许还会帮助减少应用所需的规则的数目，从而提高整体的性能.

我们使用如下示例规则来说明如何通过命名参数来参数化路由:

array(
    '<_c:(post|comment)>/<id:\d+>/<_a:(create|update|delete)>' => '<_c>/<_a>',
    '<_c:(post|comment)>/<id:\d+>' => '<_c>/read',
    '<_c:(post|comment)>s' => '<_c>/list',
)

在上面的示例中, 我们在路由规则中使用了两个命名参数: _c和_a. The former matches a controller ID to be either post or comment, while the latter matches an action ID to be create, update or delete. You may name the parameters differently as long as they do not conflict with GET parameters that may appear in URLs.

使用上面的规则, URL /index.php/post/123/create 将会被解析为 post/create 使用GET参数 id=123. And given the route comment/list and GET parameter page=2, we can create a URL /index.php/comments?page=2.

参数化主机名

从版本1.0.11开始, it is also possible to include hostname into the rules for parsing and creating URLs. One may extract part of the hostname to be a GET parameter. For example, the URL http://www.php.cn/ may be parsed into GET parameters user=admin and lang=en. On the other hand, rules with hostname may also be used to create URLs with paratermized hostnames.

In order to use parameterized hostnames, simply declare URL rules with host info, e.g.:

array(
    'http://<user:\w+>.example.com/<lang:\w+>/profile' => 'user/profile',
)

The above example says that the first segment in the hostname should be treated as userparameter while the first segment in the path info should be lang parameter. The rule corresponds to the user/profile route.

Note that CUrlManager::showScriptName will not take effect when a URL is being created using a rule with parameterized hostname.

Also note that the rule with parameterized hostname should NOT contain the sub-folder if the application is under a sub-folder of the Web root. For example, if the application is under http://www.php.cn/, then we should still use the same URL rule as described above without the sub-folder sandbox/blog.

隐藏 index.php

还有一点，我们可以做进一步清理我们的网址，即在URL中藏匿index.php入口脚本。这就要求我们配置Web服务器，以及urlManager应用程序元件。

我们首先需要配置Web服务器，这样一个URL没有入口脚本仍然可以处理入口脚本。如果是Apache HTTP server，可以通过打开网址重写引擎和指定一些重写规则。这两个操作可以在包含入口脚本的目录下的.htaccess文件里实现。下面是一个示例：

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

然后，我们设定urlManager元件的showScriptName属性为 false。

注意在正式测试之前确保apache开启了rewrite模块，在ubuntu中开启的方式如下：

cd /etc/apache2/mods-enabled

sudo ln -s ../mods-available/rewrite.load rewrite.load

sudo service apache2 restart

现在，如果我们调用$this->createUrl('post/read',array('id'=>100)) ，我们将获取网址/post/100。更重要的是，这个URL可以被我们的Web应用程序正确解析。

Faking URL Suffix(伪造URL后缀)

我们还可以添加一些网址的后缀。例如，我们可以用/post/100.html来替代/post/100 。这使得它看起来更像一个静态网页URL。为了做到这一点，只需配置urlManager元件的urlSuffix属性为你所喜欢的后缀。

3. 使用自定义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()|createUrl()]

• [CBaseUrlRule::parseUrl()|parseUrl()]

除了这种典型用法，自定义URL规则类还可以有其他的用途。比如，我们可以写一个规则类来记录有关URL解析和UEL创建的请求。 这对于正在开发中的网站来说很有用。我们还可以写一个规则类来在其他URL规则都匹配失败的时候显示一个自定义404页面。 注意，这种用法要求规则类在所有其他规则的最后声明。

 以上就是Yii框架官方指南系列43——专题：URL(创建、路由、美化及自定义)的内容，更多相关内容请关注PHP中文网（www.php.cn）！