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

Container names & useful commands

Default container names (prefix = NAME_CONTAINER value from .env):

# View running containers
docker ps

# Check logs
docker logs surecommerce_php
docker logs surecommerce_nginx

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

# 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 should contain:

<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

cp supervisord.ini.example supervisord.ini

[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 supervisord.ini /etc/supervisor/conf.d/surecommerce-worker.conf
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start surecommerce-worker:*

sudo supervisorctl status

Useful Supervisord commands

sudo supervisorctl status
sudo supervisorctl start surecommerce-worker:*
sudo supervisorctl stop surecommerce-worker:*
sudo supervisorctl restart surecommerce-worker:*
sudo supervisorctl tail -f surecommerce-worker:surecommerce-worker_00

Alternative: systemd service

[Unit]
Description=surecommerce Queue Worker
After=network.target

[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /path/to/project/artisan queue:work --queue=high,default --sleep=2 --tries=2 --timeout=120

[Install]
WantedBy=multi-user.target

sudo systemctl enable surecommerce-worker
sudo systemctl start surecommerce-worker
sudo systemctl status surecommerce-worker

Mail Configuration

After installation, configure SMTP via Admin Panel → Settings → Email Configuration. No need to edit .env manually.

1. Login to Admin Panel at /admin
2. Navigate to Settings → Email Configuration
3. Enter SMTP Host, Port, Username, Password, Encryption, and From address
4. Use the built-in Send Test Email button to verify
5. Save settings

Admin Panel Features

Queue-dependent features to test

These require a running queue worker to function:

• Excel product import (Admin → Products → Import)
• Email sending (password reset, order notifications)
• 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