2 install in shared hostings
Hesabix edited this page 2025-07-23 21:47:49 +03:30

راهنمای نصب برنامه حسابیکس بر روی هاست اشتراکی

در این راهنما به شما نحوه نصب برنامه حسابیکس را بر روی هاست اشتراکی با استفاده از پنل‌های Cpanel یا DirectAdmin توضیح خواهیم داد. این راهنما شامل مراحل دانلود، آپلود فایل‌ها، تنظیمات دیتابیس و فایل‌های پیکربندی است.


پیش‌نیازها

  1. دسترسی به هاست اشتراکی با پنل مدیریت Cpanel یا DirectAdmin.
  2. دسترسی به phpMyAdmin برای ایجاد و ایمپورت دیتابیس.
  3. دسترسی به فایل‌های برنامه از لینک: https://source.hesabix.ir/morrning/hesabixCore/releases.
  4. دسترسی به فایل .env.local.php برای تنظیمات دیتابیس و دیگر متغیرها.

مراحل نصب

1. دانلود برنامه

  1. به آدرس https://source.hesabix.ir/morrning/hesabixCore/releases بروید.
  2. نسخه optimized را برای نصب بر روی هاست اشتراکی دانلود کنید.
  3. فایل دانلودی را استخراج کرده و پوشه‌های داخل آن را بررسی کنید.

2. ایجاد دیتابیس در هاست اشتراکی

برای ایجاد دیتابیس در هاست اشتراکی مراحل زیر را دنبال کنید:

در Cpanel:

  1. وارد پنل Cpanel شوید و به بخش MySQL® Databases بروید.
  2. یک دیتابیس جدید ایجاد کنید.
  3. یک کاربر جدید برای دیتابیس ایجاد کرده و به آن دسترسی کامل به دیتابیس بدهید.

در DirectAdmin:

  1. وارد پنل DirectAdmin شوید و به بخش MySQL Management بروید.
  2. یک دیتابیس جدید ایجاد کنید.
  3. یک کاربر برای دیتابیس بسازید و به آن دسترسی کامل بدهید.

3. ایمپورت فایل دیتابیس

در phpMyAdmin، مراحل زیر را دنبال کنید:

  1. وارد phpMyAdmin شوید.
  2. دیتابیس جدیدی که ایجاد کرده‌اید را انتخاب کنید.
  3. به تب Import بروید.
  4. فایل دیتابیس پیش‌فرض hesabix-db-default.sql را که در پوشه پروژه شما موجود است، انتخاب کرده و ایمپورت کنید.این فایل در داخل پوشه hesabixBackup قرار دارد.

4. آپلود فایل‌های برنامه به هاست

برای آپلود فایل‌ها به هاست خود، از یکی از روش‌های زیر استفاده کنید:

روش اول: استفاده از FTP

  1. یک نرم‌افزار FTP مانند FileZilla را نصب کنید.
  2. به هاست خود متصل شوید.
  3. تمامی فایل‌های برنامه را به پوشه public_html هاست خود آپلود کنید.
    • توجه داشته باشید که پوشه public_html باید کاملاً با پوشه public_html در پروژه شما جایگزین شود.

روش دوم: استفاده از File Manager در Cpanel/DirectAdmin

  1. وارد Cpanel یا DirectAdmin شوید.
  2. به بخش File Manager بروید.
  3. پوشه دامینتان را را انتخاب کنید.
  4. فایل‌های پروژه را آپلود کرده و استخراج کنید تا فایل‌ها در پوشه public_html با فایل های روی هاست بازنویسی شوند. به عبارت دیگر بعد از انتقال باید فولدرهای hesabixCore و ... خارج از public_html قرار گیرند.

5. تنظیمات فایل .env.local.php

بعد از آپلود فایل‌ها، باید تنظیمات مربوط به اتصال به دیتابیس را در فایل .env.local.php انجام دهید. این فایل معمولاً شامل مقادیری است که برای پیکربندی برنامه ضروری هستنداین فایل در داخل پوشه hesabixCore قرار دارد.

نمونه فایل .env.local.php:

<?php

// This file was generated by running "composer dump-env dev"

return array (
  'APP_ENV' => 'prod',
  'SYMFONY_DOTENV_PATH' => './.env',
  'APP_SECRET' => '1188144bba4b2a91f44e1dc06328d3b6',  // شما می‌توانید این مقدار را تغییر دهید
  'DATABASE_URL' => 'mysql://DBUser:DBPassword@127.0.0.1:3306/DBName?serverVersion=8.0.32&charset=utf8mb4',
  'MESSENGER_TRANSPORT_DSN' => 'doctrine://default?auto_setup=0',
  'MAILER_DSN' => 'null://null',
  'CORS_ALLOW_ORIGIN' => '*',
  'LOCK_DSN' => 'flock',
);


---