PHP Yii 프레임워크에서 뷰를 생성하고 뷰를 렌더링하는 방법에 대한 자세한 설명

뷰는 MVC 패턴의 일부입니다. 최종 사용자에게 데이터를 표시하는 코드입니다. 웹 애플리케이션에서는 뷰 템플릿을 기반으로 뷰가 생성됩니다. 뷰 템플릿은 주로 HTML 코드와 표시 PHP 코드를 포함하는 PHP 스크립트 파일입니다. , 뷰 구성 및 렌더링에 도움이 되는 일반 메소드를 주로 제공합니다. 단순화를 위해 뷰 템플릿 또는 뷰 템플릿 파일을 뷰라고 부릅니다.

뷰 생성

위에서 언급한 것처럼 뷰는 HTML과 PHP 코드가 포함된 PHP 스크립트입니다. 다음 코드는 로그인 폼의 뷰입니다. 페이지 제목 및 양식과 같은 동적 콘텐츠를 생성하기 위해 HTML 코드는 이를 아름다운 HTML 페이지로 구성합니다.

<?php
use yii\helpers\Html;
use yii\widgets\ActiveForm;
 
/* @var $this yii\web\View */
/* @var $form yii\widgets\ActiveForm */
/* @var $model app\models\LoginForm */
 
$this->title = &#39;Login&#39;;
?>
<h1><?= Html::encode($this->title) ?></h1>
 
<p>Please fill out the following fields to login:</p>
 
<?php $form = ActiveForm::begin(); ?>
  <?= $form->field($model, &#39;username&#39;) ?>
  <?= $form->field($model, &#39;password&#39;)->passwordInput() ?>
  <?= Html::submitButton(&#39;Login&#39;) ?>
<?php ActiveForm::end(); ?>

뷰에서 $this에 액세스하여 yiiwebView를 가리켜 이 뷰 파일을 관리하고 렌더링할 수 있습니다.

$this 외에도 위 예제의 뷰에는 컨트롤러 또는 뷰 렌더링을 트리거하는 다른 개체에서 뷰로 전달된 데이터를 나타내는 $model과 같은 사전 정의된 다른 변수가 있습니다.

팁: 미리 정의된 변수를 뷰 파일의 헤더 주석에 나열하면 IDE 편집기에서 인식할 수 있고 뷰 문서를 생성하는 좋은 방법이기도 합니다.
보안

HTML 페이지를 생성하는 뷰를 생성할 때 사용자 입력 데이터를 표시하기 전에 트랜스코딩하고 필터링하는 것이 중요합니다. 그렇지 않으면 애플리케이션이 크로스 사이트 스크립팅 공격에 취약할 수 있습니다.

일반 텍스트를 표시하려면 먼저 yiihelpersHtml::encode()를 호출하여 트랜스코딩합니다. 예를 들어 다음 코드는 표시하기 전에 사용자 이름을 트랜스코딩합니다.

<?php
use yii\helpers\Html;
?>
 
<div class="username">
  <?= Html::encode($user->name) ?>
</div>

HTML 콘텐츠를 표시하려면 먼저 yiihelpersHtmlPurifier 필터를 호출합니다. 예를 들어, 다음 코드는 제출된 콘텐츠를 표시하기 전에 필터링합니다.

<?php
use yii\helpers\HtmlPurifier;
?>
 
<div class="post">
  <?= HtmlPurifier::process($post->text) ?>
</div>

팁: HTMLPurifier는 출력 데이터의 보안을 효과적으로 보장하지만 애플리케이션이 높은 수준을 요구하는 경우에는 성능이 좋지 않습니다. 성능을 고려하면 필터링된 결과를 캐시합니다.

뷰 구성

컨트롤러 및 모델과 유사하게 뷰 구성에는 몇 가지 규칙이 있습니다.

컨트롤러가 렌더링한 뷰 파일은 기본적으로 @app/views/ControllerID에 배치됩니다. 여기서 ControllerID는 컨트롤러 ID에 해당합니다. 예를 들어 컨트롤러 클래스는 PostController이고 보기 파일 디렉터리는 @app/views/post여야 하며 컨트롤러 클래스 PostCommentController에 해당하는 디렉터리는 @app/views/post-comment입니다. 모듈 컨트롤러에 있는 경우 디렉터리는 yiibaseModule::basePath 모듈 디렉터리 아래의 views/ControllerID 디렉터리여야 합니다.
위젯 렌더링의 경우 보기 파일은 기본적으로 WidgetPath/views 디렉터리에 배치됩니다. 위젯 클래스 파일이 있는 디렉터리를 나타냅니다.
다른 개체에 의해 렌더링된 보기 파일의 경우 위젯과 유사한 규칙을 따르는 것이 좋습니다.
컨트롤러나 위젯의 yiibaseViewContextInterface::getViewPath() 메서드를 재정의하여 보기 파일의 기본 디렉터리를 사용자 지정할 수 있습니다.

렌더 뷰

컨트롤러, 위젯 또는 다른 곳에서 렌더 뷰 메서드를 호출하여 뷰를 렌더링할 수 있습니다. 이 메서드는

/**
 * @param string $view 视图名或文件路径，由实际的渲染方法决定
 * @param array $params 传递给视图的数据
 * @return string 渲染结果
 */
methodName($view, $params = [])

형식과 유사합니다. 컨트롤러에서 렌더링

컨트롤러에서 다음 컨트롤러 메서드를 호출하여 뷰를 렌더링할 수 있습니다.

yiibaseController::render(): 뷰 이름을 렌더링하고 공들여 나열한 것.

yiibaseController::renderPartial(): 뷰 이름을 렌더링하고 레이아웃을 사용하지 않습니다.

yiiwebController::renderAjax(): 레이아웃을 사용하지 않고 뷰 이름을 렌더링하고 일반적으로 AJAX 웹 페이지 요청에 대한 응답으로 사용되는 등록된 모든 JS/CSS 스크립트 및 파일을 삽입합니다.

yiibaseController::renderFile(): 뷰 파일 디렉터리 또는 별칭에서 뷰 파일을 렌더링합니다.

예:

namespace app\controllers;
 
use Yii;
use app\models\Post;
use yii\web\Controller;
use yii\web\NotFoundHttpException;
 
class PostController extends Controller
{
  public function actionView($id)
  {
    $model = Post::findOne($id);
    if ($model === null) {
      throw new NotFoundHttpException;
    }
 
    // 渲染一个名称为"view"的视图并使用布局
    return $this->render('view', [
      'model' => $model,
    ]);
  }
}

Widget
위젯은 CWidget 또는 그 하위 클래스의 인스턴스입니다. 위젯은 일반적으로 뷰에 포함되어 생성됩니다. 예를 들어, 달력 위젯은 복잡한 달력 인터페이스를 렌더링하는 데 사용될 수 있습니다.

다음과 같이 보기 스크립트를 사용할 수 있습니다.

<?php $this->beginWidget(&#39;path.to.WidgetClass&#39;); ?>
...可能会由小物件获取的内容主体...
<?php $this->endWidget(); ?>

또는

<?php $this->widget(&#39;path.to.WidgetClass&#39;); ?>

후자는 본문 내용이 필요하지 않은 구성 요소에 사용됩니다.

위젯은 성능을 사용자 정의하도록 구성할 수 있습니다. CBaseController::beginWidget 또는 CBaseController::widget을 호출하여 초기화 속성 값을 설정합니다. 예를 들어 CMaskedTextField 위젯을 사용할 때 사용할 마스크를 지정하려고 합니다(번역가의 설명에 따르면 출력 형식으로 이해될 수 있음). 이 속성의 초기화 값을 전달하는 배열을 전달하면 됩니다. 여기서 배열의 키는 속성의 이름이고, 배열의 값은 아래와 같이 위젯 속성에 해당하는 값입니다.

<?php
$this->widget(&#39;CMaskedTextField&#39;,array(
  &#39;mask&#39;=>&#39;99/99/9999&#39;
));
?>

상속 CWidget을 사용하고 init() 및 run() 메서드를 재정의하면 새 위젯을 정의할 수 있습니다.

class MyWidget extends CWidget
{
  public function init()
  {
    // 此方法会被 CController::beginWidget() 调用
  }
  
  public function run()
  {
    // 此方法会被 CController::endWidget() 调用
  }
}

위젯은 기본적으로 컨트롤러처럼 자체 보기를 가질 수 있습니다. 위젯의 보기 파일은 위젯 클래스 파일이 포함된 디렉토리의 views 하위 디렉토리에 있습니다. 이러한 보기는 컨트롤러와 매우 유사한 CWidget::render()를 호출하여 렌더링할 수 있습니다. 레이아웃 파일을 지원하지 않습니다. 또한 위젯 뷰의 $this는 컨트롤러 인스턴스가 아닌 위젯 인스턴스를 가리킵니다.

뷰에서 렌더링

yiibaseView 뷰 구성 요소에서 제공하는 다음 메서드를 호출하여 뷰에서 다른 뷰를 렌더링할 수 있습니다.

yiibaseView::render(): Render 뷰 이름.

yii\web\View::renderAjax(): 渲染一个 视图名 并注入所有注册的JS/CSS脚本和文件，通常使用在响应AJAX网页请求的情况下。

yii\base\View::renderFile(): 渲染一个视图文件目录或别名下的视图文件。

例如，视图中的如下代码会渲染该视图所在目录下的 _overview.php 视图文件， 记住视图中 $this 对应 yii\base\View 组件:

<?= $this->render(&#39;_overview&#39;) ?>

其他地方渲染

在任何地方都可以通过表达式 Yii::$app->view 访问 yii\base\View 应用组件， 调用它的如前所述的方法渲染视图，例如：

// 显示视图文件 "@app/views/site/license.php"
echo \Yii::$app->view->renderFile('@app/views/site/license.php');

更多PHP的Yii框架中创建视图和渲染视图的方法详解相关文章请关注PHP中文网！