

اگر در بخش «سلامت سایت» وردپرس با پیام An Active PHP Session Was Detected روبهرو شدهاید، یعنی هنگام اجرای بررسی سلامت، یک نشست PHP همچنان باز بوده است. این هشدار معمولاً پس از فعالسازی یا بهروزرسانی یک افزونه، تغییر قالب یا اجرای کد سفارشی دیده میشود؛ اما برای پیدا کردن علت دقیق، باید بررسی کرد چه بخشی از سایت نشست را ایجاد کرده و چرا آن را بهموقع نبسته است.
باز ماندن PHP Session میتواند در برخی شرایط با درخواستهای REST API و Loopback تداخل ایجاد کند. خوشبختانه در بسیاری از سایتها میتوان بدون دستکاری فایلهای هسته وردپرس، منشأ مشکل را پیدا کرد و آن را برطرف ساخت.
خطای An Active PHP Session Was Detected در وردپرس چیست؟
PHP Session روشی برای نگهداری موقت اطلاعات کاربر بین درخواستهای مختلف است. برای نمونه، یک افزونه ممکن است با اجرای تابع session_start() نشستی ایجاد کند تا مقداری از اطلاعات را در طول فرایند مشخصی نگه دارد. خود استفاده از نشست PHP لزوماً اشتباه نیست؛ مشکل زمانی ایجاد میشود که نشست باز بماند و منابع مربوط به آن، از جمله قفل احتمالی ذخیرهساز نشست، آزاد نشوند.
وردپرس از نسخه 5.5 آزمونی برای شناسایی نشست فعال در بخش سلامت سایت دارد. اگر هنگام این آزمون وضعیت نشست برابر با PHP_SESSION_ACTIVE باشد، پیام زیر نشان داده میشود:
An active PHP session was detected
A PHP session was created by a session_start() function call.
This interferes with REST API and loopback requests.
The session should be closed by session_write_close()
before making any HTTP requests.
این پیام بهتنهایی ثابت نمیکند که REST API سایت از کار افتاده است؛ هشدار میدهد که یک نشست باز میتواند اجرای درخواستهای داخلی وردپرس را با مشکل مواجه کند. این موضوع در مستندات رسمی آزمون نشست PHP وردپرس نیز توضیح داده شده است.
علت نمایش خطای نشست فعال PHP چیست؟
1. باز ماندن نشست توسط یکی از افزونهها
برخی افزونهها برای مدیریت فرم، ورود کاربران، اتصال به سرویسهای خارجی یا فرایندهای اختصاصی از نشست PHP استفاده میکنند. اگر افزونه نشست را با session_start() آغاز کند و پیش از درخواست داخلی وردپرس نبندد، احتمال نمایش این هشدار وجود دارد. وجود این خطا بهمعنای مشکل داشتن همه افزونههای آن حوزه نیست؛ باید افزونه مسئول را با آزمون مشخص کرد.
2. کد سفارشی قالب یا افزونه اختصاصی
گاهی تابع session_start() در فایلهای یک قالب اختصاصی، افزونه سفارشی یا قطعهکدی که قبلاً به سایت اضافه شده قرار دارد. بهویژه وقتی هشدار پس از اعمال یک تغییر فنی ظاهر شده، بررسی همان تغییر نقطه شروع خوبی است.
3. فعال بودن خودکار نشست در پیکربندی PHP
در بعضی پیکربندیها، گزینه session.auto_start میتواند بدون فراخوانی مستقیم تابع در کدهای وردپرس، نشست ایجاد کند. این مورد رایجترین علت نیست، اما اگر با غیرفعالکردن موقت افزونهها و تغییر قالب هشدار همچنان باقی ماند، باید از پشتیبانی هاست خواست آن را بررسی کند.
آموزش رفع خطای An Active PHP Session Was Detected
مرحله اول: وضعیت سلامت سایت و پیامهای همراه را بررسی کنید
از پیشخوان به ابزارها ← سلامت سایت ← وضعیت بروید و بخش «مشکلات بحرانی» را باز کنید. ببینید کنار خطای نشست فعال، پیامهایی مانند «REST API با خطا مواجه شده است» یا «درخواست Loopback کامل نشد» هم دیده میشوند یا نه. این پیامها میتوانند به تشخیص دامنه مشکل کمک کنند، اما الزاماً همگی یک علت ندارند.
اگر سایت فروشگاهی یا پرترافیک دارید، پیش از آزمایش تغییرات از فایلها و پایگاه داده نسخه پشتیبان تهیه کنید. بهتر است عیبیابی روی نسخه آزمایشی سایت انجام شود.
مرحله دوم: افزونه ایجادکننده نشست را شناسایی کنید
بهجای غیرفعالکردن یکجای تمام افزونهها در سایت اصلی، از حالت عیبیابی استفاده کنید. ابزار Troubleshooting و در بعضی نصبها افزونه Health Check & Troubleshooting امکان بررسی تداخل را فراهم میکنند. حالت عیبیابی، در صورت پشتیبانی و فعالسازی صحیح، افزونهها و قالب را فقط برای نشست کاربری مدیر غیرفعال میکند و بازدیدکنندگان عادی همچنان سایت را در حالت معمول میبینند.
- افزونه عیبیابی موردنظر را نصب و فعال کنید.
- حالت Troubleshooting را برای حساب مدیر خود فعال کنید؛ جای این گزینه بسته به افزونه نصبشده ممکن است متفاوت باشد.
- با یک قالب پیشفرض و بدون افزونههای جانبی، صفحه سلامت سایت را دوباره بررسی کنید.
- اگر هشدار ناپدید شد، افزونهها را یکییکی در حالت عیبیابی فعال و بعد از هر بار صفحه سلامت سایت را بازآزمایی کنید.
- وقتی پیام دوباره ظاهر شد، آخرین افزونه فعالشده را بهعنوان یکی از مظنونهای اصلی بررسی کنید. سپس تداخل احتمالی آن با سایر افزونهها را هم آزمایش کنید.
اگر خطا با همه افزونهها غیرفعال هم دیده میشود، بهسراغ قالب، افزونههای ضروری mu-plugins و تنظیمات PHP بروید. راهنمای رسمی وردپرس نیز آزمایش مرحلهای تداخل افزونهها و قالب را توصیه میکند.
مرحله سوم: افزونه و قالب را بهروزرسانی یا با پشتیبانی آن بررسی کنید
اگر افزونه مشخصی عامل خطا بود، ابتدا تغییرات نسخههای جدید و گزارشهای پشتیبانی آن را بررسی کنید. در صورت وجود نسخه اصلاحشده، پس از تهیه نسخه پشتیبان آن را بهروزرسانی کنید. اگر مشکل باقی ماند، نام خطا و نتیجه آزمایش افزونهها را برای توسعهدهنده ارسال کنید.
این موضوع فقط یک احتمال نظری نیست؛ در یکی از گزارشهای منتشرشده در انجمن رسمی وردپرس، توسعهدهنده افزونه پس از شناسایی مشکل مدیریت نشست، نسخه اصلاحی منتشر کرد و کاربر رفع خطا را تأیید کرد. البته این گزارش به معنی وجود مشکل در نسخههای دیگر یا افزونههای مشابه نیست.
مرحله چهارم: در کد اختصاصی، نشست PHP را بهموقع ببندید
اگر بررسی نشان داد خطا از کد سفارشی سایت است، توسعهدهنده باید محل فراخوانی session_start() و زمان پایان استفاده از دادههای نشست را پیدا کند. در سادهترین حالت، پس از اتمام خواندن یا نوشتن اطلاعات نشست، میتوان آن را با session_write_close() بست:
<?php
// Example for custom code only.
if ( session_status() === PHP_SESSION_ACTIVE ) {
// Finish necessary session operations first.
session_write_close();
}
این کد یک راهحل عمومی برای چسباندن در functions.php نیست. محل صحیح اجرای آن به معماری افزونه و زمان استفاده از نشست بستگی دارد. اگر پس از بستن نشست، کد همچنان انتظار داشته باشد دادههای نشست را ذخیره کند، ممکن است عملکرد ورود، فرمها یا سایر قابلیتها مختل شود. در کدهایی که فقط خواندن اطلاعات نشست لازم است، گزینه read_and_close نیز میتواند با بررسی فنی توسعهدهنده مناسب باشد.
بنابراین برای افزونههای شخص ثالث، فایل اصلی افزونه را مستقیم ویرایش نکنید؛ تغییرات در بهروزرسانی بعدی از بین میروند و ممکن است سازگاری افزونه را مختل کنند.
مرحله پنجم: تنظیمات PHP و هاست را بررسی کنید
اگر با خاموشکردن افزونهها و استفاده از قالب پیشفرض هم هشدار باقی است، از مسیر ابزارها ← سلامت سایت ← اطلاعات ← سرور اطلاعات محیط PHP را ببینید. همه مقادیر پیکربندی نشست در این صفحه نمایش داده نمیشوند؛ برای بررسی session.auto_start و لاگهای مربوط به نشست PHP از پشتیبانی هاست کمک بگیرید.
در درخواست پشتیبانی، زمان مشاهده خطا، متن دقیق پیام، نتیجه آزمون افزونهها و در صورت وجود خطاهای REST API یا Loopback را اعلام کنید. رمز عبور، کوکی نشست، کلیدهای API یا فایلهای حاوی اطلاعات حساس را ارسال نکنید.
اگر خطای نشست PHP همراه با REST API یا cURL Error 28 نمایش داده شود چه کنیم؟
این خطاها ممکن است همزمان دیده شوند، اما نباید بدون بررسی نتیجه گرفت که نشست فعال علت قطعی کندی یا قطع ارتباط است. نشست باز میتواند بعضی درخواستها را معطل کند؛ در مقابل، خطای cURL Error 28 ممکن است از محدودیت اتصال خروجی سرور، DNS، فایروال یا کمبود منابع هم ناشی شود.
پس از برطرفکردن علت نشست فعال، سلامت سایت را دوباره آزمایش کنید. اگر خطای REST API یا cURL همچنان باقی بود، مسیر عیبیابی آن را جدا ادامه دهید. برای تشخیص دقیقتر، کد وضعیت پاسخ، زمان انتظار و گزارشهای سمت سرور اهمیت دارند.
چه کارهایی را برای رفع این خطا انجام ندهیم؟
- هشدار را صرفاً مخفی نکنید: حذف نمایش پیام، نشست باز را اصلاح نمیکند.
- همه نشستها را بدون بررسی حذف نکنید: این کار ممکن است کاربران را از حساب خارج کند یا فرایندهایی را مختل سازد.
- کد بستن نشست را کورکورانه در قالب قرار ندهید: شاید کدی دیگر هنوز نیاز داشته باشد دادههای نشست را بنویسد.
- افزونهها را در سایت زنده و بدون برنامه غیرفعال نکنید: در فروشگاه ووکامرسی، فرمها و پرداختها ممکن است از کار بیفتند.
- فایروال و تنظیمات امنیتی را دائماً خاموش نکنید: ابتدا علت واقعی خطا را شناسایی کنید.
جمعبندی
پیام An Active PHP Session Was Detected یعنی وردپرس در زمان بررسی سلامت سایت یک نشست PHP باز تشخیص داده است. برای رفع اصولی آن، ابتدا افزونه یا کد مسئول را با حالت عیبیابی پیدا کنید، سپس نسخه اصلاحی را نصب کنید یا از توسعهدهنده بخواهید نشست را پس از پایان کار با روشی مانند session_write_close() ببندد. اگر مشکل حتی در محیط ساده وردپرس ادامه دارد، تنظیمات PHP و هاست باید بررسی شوند. پس از رفع هشدار نیز خطاهای احتمالی REST API و Loopback را جداگانه آزمایش کنید.

