Shared Hosting (cPanel) Deployment
Store Console کے لیے VPS (Docker یا LEMP) بہتر ہے، لیکن یہ کسی capable shared host پر بھی چلتا ہے۔ Shared hosting کا مطلب ہے root access نہیں، عموماً MySQL (PostgreSQL کی جگہ)، Redis نہیں، اور لمبے وقت تک چلنے والے processes نہیں — یہ page انہی changes پر تفصیل سے لیتا ہے۔
Minimum Host Capabilities
- PHP 8.4، معیاری Laravel extensions کے ساتھ (زیادہ تر cPanel PHP selectors میں یہ شامل ہوتے ہیں)
- MySQL 8.0+ یا MariaDB 10.6+ (جہاں دستیاب ہو تو PostgreSQL ترجیح دیا جاتا ہے)
- Cron jobs (کم از کم ہر منٹ)
- SSH access کا سختی سے recommendation کیا جاتا ہے، اس لیے کہ
composerاورartisan
مرحلہ 1: Upload اور Document Root کی طرف اشارہ
اپنی licensed zip کو اس سے باہر upload اور extract کریں public_html، پھر (sub)domain کے document root کو app کی public/ directory کی طرف cPanel → Domains سے point کریں۔ Application root کو کبھی خودکار طور پر expose نہ کریں۔
مرحلہ 2: Shared Hosting کے لیے .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
یہ drivers بنیادی درجے کے ہیں: queue، cache اور session کی tables default migrations میں آتی ہیں، اس لیے Redis کی ضرورت نہیں۔
مرحلہ 3: Migrate اور Build
php artisan migrate --seed
npm run build # or build locally and upload public/build
مرحلہ 4: Cron Entries (Horizon اور systemd کی جگہ)
cPanel → Cron Jobs میں دو cron jobs شامل کریں:
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
دوسرا entry ہر منٹ میں ہر queue کو خالی کر کے خارج ہو جاتا ہے، جو shared host کی process limits کے تحت محفوظ ہے۔ Horizon اور اس کا dashboard shared hosting پر استعمال نہیں کیا جاتا۔
کیا خراب ہوتا ہے — اور کیسے
- AI semantic features (vector search، embeddings) کو PostgreSQL + pgvector چاہیے — MySQL پر یہ خاموشی سے بند ہو جاتے ہیں، جبکہ AI chat، generation اور report tools آپ کے configured provider کے ذریعے کام کرتے رہتے ہیں
- Real-time chat اور notifications VPS پر Reverb/WebSockets استعمال کرتے ہیں — اس کے بغیر UI خودکار طور پر periodic polling پر fallback کر جاتا ہے (
BROADCAST_CONNECTION=null) - Background jobs dedicated worker کے مقابلے میں زیادہ سے زیادہ ایک منٹ دیر سے چلتے ہیں — جو mail، invoices اور reports کے لیے قابل قبول ہے؛ بڑے stores کو VPS پر منتقل ہونا چاہیے
VPS پر کب Upgrade کریں
POS یا Delivery dispatch آنے پر، AI search پر انحصار کرنے پر، یا فی منٹ کئی سے زیادہ orders پر process کرنے پر VPS پر منتقل ہو جائیں۔ آپ کا data معیاری database dump سے migrate ہو جاتا ہے — reinstall کی ضرورت نہیں۔

