spatie/laravel-artisan-dd

Run dd from your commandline

Quickly dd anything from the commandline

, _(*1)

Laravel's tinker command allows to run any code you want as if you are inside your Laravel app. But if you want to run a single line of code if can be a bit bothersome. You must start up tinker, type the code, press enter, and quit tinker., _(*2)

This package contains an Artisan command to dd anything from the commandline. No need to start and quit tinker anymore., _(*3)

# dumps the first user
php artisan dd "User::first()"

Support us

, _(*4)

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products., _(*5)

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall., _(*6)

Installation

You can install the package via composer:, _(*7)

composer require spatie/laravel-artisan-dd

You must register the Spatie\ArtisanDd\DdCommand in the console kernel., _(*8)

// app/Console/Kernel.php

protected $commands = [
    ...
    \Spatie\ArtisanDd\DdCommand::class,
];

Usage

You can pass any code you want to execute as the first argument. The result will be dumped to the screen., _(*9)

``` bash php artisan dd "bcrypt('secret')";, <sub>(*10)</sub>

Multiple pieces of code can be dumped in one go:

``` bash
php artisan dd "bcrypt('secret')" "bcrypt('another-secret')"; 

Support for short class names

Under the hood registers short class names using our laravel-tinker-tools package. So instead of, <sub>(*11)</sub>

php artisan dd "\App\Models\NewsItem::first()"; 

you can do this:, <sub>(*12)</sub>

php artisan dd "NewsItem::first()"; 

A word to the wise

This command can run arbitrary code by using PHP's eval. Be aware that this can be potentially dangerous. By default the command will only run in a local environment. You can make it run in other environments by setting an ALLOW_DD_COMMAND enviroment variable to true., <sub>(*13)</sub>

Changelog

Please see CHANGELOG for more information what has changed recently., <sub>(*14)</sub>

Testing

bash $ composer test, <sub>(*15)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*16)</sub>

Security

If you've found a bug regarding security please mail security@spatie.be instead of using the issue tracker., <sub>(*17)</sub>

Credits

• Freek Van der Herten
• All Contributors

Idea: Sebastian De Deyne, <sub>(*18)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*19)</sub>