Pengenalan

Dalam tutorial hari ini, saya akan memperkenalkan ralat dan pengendalian pengecualian Yii serta membimbing anda melalui beberapa senario pengenalan.

Nak tahu apa itu Yii? Lihat Pengenalan kami kepada Rangka Kerja Yii dan siri Pengaturcaraan Yii2.

Apakah perbezaan antara ralat dan pengecualian?

Pepijat ialah kecacatan yang tidak dijangka dalam kod kami, selalunya ditemui dahulu oleh pengguna. Mereka biasanya mengganggu pelaksanaan program. Ia penting bukan sahaja untuk memecahkan dengan anggun untuk pengguna, tetapi juga untuk memberitahu pembangun masalah itu supaya ia boleh diperbaiki.

Pembangun membuat pengecualian apabila keadaan ralat yang boleh diramal berlaku. Dalam kod di mana pengecualian mungkin berlaku, pembangun boleh membuang() pengecualian kepada pengendali ralat yang mantap.

Bagaimana Yii menguruskan perkara ini?

Dalam Yii, ralat PHP yang tidak membawa maut (seperti amaran dan pemberitahuan) dialihkan kepada pengecualian yang boleh ditangkap supaya anda boleh memutuskan cara untuk bertindak balas dan membalasnya. Anda boleh menentukan tindakan pengawal untuk mengendalikan semua pengecualian ini. Anda juga boleh menyesuaikan format paparan ralat, seperti HTML, JSON, XML, dll.

Pengecualian dan ralat PHP yang membawa maut hanya boleh dinilai dalam mod nyahpepijat. Dalam jenis senario pembangunan ini, Yii boleh memaparkan maklumat tindanan panggilan terperinci dan coretan kod sumber (anda boleh melihat ini dalam imej pengepala di atas) .

Ralat maut ialah jenis peristiwa yang mengganggu pelaksanaan aplikasi. Ini termasuk kehabisan ingatan, membuat seketika objek kelas yang tidak wujud, atau memanggil fungsi yang tidak wujud.

Contohnya:

$t = new Unknownobject();

Mari kita mulakan dengan melihat beberapa contoh ralat dan pengendalian pengecualian.

Ralat konfigurasi dan pengendalian pengecualian

Pertama, kami mengkonfigurasi aplikasi kami di frontend/config/main.php. errorHandler ditakrifkan sebagai komponen seperti yang ditunjukkan di bawah. Contoh ini adalah daripada aplikasi siri permulaan saya, Perancang Mesyuarat. Sila ambil perhatian konfigurasi errorHandler dalam komponen: errorHandler 在 components 中的配置：

<?php
$params = array_merge(
    require(__DIR__ . '/params.php'),
    require(__DIR__ . '/params-local.php')
);
return [
    'id' => 'mp-frontend',
    'name' => 'Meeting Planner',
    'basePath' => dirname(__DIR__),
    'bootstrap' => ['log','\common\components\SiteHelper'],
    'controllerNamespace' => 'frontend\controllers',
    'catchAll'=> [],
    'components' => [
      'assetManager' => [...],
      ...
      'errorHandler' => [
            'errorAction' => 'site/error',
            'maxSourceLines' => 20,
        ],
        ...
    ],
];

在上面的示例中，errorAction 将用户定向到我的 SiteController 的错误操作。

更广泛地说，Yii 为 errorHandler 提供了多种配置选项，用于重定向和数据收集：

return [
    'components' => [
        'errorHandler' => [
            'errorAction' => 'site/error',
        ],
    ]
];

return [
    'components' => [
        'errorHandler' => [
            'errorAction' => 'site/error',
        ],
    ]
];

namespace app\controllers;

use Yii;
use yii\web\Controller;

class SiteController extends Controller
{
    public function actions()
    {
        return [
            'error' => [
                'class' => 'yii\web\ErrorAction',
            ],
        ];
    }
}

public function actionError()
{
    $exception = Yii::$app->errorHandler->exception;
    if ($exception !== null) {
        return $this->render('error', ['exception' => $exception]);
    }
}

public function actionError()
    {
        $exception = Yii::$app->errorHandler->exception;
        if ($exception instanceof \yii\web\NotFoundHttpException) {
            // all non existing controllers+actions will end up here
            return $this->render('pnf'); // page not found
        } else {
          return $this->render('error', ['exception' => $exception]);
        }
    }

use Yii;
use yii\base\ErrorException;

...

    try {
        10/0;
    } catch (ErrorException $e) {
        Yii::warning("Division by zero.");
    }
    
...

use yii\web\NotFoundHttpException;

throw new NotFoundHttpException();

  try {
          10/0;
      } catch (ErrorException $e) {
        throw new \yii\web\HttpException(451,
            'Tom McFarlin\'s humor is often lost on me
                (and lots of people).');
    }