PENANGANAN EROR DI PHP

Penanganan Error Sederhana mengunakan function die()

Function die([string $message]) berfungsi untuk menghentikan eksekusi baris kode berikutnya dan memberi output parameter optional $message. Contoh:

1. <?php  
2. //tanpa error handling  
3. $connection = mysql_connect("localhost", "user", "password");  
4. mysql_select_db("test");  
5. $result = mysql_query("select * from nama_table");  
6. while($row = mysql_fetch_array($result)){  
7. echo $row['nama_field'];  
8. }  
9. ?>  

tanpa error handling seperti kode php diatas, pada saat tidak bisa melakukan koneksi ke database mysql, maka akan muncul pesan error seperti ini:

mysql_connect()

 [function.mysql-connect]: Can't connect to local MySQL server through

socket '/var/run/mysql/mysql.sock' (2) in

/home/ellyxc/public_html/tutorial/error/die.php on line 3

Warning: mysql_select_db() [function.mysql-select-db]: Can't connect to

local MySQL server through socket '/var/run/mysql/mysql.sock' (2) in

/home/ellyxc/public_html/tutorial/error/die.php on line 4

Warning: mysql_select_db() [function.mysql-select-db]: A link to the

server could not be established in

/home/ellyxc/public_html/tutorial/error/die.php on line 4

Warning: mysql_query() [function.mysql-query]: Can't connect to local

MySQL server through socket '/var/run/mysql/mysql.sock' (2) in

/home/ellyxc/public_html/tutorial/error/die.php on line 5

Warning: mysql_query() [function.mysql-query]: A link to the server

could not be established in

/home/ellyxc/public_html/tutorial/error/die.php on line 5

Warning: mysql_fetch_array() expects parameter 1 to be resource, boolean

 given in /home/ellyxc/public_html/tutorial/error/die.php on line 6

tentu saja pengguna akan bingung melihat error di atas, dengan function die(), pesan error bisa diminimalisir seperti:

1. <?php  
2. //dengan error handling  
3. $connection = mysql_connect("localhost", "user", "password")  
4.  or die('Tidak bisa melalukan koneksi ke database');  
5. mysql_select_db("test");  
6. $result = mysql_query("select * from nama_table");  
7. while($row = mysql_fetch_array($result)){  
8. echo $row['nama_field'];  
9. }  
10. ?>  

pada saat tidak bisa melakukan koneksi ke database, kode di atas akan memberi output seperti ini

Tidak bisa melalukan koneksi ke database

Setting Error Reporting Level

PHP memberi kemampuan untuk menentukan error error apa saja yang ditampilkan menggunakan function
error_reporting([int $level ]). Parameter $level bisa diisi dengan nilai nilai berikut:

Nilai	Konstanta	Deskripsi
1	E_ERROR	Fatal run-time errors. Error yang tidak bisa dihandel, seperti masalah alokasi memori. Eksekusi skrip berhenti.
2	E_WARNING	Run-time warnings (non-fatal errors). Eksekusi Skrip tidak berhenti.
4	E_PARSE	Compile-time parse errors. Error yang terjadi karena kesalahan penulisan kode php.
8	E_NOTICE	Run-time notices. Error yang mengindikasikan bahwa skrip bisa menimbulkan error yang lain.
256	E_USER_ERROR	Pesan error yang digenerate oleh user. Seperti E_ERROR, tapi digenerate menggunakan function trigger_error().
512	E_USER_WARNING	Pesan error yang digenerate oleh user. Seperti E_WARNING, tapi digenerate menggunakan function trigger_error().
1024	E_USER_NOTICE	Pesan error yang digenerate oleh user. Seperti E_NOTICE, tapi digenerate menggunakan function trigger_error().
2048	E_STRICT	Error yang memberikan sugesti perubahan pada kode Anda untuk memastikan interoperabilitas terbaik dan kompatibilitas kode php Anda.
30719	E_ALL	Menampilkan semua error kecuali E_STRICT.

tabel selengkapnya bisa dilihat di http://www.php.net/manual/en/errorfunc.constants.php. Contoh penggunaan error_reporting().

1. <?php  
2. //menampilkan semua error  
3. error_reporting(E_ALL);  
4. //menampilkan semua error termasuk E_STRICT  
5. error_reporting(E_ALL|E_STRICT);  
6. //tidak menampilkan error  
7. error_reporting(0);  
8. ?>  

Tidak Menampilkan Error

Dari pada menampilkan error yang tidak dimengerti oleh pengguna, terkadang lebih baik tidak menampilkan error sama sekali, tetapi hanya mencatat error yang terjadi ke dalam sebuah file. Untuk itu bisa gunakan kode di bawah.

1. <?php  
2. error_reporting(E_ALL);  
3. ini_set('display_errors', 'Off');  
4. ini_set('log_errors', 'On');  
5. ini_set('error_log', 'logs/error.log');  
6. $connection = mysql_connect("localhost", "user", "password");  
7. mysql_select_db("test");  
8. $result = mysql_query("select * from nama_table");  
9. while($row = mysql_fetch_array($result)){  
10. echo $row['nama_field'];  
11. }  
12. ?>  

Untuk tidak menampilkan error digunakan function ini_set('display_errors', 'Off'); (baris ke-3). Di baris ke-5 untuk menyimpan error yang terjadi ke dalam file "logs/error.log". Pada saat terjadi error, file "logs/error.log" akan berisi data seperti ini

[21-Nov-2010

 11:57:56] PHP Warning: mysql_connect() [<a

href='function.mysql-connect'>function.mysql-connect</a>]:

Can't connect to local MySQL server through socket

'/var/run/mysql/mysql.sock' (2) in

/home/ellyxc/public_html/tutorial/error/die.php on line 6

[21-Nov-2010 11:57:56] PHP Stack trace:

[21-Nov-2010 11:57:56] PHP 1. {main}() /home/ellyxc/public_html/tutorial/error/die.php:0

[21-Nov-2010 11:57:56] PHP 2. mysql_connect() /home/ellyxc/public_html/tutorial/error/die.php:6

Mengambil pilihan untuk tidak menampilkan error bisa membingungkan pengguna. Cara yang lebih baik adalah dengan membawa user ke halaman tertentu, untuk memberi tahu pengguna bahwa sedang terjadi error.

Membuat Custom Error Handler

Selain menyediakan penanganan error standar, PHP juga memberikan kemampuan untuk membuat sebuah function yang bertugas untuk menangani error yang terjadi yang disebut dengan Custom Error Handler. Sebuah Custom Error Handler memiliki format seperti ini

error_funciton($error_level,$error_message, $error_file,$error_line,$error_context)

Parameter	Deskripsi
error_level	level error
error_message	Pesan error yang terjadi
error_file	Optional. Nama file tempat terjadi error
error_line	Optional. Nomor baris kode tempat terjadi error
error_context	Optional. Array yang berisi semua variable dan valuenya yang menyebabkan terjadinya error

Contoh:

1. <?php  
2. function customError($errorLevel,$errorMsg){  
3.  @session_start();  
4.  $_SESSION['error_msg'] = $errorMsg;  
5.  header("Location: error.php");  
6.  exit;  
7. }  
8. set_error_handler("customError");  
9. error_reporting(E_ALL);  
10. $connection = mysql_connect("localhost", "user", "password");  
11. mysql_select_db("test");  
12. $result = mysql_query("select * from nama_table");  
13. while($row = mysql_fetch_array($result)){  
14. echo $row['nama_field'];  
15. }  
16. ?>  

Baris 2-7 merupakan contoh Custom Error Handler, pesan error disimpan ke dalam sebuah session, dan pengguna dibawa ke halaman "error.php" pada saat terjadi error. Di baris 8 digunakan function set_error_handler($handler); untuk menentukan Custom Error Handler yang digunakan pada saat terjadi error. Parameter $handler diisi dengan string nama function Custom Error Handler. File "error.php" bisa seperti berikut.

1. <?php  
2. session_start();  
3. ?>  
4. <html>  
5.     <head>  
6.         <title>Error</title>  
7.     </head>  
8.     <body>  
9.         <h1>Error</h1>  
10.         <p>Maaf kami tidak bisa memproses request anda.</p>  
11.         <p>Pesan Error: <?php echo $_SESSION['error_msg'];?></p>  
12.     </body>  
13. </html>  

Mengenerate atau Men-trigger Error

PHP memberikan kemampuan untuk mengenerate custom error message menggunakan function trigger_error(). Function ini bisa digunakan misalnya pada saat pengguna memasukkan karakter karakter ilegal, seperti memasukkan tag html. Contoh:

1. $input = "<strong>hurup tebal</strong>";  
2. if(preg_match('/<(.+)>/', $input)){  
3. trigger_error("anda tidak boleh memasukkan html tag");  
4. }  

Menggunakan trigger_error bersama Custom Error Handler

1. function customError($errorLevel,$errorMsg){  
2.  @session_start();  
3.  $_SESSION['error_msg'] = $errorMsg;  
4.  header("Location: error.php");  
5.  exit;  
6. }  
7. set_error_handler("customError", E_USER_WARNING);  
8. $input = "<strong>hurup tebal</strong>";  
9. if(preg_match('/<(.+)>/', $input)){  
10. trigger_error("anda tidak boleh memasukkan html tag", E_USER_WARNING);  
11. }