متطلبات الخادم

يعمل TubePress على حزمة LAMP أو LEMP العادية. لا توجد أُطُر عمل تحتاج إلى التثبيت، ولا خطوة بناء Composer أو Node، ولا محمّل ionCube — إذا كان خادمك يشغّل WordPress بالفعل، فمن المرجح جداً أنه سيشغّل TubePress أيضاً.

تغطي هذه الصفحة الحد الأدنى من المتطلبات، والإعداد الذي نوصي به للبيئات الإنتاجية، والأجزاء الاختيارية القليلة (FFmpeg، حساب TubePress) التي تحتاجها فقط ميزات محددة. يتحقق مثبّت الويب من كل ذلك تلقائياً في خطوة فحص النظام.

المتطلبات الدنيا

هذا هو الحد الأدنى. سيرفض المثبّت الاستمرار حتى يجتاز كل عنصر مطلوب.

امتدادات PHP المطلوبة

سيتوقف الإعداد ما لم تكن هذه الامتدادات الثلاثة موجودة:

تُعدّ جلسات PHP العاملة وإعادة كتابة URL من جانب الخادم (Apache mod_rewrite أو قاعدة try_files في Nginx) مطلوبتَين أيضاً — يتحقق المثبّت من كليهما.

الإعداد الموصى به

لموقع إنتاجي سلس:

• PHP 8.4 مع OPcache — الإصدار الذي يُبنى عليه TubePress ويُختبر معه، مع تفعيل ذاكرة التخزين المؤقت للرمز الثانوي للسرعة.
• memory_limit بمقدار 256 ميغابايت أو أكثر — هامش أمان مريح للاستيراد الجماعي ومعالجة الصور.
• curl وzip وGD (أو Imagick) — اختيارية لكن موصى بها: يستخدم تنزيل الكتالوج والمتجر curl، ويحتاج تثبيت الثيمات والإضافات من اللوحة إلى zip، ويحتاج توليد الصور المصغّرة إلى GD أو Imagick.
• HTTPS — قدّم الموقع عبر TLS واضبط عنوان URL الخاص بموقعك على عنوان https.

تعمل المهام المجدولة تلقائياً عبر pseudo-cron المدمج في TubePress، لذلك لا يلزم وجود crontab في النظام. لا تزال المواقع ذات حركة المرور العالية قادرة على توصيل cron حقيقي — راجع Cron & CLI.

حدود رفع الفيديو

يُحدّد TubePress حجم الرفع المباشر بـ 500 ميغابايت افتراضياً (قابل للتعديل تحت /admin/settings). يجب أن تكون حدود PHP وخادم الويب بنفس الحجم على الأقل، وإلا ستُرفض الملفات الكبيرة قبل أن تصل إلى التطبيق:

; php.ini - allow large video uploads
upload_max_filesize = 512M
post_max_size       = 512M
memory_limit        = 256M
max_execution_time  = 300

في Nginx، ارفع أيضاً client_max_body_size؛ وفي Apache، LimitRequestBody. للمكتبات الكبيرة جداً، قم بالترميز والخدمة من التخزين البعيد بدلاً من ذلك — راجع الترميز والتخزين.

خادم الويب

جذر الويب هو مجلد public/، ويتم توجيه كل طلب عبر متحكم أمامي واحد هو public/index.php. احتفظ بـ config/ وsrc/ وstorage/ فوق جذر المستند (تقع على مستوى واحد فوق public/) حتى لا تُخدَم مباشرة أبداً.

Apache

أشر جذر المستند إلى public/ واسمح لملفات .htaccess المُضمَّنة بأداء عملها:

DocumentRoot /var/www/tubepress/public
<Directory /var/www/tubepress/public>
    AllowOverride All
    Require all granted
</Directory>

Nginx

استخدم try_files لعناوين URL نظيفة، وأنشئ أسماء مستعارة لمجلدات الثيمات والقوالب، وارفض المسارات الحساسة:

server {
    root /var/www/tubepress/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
    }

    # Serve theme and template assets
    location /themes/    { alias /var/www/tubepress/themes/; }
    location /templates/ { alias /var/www/tubepress/templates/; }

    # Never expose application internals
    location ~ ^/(config|src|storage)/ { deny all; }

    client_max_body_size 512M;
}

كلا الخادمَين من الدرجة الأولى — يكتشف المثبّت تلقائياً أيهما تستخدم.

اختياري: FFmpeg والترميز

تحتاج إلى FFmpeg فقط إذا أردت من TubePress الترميز المحلي للفيديو — تحويل الملفات المرفوعة إلى صيغ متوافقة مع الويب وتوليد صور مصغّرة للمعاينة. إذا كنت تستورد ملفات مُرمَّزة مسبقاً أو تخدمها من تخزين خارجي أو CDN، يمكنك تخطيها كلياً. راجع الترميز.

اختياري: حساب TubePress

نظام CMS مكتمل ومجاني بحد ذاته. يُتيح حساب TubePress المجاني ميزات إضافية بالدفع حسب الاستخدام — AI أرصدة، وأكثر من 400 ألف فيديو في الكتالوج، والمتجر والدعم الفني. تبدأ بـ 150 رصيداً مجانياً ولا تحتاج أبداً إلى حساب لتشغيل موقع كامل.

الخطوات التالية