Deployment Guide

1. Optimize Composer Dependencies

Before deployment, optimize Composer's autoloader to improve performance:

composer install --no-dev --optimize-autoloader

2. Generate Application Key

Ensure your application key is set:

php artisan key:generate

3. Configure Environment Variables

Create a production .env file with appropriate settings:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://your-domain.com
APP_LOCALE=en

# Database settings
DB_CONNECTION=mysql
DB_HOST=your-db-host
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

# Cache and session
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

# File system
FILESYSTEM_DISK=public

# InspireCMS specific
INSPIRECMS_LICENSE_KEY=your-license-key

4. Optimize Configuration and Routes

Cache your configuration and routes for better performance:

php artisan config:cache
php artisan route:cache
php artisan view:cache

Nginx Configuration

server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    root /path/to/your-project/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }

    # Cache static assets
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 30d;
        add_header Cache-Control "public, no-transform";
    }
}

Apache Configuration

Ensure you have a proper .htaccess file in your public directory:

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On

    # Handle Authorization Header
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    # Redirect Trailing Slashes If Not A Folder...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    # Send Requests To Front Controller...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

Using Git

1. Clone your repository on the server
2. Install dependencies: composer install --no-dev --optimize-autoloader
3. Update environment variables
4. Run migrations and optimizations
5. Restart queue workers and web server

Using Deployer (PHP Deployment Tool)

// deploy.php
require 'recipe/laravel.php';

set('application', 'inspirecms');
set('repository', 'git@github.com:username/your-repo.git');
set('git_tty', true);
set('keep_releases', 5);

host('your-domain.com')
    ->user('deployer')
    ->set('deploy_path', '/var/www/your-project');

// Tasks
task('build', function () {
    run('cd {{release_path}} && npm ci && npm run build');
});

after('deploy:failed', 'deploy:unlock');
after('deploy:vendors', 'build');
after('deploy:vendors', 'artisan:storage:link');