إنتقل إلى المحتوى الرئيسي

متطلبات الخادم

Before installing FeedbackPulse SaaS, make sure your server meets all of the following requirements.

Required Software​

SoftwareMinimum VersionRecommendedNotes
PHP8.28.3+With required extensions (see below)
MySQL8.08.0+Or MariaDB 10.6+
Web ServerApache 2.4+ or Nginx 1.18+NginxApache requires mod_rewrite
Composer2.0+LatestPHP dependency manager (or upload pre-built vendor/)
Node.jsNot required—Assets are pre-compiled

Shared hosting? If you can't run composer install, upload the entire vendor/ folder from the downloaded package. The المثبت الويب checks for vendor/autoload.php and will block installation if it's missing.

Required PHP Extensions​

The following PHP extensions must be installed and enabled:

ExtensionPurposeCheck Command
pdo_mysqlMySQL database connectionphp -m | grep pdo_mysql
mbstringMulti-byte string handlingphp -m | grep mbstring
opensslEncryption and HTTPSphp -m | grep openssl
tokenizerPHP code tokenizationphp -m | grep tokenizer
xmlXML parsingphp -m | grep xml
ctypeCharacter type checkingphp -m | grep ctype
jsonJSON encoding/decodingphp -m | grep json
bcmathArbitrary precision mathphp -m | grep bcmath
fileinfoFile type detectionphp -m | grep fileinfo
curlHTTP requests (payments, AI, webhooks)php -m | grep curl
gd or imagickImage processingphp -m | grep gd
zipBackup compressionphp -m | grep zip

Install PHP Extensions on Ubuntu/Debian​

sudo apt update
sudo apt install php8.2-mysql php8.2-mbstring php8.2-xml php8.2-bcmath \
  php8.2-curl php8.2-gd php8.2-zip php8.2-fileinfo php8.2-tokenizer

Install PHP Extensions on CentOS/RHEL​

sudo dnf install php-mysqlnd php-mbstring php-xml php-bcmath \
  php-curl php-gd php-zip php-fileinfo

On Windows (XAMPP/Laragon)​

Most extensions are pre-installed. Edit php.ini and uncomment the lines:

extension=pdo_mysql
extension=mbstring
extension=openssl
extension=curl
extension=gd
extension=zip
extension=fileinfo
extension=bcmath

نصيحة: On Laragon, all extensions are enabled by default. Just make sure you're using PHP 8.2+.

Directory Permissions​

The web server (Apache/Nginx) user must have write access to these directories:

DirectoryPermissionPurpose
storage/775Logs, cache, sessions, uploaded files
storage/app/public/775Public file uploads (logos, photos)
storage/framework/cache/775Application cache
storage/framework/sessions/775Session files
storage/framework/views/775Compiled Blade templates
storage/logs/775Application logs
bootstrap/cache/775Framework bootstrap cache
.env644Environment configuration (created by installer)

Set Permissions (Linux)​

cd /var/www/feedbackpulse-saas

# Set ownership to web server user
sudo chown -R www-data:www-data storage bootstrap/cache

# Set directory permissions
sudo chmod -R 775 storage bootstrap/cache

الأمان: Never set permissions to 777. Use 775 with the correct user/group ownership.

Network المتطلبات​

RequirementPurposeRequired?
Domain nameYour platform URLYes
SSL certificateHTTPS encryptionStrongly recommended
Wildcard DNS (optional)Tenant subdomains (*.yourdomain.com)Optional
Outbound HTTPS (port 443)Stripe, PayPal, OpenAI, OAuth APIsYes (for integrations)
Outbound SMTP (port 587/465)Sending emailsYes
TenantsCPURAMDiskNotes
1-101 vCPU1 GB20 GBShared hosting may work
10-1002 vCPU2 GB40 GBVPS recommended
100-1,0004 vCPU4 GB80 GBConsider Redis for cache/queue
1,000+8+ vCPU8+ GB160+ GBRedis required, queue workers recommended

Supported Hosting Environments​

Fully Supported​

  • VPS providers: DigitalOcean, Linode, Vultr, AWS EC2, Hetzner
  • Managed servers: Laravel Forge, Ploi, RunCloud, ServerPilot
  • Shared hosting: cPanel, Plesk, DirectAdmin, CyberPanel, HestiaCP, CloudPanel, AAPanel
  • Local dev: Laragon (Windows), Valet (macOS), Sail (Docker)

Shared hosting? FeedbackPulse SaaS is 100% compatible with الاستضافة المشتركة — even when exec() is disabled and symlinks aren't supported. See the dedicated Shared Hosting Guide for step-by-step instructions.

Partially Supported (with caveats)​

  • Managed WordPress hosting: Usually won't work (no PHP CLI access, restricted cron)

Not Supported​

  • Static hosting: Netlify, Vercel, GitHub Pages (FeedbackPulse is a PHP app, not static)
  • Serverless: AWS Lambda, Cloudflare Workers (requires persistent file system)

Verify Your Server​

Run this command to check all requirements at once:

php -v                    # Must be 8.2+
php -m                    # Check all extensions
mysql --version           # Must be 8.0+ (or MariaDB 10.6+)
composer --version        # Must be 2.0+
ls -la storage/           # Check permissions

Or simply navigate to https://yourdomain.com/install — the المثبت الويب includes an automatic requirements checker that will tell you exactly what's missing.

الخطوات التالية​

All requirements met? Proceed to: