Explication détaillée des méthodes de création et de rendu des vues dans le framework Yii de PHP

Les vues font partie du modèle MVC. C'est le code qui affiche les données aux utilisateurs finaux. Dans les applications Web, les vues sont créées sur la base de modèles de vue. Le modèle de vue est un fichier de script PHP, qui contient principalement du code HTML et affiche du code PHP. Il est géré via le composant d'application yiiwebView. , qui fournit principalement des méthodes génériques pour aider à la construction et au rendu des vues. Pour plus de simplicité, nous appelons le modèle de vue ou le fichier de modèle de vue une vue.

Créer une vue

Comme mentionné ci-dessus, la vue est un script PHP contenant du code HTML et PHP. Le code suivant est une vue d'un formulaire de connexion. Vous pouvez voir que le code PHP est utilisé. pour générer du contenu dynamique, tel que le titre et le formulaire de la page, le code HTML l'organise en une belle page 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(); ?>

Dans la vue, vous pouvez accéder à $this pour pointer vers yiiwebView afin de gérer et de restituer ce fichier de vue.

En plus de $this, la vue dans l'exemple ci-dessus a d'autres variables prédéfinies telles que $model. Ces variables représentent les données transmises à la vue depuis le contrôleur ou d'autres objets qui déclenchent le rendu de la vue.

Astuce : Listez les variables prédéfinies dans le commentaire d'en-tête du fichier de vue afin qu'elles puissent être reconnues par l'éditeur IDE. C'est également un bon moyen de générer des documents de vue.
Sécurité

Lors de la création de vues générant des pages HTML, il est important de transcoder et de filtrer les données saisies par l'utilisateur avant de les afficher, sinon votre application pourrait être vulnérable aux attaques de scripts intersites.

Pour afficher du texte brut, appelez d'abord yiihelpersHtml::encode() pour le transcodage. Par exemple, le code suivant transcode le nom d'utilisateur avant de l'afficher :

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

Pour afficher le contenu HTML, appelez d'abord. yiihelpersHtmlPurifier pour filtrer le contenu. Par exemple, le code suivant filtrera le contenu soumis avant de l'afficher :

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

Astuce : HTMLPurifier fait un bon travail pour assurer la sécurité des données de sortie, mais ses performances sont pas bon. Si votre application a besoin de hautes performances, pensez à mettre en cache les résultats filtrés.

Organisation des vues

Semblable aux contrôleurs et aux modèles, il existe certaines conventions sur l'organisation des vues :

Les fichiers de vue rendus par les contrôleurs sont placés par défaut dans @app/views/ControllerID répertoire, où ControllerID correspond à l'ID du contrôleur. Par exemple, la classe du contrôleur est PostController, le répertoire du fichier de vue doit être @app/views/post et le répertoire correspondant à la classe du contrôleur PostCommentController est @app/views/post-comment. . S'il se trouve dans un contrôleur de module, le répertoire doit être le répertoire views/ControllerID sous le répertoire du module yiibaseModule::basePath
Pour le rendu des widgets, les fichiers de vue sont placés par défaut dans le répertoire WidgetPath/views, où WidgetPath ; représente le répertoire où se trouve le fichier de classe du widget ;
Pour les fichiers de vue rendus par d'autres objets, il est recommandé de suivre des règles similaires aux widgets.
Vous pouvez remplacer la méthode yiibaseViewContextInterface::getViewPath() d'un contrôleur ou d'un widget pour personnaliser le répertoire par défaut pour les fichiers d'affichage.

Render view

Vous pouvez appeler la méthode render view dans un contrôleur, un widget ou ailleurs pour restituer une vue. La méthode est similaire au format suivant :

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

<. 🎜>Rendu du contrôleur dans le contrôleur

Dans le contrôleur, les méthodes de contrôleur suivantes peuvent être appelées pour restituer la vue :

yiibaseController::render() : Afficher un nom de vue et renvoyer le rendu résultat à l’aide d’une mise en page.

yiibaseController::renderPartial() : restitue un nom de vue et n'utilise pas de mise en page.

yiiwebController::renderAjax() : restitue un nom de vue sans utiliser de mise en page et injecte tous les scripts et fichiers JS/CSS enregistrés, généralement utilisés en réponse aux requêtes Web AJAX.

yiibaseController::renderFile() : affiche un fichier de vue dans un répertoire ou un alias de fichiers de vue.

Par exemple :

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

Un widget est une instance de CWidget ou de sa sous-classe. C'est un composant principalement utilisé pour représenter des données. Les widgets sont généralement intégrés dans une vue. pour générer une interface utilisateur complexe et indépendante. Par exemple, un widget de calendrier peut être utilisé pour afficher une interface de calendrier complexe. Les widgets rendent l'interface utilisateur plus réutilisable

Nous pouvons utiliser le script d'affichage suivant pour utiliser un widget. :

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

ou

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

Ce dernier est utilisé pour les composants qui ne nécessitent aucun contenu de corps. Le widget

peut être personnalisé via la configuration Performance. se fait en appelant CBaseController::beginWidget ou CBaseController::widget pour définir la valeur de sa propriété d'initialisation. Par exemple, lors de l'utilisation du widget CMaskedTextField, nous souhaitons spécifier le masque utilisé (peut être compris comme un format de sortie, Note du traducteur). faites-le en passant un tableau portant les valeurs d'initialisation de ces propriétés. La clé du tableau ici est le nom de la propriété, et la valeur du tableau est la valeur correspondant à la propriété du petit objet. :

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

Héritez CWidget et remplacez ses méthodes init() et run() pour définir un nouveau widget :

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

Le widget peut avoir son propre widget comme une vue contrôleur. Par défaut, les fichiers de vue des widgets sont situés dans le sous-répertoire vues du répertoire contenant les fichiers de classe de widget. Ces vues peuvent être rendues en appelant CWidget::render(), qui est très similaire au contrôleur. La seule différence est Oui, la vue widget ne prend pas en charge les fichiers de mise en page. De plus, $this dans la vue widget pointe vers l’instance du widget plutôt que vers l’instance du contrôleur.

Rendu dans une vue

Vous pouvez restituer une autre vue dans une vue en appelant les méthodes suivantes fournies par le composant de vue yiibaseView :

yiibaseView::render() : Render un nom de vue.

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中文网！