گام دوازدهم – مدیریت خطاها در پی اچ پی

پردازش خطا به طور پیش فرض در PHP بسیار ساده است. یک پیام خطا با نام فایل، شماره خط و یک پیام خطا توصیف شده به مرورگر ارسال می شود.

پردازش خطا PHP

هنگام ایجاد اسکریپت ها و برنامه های کاربردی وب، مدیریت یا دستگیری خطاها یک بخش مهم است. اگر کد شما فاقد کد خطا باشد، برنامه شما ممکن است بسیار غیر حرفه ای باشد و ممکن است در مقابل خطرات امنیتی ضعیف باشد .

این آموزش شامل برخی از رایج ترین روش های بررسی خطا در PHP می باشد.

ما روش های خطای مختلف را نشان می دهیم:

• دستور ساده die
• سفارشی کردن خطاها و تعریف تریگرها
• گزارش خطاها

پردازش خطای عمومی: با استفاده از تابع die ()

مثال زیر یک اسکریپت ساده است که یک فایل متنی را باز می کند:

<?php
$file=fopen("welcome.txt","r");
?>

اگر فایل وجود نداشته باشد خطایی مانند این را دریافت خواهید کرد:

Warning: fopen(welcome.txt) [function.fopen]: failed to open stream:
No such file or directory in C:\webfolder\test.php on line 2

برای جلوگیری از دریافت پیام خطایی مثل بالا، باید قبل از تلاش برای دسترسی به فایل موجود بودن آنرا بررسی کنیم:

<?php
if(!file_exists("welcome.txt")) {
die("File not found");
} else {
$file=fopen("welcome.txt","r");
}
?>

حالا اگر فایل وجود نداشته باشد، شما یک خطا مثل این دریافت خواهید کرد:

File not found

کد بالا کارایی بیشتری نسبت به کد قبلی دارد، زیرا از روشی ساده خطا استفاده می کند تا مانع اجرای اسکریپت پس از خطا شود.

با این حال، متوقف کردن اسکریپت به این سادگی، همیشه راه حل مناسب نیست. در ادامه نگاهی به توابع جایگزین پی اچ پی برای مدیریت خطاها داریم.

ایجاد یک متد خطای سفارشی

ایجاد یک دستگیره سفارشی خطا، بسیار ساده است. به سادگی یک تابع خاص ایجاد می کنیم که می تواند زمانیکه یک خطا در پی اچ پی رخ دهد اجرا شود.

این تابع باید بتواند حداقل دو پارامتر (سطح خطا و پیام خطا) را مدیریت کند، ولی در اصل می تواند تا پنج پارامتر (اختیاری: فایل، شماره خط و خطای خطا) را قبول کند:

شکل کلی تابع:

error_function(error_level,error_message,
error_file,error_line,error_context)

پارامترهای آن بصورت زیر هستند:

error_level : (پارامتر اجباری) و سطح گزارش error برای خطای تعریف شده توسط کاربر را مشخص می کند. باید مقدار عددی باشد جدول زیر را برای سطوح گزارش خطا احتمالی ببینید.
error_message : (پارامتر اجباری) ، پیام خطا را برای خطای تعریف شده کاربر مشخص می کند.
error_file : (پارامتر اختیاری) ، نام فایل را که خطایی رخ داده است را مشخص می کند.
error_line : (پارامتر اختیاری) ، شماره خط که در آن خطا اتفاق افتاده را مشخص می کند.
error_context : (پارامتراختیاری)، یک آرایه حاوی هر متغیر را تعیین می کند و مقادیر آنها در زمان استفاده از خطا رخ می دهد.

سطوح گزارش خطا

این سطوح گزارش خطا، انواع مختلفی از خطا است که توسط خطای کاربر تعریف می شود برای:

حالا اجازه دهید یک تابع برای رسیدگی به خطاها ایجاد کنیم:

function customError($errno, $errstr) {
echo "<b>Error:</b> [$errno] $errstr<br>";
echo "Ending Script";
die();
}

کد فوق یک تابع پردازش خطای ساده است. هنگامی که فعال می شود، سطح خطا و یک پیام خطا دریافت می کند. سطح خطا و پیام را نمایش می دهد و اسکریپت را خاتمه می دهد.

حالا که ما یک تابع مدیریت خطا ایجاد کرده ایم و باید تصمیم بگیریم که چه زمانی باید آن را فعال کنیم.

تنظیم کننده خطا

پردازشگر پیشفرض خطا برای پی اچ پی یک پردازشگر خطای پیش ساخته است. ما قصد داریم تابع فوق را بعنوان پردازشگر خطای پیش فرض در طول اجرای اسکریپت تعیین کنیم.

ما می توانیم پرداشگر خطا را برای هر نوعی از خطاها جداگانه تعیین کنیم تا اسکریپت بتواند خطاهای مختلف را با روش های مختلف اداره کند. با این حال، در این مثال ما قصد داریم برای همه خطاها، یک تابع پردازش کننده خطا تعریف کنیم:

set_error_handler("customError");

از آنجا که ما می خواهیم تابع سفارشی ما تمام اشتباهات را مدیریت کند، set_error_handler ، فقط یک پارامتر را به کار برد، پارامتر دوم می تواند برای تعیین سطح خطا اضافه شود.

مثال

تست پردازشگر خطا با تلاش برای چاپ متغیری که وجود ندارد:

<?php
//error handler function
function customError($errno, $errstr) {
echo "<b>Error:</b> [$errno] $errstr";
}
//set error handler
set_error_handler("customError");
//trigger error
echo($test);
?>


خروجی کد بالا باید چیزی شبیه به این باشد:

Error: [8] Undefined variable: test

در این بخش با روش تعریف و استفاده از تابع پردازشگر خطا در پی اچ پی آشنا شدید، در گام بعدی تعریف تریپرها و گزارش خطاها را آموزش خواهیم داد.