التثبيت - LimeSurvey CE

ملاحظة: تعليمات التثبيت هذه مخصصة للإصدار 2.0 أو الأحدث. يمكنك العثور على التعليمات الأقدم للإصدار 1.92 هنا، كما يمكنك العثور على تعليمات التحديث هنا.

تأكد من إمكانية استخدام LimeSurvey على موقعك

تأكد من أن الخادم لديك يلبي المتطلبات الإضافية التالية.

سيتم أيضًا التحقق من الحد الأدنى من المتطلبات أثناء عملية التثبيت!

الحد الأدنى من المتطلبات لـ LimeSurvey:

• الحد الأدنى لمساحة القرص 250 ميجابايت.
• MariaDB 10.3.38 أو أحدث أو MySQL 8 أو أحدث أو Microsoft SQL Server 2019 أو أحدث أو Postgres 14 أو أحدث.
• متطلبات نسخة الPHP:
  • LS 7.x من PHP 8.1.29 فما فوق (تم الاختبار حتى PHP 8.4.x)
  • LS 6.x من PHP 8.1.x إلى 8.3.x
  • LS 5.x من PHP 7.2.5 إلى 8.0.x
  • LS 3.x من PHP 5.5.9 إلى 7.4.x
• يجب ضبط إعداد `short_open_tag` في الملف php.ini على `ON`
• يجب تفعيل وحدات/مكتبات PHP التالية:
  • مكتبة الامتداد mbstring (Multibyte String Functions).
  • مشغّل قاعدة البيانات PDO لـ MySQL (pdo_mysql أو pdo_mysqli) أو Postgres (pdo_pgsql) أو MSSQL (pdo_sqlsrv لنظام Windows وpdo_dblib لنظام Linux).
  • مكتبة Curl
  • كما نفترض عمومًا أن جميع مكتبات PHP الافتراضية مفعّلة
    • hash
    • session
    • openssl أو mcrypt
    • fileinfo
    • SimpleXML
    • وغيرها …

ملاحظة: إذا كنت تتصل من Linux بقاعدة بيانات MSSQL على خادم Windows باستخدام مشغّل PDO من نوع dblib، فيجب إعداد FreeTDS الأساسي بشكل صحيح. راجع صفحة استكشاف الأخطاء وإصلاحها لمزيد من المعلومات.

امتدادات PHP الاختيارية:

• مكتبة GD مع دعم FreeType مطلوبة لرموز التحقق (captchas) والمخططات الجميلة في الإحصاءات أو لتحميل الصور عبر محرر HTML - راجع وثائق امتداد مكتبة PHP GD
• IMAP (شائعة جدًا) مطلوبة لـنظام تتبع ارتداد البريد الإلكتروني - راجع وثائق امتداد PHP IMAP
• LDAP مطلوبة لاستيراد المشاركين فى الاستبيان باستخدام LDAP - راجع وثائق PHP LDAP
• Zip (شائعة جدًا) مطلوبة لتحميل القوالب، واستيراد الموارد المؤرشفة بصيغة .zip، والتصدير إلى Excel - راجع وثائق امتداد PHP Zip
• Zlib (شائعة جدًا) مطلوبة لـComfortUpdate - راجع وثائق امتداد PHP Zlib

في معظم الحالات، سيتمكن مزوّد خدمة الويب لديك أو مسؤول النظام من مساعدتك في هذه المكونات الاختيارية.

توافق المتصفحات

بالنسبة لجانب الإجابة عن الاستبيان، ندعم حاليًا Edge وجميع المتصفحات الأحدث المماثلة مثل FF وChrome وOpera وغيرها مع تفعيل JavaScript.

بالنسبة لجزء الإدارة، ندعم حاليًا Edge وجميع المتصفحات الأحدث المماثلة مثل FF وChrome وOpera وغيرها مع تفعيل JavaScript.

أحجام الشاشة

ندعم أي حجم شاشة معقول للإجابة عن الاستبيان (360px x 640px فما فوق). الحد الأدنى لدقة الشاشة المدعومة لصفحة إدارة LimeSurvey هو 1280px x 1024px.

استضافة LimeSurvey

ينبغي أن يعمل LimeSurvey مع معظم شركات الاستضافة التي توفر PHP وMySQL. إذا كنت تريد نسخة مثبّتة مسبقًا من LimeSurvey، يمكنك تجربة LimeSurvey Cloud أو الاطلاع على مزوّدي استضافة آخرين.

تنزيل حزمة LimeSurvey

نزّل أحدث حزمة مستقرة من LimeSurvey بصيغة zip (تتوفر أيضًا حزم gzip وbz2 و7zip لراحتك) واحفظها على قرصك المحلي.

فك ضغط حزمة LimeSurvey

فك ضغط ملف zip في مجلد مخصص باستخدام برنامج الضغط المفضل لديك. عند فك الضغط، تأكد من فك بنية المجلدات مع الملفات (هذا هو السلوك الافتراضي لمعظم برامج الضغط). يجب ألا يحتوي مسار مجلد التثبيت على الرمزين الخاصين '(' أو ')'، لكن يمكن أن يحتوي على مسافة.

جمع المعلومات عن الخادم لديك

ستحتاج إلى معرفة الأمور التالية لتثبيت LimeSurvey على خادم الويب لديك بشكل صحيح:

• عنوان URL المقصود لموقعك الذي ستوضع فيه السكربتات (مثل http://my.domain.com/limesurvey).
• ما هو برنامج خادم الويب الذي تستخدمه؟
  • لـ Apache: مثال على إعداد LimeSurvey مع Apache
  • لـ nginx: يرجى الاطلاع على مثال على إعداد LimeSurvey مع nginx (قديم، بلا دعم للمحرر)
• موقع القرص الفعلي على الخادم الذي ستوضع فيه السكربتات (مثل /home/usr/htdocs/limesurvey).
• عنوان IP/الشبكة لخادم قاعدة البيانات لديك (أي localhost).
• إذا كان خادم قاعدة البيانات يستخدم منفذًا غير قياسي، فاعرف رقم هذا المنفذ.
• اسم المستخدم وكلمة المرور لخادم قاعدة البيانات.
• لدى معظم مزوّدي الخدمة لا يمكنك جعل السكربت ينشئ قاعدة البيانات، بل عليك إنشاؤها بنفسك. إذا كنت تستخدم مزوّد خدمة كهذا، فيرجى إنشاء قاعدة بيانات (مثل limesurvey) بنفسك.

تحميل الملفات إلى خادم الويب لديك

باستخدام برنامج FTP (مثل FileZilla)، اتصل بخادم الويب لديك وأنشئ مجلدًا لتخزين السكربتات. ثم حمّل الملفات مع الحفاظ على بنية المجلدات الموجودة فيها. تأكد من أنك تحمّل الملفات في الوضع الثنائي (binary mode) (راجع إعدادات برنامج FTP لديك). يرجى ملاحظة أن التحميل في وضع ASCII قد يؤدي إلى أخطاء غير معتادة (مثل الخطأ 'class not found' أثناء التثبيت)، كما قد لا يتم تحميل الصور بشكل صحيح.

ضبط أذونات المجلدات

لكي يعمل السكربت بشكل صحيح، يحتاج إلى وصول معين إلى بعض المجلدات - وينطبق هذا خاصة على أنظمة Linux/*nix.

• المجلد "/limesurvey/tmp" (وجميع مجلداته الفرعية وملفاته) يُستخدم للاستيراد والتحميل، ويجب ضبطه على قراءة وكتابة لخادم الويب لديك.
• المجلد "/limesurvey/upload/" (وجميع مجلداته الفرعية وملفاته) يجب أن يكون أيضًا بإذن قراءة وكتابة لخادم الويب لديك لتمكين تحميل ملفات الصور والوسائط.
• المجلد "/limesurvey/application/config/" يحتاج أيضًا إلى أذونات قراءة وكتابة لخادم الويب لديك.
• يمكن ضبط المجلدات الأخرى على قراءة فقط. وقد ترغب في Linux/Unix في ضبط أذونات كل ملف داخل المجلد /limesurvey/admin على قراءة فقط.

  إذا كنت تستخدم Linux، فإن ضبط الأذونات يعتمد على إعداد خادم الويب لديك. على سبيل المثال، إذا كنت تستخدم Apache HTTPD على CentOS، فاكتب chmod -R 755 <directory> ; chown -R apache <directory>. سيمنح هذا الجميع إذن القراءة، وسيحصل خادم الويب لديك على إذن الكتابة. راجع الرابط التالي لمزيد من المعلومات حول أذونات Linux.

إنشاء مستخدم قاعدة البيانات

سيقوم LimeSurvey بإنشاء قاعدة بيانات والجداول داخلها. وليتمكن من ذلك، سيحتاج إلى اسم المستخدم وكلمة المرور الخاصين بمستخدم قاعدة البيانات. نوصي عمومًا بإنشاء مستخدم قاعدة البيانات بالأذونات التالية:

- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX

- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER

- Microsoft SQL Server: غير معروف - إذا تمكنت من معرفة هذه المعلومات، يرجى استكمالها.

تشغيل سكربت التثبيت

انتقل إلى "example.org/limesurvey/admin". إذا قمت بإعداد كل شيء بشكل صحيح، فسيبدأ مثبت لايم سيرڤي في العمل - ما عليك سوى اتباع التعليمات. سيُطلب منك تحديد ما إذا كنت ترغب في إنشاء قاعدة البيانات و/أو إنشاء الجداول داخل قاعدة البيانات. بعد ذلك سيقوم LimeSurvey بإنشاء الجداول اللازمة في قاعدة البيانات.

الاتصال بسكربت الإدارة لأول مرة

لقد انتهيت عند اكتمال التثبيت! افتح المتصفح وأدخل عنوان URL الخاص بإدارة LimeSurvey. بافتراض أنك استخدمت 'limesurvey' كاسم للمجلد الذي تخزّن فيه الملفات، سيكون العنوان مشابهًا لـ "http://www.example.com/limesurvey/admin".

يجب أن تظهر لك شاشة تسجيل الدخول. بيانات تسجيل الدخول الافتراضية (إذا لم يتم تغييرها أثناء التثبيت) هي:

User: admin
Password: password

ستُطالَب بتغيير كلمة المرور الافتراضية بعد تسجيل الدخول. نتمنى لك تجربة ممتعة!

إعدادات إضافية

التخزين المؤقت

يستخدم LimeSurvey ذاكرة التخزين المؤقت للملفات في Yii افتراضيًا، ولكن يمكن إعداده لاستخدام محركات تخزين مؤقت أخرى. من بين الذاكرات المؤقتة الأخرى الممكنة:

• Memcached
• Redis
• WinCache
• XCache

يرجى الاطلاع على وثائق Yii للحصول على الوصف الكامل.

منذ LimeSurvey 4.0.0 أصبح بإمكانك أيضًا تخزين الحسابات مؤقتًا في ExpressionScript. يمكن أن يوفر ذلك تسريعًا كبيرًا بحسب تعقيد الاستبيان. لتفعيل emcache، أضف ما يلي في ملف config.php (ضمن صفيف components):

'emcache' => array('class' => 'CFileCache'),

كما هو الحال مع ذاكرة Yii المؤقتة الرئيسية، يمكن استخدام أنظمة تخزين مؤقت أخرى.

إن emcache غير متوافق مع الاستبيانات العشوائية، وسيتم إيقافه تلقائيًا في مثل هذه الحالات.

ماذا لو واجهتني مشاكل...

كما هو الحال مع جميع برامج الحاسوب، تعمل الأمور في معظم الأحيان تمامًا كما تقول التعليمات، لكنها أحيانًا لا تعمل. هناك أسباب كثيرة جدًا لعدم سير الأمور كما هو مخطط لها بحيث لا يمكن وصفها هنا. إذا واجهت مشكلة، فاطلع أولًا على الأسئلة الشائعة حول التثبيت. وإذا لم تجد إجابتك هناك، فيرجى نشر مشكلتك وأي رسائل خطأ في منتديات LimeSurvey، أو افتح تذكرة دعم (للعملاء الذين يستخدمون LimeSurvey Cloud فقط)، أو انضم إلى قناة Discord الخاصة بنا.