ViewAction.php 4.52 KB
Newer Older
1 2 3 4 5 6 7 8 9
<?php
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

namespace yii\web;

Qiang Xue committed
10
use Yii;
11 12 13 14 15 16 17
use yii\base\Action;
use yii\base\InvalidParamException;

/**
 * ViewAction represents an action that displays a view according to a user-specified parameter.
 *
 * By default, the view being displayed is specified via the `view` GET parameter.
Qiang Xue committed
18
 * The name of the GET parameter can be customized via [[viewParam]].
19 20
 *
 * Users specify a view in the format of `path/to/view`, which translates to the view name
Qiang Xue committed
21 22
 * `ViewPrefix/path/to/view` where `ViewPrefix` is given by [[viewPrefix]]. The view will then
 * be rendered by the [[\yii\base\Controller::render()|render()]] method of the currently active controller.
23
 *
Qiang Xue committed
24 25
 * Note that the user-specified view name must start with a word character and can only contain
 * word characters, forward slashes, dots and dashes.
26 27 28 29 30 31 32 33
 *
 * @author Alexander Makarov <sam@rmcreative.ru>
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 2.0
 */
class ViewAction extends Action
{
    /**
Qiang Xue committed
34
     * @var string the name of the GET parameter that contains the requested view name.
35 36
     */
    public $viewParam = 'view';
37 38 39 40 41 42 43
    /**
     * @var string the name of the default view when [[\yii\web\ViewAction::$viewParam]] GET parameter is not provided
     * by user. Defaults to 'index'. This should be in the format of 'path/to/view', similar to that given in the
     * GET parameter.
     * @see \yii\web\ViewAction::$viewPrefix
     */
    public $defaultView = 'index';
44
    /**
Qiang Xue committed
45
     * @var string a string to be prefixed to the user-specified view name to form a complete view name.
46
     * For example, if a user requests for `tutorial/chap1`, the corresponding view name will
Qiang Xue committed
47 48 49
     * be `pages/tutorial/chap1`, assuming the prefix is `pages`.
     * The actual view file is determined by [[\yii\base\View::findViewFile()]].
     * @see \yii\base\View::findViewFile()
50
     */
51
    public $viewPrefix = 'pages';
52
    /**
Qiang Xue committed
53
     * @var mixed the name of the layout to be applied to the requested view.
54 55 56 57 58 59
     * This will be assigned to [[\yii\base\Controller::$layout]] before the view is rendered.
     * Defaults to null, meaning the controller's layout will be used.
     * If false, no layout will be applied.
     */
    public $layout;

60

61 62 63 64 65 66 67
    /**
     * Runs the action.
     * This method displays the view requested by the user.
     * @throws NotFoundHttpException if the view file cannot be found
     */
    public function run()
    {
Qiang Xue committed
68
        $viewName = $this->resolveViewName();
69

70
        $controllerLayout = null;
71
        if ($this->layout !== null) {
72
            $controllerLayout = $this->controller->layout;
73 74 75 76
            $this->controller->layout = $this->layout;
        }

        try {
Qiang Xue committed
77 78 79 80 81 82
            $output = $this->render($viewName);

            if ($controllerLayout) {
                $this->controller->layout = $controllerLayout;
            }

83
        } catch (InvalidParamException $e) {
Qiang Xue committed
84 85 86 87 88

            if ($controllerLayout) {
                $this->controller->layout = $controllerLayout;
            }

89 90 91 92
            if (YII_DEBUG) {
                throw new NotFoundHttpException($e->getMessage());
            } else {
                throw new NotFoundHttpException(
Qiang Xue committed
93
                    Yii::t('yii', 'The requested view "{name}" was not found.', ['name' => $viewName])
94 95 96
                );
            }
        }
97 98

        return $output;
99 100
    }

101 102 103
    /**
     * Renders a view
     *
Qiang Xue committed
104
     * @param string $viewName view name
105 106
     * @return string result of the rendering
     */
Qiang Xue committed
107
    protected function render($viewName)
108
    {
Qiang Xue committed
109
        return $this->controller->render($viewName);
110 111
    }

112
    /**
Qiang Xue committed
113
     * Resolves the view name currently being requested.
114
     *
Qiang Xue committed
115 116
     * @return string the resolved view name
     * @throws NotFoundHttpException if the specified view name is invalid
117
     */
Qiang Xue committed
118
    protected function resolveViewName()
119
    {
120
        $viewName = Yii::$app->request->get($this->viewParam, $this->defaultView);
121

Qiang Xue committed
122
        if (!is_string($viewName) || !preg_match('/^\w[\w\/\-\.]*$/', $viewName)) {
123
            if (YII_DEBUG) {
Qiang Xue committed
124
                throw new NotFoundHttpException("The requested view \"$viewName\" must start with a word character and can contain only word characters, forward slashes, dots and dashes.");
125
            } else {
Qiang Xue committed
126
                throw new NotFoundHttpException(Yii::t('yii', 'The requested view "{name}" was not found.', ['name' => $viewName]));
127 128 129
            }
        }

Qiang Xue committed
130
        return empty($this->viewPrefix) ? $viewName : $this->viewPrefix . '/' . $viewName;
131 132
    }
}