مدیریت گزارش دیباگ – نظارت و بررسی راحت خطاها

گزارش تغییرات

2.4.3 (2025.09.24)

• تغییر نام ثابت‌های استفاده شده در DLM برای جلوگیری از تداخل با نام ثابت‌های مشابه در افزونه Download Monitor. با تشکر از Nicolas C. برای گزارش موضوع.

2.4.2 (2025.09.17)

• راهکار اضافی برای رفع خطای بحرانی PHP که در یک سناریوی خاص رخ می‌دهد. با تشکر از Michael K. برای گزارش دقیق این موضوع.

2.4.1 (2025.09.17)

• خطای بحرانی PHP که در سناریوی خاصی رخ می‌داد، رفع شد. با تشکر از Pedro و @guytimes برای گزارش دقیق این مورد در اینجا و اینجا.

2.4.0 (2025.09.12)

• هنگامی که DLM قادر به تجزیه صحیح یک ورودی گزارش نباشد، اکنون به جای نمایش «خیر پیام خطا مشخص شده…»، ورودی خام را نمایش می‌دهد. با تشکر از Michael Kupietz برای پیشنهاد این بهبود.
• افزونه DLM اکنون با نصب‌های وردپرسی که در آن‌ها مسیر پوشه‌های افزونه‌ها و پوسته‌ها غیر استاندارد است (مثلاً چیزی به جز /wp-content/plugins/ و /wp-content/themes/) کار می‌کند. با تشکر از Michael Kupietz برای پیشنهاد این بهبود.
• یک گزینه برای غیرفعال کردن ثبت خطای جاوا اسکریپت اضافه شد.
• یک گزینه برای عدم تغییر مقدار SCRIPT_DEBUG هنگام تغییر وضعیت ثبت خطا اضافه شد. با تشکر از Christine برای پیشنهاد این بهبود.
• یک گزینه برای عدم پردازش ورودی‌های گزارش با منطقه(های) زمانی غیر UTC اضافه شد، که می‌تواند در زمان‌هایی که اندازه پرونده گزارش بسیار بزرگ است، منابع زیادی مصرف کند. با تشکر از Michael Kupietz برای پیشنهاد این بهبود.

2.3.6 (2025.04.28)

• افزودن سازگاری با ورودی‌های گزارش خطایاب که در مناطق زمانی غیر از UTC هستند. با تشکر از @mroesele برای گزارش یک خطا با ورودی‌های علامت‌گذاری شده با منطقه زمانی Europe/Berlin.
• سازگاری با وردپرس نگارش ۶.۸ تایید شد

2.3.5 (2025.04.05)

• رفع آسیب‌پذیری XSS که توسط Yassine Neggaoui در رابطه با تجزیه ورودی‌های debug.log بدون پاکسازی مناسب گزارش شده بود.

2.3.4 (2025.02.19)

• رفع عدم نمایش آیکون نوار مدیر. با تشکر از @tobias_conrad برای پیشنهاد این اصلاح.

2.3.3 (2024.03.20)

• گریزدهی (escape) مناسب متغیرهای $ برای بهبود امنیت. با استفاده بهینه از افزونه عالی Plugin Check (PCP).

2.3.2 (2024.03.20)

• رفع آسیب‌پذیری XSS که توسط Majed Refaea از طریق pathstack گزارش شده بود.
• رفع آسیب‌پذیری کنترل دسترسی شکسته که توسط Majed Refaea از طریق pathstack گزارش شده بود.
• رفع آسیب‌پذیری حمله CSRF که توسط Dhabaleshwar Das از طریق pathstack گزارش شده بود.
• فعال‌سازی شناسایی تغییر در مسیر نصب وردپرس، مثلاً هنگام انتقال از محیط توسعه به محصول، یا مهاجرت به میزبان جدید، و به‌روزرسانی تنظیمات مکان پرونده گزارش خطایاب. این مورد باید مشکلی را که در آن نمایشگر ورودی‌های گزارش خطا در چنین سناریوهایی متوقف می‌شد، برطرف کند. برای اطمینان از کارکرد مدیریت گزارش خطا در سایت مقصد جدید، لطفاً آن را غیرفعال و دوباره فعال‌سازی کنید. با تشکر از @jeswd برای گزارش آن در اینجا و @jrmyfranck و @drhnews برای گزارش در اینجا.

2.3.1 (2023.11.30)

• بهبود تصادفی بودن نام پرونده گزارش خطایاب برای امنیت بیشتر.

2.3.0 (2023.11.29)

• بهبود تجزیه ورودی‌های گزارش با بیش از یک مجموعه اطلاعات داخل براکت، مانند [timestamp] [هشدار] اطلاعات دقیق درباره خطا. پیش از این به عنوان «خیر پیام خطا مشخص شده…» تجزیه می‌شد. با تشکر از @azzuwayed برای ارائه یک خط کد مهم با الگوی صحیح regex برای رفع این مورد. به نظر من افرادی که می‌توانند در صورت نیاز الگوهای regex بسازند، قدرت فوق‌العاده‌ای دارند!

2.2.2 (2023.11.29)

• [امنیت] بهبود امنیت فراخوانی ajax برای پاکسازی پرونده گزارش. فقط برای مدیران سایت مجاز شده و برای جلوگیری از CSRF با nonce ایمن شده است. با تشکر مجدد از Dmitrii Ignatyev برای یادآوری بررسی این مورد.

2.2.1 (2023.11.29)

• [مهم][امنیت] رفع یک مشکل امنیتی که در آن دایرکتوری مدیریت گزارش خطا می‌توانست در مرورگر باز شود و به بازدیدکنندگان اجازه مشاهده و دانلود پرونده گزارش خطا را می‌داد که ممکن است حاوی اطلاعات حساس باشد. هنگامی که به نگارش ۲.۲.۱ به‌روزرسانی کردید، لطفاً حداقل یک بار از برگه گزارش خطا بازدید کنید. این کار یک پرونده index.php خالی در دایرکتوری DLM ایجاد کرده و از بروز این مورد جلوگیری می‌کند. این آسیب‌پذیری توسط Dmitrii Ignatyev از شرکت CleanTalk در تاریخ ۲ نوامبر ۲۰۲۳ گزارش شده بود. پوزش می‌خواهم اگر رسیدگی به این مورد طول کشید زیرا کاملاً درگیر عرضه ASE Pro بودم.

2.2.0 (2023.06.26)

• مخفی‌سازی ابزارک پیشخوان و نماد نوار مدیر برای کاربران غیر از مدیر کل.
• جلوگیری از در حال بارگذاری public.js در بخش کاربری در صورتی که ثبت وقایع غیرفعال باشد.

2.1.4 (2023.04.15)

• افزودن پیوند به WordPress Newsboard در پابرگ.
• [حمایت مالی] اگر از این افزونه در پروژه(های) شخصی، کارهای پولی و/یا سایت(های) مشتری خود استفاده کرده و بهره‌مند شده‌اید، لطفاً با مبلغی ناچیز (از ۱ دلار در ماه) حمایت از توسعه و نگهداری مداوم این افزونه (و سایر افزونه‌های من) را مد نظر قرار دهید. با تشکر!

2.1.3 (2023.02.25)

• خطای «Undefined offset» رفع شد. با تشکر از @guyinpv برای گزارش این مشکل.

2.1.0 (2023.02.21)

• تجزیه صحیح محتوا ورودی‌هایی که از طریق تابع error_log() اضافه شده‌اند. اگر قصد دارید یک $variable پی‌اچ‌پی شامل یک آرایه یا شیء را در گزارش عیب‌یابی خروجی بگیرید، لطفاً به جای print_r() از json_encode() استفاده کنید. مانند: error_log( json_encode( $variable_name ) ). با تشکر از @guyinpv برای گزارش این پیام.

2.0.0 (2022.12.03)

• پرونده‌های هسته وردپرس، افزونه یا پوسته که در آن‌ها خطاهای PHP رخ داده است، اکنون به سادگی با کلیک بر روی مسیر پرونده در هر ورودی خطا قابل مشاهده هستند. این کار با استفاده از ویرایشگر افزونه/پوسته هسته (تغییر یافته برای بارگذاری در حالت فقط مشاهده) و مخزن wordpress-develop در گیت‌هاب برای پرونده‌های هسته انجام می‌شود.
• ثابت SCRIPT_DEBUG اکنون هنگام فعال بودن ثبت خطا، در wp-config روی true تنظیم می‌شود که به عیب‌یابی خطاهای جاوااسکریپت کمک می‌کند.
• یک دکمه برای غیرفعال کردن ویرایشگر افزونه/پوسته در زیر جدول ورودی‌های خطا اضافه شد. این مورد برای زمانی است که عیب‌یابی شما تمام شده باشد، یعنی ثبت خطا را غیرفعال کرده و پرونده گزارش عیب‌یابی را پاک کرده باشید و بخواهید امنیت موارد را حفظ کنید.

1.9.1 (2022.12.02)

• مشکل ظاهری آیکون پیوند خارجی در ورودی‌ها هنگام تازه‌سازی خودکار جدول داده‌ها رفع شد.

1.9.0 (2022.12.02)

• تشخیص نوع خطای PHP Exception و افزودن آن به صافی جدول ورودی‌ها.
• خواناتر کردن ورودی‌های خطا با شناسایی منبع خطا (هسته / افزونه / پوسته) و جداسازی مسیر پرونده و شماره خط.

1.8.7 (2022.10.22)

• رفع مشکل نبود تابع wp_date() برای وردپرس نسخه‌های قبل از 5.3.
• پنهان‌سازی تمامی اعلان‌های مدیر هنگام مشاهده ورودی‌های گزارش. با تشکر از یک اصلاحیه خوب از طرف @brianhenryie.
• بهبود توضیحات درون‌کدی برای برخی از بخش‌های کد.

1.8.6 (2022.10.09)

• رفع ارجاع اشتباه به app.js قدیمی. تغییر به admin.js.

1.8.5 (2022.10.08)

• بهبود رفتار اسکرول برای ثابت ماندن موقعیت سربرگ برگه DLM در بالا.
• تغییر تعداد پیش‌فرض ورودی‌ها برای نمایش در ابزارک پیشخوان از ۱۰ به ۵.

1.8.4 (2022.10.08)

• رفع خطای نحو همان‌طور که توسط @michel-jongbloed گزارش شده بود.

1.8.3 (2022.10.07)

• اصلاح CSS برای ابزارک پیشخوان جهت اطمینان از شکستن صحیح خطوط پیام‌های خطا، به گونه‌ای که از محفظه ابزارک بیرون نزنند.

1.8.2 (2022.10.05)

• اصلاحات CSS برای پابرگ ابزارک پیشخوان و همچنین اندازه‌بندی سربرگ و پابرگ برگه اصلی.

1.8.0 (2022.10.02)

• افزودن ابزارک پیشخوان برای نمایش آخرین خطاهای ثبت شده، وضعیت ثبت خطا و پیوندی به برگه مدیریت گزارش خطا.

1.7.0 (2022.09.28)

• بین‌المللی‌سازی افزونه؛ به این معنی که آن را برای بومی‌سازی (ترجمه به زبان‌های مختلف) آماده کنید. لطفاً در در دسترس قرار دادن مدیریت گزارش خطا به زبان خود کمک کنید. با تشکر!

1.6.4 (2022.09.27)

• رفع مشکل هشدار PHP: “تلاش برای دسترسی به آفست آرایه روی مقداری از نوع bool” گزارش شده توسط @brianhenryie و @hogash.

1.6.3 (2022.09.27)

• اصلاحات بیشتر (HTML، CSS، JS) برای اطمینان از اینکه جزئیات خطا به درستی درون جدول داده‌ها قرار می‌گیرند و باعث سرریز جدول از عرض برگه نمی‌شوند. این مورد شامل سناریوهایی است که نوسازی خودکار فعال بوده و از صفحه‌بندی استفاده می‌شود.

1.6.2 (2022.09.26)

• اصلاح CSS برای اطمینان از اینکه جزئیات خطا به درستی درون جدول داده‌ها قرار می‌گیرند و باعث سرریز جدول از عرض برگه نمی‌شوند.

1.6.1 (2022.09.26)

• بهبود شناسایی متن لنگر در wp-config.php برای کلاس WP_Config_Transformer. اطمینان حاصل کنید که تغییر وضعیت WP_DEBUG برای فایل‌های wp-config.php که از عبارت‌های “Happy publishing” یا “Happy blogging” استفاده می‌کنند، به درستی کار می‌کند.

1.6.0 (2022.09.25)

• افزودن آیکون وضعیت به نوار مدیر. این آیکون تنها در صورتی نمایش داده می‌شود که ثبت خطا فعال باشد و در برگه‌هایی غیر از برگه اصلی مدیریت گزارش خطا، از جمله بخش کاربری سایت، ظاهر خواهد شد.

1.5.3 (2022.09.24)

• بهبود تجزیه‌گر گزارش برای مدیریت پیام‌های خطا که شامل کاراکترهای # و [ هستند، مانند “Argument #1” یا “[internal function]”.

1.5.2 (2022.09.22)

• غیرفعال‌سازی نوسازی خودکار هنگام استفاده از صفحه‌بندی. در غیر این صورت، جدول همیشه به برگه اول بازگشت خواهد کرد.

1.5.1 (2022.09.21)

• رفع غلط املایی در صافی کشویی نوع خطا برای ‘JavaScript’ که مانع از عملکرد صحیح صافی برای این نوع خطا می‌شد.

1.5.0 (2022.09.21)

• افزودن صافی کشویی نوع خطا.

1.4.0 (2022.09.21)

• خطاهای جاوااسکریپت در پیشخوان مدیر و بخش کاربری سایت اکنون به صورت پیش‌فرض ثبت می‌شوند.
• بهبود متن‌های مربوط به انواع خطا برای سادگی و وضوح بیشتر.
• رفع مشکلی که در آن فراخوانی‌های AJAX برای ویژگی نوسازی خودکار در چندین سناریوی کلیک بر روی دکمه‌های تغییر وضعیت ثبت خطا و یا نوسازی خودکار به درستی متوقف نمی‌شدند.

1.3.3 (2022.09.20)

• رفع باگ: تابع تعریف نشده wp_filesize() در bootstrap.php. با تشکر از @gleysen برای گزارش آن.

1.3.1 (2022.09.18)

• رفع باگ‌های مربوط به ویژگی نوسازی خودکار. غیرفعال‌سازی نوسازی خودکار تنها روی دکمه و ورودی wp_option اعمال می‌شد اما روی فراخوانی‌های واقعی AJAX تاثیری نداشت. اگر نوسازی خودکار فعال بود، تنها هنگام کلیک روی دکمه کار می‌کرد و نه در هنگام بارگذاری برگه. هر دو مشکل رفع شدند.

1.3.0 (2022.09.18)

• پیاده‌سازی اعلان‌های Toast پس از تکمیل اقدام‌های مختلف، مانند پاک‌سازی پرونده گزارش.
• تغییر قالب تاریخ به M j, Y – H:i:s، به عنوان مثال: Dec 31, 2021 – 20:06:34.
• پیاده‌سازی ویژگی نوسازی خودکار که به طور خودکار آخرین ورودی‌های خطا را هر ۵ ثانیه بارگذاری می‌کند.

1.2.0 (2022.09.16)

• رفع مشکل شناسایی پرونده گزارش خطای موجود، در صورت وجود، برای کپی صحیح در پرونده گزارش خطای DLM.
• به‌روزرسانی خودکار جدول ورودی‌ها هنگام فعال‌سازی گزارش‌گیری، شامل کپی کردن ورودی‌ها از پرونده موجود debug.log.
• بازنویسی کد: افزودن بارگذار خودکار (autoloader) کلاس‌های PHP افزونه.

1.1.0 (2022.09.13)

• بهبود پیاده‌سازی استانداردهای کدنویسی وردپرس برای PHP در تمام کدهای برنامه.
• بهبود پاک‌سازی و گریزدهی متغیرها.
• تنظیم مرتب‌سازی اولیه جدول داده‌ها بر اساس ستون # به‌طوری که ستون «آخرین رخداد» به درستی بر اساس برچسب زمانی مرتب شود.
• افزودن متد ()get_value به کلاس WP_Config_Transformer برای کار با ثابت‌های موجود گزارش خطا در wp-config.php.
• فعال‌سازی آرگومان $options برای متدهای افزودن ()add و به‌روزرسانی ()update در WP_Config_Transformer جهت اطمینان از صحت قالب‌بندی ثابت‌های گزارش خطا در wp-config.php.

1.0.1 (2022.08.31)

• بازنویسی کد برای سازماندهی و قابلیت نگهداری بهتر.
• بهبود توضیح افزونه / README.md.

1.0.0 (2022.08.29)

• نخستین انتشار پایدار.