PHPackages                             aliziodev/laravel-gmail-unique - 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. [Validation & Sanitization](/categories/validation)
4. /
5. aliziodev/laravel-gmail-unique

ActiveLibrary[Validation & Sanitization](/categories/validation)

aliziodev/laravel-gmail-unique
==============================

A Laravel package that normalizes Gmail addresses during validation to prevent duplicate user registrations with Gmail's dot variations and plus aliases, ideal for SaaS applications with trial subscriptions.

v1.0.1(1y ago)15921MITPHPPHP ^8.1|^8.2

Since May 3Pushed 1y ago1 watchersCompare

[ Source](https://github.com/aliziodev/laravel-gmail-unique)[ Packagist](https://packagist.org/packages/aliziodev/laravel-gmail-unique)[ RSS](/packages/aliziodev-laravel-gmail-unique/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (3)Used By (0)

Laravel Gmail Unique
====================

[](#laravel-gmail-unique)

[![Packagist License](https://camo.githubusercontent.com/e60623f508586f049d48cfb8396ee411b0c9bc3be174381a1893c37462a3c1e5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e63652d4d49542d626c7565)](https://github.com/aliziodev/laravel-gmail-unique/blob/main/LICENSE)[![Latest Stable Version](https://camo.githubusercontent.com/649c0677228942d63e6871f53df8e7db68a68e184e76dc019d17081c2eb73bd7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c697a696f6465762f6c61726176656c2d676d61696c2d756e697175653f6c6162656c3d537461626c65)](https://packagist.org/packages/aliziodev/laravel-gmail-unique)[![Total Downloads](https://camo.githubusercontent.com/764e2cf1acf569458b73277e06a9b73ae12661962bbad08a23257961861a7f78/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c697a696f6465762f6c61726176656c2d676d61696c2d756e697175652e7376673f6c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/aliziodev/laravel-gmail-unique)[![PHP Version](https://camo.githubusercontent.com/5a1fab0c11c63695cd26195fd6fa9ee0d3054fd0835d1a16b483e057546480a6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f616c697a696f6465762f6c61726176656c2d676d61696c2d756e697175652e737667)](https://packagist.org/packages/aliziodev/laravel-gmail-unique)[![Laravel Version](https://camo.githubusercontent.com/732e3493fc24f35c7cb618df753d98a2d3a541c56d779211d596937e6eb0754e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302e782d726564)](https://packagist.org/packages/aliziodev/laravel-gmail-unique)[![Laravel Version](https://camo.githubusercontent.com/72f904fd603ff495f238fe71437367d4aa103ea72f48c4ee20b2e3a1629ef296/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e782d726564)](https://packagist.org/packages/aliziodev/laravel-gmail-unique)[![Laravel Version](https://camo.githubusercontent.com/5b99ec644e12357132ddb95970822afd67efedef92fcccb6270926adebd8b101/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e782d726564)](https://packagist.org/packages/aliziodev/laravel-gmail-unique)

Laravel Gmail Unique is a package that normalizes Gmail addresses during validation to prevent duplicate user registrations with Gmail's dot variations and plus aliases. Gmail treats addresses like , , and  as the same account, but standard validation treats them as different emails.

According to Google's official documentation [Google: Getting messages sent to a dotted version of my address](https://support.google.com/mail/answer/10313#zippy=%2Cgetting-messages-sent-to-a-dotted-version-of-my-address) , if you add dots to a Gmail address, you'll still get that email. For example, if your email is , you own all dotted versions of your address:

-
-
-

This package ensures that your application recognizes these variations as the same email address, preventing duplicate accounts and improving user experience. This is especially recommended for SaaS systems with trial subscriptions to prevent users from creating multiple trial accounts using Gmail variations.

Features
--------

[](#features)

- Normalizes Gmail addresses by removing dots and plus aliases
- Prevents duplicate user registrations with Gmail variations
- Easy integration with Laravel's validation system
- Configurable for custom domains and email column names
- Works with Laravel's Eloquent models via a simple trait

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

[](#installation)

You can install the package via composer:

```
composer require aliziodev/laravel-gmail-unique
```

After installation, you can use the package's install command:

```
php artisan gmail-unique:install
```

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

[](#configuration)

After publishing the configuration, you can modify the settings in `config/gmail-unique.php` :

```
return [
    // Email domains to normalize (default: gmail.com and googlemail.com)
    'domains' => ['gmail.com', 'googlemail.com'],

    // The column name used for email in your database (default: email)
    'email_column' => 'email',

    // Error message for duplicate Gmail addresses
    'error_message' => 'This email is already taken (normalized Gmail detected).'
];
```

Usage
-----

[](#usage)

### Using the Trait

[](#using-the-trait)

The simplest way to use this package is by adding the `HasNormalizedEmail` trait to your User model:

```