laravel-pjax is a pjax middleware for Laravel >5.1.

By adding pjax & jQuery to your web application, ajax and pushState can be used to deliver a fast browsing experience with real permalinks, page titles, and a working back button.

This middleware adds some functionality that other middleware (at the time of writing) did not provide, such as container whitelists and faster page filtering.

I wanted to have some additional functionality for loading "pjax" AJAX requests, so I quickly threw together this package.

Install the package:

# composer require timgws/laravel-pjax

Add the middleware to your app's kernel configuration. The higher the better!

// app/Http/Kernel.php

// ...
protected $middleware = [
    // ...
    \timgws\pjax\Middleware::class,
];

Add the service provider:

// config/app.php

// ...
    'providers' => [
        // ... Laravel providers

        timgws\pjax\ServiceProvider::class,

        // ... app providers ...
    ],

Publish the config file:

php artisan vendor:publish --provider="timgws\pjax\ServiceProvider" --tag="config"

and test!

One major difference between this module and other Laravel pjax middleware is that you can limit which containers can be requested via HTTP headers.

You may wish to edit the pjax.php config file to limit valid_containers

return [
    'valid_containers' => [
        '#pjax-container', '.content'
    ]
];

See https://github.com/defunkt/jquery-pjax#usage for further information.

Inside config.php, set the layout version to force a hard reload of the requested page when a client is on an old version of the layout.

Bumping the version will force clients to do a full reload the next request getting the new layout and assets

Set the version to something like 'v1'. Also, you will need to add a meta tag like this to the base layout:

      <meta http-equiv="x-pjax-version" content="v1">

      return [
          'layout_version' => 'v1'
      ];

See https://github.com/defunkt/jquery-pjax#usage for further information.

• Tim Groeneveld

• MIT License (see LICENSE file)

• Build test suite