समस्या निवारण

अधिकांश समस्याएं मुट्ठी भर कारणों पर आकर टिकती हैं: PHP संस्करण, फ़ाइल अनुमतियाँ, डेटाबेस क्रेडेंशियल, वेब-सर्वर रीराइटिंग या एक गायब worker। यह पृष्ठ उन लक्षणों को सूचीबद्ध करता है जो ऑपरेटरों को सबसे अधिक होते हैं और प्रत्येक को कैसे ठीक करें। संदेह होने पर, आपका PHP एरर लॉग सबसे तेज़ी से सत्य तक पहुँचने का तरीका है।

इंस्टॉलेशन की समस्याएं

"आपका PHP संस्करण समर्थित नहीं है"

TubePress को PHP 8.2 या उससे नए संस्करण की आवश्यकता है, जिसे एक parse-safe version guard द्वारा लागू किया जाता है जो किसी भी चीज़ से पहले चलता है। अपने hosting panel में PHP संस्करण बदलें (या vhost को नए PHP-FPM socket पर इंगित करें) और reload करें। आवश्यकताएं देखें।

"डेटाबेस से कनेक्ट नहीं हो सका"

इंस्टॉलर के डेटाबेस चरण के दौरान, host (अक्सर localhost या 127.0.0.1), डेटाबेस नाम, उपयोगकर्ता और पासवर्ड को दोबारा जांचें, और यह कि उपयोगकर्ता के पास उस डेटाबेस पर विशेषाधिकार हैं। डेटाबेस पहले से मौजूद होना चाहिए — इंस्टॉलर तालिकाएं बनाता है, schema नहीं।

इंस्टॉलर कॉन्फ़िगरेशन नहीं लिख सकता / एक "not writable" एरर

सेटअप के दौरान वेब सर्वर को config/ और storage/ पर write access की आवश्यकता है। PHP उपयोगकर्ता द्वारा उन निर्देशिकाओं को writable बनाएं, फिर पुनः प्रयास करें। इंस्टॉलेशन में अनुमतियों का मार्गदर्शन देखें।

मैंने इंस्टॉलेशन पूरा किया लेकिन /install अभी भी लोड होता है

इंस्टॉलेशन config/installed.php लिखता है। यदि यह अनुपस्थित है तो ऐप सोचता है कि यह अनइंस्टॉल है; यदि सेटअप पूरा हो गया, तो वह फ़ाइल मौजूद होनी चाहिए और इंस्टॉलर खुद को लॉक कर लेता है। पुनः जांचें कि config/ writable था।

साइट लोड होती है लेकिन पृष्ठ 404 देते हैं

यदि होम पेज काम करता है लेकिन हर दूसरा URL 404 देता है, तो URL rewriting front controller तक नहीं पहुँच रही।

• Apache — पुष्टि करें कि mod_rewrite सक्षम है और AllowOverride All सेट है ताकि बंडल .htaccess का सम्मान किया जाए।
• Nginx — आपका location / front controller तक fall through होना चाहिए, उदा. try_files $uri $uri/ /index.php?$query_string;। web-server नोट्स के लिए आर्किटेक्चर देखें।

लॉगिन और admin एक्सेस

मुझे admin लॉगिन नहीं मिल रहा

यदि आपने सुरक्षा के लिए एक custom admin URL सेट किया है, तो panel अब /admin पर नहीं रहता — यह केवल आपके गुप्त path पर उत्तर देता है। यदि आपके पास डेटाबेस access है तो settings तालिका से इसे पुनः प्राप्त करें। सुरक्षा देखें।

Two-factor मुझे लॉक कर रहा है

यदि आप अपना authenticator खो देते हैं, तो access पुनः प्राप्त करने के लिए डेटाबेस में उपयोगकर्ता का TOTP अक्षम करें (users तालिका पर संबंधित column), फिर पुनः नामांकन करें। सुरक्षा में विवरण।

अपलोड और मीडिया

बड़े अपलोड विफल होते हैं या time out हो जाते हैं

PHP की सीमाएं upload_max_filesize और post_max_size बढ़ाएं, और nginx पर client_max_body_size बढ़ाएं। demo एक उच्च client_max_body_size के माध्यम से multi-gigabyte अपलोड की अनुमति देता है; बड़ी फ़ाइलों के लिए अपने सर्वर पर इसे दोहराएं।

एक वीडियो नहीं चलेगा

नए अपलोड किए गए वीडियो transcoding पूरा होने तक अभी भी प्रोसेसिंग हो सकते हैं। पुष्टि करें कि format web-deliverable है, कि rendition फ़ाइलें storage में मौजूद हैं, और कि आपका सर्वर .mp4/.webm के लिए सही MIME type भेजता है। प्लेयर देखें।

थंबनेल या प्रीव्यू गायब हैं

थंबनेल और प्रीव्यू generation के लिए GD या Imagick extension (और वीडियो-derived frames के लिए FFmpeg) की आवश्यकता है। सत्यापित करें कि वे इंस्टॉल हैं और uploads/ writable है।

Transcoding अटका हुआ है

यदि jobs queue में बैठे रहते हैं और कभी पूरे नहीं होते:

• पुष्टि करें कि FFmpeg इंस्टॉल है जहाँ भी transcoding चलती है (local server या remote worker)।
• यदि आप remote transcode servers का उपयोग करते हैं, तो जांचें कि worker चल रहा है और उसकी API key admin में configured से मेल खाती है।
• सुनिश्चित करें कि scheduler चल रहा है (नीचे देखें) — job dispatch और retry pseudo-cron पर चलते हैं।

शेड्यूल किया गया कार्य नहीं चल रहा

pseudo-cron केवल page renders पर fire होता है। एक quiet साइट पर heartbeat इसे जीवित रखता है — सुनिश्चित करें कि heartbeat_enabled 1 है। यदि आपने इसे अक्षम किया है, तो या तो इसे पुनः सक्षम करें या एक system cron entry जोड़ें जो आपकी साइट को समय-समय पर hit करे।

ईमेल नहीं भेजा जा रहा

ईमेल और सूचनाएं के अंतर्गत SMTP configure करें और पुष्टि करने के लिए बिल्ट-इन परीक्षण ईमेल भेजें बटन का उपयोग करें। यदि परीक्षण विफल होते हैं, तो SMTP host/port/credentials सत्यापित करें और यह कि आपका host outbound mail की अनुमति देता है; deliverability के लिए, अपने domain पर SPF/DKIM सेट करें।

प्रदर्शन

बड़े पैमाने पर एक तेज़ साइट के लिए: OPcache सक्षम करें, PHP को पर्याप्त मेमोरी दें, MySQL को PHP के साथ एक ही network पर रखें, और CTR पुनर्गणना और अन्य scheduled tasks को चलने दें। TubePress बड़े libraries के लिए आवश्यक indexes और chunked jobs के साथ आता है — रखरखाव देखें।

अपडेट विफल होते हैं

यदि कोई अपडेट लागू नहीं होगा, तो पुष्टि करें कि core फ़ाइलें PHP उपयोगकर्ता द्वारा writable हैं और आप PHP 8.2+ पर हैं। रोलबैक कर सकने के लिए अपडेट करने से पहले हमेशा बैकअप लें। अपडेट करना देखें।

अभी भी अटके हुए हैं?

सटीक एरर संदेश और संबंधित log lines एकत्र करें, फिर अपने dashboard से या in-admin support widget से एक ticket खोलें। आप जितना अधिक context शामिल करते हैं — PHP संस्करण, web server, और आप क्या कर रहे थे — उतनी तेज़ी से इसे हल किया जाता है। घोषणाएं और सहायता देखें।