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 37
     */
    public $viewParam = 'view';

38 39 40 41 42 43 44 45
    /**
     * @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';

46
    /**
Qiang Xue committed
47
     * @var string a string to be prefixed to the user-specified view name to form a complete view name.
48
     * For example, if a user requests for `tutorial/chap1`, the corresponding view name will
Qiang Xue committed
49 50 51
     * 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()
52
     */
53
    public $viewPrefix = 'pages';
54 55

    /**
Qiang Xue committed
56
     * @var mixed the name of the layout to be applied to the requested view.
57 58 59 60 61 62 63 64 65 66 67 68 69
     * 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;

    /**
     * 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
70
        $viewName = $this->resolveViewName();
71

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

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

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

85
        } catch (InvalidParamException $e) {
Qiang Xue committed
86 87 88 89 90

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

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

        return $output;
101 102
    }

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

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

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

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