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 نصب کنی)

---

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

بکاپ دیتابیس

```bash

بکاپ کامل دیتابیس

mysqldump -u root -p ifnex_db > /backups/ifnex_$(date +%Y%m%d_%H%M%S).sql

یا فشرده

mysqldump -u root -p ifnex_db | gzip > /backups/ifnex_$(date +%Y%m%d_%H%M%S).sql.gz ```

بکاپ فایل‌ها

```bash

بکاپ فایل‌های لاراول

tar -czf /backups/laravel_$(date +%Y%m%d_%H%M%S).tar.gz /home/USER/web/api.ifnex.vernahost.ir/public_html

بکاپ فایل‌های وردپرس

tar -czf /backups/wordpress_$(date +%Y%m%d_%H%M%S).tar.gz /home/USER/web/ifnex.vernahost.ir/public_html ```

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

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
git clone https://www.git.vernahost.ir/gitmodir110/ifnex.git tmp-ifnex
cp -r tmp-ifnex/04_Laravel/* .
# فقط فایل‌های مخفی خاص را کپی کنید
cp -r tmp-ifnex/04_Laravel/.env.example .
cp -r tmp-ifnex/04_Laravel/.gitignore .
# یا بهتر است فایل‌ها را دستی کپی کنید ...

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

```bash
cd /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.

۷. تنظیمات Web Server

Nginx (لاراول)

```nginx server { listen 80; server_name api.ifnex.vernahost.ir; root /home/USER/web/api.ifnex.vernahost.ir/public_html/public;

index index.php;

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    include fastcgi_params;
}

location ~ /\.(?!well-known).* {
    deny all;
}

} ```

Apache (لاراول)

```apache <VirtualHost *:80> ServerName api.ifnex.vernahost.ir DocumentRoot /home/USER/web/api.ifnex.vernahost.ir/public_html/public

<Directory /home/USER/web/api.ifnex.vernahost.ir/public_html/public>
    AllowOverride All
    Require all granted
</Directory>

ErrorLog ${APACHE_LOG_DIR}/api.ifnex.error.log
CustomLog ${APACHE_LOG_DIR}/api.ifnex.access.log combined

\```

۸. Queue Worker (اگر استفاده می‌شود)

Supervisor Setup

```bash sudo nano /etc/supervisor/conf.d/ifnex-worker.conf ```

```ini [program:ifnex-worker] process_name=%(program_name)s_%(process_num)02d command=php /home/USER/web/api.ifnex.vernahost.ir/public_html/artisan queue:work --sleep=3 --tries=3 --max-time=3600 autostart=true autorestart=true stopasgroup=true killasgroup=true user=USER numprocs=2 redirect_stderr=true stdout_logfile=/home/USER/web/api.ifnex.vernahost.ir/public_html/storage/logs/worker.log ```

```bash sudo supervisorctl reread sudo supervisorctl update sudo supervisorctl start all ```

۹. SSL/TLS (HTTPS)

Let's Encrypt (رایگان)

```bash

نصب Certbot

sudo apt install certbot python3-certbot-nginx

دریافت SSL certificate

sudo certbot --nginx -d api.ifnex.vernahost.ir -d ifnex.vernahost.ir

تمدید خودکار (تست)

sudo certbot renew --dry-run ```