SureCommerce

PHP Extensions

php.ini Recommended Settings

upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
max_input_time = 300
memory_limit = 256M
max_input_vars = 3000

Start queue worker

Required for background jobs (Excel import, email, image optimization, warranty serial generation). Run in a separate terminal after installation:

# Local / development:
php artisan queue:work --queue=high,default

# Production (use Supervisord — see Queue Workers section below)

Container names & useful commands

# View running containers
docker ps

# Open shell in PHP container
docker exec -it surecommerce_php bash

# Check logs
docker logs surecommerce_php
docker logs surecommerce_nginx

# Restart all
docker-compose restart

# Stop and remove containers (keeps DB data)
docker-compose down

# Stop and remove everything including DB data
docker-compose down -v

Apache — .htaccess

Ensure mod_rewrite is enabled. The .htaccess in the public/ folder handles URL rewriting automatically.

<IfModule mod_rewrite.c>
    Options -MultiViews -Indexes
    RewriteEngine On
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

Nginx — server block

server {
    listen 80;
    server_name yourdomain.com;
    root /path/to/project/public;
    index index.php;
    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Supervisord setup (production)

# Ubuntu/Debian
sudo apt-get install supervisor

# CentOS/RHEL
sudo yum install supervisor
sudo systemctl enable supervisord && sudo systemctl start supervisord

[program:surecommerce-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /path/to/project/artisan queue:work --queue=high,default --sleep=2 --tries=2 --timeout=120
autostart=true
autorestart=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/path/to/project/storage/logs/worker.log
stopwaitsecs=3600

sudo cp surecommerce-worker.conf /etc/supervisor/conf.d/
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start surecommerce-worker:*

Mail Configuration

Configure SMTP via Admin Panel → Settings → Email Configuration. No need to edit .env manually.

Admin Panel Features

Queue-dependent features (require queue worker running)

• Excel product import (Admin → Products → Import)
• Email sending (password reset, order notifications, warranty activation)
• Image optimization on upload
• Warranty serial code generation

# Run locally (keep this terminal open):
php artisan queue:work --queue=high,default

# Check for failed jobs:
php artisan queue:failed

Post-Installation Security Checklist