laradumps / laradumps

🛻 LaraDumps is a friendly app designed to boost your Laravel PHP coding and debugging experience.

LaraDumps

Download the App

_{Available for Windows, Linux and macOS.}

📚 Documentation

👋 Hello Dev,

LaraDumps is a friendly app that boosts your Laravel PHP coding and debugging experience.

When using LaraDumps, you can see the result of your debug displayed in a standalone Desktop application.

These are some debug tools available for you:

• Dump single or multiple variables at once.
• See your dumped values in a Table, with a built-in search feature.
• Improve your debugging experience using different screens.
• Watch SQL Queries.
• Monitor Laravel Logs.
• Validate JSON strings.
• Verify if a string contains a substring.
• View phpinfo() configuration.
• List your Laravel Routes.
• Inspect Model attributes.
• Learn more in our Reference Sheet.

Get Started

Requirements

PHP 8.0+ and Laravel 8.75+

Using Laravel

 composer require laradumps/laradumps --dev

PHP Project

 composer require laradumps/laradumps-core --dev

See also: https://laradumps.dev/get-started/release-notes.html#php-package

• Debug your code using ds() in the same way you would use Laravel's native functions dump() or dd().

• Run your Laravel application and see the debug dump in the LaraDumps App window.

Example

Here's an example:

// File: routes/web.php

<?php 

Route::get('/', function () {
    ds('Home page accessed!');
    return view('home');
});

The Desktop App receives:

Credits

LaraDumps is a free open-source project, and it was inspired by Spatie Ray, check it out!

• Author: Luan Freitas

• Logo by Vitor S. Rodrigues

laradumps's Issues

Tests run extremely slowly when Laradumps App is closed and Send Queries is Enabled

Software Version

Software	Version (exactly)
LaraDumps App	v1.5.1
LaraDumps package	v1.7.0
Laravel	v8.83.27
Operating System	Win 11

What is your project Environment?

• Other - Running tests from command line

---

Describe the bug

What happened?

My tests were taking incredibly long to execute. After a long day of debugging, I realised that because events are dispatched synchronously, the test RefreshDatabase trait migrations were triggering "Illuminate\Database\Events\QueryExecuted" events. These in turn would trigger Laradumps to send the queries (DS_SEND_QUERIES=true) to the Laradumps App.

But, since Laradumps was not running, the SendPayload has to timeout on its curl requests 3 times per migration-related query (CREATE TABLE; INSERT INTO migrations; CREATE INDEX). Each table migration was thus taking 2 seconds to execute, cumulatively 60 seconds per test.

Steps to Reproduce the problem

• Enable DS_SEND_QUERIES=true
• Close the Laradumps App
• Run a test using the RefreshDatabase trait

I assume the same problem would occur with DS_SEND_LOGS=true as well.

Suggestions

Improve the developer experience by providing a warning on repeat curl failures.

• Print out on the console if running a test/command line
• Notice if running on web (requests also take very long if Laradumps App is closed and DS_SEND_QUERIES=true)
• Circuit breaker in production
• Wake up Laradumps App if it is not running (Would be great, but probably not easy to implement)

Falha no configure

          Bom dia!

Estou utilizando o sail em um ambiente WSL2, porém não funcionou com a configuração abaixo.

Existe alguma outra configuração ?

Originally posted by @Jeferson-N in #116 (comment)

Queria deixar meu agradecimentos aos criados e mantenedores deste repositório.

Obrigado a todas as pessoas que estão envolvidas ou ja se envolveram neste repositório!

Quero agradecer a cada um por deixar minha vida de desenvolvedor melhor !

OBRIGADO !

Define project path when using docker

🛻 LaraDumps Feature Request

Summary

When clicking a path, it tries to open the file with the docker internal path. It would be nice if we could somehow specify the local project path in, for example, the .env

Why is this needed?

Cannot open file from the desktop app when using docker.

Suggested Solution(s)

Adding a configuration option to set a local project path like:
DS_LOCAL_DIR=/home/user/project

Or am I missing something?

[BUG] dsd(123) renders an array like dump on app

Information

Pre-steps

Have you searched through other issues to see if your problem is already reported or has been fixed?

• Yes - I did not find it.
• No

Did you read the documentation?

• Yes - I did not find it.
• No

Have you tried to reconfigure LaraDumps?

To configure LaraDumps, run: php artisan ds:init.

• Yes - I didn't work.
• No, I believe this error is not related the configuration.

Software Version

You can run composer show -i and npm list to list installed package with their versions.

Software	Version (exactly)
LaraDumps App	2.3.3
LaraDumps package	2.2.0
Laravel
Operating System	WSL2 & php-fpm docker

What is your project Environment?

• Laravel Valet
• Laravel Sail
• Docker
• XAMPP
• Laragon
• Other - please specify: Bagisto

---

Describe the bug

What happened?

I've treid to test a dump using dsd(123) on Artisan tinker but it printed a dump log as if like an array with a single value "123"

Steps to Reproduce the problem

php artisan tinker
type dsd(123) and enter
see the log output on desktop app

Extra information

There are no commands defined in the "ds" namespace

hi
I installed laradumps by composer on my laravel project and installed windows app on my system. then i ran "php artisan ds:init" but this message back to me:
ERROR There are no commands defined in the "ds" namespace.
how can I fix that? please guide me.
thanks.

Suporte ao Livewire

Gostaria de saber se tem previsão e se faz parte do backlog voltar a debugar o Livewire?

Estou parado na versão 1.7.2 por conta do Livewire que é um fator importante pra mim

LaraDumps Doc

The laradumps.gitbook.io link is currently unavailable

To access the doc you can use https://lara-dumps.gitbook.io temporarily.

Error running artisan ds:check on my pipeline

I can't run ds:check on my pipeline because composer doesn't include --dev dependencies.

I get the following error: There are no commands defined in the "ds" namespace

Creating another step to include --dev just to check ds:check, remove vendor and re-create without --dev is impracticable and a waste of build time.

So, I suggest to include ds() to the requirements and ignore the function call if production environment, just like Ray. Also a config flag to allow ds() in production would be nice.

Says cannot be opened because the developer cannot be verified

When I tried to install it on my M1 macbook air, it says this.
However I can open it by going inside the Application folder and right clicking and clicking on open.
Hope this will be fixed soon. It's a great tool. Thanks for making it.

LaraDumps For JS Environment

🛻 LaraDumps Feature Request

Summary

Extend LaraDumps functionality to support JavaScript/Node.js development environments like Node.js, Vue, React, etc., similar to the Spatie Ray tool

Why is this needed?

LaraDumps is a great tool for debugging and inspecting data in Laravel applications. However, as the web development landscape evolves, more and more applications are built using JavaScript frameworks and libraries like Vue, React, and Node.js. Developers working with these technologies would greatly benefit from having a tool similar to LaraDumps that allows them to easily inspect and debug their code during development.

Suporte ao PHP 7.3

Primeiro quero parabenizá-los pelo projeto, está muito bom, mas muito bom mesmo.
Queria muito usar a ferramenta mas por N motivos preciso usar o PHP 7.3 e a versão atual da ferramenta necessita do PHP 8.
Para usar fiz um fork do repositório aqui e estou usando aqui no meu projeto laravel. Falei com o Tio Jobs via coments do Youtube sobre isso.
Não sei se pretendem manter uma versão com suporte a versões anteriores ao PHP8 mas fica a minha contribuição.
Se desejarem manter uma tag para, por exemplo, faço um pr no repositório do que tenho aqui :)

Segue uma imagem dessa maravilha rodando

Não está debugando componente Livewire na versão 2.0.2

Depois que fiz a atualização pra nova versão, não estou mais conseguindo fazer o debug dos componentes Livewire. Procurei nas Releases Notes se foi removido essa opção e não encontrei nada sobre o assunto

[BUG] Empty values are not being displayed

Have you searched through other issues to see if your problem is already reported or has been fixed?

• Yes - I did not find it.
• No

Did you read the documentation?

• Yes - I did not find it.
• No

Have you tried to reconfigure LaraDumps?

To configure LaraDumps, run: php artisan ds:init.

• Yes - I didn't work.
• No, I believe this error is not related the configuration.

What is your project Environment?

• Laravel Valet
• Laravel Sail
• Docker
• XAMPP
• Laragon
• Other - please specify: ________

---

Describe the bug

What happened?

Null and "empty" values are not displayed on Laradumps

Steps to Reproduce the problem

ds('');
ds(0);
ds('0');
ds(null)

[BUG] Website download link not working (404)

Describe the bug

What happened?

Download link not working (404)

https://laradumps.dev/get-started/get-started/installation?id=desktop-app

[BUG]

🛻 LaraDumps Bug Report

❗ You MUST use this template to submit an issue or it will be CLOSED. ❗

Thank you for reporting a bug and helping us to improve our software!

Guidelines

🐛 We use GitHub Issues EXCLUSIVELY for tracking bugs and unexpected software behavior.

🙏 Questions like "How to...", "how can I...", "I would like to..." should be posted in the LaraDumps Discussions tab.

✍️ Give this report a short but meaningful title. Make it easy to spot for others who might be facing the same issue.

⚠️ Issues that do not describe a bug will be closed.

Information

Pre-steps

Have you searched through other issues to see if your problem is already reported or has been fixed?

• [x ] Yes - I did not find it.
• No

Did you read the documentation?

• [x ] Yes - I did not find it.
• No

Have you tried to reconfigure LaraDumps?

To configure LaraDumps, run: php artisan ds:init.

• [x ] Yes - I didn't work.
• No, I believe this error is not related the configuration.

Software Version

You can run composer show -i and npm list to list installed package with their versions.

Software	Version (exactly)
LaraDumps App	1.7.2
LaraDumps package	newest
Laravel	v9.40.1
Operating System	windows 10

What is your project Environment?

• Laravel Valet
• Laravel Sail
• Docker
• XAMPP
• Laragon
• [ x] Other - please specify: ________Laravel Homestead

---

Describe the bug

What happened?

I tried multiple addresses in .env but I never received anything when using ds(); on 'welcome' route as in an example. I am using simple Laravel Homestead implementation.

Steps to Reproduce the problem

First click on "FOO" then....

Suggestions

(Do you have any idea how we can fix it?)

Extra information

Screenshots

[BUG]Click on the Filename Lines No. refresh the laradumps windows

🛻 LaraDumps Bug Report

❗ You MUST use this template to submit an issue or it will be CLOSED. ❗

Thank you for reporting a bug and helping us to improve our software!

Guidelines

🐛 We use GitHub Issues EXCLUSIVELY for tracking bugs and unexpected software behavior.

🙏 Questions like "How to...", "how can I...", "I would like to..." should be posted in the LaraDumps Discussions tab.

✍️ Give this report a short but meaningful title. Make it easy to spot for others who might be facing the same issue.

⚠️ Issues that do not describe a bug will be closed.

Information

Pre-steps

Have you searched through other issues to see if your problem is already reported or has been fixed?

• Yes - I did not find it.
• No

Did you read the documentation?

• Yes - I did not find it.
• No

Have you tried to reconfigure LaraDumps?

To configure LaraDumps, run: php artisan ds:init.

• Yes - I didn't work.
• No, I believe this error is not related the configuration.

Software Version

You can run composer show -i and npm list to list installed package with their versions.

Software	Version (exactly)
LaraDumps App	v2.1.0
LaraDumps package	v.2.1.0
Laravel	v10.14.1
Operating System	macOS v13.4 (22F66)

What is your project Environment?

• Laravel Valet
• Laravel Sail
• Docker
• XAMPP
• Laragon
• Other - please specify: ________

---

Describe the bug

When I click on the Filename Lines No. refresh the laradumps windows. Previous logs all gone.

What happened?

I did click the filename:line_no expecting Go to Phpstorm as a result. However, I received the laradumps windows refresh.

Steps to Reproduce the problem

First click on "filename:line" then it happen

Suggestions

No idea

Extra information

This is the output when I runvendor/bin/laradumps configure

When I click Save. It show

Só vim elogiar! PERFEITO!

Caraca que massa isso que vocês fizeram, eu tava atraz de algo assim, eu não consegui colocar o xdebug, isso facilitou minha vida! parabéns a todos envolvidos!

[BUG] Erro ao rodar o configure

Erro na atualização do laradumps quando tento rodar o configure parece que não esta identificando o APP como aberto e não prossegue a configuração

[BUG]

Olá,
essa msg não sai da tela, ja fiz a atualização do package mas agora toda request abre esse modal:

Laradumps and WSL2

Hello guys,

how do you run Laradumps with WSL2?

I am using a testproject on WSL2 and run it through php artisan serve but anything is beeing dumped in the app.

Am I missing something?

Thanks in advance

Send Queries to defined screen

🛻 LaraDumps Feature Request

Summary

It would be really nice to send the queries to a defined sreen.

Why is this needed?

It would help to organize the output of the queries.

Suggested Solution(s)

ds()->toScreen('LaraDumps')->queriesOn('Check user query');

Related issue(s)/PR(s)

Queries are always sent to "screen 1".

[BUG] Trait "LaraDumps\LaraDumpsCore\Concerns\Traceable" not found

🛻 LaraDumps Bug Report

Information

Pre-steps

Have you searched through other issues to see if your problem is already reported or has been fixed?

• Yes - I did not find it.
• No

Did you read the documentation?

• Yes - I did not find it.
• No

Have you tried to reconfigure LaraDumps?

To configure LaraDumps, run: php artisan ds:init.

• Yes - I didn't work. I received the same error
• No, I believe this error is not related the configuration.

Software Version

You can run composer show -i and npm list to list installed package with their versions.

Software	Version (exactly)
LaraDumps App	2.4.3
LaraDumps package	v2.3.1
Laravel	9.52.16
Operating System	MacOS

What is your project Environment?

• Laravel Valet
• Laravel Sail
• Docker
• XAMPP
• Laragon
• Other - please specify: ________

---

Describe the bug

What happened?

I received "Trait "LaraDumps\LaraDumpsCore\Concerns\Traceable" not found" when trying to install LaraDumps. How to fix this?

Extra information

Screenshots

Melhorar a visualização de json

Fala Luan, procurei na documentação mas não encontrei nada parecido, tem hora que temos que usar mais de 1 endpoint de uma API utilizando o JSON do endpoint anterior, ao dar um dd no POSTMAN eu consigo pegar o JSON em string e jogar ele para o próximo endpoint, tentei a mesma coisa com o LARADUMPS mas a string se perde de vista ficando em uma só linha, tem algum comando para dar uma especie de beautfy no json para melhor leitura?

OBS, ds($json)->isJson() não serve pois este mostra o json como objeto.

OBS2, muito top o Laradumps, parabéns...

Laradumps don´t work in Laragon?

Laradumps don´t work in Laragon?

I did several tests and the desktop app cannot detect the log

My .env

DS_APP_HOST=127.0.0.1
DS_APP_PORT=8000
DS_SEND_QUERIES=true
DS_SEND_LOGS=true
DS_SEND_LIVEWIRE_COMPONENTS=true
DS_SEND_LIVEWIRE_FAILED_VALIDATION=true
DS_AUTO_CLEAR_ON_PAGE_RELOAD=true
DS_AUTO_INVOKE_APP=true
DS_PREFERRED_IDE=phpstorm

QUeries

From 1.6.0 I always have the query display enabled, why? the configuration is right and in the previous version it was fine

[BUG] Mailable dump with raw data fails

🛻 LaraDumps Bug Report

Information

Pre-steps

Have you searched through other issues to see if your problem is already reported or has been fixed?

• [ X] Yes - I did not find it.
• No

Did you read the documentation?

• [X ] Yes - I did not find it.
• No

Have you tried to reconfigure LaraDumps?

To configure LaraDumps, run: vendor/bin/laradumps configure.

• [ X] Yes - I didn't work.
• No, I believe this error is not related the configuration.

Software Version

You can run composer show -i and npm list to list installed package with their versions.

Software	Version (exactly)
LaraDumps App	v2.1.0
LaraDumps package	v2.1.0
LaraDumps core	v0.2.0
Laravel	9.52.10
Operating System	MAC

What is your project Environment?

• [X ] Laravel Valet
• Laravel Sail
• Docker
• XAMPP
• Laragon
• Other - please specify: ________

---

Describe the bug

What happened?

When sending and email with Raw data throws an error on laradump:

ERROR  Call to a member function getPath() on string in vendor/laradumps/laradumps/src/Payloads/MailPayload.php on line 36.

Steps to Reproduce the problem

Create a Mailable and add an attachment using fromData. For example:

public function attachments()
{
    return [
        Attachment::fromData(fn () => $this->csv, 'export.csv')
                ->withMime('text/csv'),
    ];
}

Suggestions

Change the MailPayload class to handle raw data,

[BUG] characters error in the linux desktop app

When you change any configuration and click save, the message in the image below appears

This happens in the Linux app installed by the snap store
distro Ubuntu 23.04

https://i.imgur.com/LlGtLfC.png

[BUG] Permission denied

🛻 LaraDumps Bug Report

❗ You MUST use this template to submit an issue or it will be CLOSED. ❗

Thank you for reporting a bug and helping us to improve our software!

Guidelines

🐛 We use GitHub Issues EXCLUSIVELY for tracking bugs and unexpected software behavior.

🙏 Questions like "How to...", "how can I...", "I would like to..." should be posted in the LaraDumps Discussions tab.

✍️ Give this report a short but meaningful title. Make it easy to spot for others who might be facing the same issue.

⚠️ Issues that do not describe a bug will be closed.

Information

Pre-steps

Have you searched through other issues to see if your problem is already reported or has been fixed?

• [X ] Yes - I did not find it.
• No

Did you read the documentation?

• [ X] Yes - I did not find it.
• No

Have you tried to reconfigure LaraDumps?

To configure LaraDumps, run: php artisan ds:init.

• Yes - I didn't work.
• [ X] No, I believe this error is not related the configuration.

Software Version

You can run composer show -i and npm list to list installed package with their versions.

Software	Version (exactly)
LaraDumps App	1.7.2
LaraDumps package	1.11.1
Laravel	10.9.0
Operating System	Windows 11 x64

What is your project Environment?

• Laravel Valet
• Laravel Sail
• Docker
• XAMPP
• Laragon
• [X ] Other - please specify: PHP CLI

---

Describe the bug

What happened?

I'm having an error whenever I try to do any action related to laradumps, in a Laravel project:

In LaraDumpsServiceProvider.php line 52:

require_once(<path to my project>\vendor\laradumps\laradumps\src./functions.php): Failed to open stream: Permission denied

Steps to Reproduce the problem

Install the package in a Laravel app.

Suggestions

Extra information

Screenshots

Please make a option to disable switching focus to laradumps

🛻 LaraDumps Feature Request

Summary

When I run my app, laradumps app focuses to the forefront. Can an option be added to disable it?

Why is this needed?

Laradumps gets focused to the front of other apps

Suggested Solution(s)

Add a option to prevent this from happening.

Related issue(s)/PR(s)

Let us know if this is related to any issue/request

Broken Installer for Windows 1.50

Describe the bug

What happened?

The latest installer for Windows ver 1.50 has an extraction error during the installation. I downloaded it thrice and had the problem repeat itself. The first time was automated from within Laradumps, the other 2 times were manual browser downloads.

Steps to Reproduce the problem

Download: https://github.com/laradumps/app/releases/download/v1.5.0/LaraDumps-Setup-1.5.0.exe
Install

Suggestions

Re-build the installer

Extra information