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