نصب و راه اندازی

قبل از شروع فرآیند نصب، حتماً ابتدا باید نیازمندی‌های سیستم را بررسی کنید.

نصب روی آپاچی (Apache)

• ایجاد پایگاه داده: یک پایگاه داده MySQL (یا MariaDB) جدید از cPanel یا DirectAdmin خود (یا از کنترل پنل مشابه) با استفاده از phpMyAdmin (یا ابزار مدیریت پایگاه داده مشابه) ایجاد کنید. حتماً یک کاربر با دسترسی‌های کامل (Full Privileges) به این دیتابیس اختصاص دهید.
• آپلود فایل‌ها: فایلی را که از پنل کاربری خود دریافت کرده‌اید از حالت فشرده خارج کرده و محتویات پوشه برنامه را در ریشه سرور خود (معمولاً پوشه public_html یا www) آپلود کنید.

مهم

همیشه از یک برنامه دستکاپ مانند FileZilla برای آپلود فایل ها در FTP به جای فایل منیجر‌های مبتنی بر وب استفاده کنید تا از مشکلات مربوط به فایل های خراب یا آپلود نشده به درستی جلوگیری کنید.

مهم

اطمینان حاصل کنید که فایل .htaccess به درستی در پوشه اصلی برنامه روی سرور کپی شده باشد.

این همان چیزی است که فایل ها باید در سرور شما به نظر برسند:

• اجرای نصب‌کننده: به آدرس نصب اسکریپت بروید (مثلاً: http://mysite.com/install) و مراحل نصب جادویی (Wizard) را دنبال کنید.

نصب روی انجین‌ایکس (Nginx)

• ایجاد پایگاه داده: مشابه روش آپاچی، ابتدا دیتابیس و کاربر آن را با دسترسی کامل ایجاد کنید.
• تنظیمات سرور: تمام فایل‌های برنامه را در ریشه سرور قرار داده و پیکربندی Nginx خود را به صورت زیر تنظیم کنید:

...
root "/path/to/www/public";
...
location / {
   try_files $uri $uri/ /index.php?$query_string;
}
...

یا

...
root "/path/to/public_html/public";
...
location / {
    try_files $uri $uri/ /index.php?$query_string;
}
...

برای جزئیات بیشتر، می توانید پیکربندی سرور Nginx را مطالعه کنید.

• راه‌اندازی مجدد: سرویس Nginx را ری‌استارت کرده و سپس به آدرس http://mysite.com/install مراجعه کنید.

نصب روی لوکال‌هاست (Localhost)

• نام دامنه مجازی: به جای استفاده از آدرس ساده localhost/mysite، باید یک میزبان مجازی (Virtual Host) با نام دامنه‌ای مانند http://mysite.localhost ایجاد کنید.
• ابزارهای پیشنهادی: این کار در ابزارهای زیر به راحتی قابل انجام است:
  • Laravel Herd یا MAMP PRO (برای مک و ویندوز)
  • Laragon (فقط برای ویندوز)
  • XAMPP (ویندوز، مک و لینوکس)
    • با دنبال کردن مراحل مقالات زیر می توان این کار را در XAMPP انجام داد:
      • How to Change localhost to a Custom Domain Name in XAMPP/WAMP (Windows)?
      • How to change the URL from "localhost" to something else, on a local system using wampserver?
• پس از تنظیم دامنه مجازی، سرور را ری‌استارت کرده، دیتابیس را بسازید و به آدرس نصب (مثلاً http://mysite.localhost/install) بروید.

نکات مهم نصب

پوشه نصب

این اسکریپت فاقد پوشه فیزیکی به نام "install" است؛ فرآیند نصب به صورت هوشمند توسط یک کنترلر داخلی مدیریت می‌شود.

زمان بارگذاری

زمان بارگذاری در طول نصب یا ارتقا ممکن است کمی طولانی به نظر برسد. این موضوع به دلیل ایجاد وقفه‌های ۱ تا ۲ ثانیه‌ای در کدهاست تا از اجرای صحیح و همگام فرآیندها در سرورهای مختلف اطمینان حاصل شود و تداخلی ایجاد نشود.