PHPackages                             fanout/laravel-grip - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. fanout/laravel-grip

ActiveLibrary[API Development](/categories/api)

fanout/laravel-grip
===================

GRIP for Laravel

v2.1.0(2y ago)912.5k↓25%1MITPHP

Since Jul 16Pushed 2y ago5 watchersCompare

[ Source](https://github.com/fanout/laravel-grip)[ Packagist](https://packagist.org/packages/fanout/laravel-grip)[ RSS](/packages/fanout-laravel-grip/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (4)Used By (0)

laravel-grip
------------

[](#laravel-grip)

GRIP library for [Laravel](https://laravel.com/), provided as a Laravel package.

Minimum supported version of Laravel is 7.0, but it may work with older versions.

Supported GRIP servers include:

- [Pushpin](http://pushpin.org/)
- [Fastly Fanout](https://docs.fastly.com/products/fanout)

This library also supports legacy services hosted by [Fanout](https://fanout.io/) Cloud.

Authors: Katsuyuki Omuro , Madeline Boby

### Introduction

[](#introduction)

[GRIP](https://pushpin.org/docs/protocols/grip/) is a protocol that enables a web service to delegate realtime push behavior to a proxy component, using HTTP and headers.

`laravel-grip` parses the `Grip-Sig` header in any requests to detect if they came through a GRIP proxy, and provides your route handler with tools to handle such requests. This includes access to information about whether the current request is proxied or is signed, as well as methods to issue any hold instructions to the GRIP proxy.

Additionally, `laravel-grip` also handles [WebSocket-Over-HTTP processing](https://pushpin.org/docs/protocols/websocket-over-http/) so that WebSocket connections managed by the GRIP proxy can be controlled by your route handlers.

### Installation

[](#installation)

Install the library.

```
composer require fanout/laravel-grip
```

This brings in the library, as well as installs the middleware into your Laravel application's stack by using the providers mechanism of Composer.

#### Configuration

[](#configuration)

`laravel-grip` can be configured by adding a file called `./config/grip.php` to your Laravel application. It should look like this:

```