Pengendalian pengecualian PHP

Pengendalian Pengecualian PHP

Pengecualian digunakan untuk menukar aliran biasa skrip apabila ralat tertentu berlaku.

Apakah pengecualian

PHP 5 menyediakan kaedah pengendalian ralat berorientasikan objek baharu.

Pengendalian pengecualian digunakan untuk menukar aliran biasa skrip apabila situasi ralat (pengecualian) tertentu berlaku. Keadaan ini dipanggil pengecualian.

Apabila pengecualian dicetuskan, perkara yang biasanya berlaku ialah:

·   Keadaan kod semasa disimpan

·   Pelaksanaan kod ditukar kepada pengendali pengecualian (Fungsi tersuai) yang telah ditetapkan

·  Bergantung pada situasi, pemproses boleh memulakan semula pelaksanaan kod daripada keadaan kod yang disimpan, menamatkan pelaksanaan skrip atau meneruskan pelaksanaan skrip dari lokasi lain dalam kod

Kami akan menunjukkan pengendalian Ralat yang berbeza kaedah:

· Penggunaan asas pengecualian

· Buat pengendali pengecualian tersuai

· Pengecualian berbilang

· Lempar semula pengecualian

·      Tetapkan pengendali pengecualian peringkat teratas

Nota: Pengecualian hanya boleh digunakan dalam situasi ralat dan tidak boleh digunakan untuk melompat ke lokasi lain dalam kod pada titik yang ditentukan.

Penggunaan asas pengecualian

Apabila pengecualian dilemparkan, kod berikutnya tidak akan terus dilaksanakan akan cuba mencari blok "tangkapan" yang sepadan.

Jika pengecualian tidak ditangkap dan tidak perlu menggunakan set_exception_handler() untuk pemprosesan yang sepadan, maka ralat serius (ralat maut) akan berlaku dan "Pengecualian Tidak Ditangkap" akan dikeluarkan.

Mari cuba melontar pengecualian tanpa menangkapnya:

<?php
// 创建一个有异常处理的函数
function checkNum($number)
{
         if($number>1)
         {
                 throw new Exception("Value must be 1 or below");
         }
         return true;
}
 
// 触发异常
checkNum(2);
?>

Kod di atas akan mendapat ralat seperti ini:

Fatal error: Uncaught exception 'Exception' with message 'Value must be 1 or below' in /www/runoob/test/test.php:7 Stack trace: #0 /www/runoob/test/test.php(13): checkNum(2) #1 {main} thrown in /www/runoob/test/test.php on line 7

Cuba, baling dan tangkap

Untuk mengelakkan ralat yang dilihat dalam contoh di atas, kita perlu mencipta kod yang sesuai untuk mengendalikan pengecualian.

Kod pengendalian pengecualian yang sesuai hendaklah termasuk:

1. Cuba - Fungsi yang menggunakan pengecualian hendaklah terletak dalam blok kod "cuba". Jika tiada pengecualian dicetuskan, kod meneruskan pelaksanaan seperti biasa. Tetapi jika pengecualian dicetuskan, pengecualian akan dilemparkan.

2. Lempar - menentukan cara mencetuskan pengecualian. Setiap "lontaran" mesti sepadan dengan sekurang-kurangnya satu "tangkapan".

3 Tangkap - Blok kod "tangkap" akan menangkap pengecualian dan mencipta objek yang mengandungi maklumat pengecualian.

Mari kita cetuskan pengecualian:

<?php
// 创建一个有异常处理的函数
function checkNum($number)
{
         if($number>1)
         {
                 throw new Exception("变量值必须小于等于 1");
         }
                 return true;
}
        
// 在 try 块 触发异常
try
{
         checkNum(2);
         // 如果抛出异常，以下文本不会输出
         echo '如果输出该内容，说明 $number 变量';
}
// 捕获异常
catch(Exception $e)
{
         echo 'Message: ' .$e->getMessage();
}
?>

Kod di atas akan mendapat ralat seperti ini:

Mesej: Nilai pembolehubah mestilah kurang daripada atau sama dengan 1

Penjelasan contoh :

Kod di atas membuang pengecualian dan menangkapnya:

1. Cipta fungsi checkNum(). Ia mengesan sama ada nombor itu lebih besar daripada 1. Jika ya, buang pengecualian.

2. Panggil fungsi checkNum() dalam blok kod "cuba".

3. Pengecualian dalam fungsi checkNum() dilemparkan.

4. Blok kod "tangkap" menerima pengecualian dan mencipta objek ($e) yang mengandungi maklumat pengecualian.

5. Keluarkan mesej ralat daripada pengecualian ini dengan memanggil $e->getMessage() daripada objek pengecualian ini.

Walau bagaimanapun, untuk mengikut prinsip "setiap lontaran mesti sepadan dengan tangkapan", anda boleh menyediakan pengendali pengecualian peringkat atas untuk mengendalikan ralat terlepas.

Buat kelas Pengecualian tersuai

Mencipta pengendali pengecualian tersuai adalah sangat mudah. Kami hanya mencipta kelas khusus yang fungsinya dipanggil apabila pengecualian berlaku dalam PHP. Kelas ini mestilah lanjutan daripada kelas pengecualian.

Kelas pengecualian tersuai ini mewarisi semua sifat kelas pengecualian PHP dan anda boleh menambah fungsi tersuai padanya.

Kita mulakan dengan mencipta kelas pengecualian:

<?php
class customException extends Exception
{
         public function errorMessage()
         {
                 // 错误信息
                 $errorMsg = '错误行号 '.$this->getLine().' in '.$this->getFile()
                 .': <b>'.$this->getMessage().'</b> 不是一个合法的 E-Mail 地址';
                 return $errorMsg;
         }
}
$email = "someone@example...com";
try
{
         // 检测邮箱
         if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE)
         {
                 // 如果是个不合法的邮箱地址，抛出异常
                 throw new customException($email);
         }
}
catch (customException $e)
{
//display custom message
echo $e->errorMessage();
}
?>

Kelas baharu ini ialah salinan kelas pengecualian lama, ditambah dengan fungsi errorMessage(). Hanya kerana ia adalah salinan kelas lama, ia mewarisi sifat dan kaedah daripada kelas lama, dan kita boleh menggunakan kaedah kelas pengecualian, seperti getLine(), getFile(), dan getMessage().

Penjelasan contoh:

Kod di atas membuang pengecualian dan menangkapnya melalui kelas pengecualian tersuai:

1 Kelas customException() adalah sebagai Dibuat sebagai sambungan daripada kelas pengecualian lama. Dengan cara ini ia mewarisi semua sifat dan kaedah kelas pengecualian lama.

2. Cipta fungsi errorMessage(). Jika alamat e-mel tidak sah, fungsi ini mengembalikan mesej ralat.

3. Tetapkan pembolehubah $e-mel kepada rentetan alamat e-mel yang tidak sah.

4. Jalankan blok kod "cuba" dan buang pengecualian kerana alamat e-mel adalah haram.

5. Blok kod "catch" menangkap pengecualian dan memaparkan mesej ralat.

Berbilang pengecualian

Anda boleh menggunakan berbilang pengecualian untuk skrip untuk mengesan berbilang situasi.

Anda boleh menggunakan berbilang blok kod if..else, atau blok kod suis, atau sarang berbilang pengecualian. Pengecualian ini boleh menggunakan kelas pengecualian yang berbeza dan mengembalikan mesej ralat yang berbeza:

<?php
class customException extends Exception
{
         public function errorMessage()
         {
                 // 错误信息
                 $errorMsg = '错误行号 '.$this->getLine().' in '.$this->getFile()
                 .': <b>'.$this->getMessage().'</b> 不是一个合法的 E-Mail 地址';
                 return $errorMsg;
         }
}
$email = "someone@example.com";
try
{
         // 检测邮箱
         if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE)
         {
                 // 如果是个不合法的邮箱地址，抛出异常
                 throw new customException($email);
         }
         // 检测 "example" 是否在邮箱地址中
         if(strpos($email, "example") !== FALSE)
         {
                 throw new Exception("$email 是 example 邮箱");
         }
}
catch (customException $e)
{
         echo $e->errorMessage();
}
catch(Exception $e)
{
         echo $e->getMessage();
}
?>

Penjelasan contoh:

Kod di atas menguji dua syarat Jika mana-mana syarat tidak benar, ia akan membuang Throw an pengecualian:

1 Kelas customException() dicipta sebagai lanjutan daripada kelas pengecualian lama. Dengan cara ini ia mewarisi semua sifat dan kaedah kelas pengecualian lama.

2. Cipta fungsi errorMessage(). Jika alamat e-mel tidak sah, fungsi ini mengembalikan mesej ralat.

3 Tetapkan pembolehubah $e-mel kepada rentetan yang merupakan alamat e-mel yang sah tetapi mengandungi rentetan "contoh".

4. Jalankan blok kod "cuba" Di bawah syarat pertama, tiada pengecualian akan dilemparkan.

5 Memandangkan e-mel mengandungi rentetan "contoh", syarat kedua akan mencetuskan pengecualian.

6. Blok kod "tangkap" akan menangkap pengecualian dan memaparkan mesej ralat yang sesuai.

Jika kelas customException membuang pengecualian, tetapi tidak menangkap customException, tetapi hanya menangkap pengecualian asas, kendalikan pengecualian di sana.

Lempar semula pengecualian

Kadangkala, apabila pengecualian dilemparkan, anda mungkin mahu melakukannya dalam cara yang berbeza cara daripada cara standard untuk memprosesnya. Pengecualian boleh dilemparkan semula dalam blok "tangkapan".

Skrip harus menyembunyikan ralat sistem daripada pengguna. Ralat sistem mungkin penting kepada pengaturcara, tetapi pengguna tidak berminat dengannya. Untuk memudahkan pengguna, anda boleh membuang pengecualian sekali lagi dengan mesej mesra pengguna:

<?php
class customException extends Exception
{
         public function errorMessage()
         {
                 // 错误信息
                 $errorMsg = $this->getMessage().' 不是一个合法的 E-Mail 地址。';
                 return $errorMsg;
         }
}
$email = "someone@example.com";
try
{
         try
         {
                 // 检测 "example" 是否在邮箱地址中
                 if(strpos($email, "example") !== FALSE)
                 {
                          // 如果是个不合法的邮箱地址，抛出异常
                          throw new Exception($email);
                 }
         }
         catch(Exception $e)
         {
                 // 重新抛出异常
                 throw new customException($email);
         }
}
catch (customException $e)
{
         // 显示自定义信息
         echo $e->errorMessage();
}
?>

Contoh penjelasan:

Kod di atas mengesan sama ada terdapat aksara dalam String alamat e-mel " contoh". Jika ya, buang pengecualian sekali lagi:

1 Kelas customException() dicipta sebagai lanjutan daripada kelas pengecualian lama. Dengan cara ini ia mewarisi semua sifat dan kaedah kelas pengecualian lama.

2. Cipta fungsi errorMessage(). Jika alamat e-mel tidak sah, fungsi ini mengembalikan mesej ralat.

3 Tetapkan pembolehubah $e-mel kepada rentetan yang merupakan alamat e-mel yang sah tetapi mengandungi rentetan "contoh".

4. Blok "cuba" mengandungi blok "cuba" lain supaya pengecualian boleh dilemparkan semula.

5 Oleh kerana e-mel mengandungi rentetan "contoh", pengecualian dicetuskan.

6. Blok kod "catch" menangkap pengecualian dan melemparkan semula "customException".

7. Tangkap "customException" dan paparkan mesej ralat.

Jika pengecualian tidak ditangkap dalam blok "cuba" semasa, ia akan mencari blok tangkapan pada tahap yang lebih tinggi.

Tetapkan pengendali pengecualian peringkat atas

Fungsi set_exception_handler() boleh menetapkan fungsi yang ditentukan pengguna yang mengendalikan semua pengecualian yang tidak ditangkap.

<?php
function myException($exception)
{
         echo "<b>Exception:</b> " , $exception->getMessage();
}
set_exception_handler('myException');
throw new Exception('Uncaught Exception occurred');
?>

Keluaran kod di atas adalah seperti berikut:

Pengecualian: Pengecualian Tidak Ditangkap berlaku

Dalam kod di atas, tiada blok kod "tangkap", tetapi peringkat atas dicetuskan pengendali pengecualian. Fungsi ini harus digunakan untuk menangkap semua pengecualian yang tidak ditangkap.

Peraturan pengecualian

· Kod yang memerlukan pengendalian pengecualian hendaklah diletakkan dalam blok kod cuba untuk menangkap kemungkinan pengecualian.

·      Setiap blok kod cubaan atau lempar mesti mempunyai sekurang-kurangnya satu blok kod tangkapan yang sepadan.

· Gunakan berbilang blok kod tangkapan untuk menangkap pelbagai jenis pengecualian.

· Anda boleh melontar (melempar lagi) pengecualian dalam blok tangkapan dalam blok percubaan.

Ringkasnya: jika pengecualian dilemparkan, anda mesti menangkapnya.