PHPackages                             agilesdesign/pseudo - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. agilesdesign/pseudo

ActiveLibrary[Authentication & Authorization](/categories/authentication)

agilesdesign/pseudo
===================

Guest user library for Laravel

v1.0.0-rc.1(8y ago)1212.3k↓100%6[1 issues](https://github.com/jrseliga/pseudo/issues)MITPHPPHP 7.\*CI failing

Since Nov 22Pushed 7y agoCompare

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

READMEChangelog (3)Dependencies (3)Versions (5)Used By (0)

pseudo
======

[](#pseudo)

Guest user library for Laravel

Branchmaster[![build status](https://camo.githubusercontent.com/f204877495a1e7db45e3c80b2753adacb372056adcc64c4244d3be52ecc82022/68747470733a2f2f6769746c61622e636f6d2f6167696c657364657369676e2f70736575646f2f6261646765732f6d61737465722f6275696c642e737667)](https://gitlab.com/agilesdesign/pseudo/commits/master)[![coverage report](https://camo.githubusercontent.com/f7fdf4a737e113c690b0649762d5dc94c37a62aadaac663df48109905cfea30f/68747470733a2f2f6769746c61622e636f6d2f6167696c657364657369676e2f70736575646f2f6261646765732f6d61737465722f636f7665726167652e737667)](https://gitlab.com/agilesdesign/pseudo/commits/master)dev[![build status](https://camo.githubusercontent.com/fe2c398449ac48bf45cc3d6dcf497c0dbafc52eb82d01a9e95e717be40379a72/68747470733a2f2f6769746c61622e636f6d2f6167696c657364657369676e2f70736575646f2f6261646765732f6465762f6275696c642e737667)](https://gitlab.com/agilesdesign/pseudo/commits/dev)[![coverage report](https://camo.githubusercontent.com/3ef8242f00e6795c03fe38b1198ed8cee662056f84befa1ed07759c6835cf019/68747470733a2f2f6769746c61622e636f6d2f6167696c657364657369676e2f70736575646f2f6261646765732f6465762f636f7665726167652e737667)](https://gitlab.com/agilesdesign/pseudo/commits/dev)Description
-----------

[](#description)

pseudo adds the ability for guests permissions within Laravel's authentication functionality.

Installation
------------

[](#installation)

##### Include through composer

[](#include-through-composer)

`composer require agilesdesign/pseudo`

##### Add to provider list

[](#add-to-provider-list)

```
'providers' => [
    Pseudo\Providers\PseudoServiceProvider::class,
];
```

Overview
--------

[](#overview)

Comparison to default Laravel behavior

```
Auth::check() // true if User false if Pseudo/Contracts/GuestContract
```

```
Auth::user() // returns instance of Pseudo/Contracts/GuestContract instead of null if no user found
```

```
@can() // no longer automatically fails if not authenticated, allows Gate to be checked
```

Configuration
-------------

[](#configuration)

#### Update Guard Driver(s)

[](#update-guard-drivers)

`config/auth.php`

```
'guards' => [
    // To use with web guard
    'web' => [
        'driver' => 'pseudo',
        'provider' => 'users',
    ],

    // To use with api guard
    'api' => [
        'driver' => 'pseudo-token',
        'provider' => 'users',
    ],
],
```

#### Register Service Provider

[](#register-service-provider)

> Manually registering the ServiceProvider is only necessary if your Laravel application is version 5.4.\* or before. `config/app.php`

```
'providers' => [
    /*
     * Package Service Providers...
     */
    \Pseudo\Providers\PseudoServiceProvider::class,
],
```

Usage
-----

[](#usage)

An instance of `Pseudo\Auth\Guest` is resolved from Laravel's Service Container when `Pseudo/Contracts/GuestContract` is requested.

This binding is registered in the supplied ServiceProvider:

```
public function register()
{
    $this->app->bind(GuestContract::class, Guest::class);
}
```

You may override this by providing your own `GuestUser` class that implements `Pseudo/Contracts/GuestContract` and rebinding the interface:

```
class GuestUser extends User implements GuestContract
{
    //You can override any attribute by using Eloquent Accessors
    public function getNameAttribute(){
        return 'Guest User';
    }
}
```

```
this->app->bind(\Pseudo\Contracts\GuestContract::class, \App\GuestUser::class);
```

Policy checks can still be type-hinted for Laravel's `App\User` since `Pseudo\Auth\Guest` extends it.

##### Example

[](#example)

```
Gate::define('create-article', function ($user, $article) {
    if($user instanceof Pseudo\Auth\Guest)
    {
      // logic for guest
    }
    else
    {
      // logic for authenticated
    }
});
```

###  Health Score

30

—

LowBetter than 65% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~125 days

Total

3

Last Release

3206d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/22e0796a6ce5a744ca1e68660fa49b9f86fa3e2cc6c0787c872281a16776df7a?d=identicon)[jrseliga](/maintainers/jrseliga)

---

Top Contributors

[![jrseliga](https://avatars.githubusercontent.com/u/3277067?v=4)](https://github.com/jrseliga "jrseliga (30 commits)")[![hailwood](https://avatars.githubusercontent.com/u/709773?v=4)](https://github.com/hailwood "hailwood (1 commits)")

---

Tags

authenticationauthorizationlaravelphp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/agilesdesign-pseudo/health.svg)

```
[![Health](https://phpackages.com/badges/agilesdesign-pseudo/health.svg)](https://phpackages.com/packages/agilesdesign-pseudo)
```

###  Alternatives

[namshi/jose

JSON Object Signing and Encryption library for PHP.

1.8k99.6M101](/packages/namshi-jose)[league/oauth1-client

OAuth 1.0 Client Library

99698.8M106](/packages/league-oauth1-client)[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[gesdinet/jwt-refresh-token-bundle

Implements a refresh token system over Json Web Tokens in Symfony

70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[league/oauth2-google

Google OAuth 2.0 Client Provider for The PHP League OAuth2-Client

41721.2M118](/packages/league-oauth2-google)[illuminate/auth

The Illuminate Auth package.

9327.3M1.0k](/packages/illuminate-auth)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)