Yii2 视图代码风格

以下代码风格用于 Yii 2.x 核心和官方扩展中的视图文件。我们不强制你在自己的应用中使用此风格。自由决断，选你喜欢的。

  1. <?php
  2. // 每个模板文件必须有 PHP 开始标签。开始标签后需要空一行。
  4. // 这里描述通过控制器传过来的变量
  5. /**
  6.  * @var yii\base\View $this
  7.  * @var yii\widgets\ActiveForm $form
  8.  * @var app\models\Post[] $posts
  9.  * @var app\models\ContactMessage $contactMessage
  10.  */
  11. // 描述完也要空一行
  13. // 命名空间的类声明
  14. use yii\helpers\Html;
  15. use yii\widgets\ActiveForm;
  16. // 下面也要空一行
  18. // 设置上下文属性，调用 setter， 和做其它事。
  19. $this->title = 'Posts';
  20. ?>
  21. <!-- foreach，for，if等最好用单独的代码段 -->
  22. <?php foreach ($posts as $post): ?>
  23.     <!-- 注意缩进 -->
  24.     <h2><?= Html::encode($post['title']) ?></h2>
  25.     <p><?= Html::encode($post['shortDescription']) ?></p>
  26. <!-- 如果使用了多个代码段， 应该用 `endforeach;`， `endfor;`， `endif;` 等代替 `}` -->
  27. <?php endforeach; ?>
  29. <!-- 小物件的调用可能在多个逻辑控制语句中 -->
  30. <?php $form = ActiveForm::begin([
  31.     'options' => ['id' => 'contact-message-form'],
  32.     'fieldConfig' => ['inputOptions' => ['class' => 'common-input']],
  33. ]); ?>
  34.     <!-- 注意缩进 -->
  35.     <?= $form->field($contactMessage, 'name')->textInput() ?>
  36.     <?= $form->field($contactMessage, 'email')->textInput() ?>
  37.     <?= $form->field($contactMessage, 'subject')->textInput() ?>
  38.     <?= $form->field($contactMessage, 'body')->textArea(['rows' => 6]) ?>
  40.     <div class="form-actions">
  41.         <?= Html::submitButton('Submit', ['class' => 'common-button']) ?>
  42.     </div>
  43. <!-- 结束小物件调用应该用单独一组 PHP 标签 -->
  44. <?php ActiveForm::end(); ?>
  45. <!-- 结尾必须多出一个换行符 -->