Doc comments and code style for 'debug' extension adjusted

extensions/debug/Panel.php

@@ -25,12 +25,22 @@ use yii\helpers\Url;
  */
 class Panel extends Component
 {
+    /**
+     * @var string panel unique identifier.
+     * It is set automatically by the container module.
+     */
     public $id;
+    /**
+     * @var string request data set identifier.
+     */
     public $tag;
     /**
      * @var Module
      */
     public $module;
+    /**
+     * @var mixed data associated with panel
+     */
     public $data;
     /**
      * @var array array of actions to add to the debug modules default controller.

extensions/debug/panels/MailPanel.php

@@ -25,7 +25,6 @@ use yii\mail\MessageInterface;
  */
 class MailPanel extends Panel
 {
-
     /**
      * @var string path where all emails will be saved. should be an alias.
      */
@@ -35,6 +34,9 @@ class MailPanel extends Panel
      */
     private $_messages = [];
 
+    /**
+     * @inheritdoc
+     */
     public function init()
     {
         parent::init();
@@ -74,16 +76,25 @@ class MailPanel extends Panel
         });
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getName()
     {
         return 'Mail';
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getSummary()
     {
         return Yii::$app->view->render('panels/mail/summary', ['panel' => $this, 'mailCount' => count($this->data)]);
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getDetail()
     {
         $searchModel = new Mail();
@@ -96,6 +107,9 @@ class MailPanel extends Panel
         ]);
     }
 
+    /**
+     * @inheritdoc
+     */
     public function save()
     {
         return $this->getMessages();

extensions/debug/views/default/index.php

@@ -1,9 +1,4 @@
 <?php
-
-use yii\helpers\Html;
-use yii\grid\GridView;
-use yii\data\ArrayDataProvider;
-
 /**
  * @var \yii\web\View $this
  * @var array $manifest
@@ -12,6 +7,10 @@ use yii\data\ArrayDataProvider;
  * @var \yii\debug\Panel[] $panels
  */
 
+use yii\helpers\Html;
+use yii\grid\GridView;
+use yii\data\ArrayDataProvider;
+
 $this->title = 'Yii Debugger';
 ?>
 <div class="default-index">

extensions/debug/views/default/panels/db/detail.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * @var yii\debug\panels\DbPanel $panel
+ * @var yii\debug\models\search\Db $searchModel
+ * @var yii\data\ArrayDataProvider $dataProvider
+ */
+
 use yii\helpers\Html;
 use yii\grid\GridView;
 

extensions/debug/views/default/panels/db/summary.php

@@ -1,3 +1,10 @@
+<?php
+/**
+ * @var yii\debug\panels\DbPanel $panel
+ * @var integer $queryCount
+ * @var integer $queryTime
+ */
+?>
 <?php if ($queryCount): ?>
 <div class="yii-debug-toolbar-block">
     <a href="<?= $panel->getUrl() ?>" title="Executed <?= $queryCount ?> database queries which took <?= $queryTime ?>.">

extensions/debug/views/default/panels/log/detail.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * @var yii\debug\panels\LogPanel $panel
+ * @var yii\debug\models\search\Log $searchModel
+ * @var yii\data\ArrayDataProvider $dataProvider
+ */
+
 use yii\helpers\Html;
 use yii\grid\GridView;
 use yii\helpers\VarDumper;

extensions/debug/views/default/panels/log/summary.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * @var yii\debug\panels\LogPanel $panel
+ * @var array $data
+ */
+
 use yii\log\Target;
 use yii\log\Logger;
 

extensions/debug/views/default/panels/mail/_item.php

@@ -1,4 +1,7 @@
 <?php
+/**
+ * @var array $model
+ */
 
 use yii\helpers\Html;
 use yii\widgets\DetailView;

extensions/debug/views/default/panels/mail/detail.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * @var yii\debug\panels\MailPanel $panel
+ * @var yii\debug\models\search\Mail $searchModel
+ * @var yii\data\ArrayDataProvider $dataProvider
+ */
+
 use \yii\widgets\ListView;
 use yii\widgets\ActiveForm;
 use yii\helpers\Html;
@@ -25,7 +31,7 @@ $listView->sorter = ['options' => ['class'=>'mail-sorter']];
 <div id="email-form" style="display: none;">
     <?php $form = ActiveForm::begin([
             'method' => 'get',
-            'action' => ['/debug/default/view', 'tag'=>\Yii::$app->request->get('tag'), 'panel'=>'mail'],
+            'action' => ['/debug/default/view', 'tag' => Yii::$app->request->get('tag'), 'panel' => 'mail'],
     ]); ?>
     <div class="row">
         <?= $form->field($searchModel, 'from', ['options' => ['class' => 'col-lg-6']])->textInput() ?>

extensions/debug/views/default/panels/mail/summary.php

@@ -1,6 +1,7 @@
 <?php
 /**
  * @var yii\debug\panels\MailPanel $panel
+ * @var integer $mailCount
  */
 if ($mailCount): ?>
 <div class="yii-debug-toolbar-block">

extensions/debug/views/default/panels/profile/detail.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * @var yii\debug\panels\ProfilingPanel $panel
+ * @var yii\debug\models\search\Profile $searchModel
+ * @var yii\data\ArrayDataProvider $dataProvider
+ * @var integer $time
+ * @var integer $memory
+ */
+
 use yii\grid\GridView;
 use yii\helpers\Html;
 

extensions/debug/views/default/panels/profile/summary.php

@@ -1,3 +1,10 @@
+<?php
+/**
+ * @var yii\debug\panels\ProfilingPanel $panel
+ * @var integer $time
+ * @var integer $memory
+ */
+?>
 <div class="yii-debug-toolbar-block">
     <a href="<?= $panel->getUrl() ?>" title="Total request processing time was <?= $time ?>">Time <span class="label label-info"><?= $time ?></span></a>
     <a href="<?= $panel->getUrl() ?>" title="Peak memory consumption">Memory <span class="label label-info"><?= $memory ?></span></a>

extensions/debug/views/default/panels/request/detail.php

@@ -1,10 +1,10 @@
 <?php
-use yii\bootstrap\Tabs;
-
 /**
  * @var yii\debug\panels\RequestPanel $panel
  */
 
+use yii\bootstrap\Tabs;
+
 echo "<h1>Request</h1>";
 
 echo Tabs::widget([

extensions/debug/views/default/panels/request/summary.php

@@ -1,11 +1,11 @@
 <?php
-use yii\helpers\Html;
-use yii\web\Response;
-
 /**
  * @var yii\debug\panels\RequestPanel $panel
  */
 
+use yii\helpers\Html;
+use yii\web\Response;
+
 $statusCode = $panel->data['statusCode'];
 if ($statusCode === null) {
     $statusCode = 200;

extensions/debug/views/default/panels/request/table.php

@@ -1,11 +1,11 @@
 <?php
-use yii\helpers\Html;
-use yii\helpers\VarDumper;
-
 /**
  * @var string $caption
  * @var array $values
  */
+
+use yii\helpers\Html;
+use yii\helpers\VarDumper;
 ?>
 <h3><?= $caption ?></h3>
 

extensions/debug/views/default/toolbar.php

@@ -5,6 +5,7 @@
  * @var string $tag
  * @var string $position
  */
+
 use yii\helpers\Url;
 
 $minJs = <<<EOD

extensions/debug/views/default/view.php

@@ -1,10 +1,4 @@
 <?php
-
-use yii\bootstrap\ButtonDropdown;
-use yii\bootstrap\ButtonGroup;
-use yii\helpers\Url;
-use yii\helpers\Html;
-
 /**
  * @var \yii\web\View $this
  * @var array $summary
@@ -14,6 +8,11 @@ use yii\helpers\Html;
  * @var \yii\debug\Panel $activePanel
  */
 
+use yii\bootstrap\ButtonDropdown;
+use yii\bootstrap\ButtonGroup;
+use yii\helpers\Url;
+use yii\helpers\Html;
+
 $this->title = 'Yii Debugger';
 ?>
 <div class="default-view">

extensions/elasticsearch/DebugAction.php

@@ -28,9 +28,13 @@ class DebugAction extends Action
      */
     public $db;
     /**
-     * @var Panel
+     * @var DebugPanel
      */
     public $panel;
+    /**
+     * @var \yii\debug\controllers\DefaultController
+     */
+    public $controller;
 
     public function run($logId, $tag)
     {

extensions/elasticsearch/DebugPanel.php

@@ -33,11 +33,17 @@ class DebugPanel extends Panel
         ];
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getName()
     {
         return 'Elasticsearch';
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getSummary()
     {
         $timings = $this->calculateTimings();
@@ -59,6 +65,9 @@ EOD;
         return $queryCount > 0 ? $output : '';
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getDetail()
     {
         $timings = $this->calculateTimings();