https://github.com/qustavo/laravel-fragment-caching

Fragment Caching support for the Laravel Framework
https://github.com/qustavo/laravel-fragment-caching

Last synced: 3 months ago
JSON representation

Fragment Caching support for the Laravel Framework

• Host: GitHub
• URL: https://github.com/qustavo/laravel-fragment-caching
• Owner: qustavo
• License: mit
• Archived: true
• Created: 2014-02-09T03:27:48.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2016-03-08T09:48:36.000Z (over 8 years ago)
• Last Synced: 2024-07-22T23:29:46.488Z (3 months ago)
• Language: PHP
• Homepage:
• Size: 17.6 KB
• Stars: 34
• Watchers: 3
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Not supported [![No Maintenance Intended](http://unmaintained.tech/badge.svg)](http://unmaintained.tech/)

=============

This project is not supported anymore, you can try [matryoshka](https://github.com/laracasts/matryoshka) instead.

laravel-fragment-caching

========================

Add a Fragment caching support helper. [Blog post](http://gustaf.espontanea.io/blog/2014/02/09/laravel-fragment-caching)

Installation

============

Run: `composer require gchaincl/laravel-fragment-caching:dev-master`

or

 * add: 	`"require": { "gchaincl/laravel-fragment-caching": "dev-master" }, `to composer.json

 * run: `composer install`

 * add: The following to your `app/config/app.php`

```php

$providers => array(

  ...

 	'Gchaincl\LaravelFragmentCaching\ViewServiceProvider',

)

``` 

Usage

=====

In your view:

```php



@foreach ($posts as $post)


@cache("post" . $post->id)

    
 {{ link_to_route('post.show', $post->title, $post->id) }} ({{ $post->user->username }})

@endcache


@endforeach



```


First time we load that view, Framework will run 3 queries:

```sql

select * from "posts"

select * from "users" where "users"."id" = '5' limit 1

select * from "users" where "users"."id" = '5' limit 1

```

Second time, as fragments are already cached, there will be just one query:

```sql

select * from "posts"

```

Conditional caching

===================

In situations where you don't always want to cache a block you can use `@cacheif($condition, $cacheId)`

```php

{{-- Only use the cache for guests, admins will always get content rendered from the template --}}

@cacheif( Auth::guest(), "post" . $post->id)

    
 {{ link_to_route('post.show', $post->title, $post->id) }} (@if (Auth::guest()) {{ $post->user->username }} @else {{ $post->user->email }} @endif)

@endcacheif

```


Tip

---

To update view rendering on model changes, you should expire your fragments:

```php

// app/model/Post.php

class Post extends Eloquent {

    public static function boot() {

        parent::boot();

        static::updated(function($model) {

            Cache::forget("post" . $model->id);

        });

    }

}

```