PHP debug_backtrace() فنکشن

مثال

PHP کا backtrace پیدا کرنا:

<?php
 function a($txt) {
     b("Glenn");
 }
 function b($txt) {
     c("Cleveland");
}
 function c($txt) {
     var_dump(debug_backtrace());
 }
 a("Peter");
 ?> 

یہ کد کا آؤٹ پتا مندرجہ ذیل ہیں:

Array (
     [0] => Array (
         [file] => C:\webfolder\test.php
         [line] => 6
         [function] => c
         [args] => Array (
             [0] => Cleveland
         )
     )
     [1] => Array (
         [file] => C:\webfolder\test.php
         [line] => 3
         [function] => b
         [args] => Array (
             [0] => Glenn
         )
     )
     [2] => Array (
         [file] => C:\webfolder\test.php
         [line] => 11
         [function] => a
         [args] => Array (
             [0] => Peter
         )
     )
 )

تعریف و استعمال

debug_backtrace() فنکشن backtrace (واپسی پٹر) پیدا کرتا ہے۔

یہ فنکشن debug_backtrace() کی کد سے پیدا ہونے والے اعداد وشمار کو دکھاتا ہے۔

ایک مربوطہ آرایہ واپس کرتا ہے۔ ممکنہ واپس وصول کئے جانے والے عناصر مندرجہ ذیل ہیں:

نام نوع توضیح
توابع رشته نام تابع فعلی
خط عدد صحیح شماره خط فعلی
فایل رشته نام فایل فعلی
کلاس رشته نام کلاس فعلی
آبجکت آبجکت آبجکت فعلی
نوع رشته

نوع فراخوانی فعلی. فراخوانی‌های ممکن:

  • بازگشت: "->" - فراخوانی روش
  • بازگشت: "::" - فراخوانی روش استاتیک
  • بازگشت nothing - فراخوانی تابع
args آرایه اگر در داخل یک تابع باشد، پارامترهای تابع را لیست کنید. اگر در یک فایل مراجعه شده باشد، نام فایل مراجعه شده را لیست کنید.

جملات

debug_backtrace(گزینه‌ها,محدودیت);
پارامتر توضیح
گزینه‌ها

اختیاری. ماسک بیت برای گزینه‌های زیر تعیین کنید:

  • DEBUG_BACKTRACE_PROVIDE_OBJECT (آیا باید شامل "object" باشد)
  • DEBUG_BACKTRACE_IGNORE_ARGS (آیا شامل "args" است که شامل تمام پارامترهای function/method است و می‌تواند هزینه حافظه را کاهش دهد.)
محدودیت اختیاری. محدود کردن تعداد فریم‌های استک را محدود کنید. پیش‌فرض (محدودیت=0) بازگشت تمام فریم‌های استک

جزئیات فنی

مقدار بازگشتی: هیچ‌کدام
نسخه PHP: 4.3+
رویدادهای به‌روزرسانی PHP

PHP 5.4: پارامتر انتخابی اضافه شد محدودیت.

PHP 5.3.6: پارامتر provide_object تغییر داد گزینه‌ها، و پارامتر انتخابی DEBUG_BACKTRACE_IGNORE_ARGS اضافه شد.

PHP 5.2.5: اضافه شد پارامتر انتخابی provide_object.

PHP 5.1.1: اضافه شد آبجکت برای عناصر ممکنه.