Laravel SharedSync

SharedSync is a Laravel package designed for deploying applications to shared hosting environments where only FTP or SFTP access is available. It builds the project locally and performs incremental uploads to the remote server.

This package is aimed at Laravel developers who want to deploy their applications to shared hosting environments that only support FTP or SFTP (A notable example is OVH's shared hosting basic plan)

Features

• Build project locally before deployment (Composer, NPM, Artisan cache).
• Incremental deployment using a manifest file (.deploy-manifest.json).
• Supports both FTP and SFTP.
• Configurable ignore rules (supports .deployignore).
• Dry-run mode to see changes before uploading.
• Selective deployment using the --only flag.

Requirements

• PHP 8.2+
• Laravel 10.0+
• FTP or SFTP access to your hosting provider.

Installation

You can install the package via composer:

composer require cslash/laravel-sharedsync

Publish the configuration file:

php artisan vendor:publish --tag=sharedsync-config

Configuration

Edit config/sharedsync.php with your server details. You can also use environment variables.

Example .env configuration:

SHAREDSYNC_DRIVER=ftp

FTP_HOST=ftp.example.com
FTP_USER=user@example.com
FTP_PASS=secret
FTP_ROOT=/public_html
FTP_PASSIVE=true
FTP_SSL=false

SFTP_HOST=sftp.example.com
SFTP_USER=user
SFTP_PASS=secret
SFTP_ROOT=/var/www/html
SFTP_PRIVATE_KEY=/path/to/id_rsa

Example config/sharedsync.php:

'driver' => env('SHAREDSYNC_DRIVER', 'ftp'),

'ftp' => [
    'host' => env('FTP_HOST'),
    'username' => env('FTP_USER'),
    'password' => env('FTP_PASS'),
    'port' => env('FTP_PORT', 21),
    'root' => env('FTP_ROOT', '/'),
    'passive' => env('FTP_PASSIVE', true),
    'ssl' => env('FTP_SSL', false),
],

'sftp' => [
    'host' => env('SFTP_HOST'),
    'username' => env('SFTP_USER'),
    'password' => env('SFTP_PASS'),
    'port' => env('SFTP_PORT', 22),
    'root' => env('SFTP_ROOT', '/'),
    'privateKey' => env('SFTP_PRIVATE_KEY'),
],

Important Note on Local Build

The composer build step runs composer install --no-dev --optimize-autoloader locally. If you run the deployment command from the same environment where your dev-dependencies are needed (e.g., your local development machine), this may cause the current Artisan process to fail if it tries to load a dev-dependency class (like collision) after it has been removed from the vendor folder.

By default, the composer build step is disabled in the configuration to prevent this. If you enable it, ensure you are running the deployment in a dedicated build environment or be prepared to run composer install again after the deployment.

Usage

Basic Deployment

php artisan sharedsync:deploy

Test Connection

Test the connection to your remote server:

php artisan sharedsync:test

List Remote Files

List files on the remote server:

php artisan sharedsync:ls

Or list a specific directory:

php artisan sharedsync:ls path/to/directory

Show Deployment Diff

List files that will be uploaded or updated:

php artisan sharedsync:diff

Dry Run

See which files will be uploaded or deleted without actually performing the actions:

php artisan sharedsync:deploy --dry-run

Force Deployment

Ignore the manifest and upload all files:

php artisan sharedsync:deploy --force

Selective Deployment

Only upload files from specific directories:

php artisan sharedsync:deploy --only=app,config,resources/views

How It Works

1. Build: Runs composer install --no-dev, npm run build, and php artisan *:cache locally.
2. Scan: Recursively scans the local project directory, applying ignore rules.
3. Compare: Compares the scanned files against the last deployment manifest.
4. Upload: Connects via FTP/SFTP and uploads new or modified files.
5. Delete: Removes files from the remote server that no longer exist locally (if enabled).
6. Manifest: Updates the local .deploy-manifest.json file.

License

The MIT License (MIT).