Snappy Image Wrapper for Laravel

 Snappy is a PHP library allowing thumbnails, snapshots, and PDF generation from a URL or HTML page. Barry vd. Heuvel is the author of a Laravel Snappy (which has been around since Laravel 5), making it even easier to integrate with Laravel:

 1// Generate a PDF From a view
 2$pdf = PDF::loadView('pdf.invoice', $data);
 3$pdf->download('invoice.pdf');
 4 
 5// Generate a PDF from a URL
 6PDF::loadFile('https://www.github.com')
 7     ->inline('github.pdf');
 8 
 9// Change the orientation and paper size
10PDF::loadHtml($html)
11     ->setPaper('a4')
12     ->setOrientation('landscape')
13     ->setOption('margin-bottom', 0)
14     ->save('myfile.pdf');

Along with some nifty convenience methods, Snappy for Laravel has testing features to help you assert things that Snappy generates:

1PDF::fake();
2 
3// Perform order shipping...
4 
5PDF::assertViewIs('view-pdf-order-shipping');
6PDF::assertSee('Name');

Snappy requires the wkhtmltopdf (available on Windows, Mac, and Linux), which is a command-line tool to render HTML into PDF and various image formats. Installation instructions are available in the readme so you can ensure wkhtmltopdf is installed and the path configured properly.

Read More

Organize Laravel Applications With Actions

 The Laravel actions package provides a new way to organize your Laravel applications’ logic by focusing on actions. Using this technique, you can execute the same class as a controller, a command, a job, and a listener.

In v2, the package no longer extends an Action class but instead uses traits to provide helper methods and detect which context to execute a class.

Here’s a simple example of an action class that we can use as a controller, an object, a job, a listener, etc.:

 1namespace App\Authentication\Actions;
 2 
 3use Lorisleiva\Actions\Concerns\AsAction;
 4 
 5class UpdateUserPassword
 6{
 7    use AsAction;
 8 
 9    public function handle(User $user, string $newPassword)
10    {
11        $user->password = Hash::make($newPassword);
12        $user->save();
13    }
14}

And here are the various ways you can run this class:

 1// Equivalent to "app(UpdateUserPassword::class)".
 2UpdateUserPassword::make();
 3 
 4// Equivalent to "UpdateUserPassword::make()->handle($user, 'secret')".
 5UpdateUserPassword::run($user, 'secret');
 6 
 7// As a controller defined in routes
 8Route::put(
 9    'auth/password',
10    UpdateUserPassword::class
11)->middleware('auth');

You can even define controller validation within the UpdateUserPassword action:

1public function rules()
2{
3    return [
4        'current_password' => ['required'],
5        'password' => ['required', 'confirmed'],
6    ];
7}

You can even run this class as a command. Check out the Basic usage documentation for details on defining actions capable of running as a command.

Read More