وقتی وردپرس به api.wordpress.org متصل نمی‌شود، جست‌وجوی افزونه، اطلاعات نسخه یا به‌روزرسانی ممکن است مختل شود. بازشدن مخزن در مرورگر شما، اتصال سرور هاست را ثابت نمی‌کند. ابتدا متن دقیق خطا را در سلامت سایت ثبت کنید و اتصال را از محیط همان سرور بررسی کنید؛ همه خطاها ناشی از تحریم، فایروال یا خرابی خود وردپرس نیستند.
۱. پیام و دامنه اختلال را مشخص کنید
در ابزارها، سلامت سایت را باز و آزمون ارتباط با WordPress.org را بررسی کنید. آیا فقط API مشکل دارد یا دریافت بسته از downloads.wordpress.org نیز شکست می‌خورد؟ خطای DNS، اتصال، timeout و گواهی هرکدام مسیر متفاوتی دارند. زمان، نام میزبان مقصد و شماره خطا را ثبت کنید. اطلاعات حساس داخل لاگ را قبل از اشتراک حذف کنید.
۲. DNS و HTTPS را از خود سرور بررسی کنید
getent ahosts api.wordpress.org
curl --head --connect-timeout 10 --max-time 20 https://api.wordpress.org/این مثال‌ها برای مدیر مجاز سرور و ابزار نصب‌شده‌اند. دریافت یک پاسخ HTTP از ریشه میزبان، حتی 404، با شکست DNS یا TLS تفاوت دارد؛ با این حال موفقیت آن، موفقیت endpoint واقعی به‌روزرسانی را تضمین نمی‌کند. تست HEAD هم الزاماً معادل GET نیست. محیط CLI و PHP وب ممکن است DNS، proxy یا مجموعه CA متفاوتی داشته باشند.
۳. خطای TLS را اصولی برطرف کنید
زمان سیستم، بسته CA، نسخه cURL/OpenSSL و زنجیره گواهی را بررسی کنید. گزینه sslverify=false، curl -k یا جایگزین‌کردن HTTPS با HTTP راه‌حل مناسب اتصال مخزن نیست؛ این کار امکان دست‌کاری پاسخ و بسته نرم‌افزاری را بیشتر می‌کند. اگر سرویس در مسیر از پراکسی سازمانی استفاده می‌کند، اعتماد به CA آن باید طبق سیاست سازمان و با منبع معتبر تنظیم شود.
۴. محدودیت درخواست خارجی وردپرس
ثابت WP_HTTP_BLOCK_EXTERNAL می‌تواند درخواست‌های خارجی را محدود کند و WP_ACCESSIBLE_HOSTS میزبان‌های مجاز را تعیین می‌کند. افزونه امنیتی، must-use plugin یا فیلتر HTTP هم ممکن است اثر داشته باشد. اگر محدودیت عمدی است، کل سیاست را حذف نکنید؛ مدیر باید میزبان‌های مورد نیاز به‌روزرسانی و دریافت بسته را به‌صورت مستند مجاز کند. فقط api.wordpress.org همیشه تمام فرایند دریافت فایل را پوشش نمی‌دهد.
۵. فایروال، پراکسی و مسیر شبکه
مجوز خروجی HTTPS، DNS، مسیر IPv4/IPv6 و تنظیمات proxy را در همان محیط PHP بررسی کنید. عمومی‌کردن DNS یا خاموش‌کردن فایروال بدون شواهد می‌تواند مشکل جدید بسازد. اگر میزبان مقصد در شبکه محدود است، مسیر مجاز و مورد تأیید ارائه‌دهنده را انتخاب کنید؛ بسته‌های وردپرس را از سایت ناشناس جایگزین نکنید.
۶. کنترل نهایی پس از اصلاح
آزمون سلامت سایت را دوباره اجرا کنید، جست‌وجوی یک افزونه و دریافت اطلاعات به‌روزرسانی را بررسی کنید. نصب یا ارتقای نرم‌افزار را ابتدا با بکاپ و در محیط آزمایشی انجام دهید. یک درخواست موفق از shell، پایان عیب‌یابی وردپرس نیست. برای پشتیبانی، گزارش شامل زمان، مقصد، خطای پالایش‌شده، نسخه PHP و نتیجه تفاوت CLI و وب را آماده کنید.
منابع و دامنه راهنما
این راهنما بر پایه مستندات رسمی زیر بازبینی شده است. نام گزینه‌ها و امکانات ممکن است با نسخه نرم‌افزار یا سطح دسترسی سرویس شما تفاوت داشته باشد.
