Skip to content

Installation

With LaraDumps, you can go right into debugging with minimal effort:

1 - Download the LaraDumps Desktop App.

2 - Add the LaraDumps PHP Package:

3․ Start to Debug!


Desktop App

LaraDumps Desktop App is available for Windows, Linux and macOS.

Proceed to the installation instructions according to your operating system:

Windows

Click to Download LaraDumps v3.0.0 installer for Windows.

Once downloaded, open it and proceed with the installer.

Linux

Snapcraft

Download from https://snapcraft.io/laradumps

bash
sudo snap install laradumps

AppImage

Download the latest application image LaraDumps-x.x.x.AppImage from GitHub.

Click to Download LaraDumps v3.0.0 application image for Linux.

Once downloaded, assign execution permission to the file:

Click on Properties, navigate to Permissions and click Allow to execute file as program. Now, open the AppImage file to proceed with the installation.

Alternatively, use the Terminal and run the command below:

shell
chmod u+x ./LaraDumps-3.0.0.AppImage && ./LaraDumps-3.0.0.AppImage

(These steps might slightly change depending on your Linux distribution).

macOS

Click to Download LaraDumps v3.0.0 Apple Disc Image (.dmg) for macOS.

Once downloaded, open the file and drag & drop the LaraDumps app into your Applications folder.

Authorizing the app

The first time you open LaraDumps, you will receive an alert saying LaraDumps cannot be opened.

Don't worry! This is just because the app code is not signed with Apple. LaraDumps is not a malicious software and all code is open-source.

To authorize LaraDumps to run, follow these steps:

1․ Click on the  (Apple logo) on the top menu.

2․ Go to System Preferences.

3․ Open the Security & Privacy tab.

4․ Click on the 🔒 (lock pad) and enter your password to authenticate.

5․ Click Open Anyway for LaraDumps.

6․ Once again, click Open when you are prompted about "This is an Internet Application".

Now, LaraDumps should run just fine!

Laravel Package

Requirements: PHP 8.1+ and Laravel 10+

1․ Install LaraDumps Package in your Laravel project using Composer.

Run the command:

shell
composer require laradumps/laradumps ^3.0 --dev -W

2․ Now, configure LaraDumps. Run the command below:

shell
php artisan ds:init $(pwd)

This command will generate a file called laradumps.yaml in the root of your project that looks like this:

WARNING

This file is important for correct communication between the desktop app and the Laravel or PHP project. If your project_path is empty, you must manually add your project's $(pwd) to app.project_path

yaml
app:
  primary_host: 127.0.0.1
  secondary_host: host.docker.internal
  port: 9191
  workdir: /var/www/html/
  project_path: /your-project-path-here/
config:
  sleep: 0
  color_in_screen: false
  docker: false
observers:
  dump: false
  original_dump: false
  queries: false
  mail: false
  logs_applications: false
  logs_vendor: false
  logs_deprecated: false
  http: false
  jobs: false
  commands: false
  scheduled_commands: false
  gate: false
  cache: false

See full information in configuration options.

Agnostic PHP Framework

Requirements: PHP 8.1+

1․ Install LaraDumps Package in your PHP project using Composer.

Run the command:

shell
composer require laradumps/laradumps-core ^2.0 --dev

2․ Now, configure LaraDumps. Run the command below:

shell
vendor/bin/laradumps init $(pwd)

INFO

Similar to Laravel step, a laradumps.yaml file will be generated here without the "observers" key, which is specific to Laravel.

yaml
app:
  primary_host: 127.0.0.1
  secondary_host: host.docker.internal
  port: 9191
  workdir: /var/www/html/
  project_path: /your-project-path-here/
config:
  sleep: 0
  color_in_screen: false
  docker: false

See full information in configuration options.


Global LaraDumps

Requirements: PHP 8.1+

1․ You can install the global LaraDumps via Composer.

shell
composer global require laradumps/global-laradumps

How to install

shell
global-laradumps install

How to uninstall

shell
global-laradumps uninstall

Created By Luan Freitas