codehubcare/laravel-deployer

There is no license information available for the latest version (3.0.2) of this package.

Deploy laravel based application to a shared web hosting

Maintainers

Details

github.com/codehubcare/laravel-deployer

Source

Issues

Installs: 20

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

3.0.2 2025-03-20 21:02 UTC

Requires

Requires (Dev)

Unknown License e8667ab98949c0dcb6f956fcc16ae3b5f26cef24

  • Shamshad Zaheer <shamshadzr.woop@gmail.com>

This package is auto-updated.

Last update: 2025-04-20 21:15:51 UTC

README

A powerful tool for automating and streamlining Laravel application deployments to remote servers via FTP/SFTP.

Features

  • Automated directory and file uploads
  • Configurable deployment paths
  • Environment-specific settings
  • Simple command-line interface

Prerequisites

  • PHP 7.4 or higher
  • Composer
  • Laravel 8.x or higher
  • FTP/SFTP server access

Installation

Step 1: Install the Package

Add Laravel Deployer to your project as a development dependency:

composer require codehubcare/laravel-deployer --dev

The --dev flag ensures it's only included in development environments.

Step 2: Publish Configuration

Publish the configuration file to customize deployment settings:

php artisan vendor:publish --provider="Codehubcare\LaravelDeployer\LaravelDeployerServiceProvider"

This command creates a config/laravel-deployer.php file in your Laravel application where you can modify default settings.

Configuration

Environment Variables

Update your .env file with the following variables:

LARAVEL_DEPLOYER_SRC_PATH=src
LARAVEL_DEPLOYER_PUBLIC_PATH=public_html

# FTP/SFTP connection details
LARAVEL_DEPLOYER_FTP_HOST=your.ftp.host.com
LARAVEL_DEPLOYER_FTP_USERNAME=your_username
LARAVEL_DEPLOYER_FTP_PASSWORD=your_password
LARAVEL_DEPLOYER_FTP_PORT=21

Usage

Deploy your application with a single command:

php artisan laravel-deployer:deploy

What Happens During Deployment

  • Connects to the remote server using provided credentials
  • Uploads the source directory contents to the remote destination
  • Creates necessary directories if they don't exist
  • Maintains directory structure

Troubleshooting

  • Connection Failed: Verify FTP credentials and network accessibility
  • Permission Denied: Check remote directory permissions
  • Files Not Visible: Confirm the correct remote path is set

Additional Notes

  • Always backup your application before deployment
  • Test deployment in a staging environment first
  • Keep sensitive credentials out of version control by using .env

For more advanced configuration options, refer to the config/laravel-deployer.php file comments.