Anda di halaman 1dari 6

Penanganan Error di PHP

No v 21, 201 0 By My PH Ptut oria ls Lev el: Ma hir Ko mentar Print Pada saat membuat sebuah aplikasi web, penanganan error (error handling) merupakan hal yang sangat penting. Penanganan error yang standar di PHP sangat sederhana. Error dikirim ke browser berisi pesan error, nama file, baris kode ke berapa tempat terjadinya error. Tanpa penanganan error yang baik, tentunya pada saat terjadi error, error akan tampil di browser dan dilihat oleh semua pengguna. Hal ini bisa menimbulkan ancaman terhadap keamanan website. PHP telah menyediakan function function untuk penanganan error seperti dijelaskan di Error Handling and Logging.

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

tanpa error handling seperti kode php diatas, pada saat tidak bisa melakukan koneksi ke database mysql, maka akan muncul pesan error seperti ini:
1. 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

2. 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 3. 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 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 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 6. 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
1. 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 2 4 8 256
E_ERROR E_WARNING E_PARSE E_NOTICE E_USER_ERROR

Fatal run-time errors. Error yang tidak bisa dihandel, seperti masalah alokasi memori. Eksekusi skrip berhenti. Run-time warnings (non-fatal errors). Eksekusi Skrip tidak berhenti. Compile-time parse errors. Error yang terjadi karena kesalahan penulisan kode php. Run-time notices. Error yang mengindikasikan bahwa skrip bisa menimbulkan error yang lain. Pesan error yang digenerate oleh user. Seperti E_ERROR, tapi digenerate menggunakan function trigger_error().

Nilai 512 1024 2048

Konstanta
E_USER_WARNING E_USER_NOTICE

Deskripsi Pesan error yang digenerate oleh user. Seperti E_WARNING, tapi digenerate menggunakan function trigger_error(). Pesan error yang digenerate oleh user. Seperti E_NOTICE, tapi digenerate menggunakan function trigger_error(). Error yang memberikan sugesti perubahan pada kode Anda untuk memastikan interoperabilitas terbaik dan kompatibilitas kode php Anda.

E_STRICT

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

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 ke3). 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
1. [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 2. [21-Nov-2010 11:57:56] PHP Stack trace: 3. [21-Nov-2010 11:57:56] PHP 1. {main}() /home/ellyxc/public_html/tutorial/error/die.php:0

4. [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
1. error_funciton($error_level,$error_message, $error_file,$error_line,$error_context)

Parameter error_level error_message error_file error_line error_context Contoh:

Deskripsi level error Pesan error yang terjadi Optional. Nama file tempat terjadi error Optional. Nomor baris kode tempat terjadi error Optional. Array yang berisi semua variable dan valuenya yang menyebabkan terjadinya error

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

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. }

Mengirim Email Saat Terjadi Error


Bagi para programmer atau webmaster, mendapatkan email saat terjadi error sangat membantu untuk mengambil tindakan yang cepat dan bila diperlukan untuk memperbaiki kode yang ada. Untuk itu bisa menggunakan kode seperti:
1. 2. 3. 4. 5. 6. 7. 8. 9. function customError($errorLevel,$errorMsg){ echo "<b>Error:</b> [$errorLevel] $errstr<br />"; echo "Admin terlah diberi tahu"; error_log("Error: [$errorLevel] $errorMsg",1, "admin@example.com","From: error@example.com"); } set_error_handler("customError", E_USER_WARNING); $input = "<strong>hurup tebal</strong>"; if(preg_match('/<(.+)>/', $input)){

10. trigger_error("anda tidak boleh memasukkan html tag", E_USER_WARNING); 11. }

Cara ini tidak disarankan untuk digunakan pada setiap error yang terjadi (bisa menyebabkan spamming). Error error lain lebih baik disimpan di server dalam sebuah file atau media lain.

Rangkuman
PHP memiliki penanganan error standar yang sederhana. Error dikirim ke browser berisi pesan error, nama file, baris kode ke berapa tempat terjadinya error. PHP memberikan kemampuan penanganan error yang lebih baik mulai dari menggunakan function die() sampai menggunakan custom error handler. Dengan function error_reporting() bisa difilter error error apa saja yang ingin ditampilkan. Untuk tidak menampilkan error bisa digunakan function ini_set('display_errors', 'Off'); dan function ini_set('error_log', 'logs/error.log'); untuk menyimpan error ke dalam file "logs/error.log", menggunakan function trigger_error() untuk mengenerate custom error message, serta function error_log() untuk mengirim email pada saat terjadi error.

Referensi

http://www.php.net/manual/en/book.errorfunc.php http://www.w3schools.com/php/php_error.asp

Tags: tutorial php, php error, error handling