استقرار روی هاست اشتراکی (cPanel)
Store Console ترجیحاً روی VPS (Docker یا LEMP) اجرا میشود، اما روی هاست اشتراکی توانمند نیز کار میکند. هاست اشتراکی یعنی بدون دسترسی root، معمولاً MySQL بهجای PostgreSQL، بدون Redis و بدون فرایندهای طولانیمدت — این صفحه دقیقاً تغییرات مربوط به همین موارد را پوشش میدهد.
حداقل قابلیتهای هاست
- PHP 8.4 همراه با افزونههای استاندارد Laravel (بیشتر PHP selectors در cPanel آنها را شامل میشوند)
- MySQL 8.0+ یا MariaDB 10.6+ (در صورت در دسترس بودن، PostgreSQL ترجیح داده میشود)
- کارهای Cron (حداقل هر دقیقه)
- دسترسی SSH بهشدت توصیه میشود برای
composerوartisan
مرحله ۱: بارگذاری و تعیین Document Root
فایل zip دارای مجوز خود را خارج از public_htmlبارگذاری و استخراج کنید، سپس Document Root دامنه یا زیردامنه را از طریق public/ مسیر app در cPanel → Domains به دایرکتوری اپلیکیشن اشاره دهید. هرگز ریشه اپلیکیشن را مستقیماً در معرض دسترسی قرار ندهید.
مرحله ۲: پیکربندی .env برای هاست اشتراکی
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cpaneluser_storeconsole
DB_USERNAME=cpaneluser_sc
DB_PASSWORD=your_password
QUEUE_CONNECTION=database
CACHE_STORE=database
SESSION_DRIVER=database
BROADCAST_CONNECTION=null
این درایورها پشتیبانی کامل دارند: جداول queue، cache و session در migrationهای پیشفرض ارائه شدهاند، بنابراین نیازی به Redis نیست.
مرحله ۳: Migration و Build
php artisan migrate --seed
npm run build # or build locally and upload public/build
مرحله ۴: ورودیهای Cron (جایگزین Horizon و systemd)
دو کار Cron در cPanel → Cron Jobs اضافه کنید:
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
ورودی دوم در هر دقیقه تمام صفها را تخلیه میکند و خارج میشود؛ این روش با محدودیت فرایندهای هاست اشتراکی سازگار است. Horizon و dashboard آن در هاست اشتراکی استفاده نمیشوند.
چه چیزهایی محدود میشوند — و به چه روش
- قابلیتهای معنایی AI (جستوجوی برداری و embedding) به PostgreSQL + pgvector نیاز دارند — روی MySQL بهطور کامل غیرفعال میشوند، اما چت AI، تولید محتوا و ابزارهای گزارشدهی از طریق provider پیکربندیشده همچنان کار میکنند
- چت و اعلانهای لحظهای روی VPS از Reverb/WebSockets استفاده میکنند — بدون آن، رابط کاربری بهطور خودکار به polling دورهای تغییر میکند (
BROADCAST_CONNECTION=null) - کارهای پسزمینه تا یک دقیقه دیرتر از زمان اجرا روی worker اختصاصی انجام میشوند — برای ایمیل، invoice و report قابل قبول است؛ فروشگاههای پرترافیک باید به VPS مهاجرت کنند
چه زمانی به VPS ارتقا دهیم
زمانی به VPS مهاجرت کنید که POS یا ارسال Delivery را فعال میکنید (حساس به تأخیر)، به جستوجوی AI متکی هستید یا در هر دقیقه بیش از چند سفارش پردازش میکنید. دادههای شما با یک database dump استاندارد منتقل میشوند — نیازی به نصب مجدد نیست.

