学习 yii 框架 – 安全站点和非安全站点的 URL 管理

在本文中我将描述怎么管理安全站点和非安全站点的 URL 管理。

安全站点的内容使用httpsSSL (安全套接字层) 协议发送,而非安全站点使用http协议。为了描述简单,我们称前者https内容/页,后者 'http' 内容/页。一个严格要求的网站通常需要一些页面使用https,一些页面使用http。例如,为了防止密码嗅探,我们的登录页面使用https,而为了减轻服务器压力,对于不敏感的页面(例如,主页)我们使用http。

当我们在https页面是我们会需要生成http页面 URL,反之亦然。例如,一个站点有一个所有页面都使用的主菜单,主菜单中包含有,https(例如;登录页) 和http(例如:关于页) 的链接。如果我们在一个http页面,我们可以直接链接到其他http页面(例如: /about),但是我们不得不使用绝对URL地址使用https协议链接到其他https页面。同上如果我们在https页面,我们也会遇到类似的情况。

另一种情况是我们使用http协议请求也安全页面,我们应当将浏览器重定向到使用https协议,反之亦然。重定义通常为 301 永久重定向。这可能使用 web 服务器的重写规则实现。但是如果我们要细化安全和非安全的页面,重写规则可能会变得非常复杂。

为了实现上面的两个需求,我们可以继承 CUrlManager, 如下

class UrlManager extends CUrlManager
{
    /**
     * @var string 非SSL模式下的主机信息
     */
    public $hostInfo = 'http://localhost';
    /**
     * @var string SSL模式下的主机信息
     */
    public $secureHostInfo = 'https://localhost';
    /**
     * @var array 只在 SSL 模式下可用的路由列表.
     * 数组的每一项既可以是一个 URL 路由(例,'site/create')
     * 也可以是控制器 ID (例,'settings').后者表示该控制器所有动作都为安全页
     */
    public $secureRoutes = array();

    public function createUrl($route, $params = array(), $ampersand = '&')
    {
        $url = parent::createUrl($route, $params, $ampersand);

        // 如果已经为 绝对 URL 直接返回
        if (strpos($url, 'http') === 0) {
            return $url;  
        }

        // 检查当前协议是否是预期的协议
        // 如果不是则需要在生成 URL 时使用正确的主机信息
        $secureRoute = $this->isSecureRoute($route);
        if (Yii::app()->request->isSecureConnection) {
            return $secureRoute ? $url : $this->hostInfo . $url;
        } else {
            return $secureRoute ? $this->secureHostInfo . $url : $url;
        }
    }

    public function parseUrl($request)
    {
        $route = parent::parseUrl($request);

        // 如果当前协议不符合预期协议,执行 301 重定向
        $secureRoute = $this->isSecureRoute($route);
        $sslRequest = $request->isSecureConnection;
        if ($secureRoute !== $sslRequest) {
            $hostInfo = $secureRoute ? $this->secureHostInfo : $this->hostInfo;
            if ((strpos($hostInfo, 'https') === 0) xor $sslRequest) {
                $request->redirect($hostInfo . $request->url, true, 301);
            }
        }
        return $route;
    }

    private $_secureMap;

    /**
     * @param string 需要检查的 URL 路由
     * @return boolean 给出的 URL 路由是否应该在 SSL 模式下
     */
    protected function isSecureRoute($route)
    {
        if ($this->_secureMap === null) {
            foreach ($this->secureRoutes as $r) {
                $this->_secureMap[strtolower($r)] = true;
            }
        }
        $route = strtolower($route);
        if (isset($this->_secureMap[$route])) {
            return true;
        } else {
            return ($pos = strpos($route, '/')) !== false 
                && isset($this->_secureMap[substr($route, 0, $pos)]);
        }
    }
}

现在,在应用程序的配置,我们应当使用我们的 URL 管理器来取代默认。

return array(
    // ....
    'components' => array(
        'urlManager' => array(
            'class' => 'UrlManager',
            'urlFormat' => 'path',
            'hostInfo' => 'http://example.com',
            'secureHostInfo' => 'https://example.com',
            'secureRoutes' => array(
                'site/login',   // site/login action
                'site/signup',  // site/signup action
                'settings',     // all actions of SettingsController
            ),
        ),
    ),
);

在上面的代码中,我们配置了urlManager登录、注册和所有设置页面为安全页面。如果,你想添加其他页面,只需向secureRoutes数组中添加相应内容。

现在我们可以像往常一样使用Yii::app()->createUrl()方法来创建 URL 地址。我们的urlManager会自动确定是否需要加上合适的前缀,如果需要的话,url 管理器也会执行 301 重定向。

英文原文

发表评论