Trace به رشته (getTraceAsString)
متد «getTraceAsString()» ردگیری پشته «Stack Trace» را متنی می کند. یعنی مسیر اجرای توابع را به یک رشته تبدیل می کند. این مثل گزارش قدم به قدم برگشت از حیاط تا کلاس است.
تعریف کوتاه و کاربرد
getTraceAsString() رشته ای از ردگیری پشته برمی گرداند. این رشته وضعیت اجرای توابع را هنگام پرتاب «استثنا (Exception)» نشان می دهد. بنابراین خواندنش ساده تر از آرایه است و برای لاگ عالی است.
مثال عملی از منبع
<?php
function myFunction($num) {
throw new Exception("An error occurred");
}
try {
myFunction(5);
}
catch (Exception $e) {
print_r($e->getTraceAsString());
}
?>
سه گام برای استفاده سریع
- کد حساس را داخل بلوک try قرار بده.
- استثنا را در catch بگیر و ذخیره کن.
- رشته getTraceAsString() را چاپ یا لاگ کن.
نکته: خروجی را در فایل لاگ بنویس. سپس راحت تر جست وجو کن.
مطالعه مرتبط
نسخه آرایه ای را در getTrace ببین. پیام خطا را با getMessage و کد را با getCode بگیر. همچنین مسیر فایل با getFile و شماره خط با getLine. این صفحه Trace به رشته جمع بندی متنی دارد.
جمع بندی سریع
- getTraceAsString() خروجی متنی می دهد.
- خواندن و لاگ کردن را ساده می کند.
- برای رفع خطا بسیار مفید است.
- کنار getTrace جزئیات کامل تر می گیری.