إنتقل إلى المحتوى الرئيسي

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

قبل تثبيت FeedbackPulse SaaS، تأكد من استيفاء خادمك لـ جميع المتطلبات التالية.

البرامج المطلوبة​

البرنامجالحد الأدنى للإصدارالموصى بهملاحظات
PHP8.48.4+مع الامتدادات المطلوبة (انظر أدناه)
MySQL8.08.0+أو MariaDB 10.6+
خادم الويبApache 2.4+ أو Nginx 1.18+Nginxيتطلب Apache تفعيل mod_rewrite
Composer2.0+الأحدثمدير اعتماديات PHP (أو ارفع vendor/ المُبنى مسبقًا)
Node.jsغير مطلوب—الأصول مُصرَّفة مسبقًا

الاستضافة المشتركة؟ إذا لم تستطع تشغيل composer install، ارفع مجلد vendor/ بالكامل من الحزمة المُنزَّلة. يتحقق مثبّت الويب من وجود vendor/autoload.php وسيمنع التثبيت إذا كان مفقودًا.

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

يجب تثبيت وتفعيل امتدادات PHP التالية:

الامتدادالغرضأمر التحقق
pdo_mysqlالاتصال بقاعدة بيانات MySQLphp -m | grep pdo_mysql
mbstringمعالجة السلاسل متعددة البايتphp -m | grep mbstring
opensslالتشفير وHTTPSphp -m | grep openssl
tokenizerتقسيم كود PHPphp -m | grep tokenizer
xmlتحليل XMLphp -m | grep xml
ctypeالتحقق من نوع الأحرفphp -m | grep ctype
jsonترميز/فك ترميز JSONphp -m | grep json
bcmathالرياضيات بدقة عاليةphp -m | grep bcmath
fileinfoاكتشاف نوع الملفphp -m | grep fileinfo
curlطلبات HTTP (مدفوعات، AI، webhooks)php -m | grep curl
gd أو imagickمعالجة الصورphp -m | grep gd
zipضغط النسخ الاحتياطيةphp -m | grep zip

تثبيت امتدادات PHP على Ubuntu/Debian​

sudo apt update
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath \
  php8.4-curl php8.4-gd php8.4-zip php8.4-fileinfo php8.4-tokenizer

تثبيت امتدادات PHP على CentOS/RHEL​

sudo dnf install php-mysqlnd php-mbstring php-xml php-bcmath \
  php-curl php-gd php-zip php-fileinfo

على Windows (XAMPP/Laragon)​

معظم الامتدادات مثبّتة مسبقًا. عدّل php.ini وأزل التعليقات عن السطور:

extension=pdo_mysql
extension=mbstring
extension=openssl
extension=curl
extension=gd
extension=zip
extension=fileinfo
extension=bcmath

نصيحة: في Laragon، جميع الامتدادات مفعّلة بشكل افتراضي. فقط تأكد من استخدام PHP 8.4+.

صلاحيات المجلدات​

يجب أن يمتلك مستخدم خادم الويب (Apache/Nginx) حق الكتابة على هذه المجلدات:

المجلدالصلاحيةالغرض
storage/775السجلات، الذاكرة المؤقتة، الجلسات، الملفات المرفوعة
storage/app/public/775رفع الملفات العامة (الشعارات، الصور)
storage/framework/cache/775ذاكرة التطبيق المؤقتة
storage/framework/sessions/775ملفات الجلسة
storage/framework/views/775قوالب Blade المُصرَّفة
storage/logs/775سجلات التطبيق
bootstrap/cache/775ذاكرة تشغيل الإطار المؤقتة
.env644إعداد البيئة (يُنشأ بواسطة المثبّت)

ضبط الصلاحيات (Linux)​

cd /var/www/feedbackpulse-saas

# ضبط الملكية لمستخدم خادم الويب
sudo chown -R www-data:www-data storage bootstrap/cache

# ضبط صلاحيات المجلدات
sudo chmod -R 775 storage bootstrap/cache

الأمان: لا تضبط الصلاحيات على 777 أبدًا. استخدم 775 مع الملكية الصحيحة للمستخدم/المجموعة.

متطلبات الشبكة​

المتطلبالغرضمطلوب؟
اسم النطاقرابط منصتكنعم
شهادة SSLتشفير HTTPSموصى به بشدة
DNS الشامل (اختياري)النطاقات الفرعية للمستأجرين (*.yourdomain.com)اختياري
HTTPS الصادر (المنفذ 443)APIs لـ Stripe وPayPal وOpenAI وOAuthنعم (للتكاملات)
SMTP الصادر (المنفذ 587/465)إرسال رسائل البريد الإلكترونينعم

مواصفات الخادم الموصى بها​

المستأجرونالمعالجالذاكرةالقرصملاحظات
1-101 vCPU1 GB20 GBالاستضافة المشتركة قد تعمل
10-1002 vCPU2 GB40 GBيُوصى بـ VPS
100-1,0004 vCPU4 GB80 GBفكّر في Redis للذاكرة المؤقتة/قائمة الانتظار
1,000+8+ vCPU8+ GB160+ GBRedis مطلوب، يُوصى بعمال قائمة انتظار

بيئات الاستضافة المدعومة​

مدعومة بالكامل​

  • مزودو VPS: DigitalOcean وLinode وVultr وAWS EC2 وHetzner
  • خوادم مُدارة: Laravel Forge وPloi وRunCloud وServerPilot
  • استضافة مشتركة: cPanel وPlesk وDirectAdmin وCyberPanel وHestiaCP وCloudPanel وAAPanel
  • تطوير محلي: Laragon (Windows) وValet (macOS) وSail (Docker)

الاستضافة المشتركة؟ FeedbackPulse SaaS متوافق 100% مع الاستضافة المشتركة — حتى عند تعطيل exec() وعدم دعم الروابط الرمزية. راجع دليل الاستضافة المشتركة المخصص للتعليمات خطوة بخطوة.

مدعومة جزئيًا (مع تحفظات)​

  • استضافة WordPress المُدارة: عادةً لن تعمل (لا وصول لـ PHP CLI، cron مقيّد)

غير مدعومة​

  • الاستضافة الثابتة: Netlify وVercel وGitHub Pages (FeedbackPulse تطبيق PHP، وليس ثابتًا)
  • بدون خادم: AWS Lambda وCloudflare Workers (يتطلب نظام ملفات ثابتًا)

التحقق من خادمك​

شغّل هذا الأمر للتحقق من جميع المتطلبات دفعةً واحدة:

php -v                    # يجب أن يكون 8.4+
php -m                    # التحقق من جميع الامتدادات
mysql --version           # يجب أن يكون 8.0+ (أو MariaDB 10.6+)
composer --version        # يجب أن يكون 2.0+
ls -la storage/           # التحقق من الصلاحيات

أو ببساطة انتقل إلى https://yourdomain.com/install — يتضمن مثبّت الويب فاحصًا تلقائيًا للمتطلبات سيخبرك بدقة بما هو مفقود.

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

استُوفيت جميع المتطلبات؟ انتقل إلى: