التثبيت - LimeSurvey CE

ملاحظة: تعليمات التثبيت هذه مخصصة لإصدار LimeSurvey الحالي. يمكنك العثور على التعليمات الأقدم للإصدار 1.92 هنا، كما يمكنك العثور على تعليمات التحديث هنا. إذا كنت تفضل تثبيت LimeSurvey من سطر الأوامر، فراجع التثبيت باستخدام واجهة سطر الأوامر (CLI).

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

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

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

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

• الحد الأدنى لمساحة القرص 500 ميجابايت (حزمة LimeSurvey 7.x بعد فك الضغط وحدها تشغل حوالي 380 ميجابايت)، بالإضافة إلى مساحة للملفات التي تحمّلها وبيانات الاستبيان.
• MariaDB 10.3.38 أو أحدث أو MySQL 8 أو أحدث أو Microsoft SQL Server 2019 أو أحدث أو Postgres 14 أو أحدث.
• متطلبات نسخة الPHP:
  • LS 7.x من PHP 8.1.29 فما فوق (تم الاختبار حتى PHP 8.5.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
• قيمة memory_limit في PHP لا تقل عن 128 ميجابايت.
• يجب تفعيل وحدات/مكتبات PHP التالية:
  • مكتبة الامتداد mbstring (Multibyte String Functions).
  • مشغّل قاعدة البيانات PDO لـ MySQL/MariaDB (pdo_mysql) أو Postgres (pdo_pgsql) أو MSSQL (pdo_sqlsrv لنظام Windows وpdo_dblib لنظام Linux).
  • GD - راجع وثائق امتداد مكتبة PHP GD
  • Zip - راجع وثائق امتداد PHP Zip
  • Zlib - راجع وثائق امتداد PHP Zlib
  • مكتبة Curl
  • fileinfo
  • JSON
  • كما نفترض عمومًا أن جميع مكتبات PHP الافتراضية مفعّلة، على سبيل المثال:
    • ctype
    • filter
    • hash
    • openssl
    • session
    • SimpleXML
    • وغيرها …
• بالنسبة إلى LimeSurvey 7.x: يجب ضبط تنسيق عناوين URL على path (عناوين مثل index.php/admin). لم يعد تنسيق get القديم (عناوين مثل index.php?r=admin) مدعومًا. يضبط المثبّت تنسيق path تلقائيًا، لذا لا تحتاج إلى التحقق من ذلك إلا إذا أعدت استخدام ملف config.php أقدم يحتوي على 'urlFormat' => 'get'.

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

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

• مكتبة GD مع دعم FreeType وJPEG مطلوبة لرموز التحقق (captchas) والمخططات الجميلة في الإحصاءات أو لتحميل الصور عبر محرر HTML - راجع وثائق امتداد مكتبة PHP GD
• IMAP مطلوبة لـنظام تتبع ارتداد البريد الإلكتروني - راجع وثائق امتداد PHP IMAP. منذ PHP 8.4 لم يعد امتداد IMAP مضمّنًا مع PHP ويجب تثبيته بشكل منفصل من PECL.
• LDAP مطلوبة لاستيراد المشاركين فى الاستبيان باستخدام LDAP - راجع وثائق PHP LDAP
• Intl تُستخدم لفرز النصوص بشكل صحيح وفقًا لقواعد اللغة المعنية - راجع وثائق PHP Intl
• Sodium موصى بها لتشفير البيانات - راجع وثائق PHP Sodium. إذا لم تكن متوفرة، يعود LimeSurvey إلى تطبيق PHP أبطأ بكثير.

إعدادات PHP الموصى بها (يعرض المثبّت تحذيرًا إذا كانت قيمك أقل):

• max_input_vars: 5000 أو أكثر
• post_max_size: 32M أو أكثر
• upload_max_filesize: 32M أو أكثر

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

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

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

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

أحجام الشاشة

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

استضافة LimeSurvey

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

تنزيل حزمة LimeSurvey

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

فك ضغط حزمة LimeSurvey

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

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

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

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

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

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

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

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

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

  إذا كنت تستخدم Linux، فإن ضبط الأذونات يعتمد على إعداد خادم الويب لديك. على سبيل المثال، إذا كان خادم الويب يعمل بالمستخدم www-data (Debian/Ubuntu) أو apache (RHEL/Rocky Linux/AlmaLinux)، فاكتب chown -R www-data <directory> ; chmod -R 755 <directory> للمجلدات الثلاثة المذكورة أعلاه. سيمنح هذا الجميع إذن القراءة، وسيحصل خادم الويب لديك على إذن الكتابة.

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

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

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

- PostgreSQL: أسهل طريقة هي جعل مستخدم قاعدة البيانات مالك قاعدة بيانات LimeSurvey. وإلا فإن المستخدم يحتاج إلى امتياز CREATE على المخطط بالإضافة إلى SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER على الجداول وUSAGE على المتسلسلات (sequences).

- Microsoft SQL Server: ينبغي أن يكون مستخدم قاعدة البيانات عضوًا في الدور db_owner لقاعدة بيانات LimeSurvey. وإذا أردت أن ينشئ المثبّت قاعدة البيانات، فإن المستخدم يحتاج أيضًا إلى دور الخادم dbcreator.

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

افتح عنوان URL الخاص بتثبيت LimeSurvey في المتصفح (مثل https://example.org/limesurvey). إذا قمت بإعداد كل شيء بشكل صحيح، فسيبدأ مثبت لايم سيرڤي تلقائيًا - ما عليك سوى اتباع التعليمات:

1. اختر لغة المثبّت ووافق على الترخيص.
2. راجع فحص ما قبل التنصيب. يجب أن تكون جميع العناصر المطلوبة بحالة OK قبل أن تتمكن من المتابعة.
3. أدخل تأكيد قاعدة البيانات. سيسألك LimeSurvey عما إذا كنت ترغب في إنشاء قاعدة البيانات و/أو إنشاء الجداول داخل قاعدة البيانات، ثم سينشئ الجداول اللازمة.
4. أعدّ حساب المسؤول: أدخل اسم المستخدم وكلمة المرور والبريد الإلكتروني للمسؤول، بالإضافة إلى اسم موقع الاستبيان واللغة الإفتراضية.

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

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

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

User: admin
Password: password

إذا كنت لا تزال تستخدم كلمة المرور الافتراضية، فغيّرها فورًا في إعدادات حسابك. نتمنى لك تجربة ممتعة!

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

لمزيد من الإعدادات، مثل إعداد البريد الإلكتروني (SMTP) أو إعدادات الأمان، راجع الإعدادات الاختيارية وإعدادات عامة.

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

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

• Memcached (CMemCache)
• Redis (CRedisCache)
• APCu (CApcCache)
• قاعدة البيانات (CDbCache)

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

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

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

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

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

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

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