ifnex/DEPLOYMENT.md

راهنمای استقرار IFNEX

آخرین بروزرسانی: 2026-08-29

---

محیط‌ها

محیط	دامنه	نقش
Production	api.ifnex.vernahost.ir	API لاراول
Production	ifnex.vernahost.ir	وب‌سایت وردپرس
Local	localhost:8000	توسعه

---

پیش‌نیازها

• SSH دسترسی به سرور
• HestiaCP (مدیریت سرور)
• Git روی سرور
• Composer روی سرور (اختیاری — بهتره locallly نصب کنی)

---

۱. استقرار لاراول

۱.۱ کلون مخزن روی سرور

cd /home/USER/web/api.ifnex.vernahost.ir/public_html
git clone https://www.git.vernahost.ir/gitmodir110/ifnex.git .

اگر پوشه لاراول زیرمسیر 04_Laravel/ هست:

cd /home/USER/web/api.ifnex.vernahost.ir/public_html
ngit clone https://www.git.vernahost.ir/gitmodir110/ifnex.git tmp-ifnex
cp -r tmp-ifnex/04_Laravel/* .
cp -r tmp-ifnex/04_Laravel/.* . 2>/dev/null
rm -rf tmp-ifnex

۱.۲ نصب وابستگی‌ها

ncd /home/USER/web/api.ifnex.vernahost.ir/public_html
composer install --no-dev --optimize-autoloader

۱.۳ تنظیم .env

cp .env.example .env
nano .env

مقادیر مهم:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://api.ifnex.vernahost.ir

DB_HOST=localhost
DB_DATABASE=ifnex_db
DB_USERNAME=ifnex_user
DB_PASSWORD=STRONG_PASSWORD

CORS_ALLOWED_ORIGINS=https://ifnex.vernahost.ir

ZARINPAL_SANDBOX=false
ZARINPAL_MERCHANT_ID=YOUR_MERCHANT_ID

۱.۴ دیتابیس

# ایجاد دیتابیس (اگر وجود نداره)
mysql -u root -p -e "CREATE DATABASE ifnex_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# اجرای migrations
php artisan migrate --force

# اجرای seeders (فقط بار اول)
php artisan db:seed --force

۱.۵ پیکربندی نهایی

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan filament:clear-cached-components

---

۲. استقرار وردپرس (پلاگین و قالب)

۲.۱ آپلود فایل‌ها

# قالب IFNEX
cd /home/USER/web/ifnex.vernahost.ir/public_html/wp-content/themes/
# فایل‌های قالب را اینجا آپلود/بروزرسانی کن

# پلاگین IFNEX Bridge
cd /home/USER/web/ifnex.vernahost.ir/public_html/wp-content/plugins/
# فایل‌های پلاگین را اینجا آپلود/بروزرسانی کن

۲.۲ تنظیم پلاگین

در پیشخوان وردپرس → تنظیمات → IFNEX Bridge:

تنظیم	مقدار
API URL	https://api.ifnex.vernahost.ir/api/v1
Bridge API Key	کلید مشترک بین وردپرس و لاراول

---

۳. بروزرسانی (بعد از تغییرات جدید)

۳.۱ لاراول

cd /home/USER/web/api.ifnex.vernahost.ir/public_html

# خاموش کردن موقت سایت
php artisan down

# بکاپ
cp .env .env.backup

# دریافت تغییرات
git fetch --all
git pull origin main

# وابستگی‌ها (اگه composer.json تغییر کرده)
composer install --no-dev --optimize-autoloader

# مایگریشن‌های جدید
php artisan migrate --force

# پاک‌سازی کش
php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear
php artisan filament:clear-cached-components

# کش مجدد
php artisan config:cache
php artisan route:cache
php artisan view:cache

# روشن کردن سایت
php artisan up

۳.۲ وردپرس

cd /home/USER/web/ifnex.vernahost.ir/public_html/wp-content/plugins/ifnex-bridge
git pull origin main

اگر پلاگین از طریق گیت کلون نشده، فایل‌ها را دستی آپلود کن.

---

۴. تنظیمات Cron

crontab -e

# به‌روزرسانی نرخ ارز (اگر ExchangeRateService فعال شد)
0 0 * * * cd /home/USER/web/api.ifnex.vernahost.ir/public_html && php artisan ifnex:update-exchange-rates >> /dev/null 2>&1

---

۵. عیب‌یابی

بررسی لاگ‌ها

# لاگ لاراول
tail -f /home/USER/web/api.ifnex.vernahost.ir/public_html/storage/logs/laravel.log

# لاگ HestiaCP
tail -f /var/log/hestia.log

کلیر کش

php artisan optimize:clear

بررسی وضعیت

php artisan about
php artisan route:list --path=api/v1

---

۶. نکات امنیتی

• .env هرگز در گیت کامیت نشود (در .gitignore باشد)
• APP_DEBUG=false در Production
• CORS_ALLOWED_ORIGINS فقط دامنه وردپرس
• IFNEX_API_KEY یک کلید قوی و تصادفی باشد
• SSL/HTTPS فعال باشد
• رمز عبور دیتابیس قوی باشد

---

© 2026 VernaSoft Group. Internal use only.