commit 4d71adb1ec703024a72414ca51d3769934d9e0bc Author: Hesabix Date: Wed Jul 23 21:34:44 2025 +0330 Add install in shared hostings diff --git a/install-in-shared-hostings.md b/install-in-shared-hostings.md new file mode 100644 index 0000000..70eef20 --- /dev/null +++ b/install-in-shared-hostings.md @@ -0,0 +1,86 @@ +# راهنمای نصب برنامه حسابیکس بر روی هاست اشتراکی + +در این راهنما به شما نحوه نصب برنامه حسابیکس را بر روی هاست اشتراکی با استفاده از پنل‌های Cpanel یا DirectAdmin توضیح خواهیم داد. این راهنما شامل مراحل دانلود، آپلود فایل‌ها، تنظیمات دیتابیس و فایل‌های پیکربندی است. + +--- + +## پیش‌نیازها + +1. **دسترسی به هاست اشتراکی** با پنل مدیریت Cpanel یا DirectAdmin. +2. **دسترسی به phpMyAdmin** برای ایجاد و ایمپورت دیتابیس. +3. **دسترسی به فایل‌های برنامه** از لینک: [https://source.hesabix.ir/morrning/hesabixCore/releases](https://source.hesabix.ir/morrning/hesabixCore/releases). +4. **دسترسی به فایل `.env.local.php`** برای تنظیمات دیتابیس و دیگر متغیرها. + +--- + +## مراحل نصب + +### 1. دانلود برنامه + +1. به آدرس [https://source.hesabix.ir/morrning/hesabixCore/releases](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 + 'prod', + 'SYMFONY_DOTENV_PATH' => './.env', + 'APP_SECRET' => '1188144bba4b2a91f44e1dc06328d3b6', // شما می‌توانید این مقدار را تغییر دهید + 'DATABASE_URL' => 'mysql://hesabix_user:Kx8rI3wI9kle@127.0.0.1:3306/hesabix_next_hesabix_ir?serverVersion=8.0.32&charset=utf8mb4', + 'MESSENGER_TRANSPORT_DSN' => 'doctrine://default?auto_setup=0', + 'MAILER_DSN' => 'null://null', + 'CORS_ALLOW_ORIGIN' => '*', + 'LOCK_DSN' => 'flock', +); + + +---