Last Modified

Last Modified for Laravel

Setting the response code 304 Not Modified in the absence of content changes.

Installation

To get the latest version of Last Modified simply require the project using Composer:

$ composer require dragon-code/last-modified

Instead, you may of course manually update your require block and run composer update if you so choose:

{
"require": {
"dragon-code/last-modified": "^4.0"
}
}

And call php artisan vendor:publish --provider="DragonCode\LastModified\ServiceProvider" command.

Note

If you were using version 2.0 or less, run the php artisan migrate command. If this is your first time here, then you do not need to install this command, since, starting from version 2.1, we refused to store data in the database, replacing the storage with a cache.

Next, add middleware in $middlewareGroups > web section in app/Http/Kernel.php file:

useDragonCode\LastModified\Middlewares\CheckLastModified;
protected$middlewareGroups = [
'web' => [
CheckLastModified::class,
]
]

IMPORTANT! It's recommended to add a middleware after CheckForMaintenanceMode::class.

The system works like this: when opening a page, the middleware checks if there is an entry in the database table about this link. If there is, it checks the Last-Modified header key and returns either 200 or 304 code.

To add records to the table, it is recommended to create a console command in your application using the following example:

Create / Update

useCarbon\Carbon;
useDragonCode\LastModified\Resources\Item;
useDragonCode\LastModified\Services\LastModified;
publicfunctionhandle()
{
$collection_1 = Foo::whereIsActive(true)->get();
$collection_2 = Bar::where('id', '>', 50)->get();
$collection_3 = Baz::query()->get();
$builder_1 = Foo::whereIsActive(true);
$builder_2 = Bar::where('id', '>', 50);
$builder_3 = Baz::query();
$model_1 = Foo::whereIsActive(true)->first();
$model_2 = Bar::where('id', '>', 50)->first();
$model_3 = Baz::query()->first();
$item_1 = Item::make(['url' => 'https://example.com/foo', 'updated_at' => Carbon::now());
$item_2 = Item::make(['url' => 'https://example.com/bar', 'updated_at' => Carbon::parse('2018-03-02'));
$item_3 = Item::make(['url' => 'https://example.com/baz?id=1', 'updated_at' => Carbon::now());
LastModified::make()
->collections($collection_1, $collection_2, $collection_3)
->builders($builder_1, $builder_2, $builder_3)
->models($model_1, $model_2, $model_3)
->manual($item_1, $item_2, $item_3)
->update();
}

IMPORTANT! The url attribute must be available for models.

If the model has no attribute url, it should be created.

For example:

protected getUrlAttribute(): string
{
$slug = $this->slug;
returnroute('page.show', compact('slug'));
}

Delete

useCarbon\Carbon;
useDragonCode\LastModified\Resources\Item;
useDragonCode\LastModified\Services\LastModified;
publicfunctionhandle()
{ $collection_1 = Foo::whereIsActive(false)->get();
$collection_2 = Bar::whereIn('id', [50, 60, 62, 73])->get();
$builder_1 = Foo::whereIsActive(true);
$builder_2 = Bar::where('id', '>', 50);
$builder_3 = Baz::query();
$model_1 = Foo::whereIsActive(false)->first();
$model_2 = Bar::whereIn('id', [50, 60, 62, 73])->first();
$item_1 = Item::make(['url' => 'https://example.com/foo', 'updated_at' => Carbon::now()]);
$item_2 = Item::make(['url' => 'https://example.com/bar', 'updated_at' => Carbon::now()]);
LastModified::make()
->collections($collection_1, $collection_2, $collection_3)
->builders($builder_1, $builder_2, $builder_3)
->models($model_1, $model_2, $model_3)
->manual($item_1, $item_2, $item_3)
->delete();
}

Observer

In order to reduce the load on the database and free up the crown queue, it is recommended to use the observer to update the records:

namespaceApp\Observers;
useIlluminate\Database\Eloquent\Model;
useDragonCode\LastModified\Services\LastModified;
class LastModifiedObserver
{
publicfunctionsaving(Model$model)
{
LastModified::make()
->models($model)
->update();
}
publicfunctiondeleting(Model$model)
{
LastModified::make()
->models($model)
->delete();
}
}

Don't forget to add the link to the service provider:

namespaceApp\Providers;
useApp\Observers\LastModifiedObserver;
useIlluminate\Foundation\Auth\User;
useIlluminate\Support\ServiceProvider;
class ObserverServiceProvider extends ServiceProvider
{
publicfunctionboot()
{
Page::observe(LastModifiedObserver::class);
News::observe(LastModifiedObserver::class);
// ...
}
}

License

This package is licensed under the MIT License.