Dispatch Laravel Jobs Via Artisan

 Laravel Artisan Dispatchable is a package by Spatie to register queue jobs as Artisan commands. The Laravel scheduler can schedule queue jobs that do not block the scheduler, but this approach has one downside:

You have to choose between using an artisan command + blocking the scheduler on the one hand, and job + not blocking the scheduler on the other hand.

Using our package, you don't have to make that choice anymore. When letting your job implement Spatie's ArtisanDispatchable, you will not block the scheduler and can still execute the logic via Artisan.

The way this package works is that you implement this packages ArtisanDispatchable interface, and your job is available as an artisan command:

 1use Illuminate\Contracts\Queue\ShouldQueue;
 2use Spatie\ArtisanDispatchable\Jobs\ArtisanDispatchable;
 3 
 4class ProcessPodcast implements ShouldQueue, ArtisanDispatchable
 5{
 6    public function handle()
 7    {
 8        // perform some work...
 9    }
10}

The neat part about this package is that it comes with conventions that allow your job to be available to artisan without any more work, using the kebab-case of the class name:

1# Execute via Artisan
2php artisan process-podcast
3 
4# Put your job on the queue instead of executing immediately
5php artisan process-podcast --queued
6 
7# Eloquent models as constructor arguments
8# Podcast model instance as a constructor argument
9php artisan process-podcast --podcast="1234"

While this package has conventions of command names, the package allows you to override both the command name and description.

You can learn more about this package, get full installation instructions, and view the source code on GitHub. Also, check out the announcement post by Freek Van der Herten.

Read More

Build Typescript Interfaces for Laravel Models

Laravel Typescript is a package that lets you generate TypeScript interfaces from your Laravel models. The example from the documentation demonstrates how you can take a complex model with database columns and relationships and quickly generate the TypeScript interfaces for them:

 1class Product extends Model
 2{
 3    public function category(): BelongsTo
 4    {
 5        return $this->belongsTo(Category::class);
 6    }
 7 
 8    public function features(): HasMany
 9    {
10        return $this->hasMany(Feature::class);
11    }
12}

The above model will translate into the following interface:

 1declare namespace App.Models {
 2    export interface Product {
 3        id: number;
 4        category_id: number;
 5        name: string;
 6        price: number;
 7        created_at: string | null;
 8        updated_at: string | null;
 9        category?: App.Models.Category | null;
10        features?: Array<App.Models.Feature> | null;
11    }
12    // ...
13}

This package can support database columns, model relationships, model accessors, and planned support for casted attributes.

Finally, here's an example of how you might use this package with a Vue 3 component:

 1import { defineComponent, PropType } from "vue";
 2 
 3export default defineComponent({
 4    props: {
 5        product: {
 6            type: Object as PropType<App.Models.Product>,
 7            required: true,
 8        },
 9    },
10}

You can learn more about this package, get full installation instructions, and view the source code on GitHub.

Read More