استكشاف الأخطاء وإصلاحها

معظم المشكلات ترجع إلى عدد محدود من الأسباب: إصدار PHP، أذونات الملفات، بيانات اعتماد قاعدة البيانات، إعادة كتابة خادم الويب، أو عامل غير موجود. تسرد هذه الصفحة الأعراض الأكثر شيوعاً لدى المشغّلين وكيفية إصلاح كل منها. عند الشك، فإن سجل أخطاء PHP لديك هو أسرع طريق للوصول إلى الحقيقة.

مشاكل التثبيت

"إصدار PHP الخاص بك غير مدعوم"

يتطلب TubePress إصدار PHP 8.2 أو أحدث، يُطبَّق ذلك بواسطة حارس إصدار آمن للتحليل يعمل قبل أي شيء آخر. غيّر إصدار PHP في لوحة الاستضافة الخاصة بك (أو وجّه المضيف الافتراضي إلى مقبس PHP-FPM أحدث) وأعد التحميل. انظر المتطلبات.

"تعذّر الاتصال بقاعدة البيانات"

خلال خطوة قاعدة البيانات في المثبّت، تحقق مرة أخرى من المضيف (غالباً localhost أو 127.0.0.1)، واسم قاعدة البيانات، والمستخدم وكلمة المرور، وتأكد من أن المستخدم لديه صلاحيات على تلك قاعدة البيانات. يجب أن تكون قاعدة البيانات موجودة مسبقاً — يُنشئ المثبّت الجداول وليس المخطط نفسه.

لا يستطيع المثبّت كتابة الإعداد / خطأ "غير قابل للكتابة"

يحتاج خادم الويب إلى صلاحية الكتابة في config/ وstorage/ أثناء الإعداد. اجعل تلك المجلدات قابلة للكتابة بواسطة مستخدم PHP، ثم أعد المحاولة. انظر إرشادات الأذونات في التثبيت.

انتهيت من التثبيت لكن /install لا يزال يُحمَّل

يكتب التثبيت ملف config/installed.php. إذا كان مفقوداً، يعتقد التطبيق أنه غير مثبّت؛ إذا اكتمل الإعداد، يجب أن يكون هذا الملف موجوداً وسيقفل المثبّت نفسه. أعد التحقق من أن config/ كانت قابلة للكتابة.

يتحمل الموقع لكن الصفحات تُعطي خطأ 404

إذا كانت الصفحة الرئيسية تعمل لكن كل عنوان URL آخر يُعيد 404، فإن إعادة كتابة URL لا تصل إلى وحدة التحكم الأمامية.

• Apache — تأكد من تفعيل mod_rewrite وأن AllowOverride All مضبوط لكي يُحترم ملف .htaccess المرفق.
• Nginx — يجب أن يُمرر location / إلى وحدة التحكم الأمامية، مثل try_files $uri $uri/ /index.php?$query_string;. انظر البنية للاطلاع على ملاحظات خادم الويب.

تسجيل الدخول والوصول إلى الإدارة

لا أجد رابط تسجيل دخول الإدارة

إذا قمت بتعيين رابط إدارة مخصص للأمان، لم يعد اللوح موجوداً في /admin — بل يستجيب فقط على مسارك السري. استرجعه من جدول settings إذا كان لديك وصول إلى قاعدة البيانات. انظر الأمان.

المصادقة الثنائية تمنعني من الدخول

إذا فقدت تطبيق المصادقة الخاص بك، عطّل TOTP المستخدم في قاعدة البيانات (العمود ذو الصلة في جدول users) لاستعادة الوصول، ثم أعد التسجيل. التفاصيل في الأمان.

الرفع والوسائط

تفشل عمليات الرفع الكبيرة أو تنتهي مهلتها

ارفع حدود PHP: upload_max_filesize وpost_max_size، وفي Nginx زد client_max_body_size. يتيح الديمو رفع ملفات بحجم عدة جيجابايت عبر قيمة عالية لـ client_max_body_size؛ طابق ذلك على خادمك للملفات الكبيرة.

فيديو لن يُشغَّل

قد لا تزال مقاطع الفيديو المرفوعة حديثاً قيد المعالجة حتى تكتمل عملية الترميز. تأكد من أن التنسيق قابل للتسليم عبر الويب، وأن ملفات التصيير موجودة في التخزين، وأن خادمك يرسل نوع MIME الصحيح لـ .mp4/.webm. انظر المشغّل.

الصور المصغّرة أو المعاينات مفقودة

تحتاج عملية توليد الصور المصغّرة والمعاينات إلى امتداد GD أو Imagick (وFFmpeg لإطارات مشتقة من الفيديو). تحقق من تثبيتها وأن uploads/ قابلة للكتابة.

الترميز متوقف

إذا ظلت المهام في قائمة الانتظار ولا تكتمل قط:

• تأكد من تثبيت FFmpeg أينما يعمل الترميز (الخادم المحلي أو عامل بعيد).
• إذا كنت تستخدم خوادم ترميز بعيدة، تحقق من أن العامل يعمل وأن مفتاح API الخاص به يطابق المُعدَّ في الإدارة.
• تأكد من أن المجدوِل يعمل (انظر أدناه) — يعمل إرسال المهام وإعادة المحاولة على pseudo-cron.

المهام المجدولة لا تعمل

يُطلَق pseudo-cron فقط عند تصيير الصفحات. على موقع هادئ، تبقيه نبضة القلب حياً — تأكد من أن heartbeat_enabled يساوي 1. إذا قمت بتعطيله، فإما أعده تفعيله أو أضف مدخل cron للنظام يصل إلى موقعك بشكل دوري.

البريد الإلكتروني لا يُرسَل

قم بضبط SMTP في البريد الإلكتروني والإشعارات واستخدم زر إرسال بريد إلكتروني اختباري المدمج للتأكيد. إذا فشلت الاختبارات، تحقق من مضيف SMTP/المنفذ/بيانات الاعتماد وأن مضيفك يسمح بالبريد الصادر؛ للتحقق من التسليم، قم بإعداد SPF/DKIM على نطاقك.

الأداء

لموقع سريع الاستجابة على نطاق واسع: فعّل OPcache، أعطِ PHP ذاكرة كافية، أبقِ MySQL على نفس شبكة PHP، واترك إعادة حساب CTR والمهام المجدولة الأخرى تعمل. يأتي TubePress بالفهارس والمهام المجمّعة اللازمة للمكتبات الكبيرة — انظر الصيانة.

التحديثات تفشل

إذا لم يُطبَّق تحديث، تأكد من أن ملفات النواة قابلة للكتابة بواسطة مستخدم PHP وأنك على PHP 8.2+. احرص دائماً على النسخ الاحتياطي قبل التحديث حتى تتمكن من التراجع. انظر التحديث.

لا تزال عالقاً؟

اجمع رسالة الخطأ الدقيقة وسطور السجل ذات الصلة، ثم افتح تذكرة من لوحة تحكمك أو عنصر واجهة الدعم داخل الإدارة. كلما زاد السياق الذي تقدمه — إصدار PHP، خادم الويب، وما كنت تفعله — كلما أُحلت أسرع. انظر الإعلانات والدعم.