cooper/laravel-deploy

A Laravel package for deploying Laravel projects using a shell script.

dev-master 2024-11-15 09:25 UTC

Requires

• laravel/framework: ^10.0|^11.0

MIT

• Cooper

README

Overview

The Laravel Deploy Package simplifies the deployment of Laravel projects using a customizable shell script.

It also supports optional integration with Laravel Horizon and Telescope.

Features

• Customizable Deployment Script: Automatically generate and customize a deployment script based on your project requirements.
• Horizon & Telescope Support: Includes commands for Horizon and Telescope if they are installed in your project.
• PHP Version Management: Specify the PHP version to use during deployment, with support for versioned paths.
• Git Branch Selection: Define the default Git branch to deploy from.

Installation

To install the package, run:

composer require cooper/laravel-deploy

After installation, you can publish the deployment script:

php artisan deploy:setup

Usage

Setup Deployment

To set up the deployment script, use:

php artisan deploy:setup

During setup, you will be prompted for:

• Default Git Branch: The Git branch to deploy. If left blank, it defaults to the master of your Laravel installation.

The script file will be generated based on your input.

Running the Deployment

Once the script is generated, you can deploy your application by running:

php artisan deploy

This script will:

1. Navigate to the specified project directory.
2. Fetch the latest code from the specified Git branch.
3. Install or update composer dependencies.
4. Run database migrations and other necessary commands.
5. Display a success message upon completion.

License

This package is open-sourced software licensed under the MIT license.