PHPackages                             kseven/userstamps - 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. [Database & ORM](/categories/database)
4. /
5. kseven/userstamps

ActiveLibrary[Database & ORM](/categories/database)

kseven/userstamps
=================

Laravel Userstamps provides an Eloquent trait which automatically maintains `created\_by` and `updated\_by` columns on your model, populated by the currently authenticated user in your application.

v1.0.0(11mo ago)01MITPHPPHP ^8.2CI failing

Since Jun 17Pushed 11mo agoCompare

[ Source](https://github.com/ksevendev/userstamps)[ Packagist](https://packagist.org/packages/kseven/userstamps)[ RSS](/packages/kseven-userstamps/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

 [![](./logo.svg)](./logo.svg)

[![Total Downloads](https://camo.githubusercontent.com/6eefb1baed67eb3950a7e8df6aed821f91023aa70ec0db411f2290a69124673d/68747470733a2f2f706f7365722e707567782e6f72672f6b736576656e2f757365727374616d70732f646f776e6c6f616473)](https://packagist.org/packages/kseven/userstamps)[![Latest Stable Version](https://camo.githubusercontent.com/8ab1e7d82cefab4f34db5f30a1b412b0fc3f9b8fec93496085e240b8aebbf3b4/68747470733a2f2f706f7365722e707567782e6f72672f6b736576656e2f757365727374616d70732f76)](https://packagist.org/packages/kseven/userstamps)[![License](https://camo.githubusercontent.com/b307c98073ba41b4a941638374ebdb0f1c5d493ca64a21669ea4d1569d19c815/68747470733a2f2f706f7365722e707567782e6f72672f6b736576656e2f757365727374616d70732f6c6963656e7365)](https://packagist.org/packages/kseven/userstamps)

Sobre o Laravel Userstamps
--------------------------

[](#sobre-o-laravel-userstamps)

O Laravel Userstamps fornece uma *trait* para Eloquent que mantém automaticamente as colunas `created_by` e `updated_by` no seu model, preenchidas com o usuário autenticado no momento.

Ao usar a *trait* `SoftDeletes` do Laravel, uma coluna `deleted_by` também será tratada por este pacote.

Instalação
----------

[](#instalação)

Este pacote requer Laravel 9 ou superior executando em PHP 8.2 ou superior.

Ele pode ser instalado usando o Composer:

```
composer require kseven/userstamps

```

Uso
---

[](#uso)

Seu model precisará incluir colunas `created_by` e `updated_by`, com valor padrão `null`.

Se estiver usando a *trait* `SoftDeletes` do Laravel, também precisará da coluna `deleted_by`.

O tipo das colunas deve corresponder ao tipo da coluna de ID na tabela de usuários.

Você pode criar as colunas de userstamp com:

```
$table->userstamps();
$table->userstampSoftDeletes();
```

Agora você pode usar a trait no seu model, e os userstamps serão mantidos automaticamente:

```
use KSeven\Userstamps\Traits\Userstamps;

class User extends Model {

    use Userstamps;
}
```

Opcionalmente, se quiser sobrescrever os nomes das colunas `created_by`, `updated_by` ou `deleted_by`, você pode definir constantes na sua classe. Certifique-se de que os nomes batem com os usados na sua migration:

```
use KSeven\Userstamps\Traits\Userstamps;

class User extends Model {

    use Userstamps;

    const CREATED_BY = 'alt_created_by';
    const UPDATED_BY = 'alt_updated_by';
    const DELETED_BY = 'alt_deleted_by';
}
```

Ao utilizar esta trait, relacionamentos auxiliares estarão disponíveis para recuperar o usuário que criou, atualizou e excluiu (ao usar `SoftDeletes`) o model:

```
$model->creator; // usuário que criou o model
$model->editor; // usuário que atualizou por último o model
$model->destroyer; // usuário que excluiu o model
```

Methods are also available to temporarily stop the automatic maintaining of userstamps on your models:

```
$model->stopUserstamping(); // para a atualização dos userstamps no model
$model->startUserstamping(); // retoma a atualização dos userstamps no model
```

Resolvendo Usuários
-------------------

[](#resolvendo-usuários)

Por padrão, os usuários são resolvidos usando o método `Auth::id()` do Laravel, retornando o ID do usuário autenticado no momento.

Casos de uso mais avançados são suportados com uma estratégia de resolução personalizada.

Neste exemplo, é usado um método personalizado para obter o ID:

```
use KSeven\Userstamps\Userstamps;

Userstamps::resolveUsing(
    fn () => auth()->user()->customUserIdResolutionMethod()
);
```

O método `Userstamps::resolveUsing` é ideal para ser utilizado no método `boot` do `AppServiceProvider`.

Soluções Alternativas
---------------------

[](#soluções-alternativas)

Este pacote funciona conectando-se aos eventos de modelo do Eloquent, estando sujeito às mesmas limitações desses listeners.

Se você fizer alterações que ignoram o Eloquent, os eventos não serão disparados e os userstamps não serão atualizados.

Isso geralmente acontece ao realizar atualizações ou exclusões em massa nos modelos ou em seus relacionamentos.

Neste exemplo, os relacionamentos são atualizados via Eloquent e os userstamps **serão** mantidos:

```
$model->foos->each(function ($item) {
    $item->bar = 'x';
    $item->save();
});
```

Neste exemplo, os relacionamentos são atualizados em massa, ignorando o Eloquent. Os userstamps **não serão** mantidos:

```
$model->foos()->update([
    'bar' => 'x',
]);
```

Como alternativa, dois métodos auxiliares estão disponíveis — `updateWithUserstamps` e `deleteWithUserstamps`. Eles funcionam como update e delete, mas garantem que as colunas `updated_by` e `deleted_by` sejam atualizadas no modelo.

Você geralmente não precisará usar esses métodos, a não ser que esteja fazendo atualizações em massa que ignoram os eventos do Eloquent.

Neste exemplo, os modelos são atualizados em massa e os userstamps **não serão** mantidos:

```
$model->where('name', 'foo')->update([
    'name' => 'bar',
]);
```

Neste exemplo, os modelos são atualizados em massa com o método auxiliar e os userstamps **serão** mantidos:

```
$model->where('name', 'foo')->updateWithUserstamps([
    'name' => 'bar',
]);
```

Licença
-------

[](#licença)

Este software de código aberto está licenciado sob a [MIT Licença](https://opensource.org/licenses/MIT).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance52

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

336d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/370be5a4a8a82b20f3c9a77adc97316236c3473f87419f3595b5080bf5252bf0?d=identicon)[kseven](/maintainers/kseven)

---

Top Contributors

[![ksevendev](https://avatars.githubusercontent.com/u/32661918?v=4)](https://github.com/ksevendev "ksevendev (4 commits)")

---

Tags

laraveleloquentuserstampscreated\_byupdated\_bydeleted\_by

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/kseven-userstamps/health.svg)

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

###  Alternatives

[wildside/userstamps

Laravel Userstamps provides an Eloquent trait which automatically maintains `created\_by` and `updated\_by` columns on your model, populated by the currently authenticated user in your application.

7511.7M13](/packages/wildside-userstamps)[cybercog/laravel-love

Make Laravel Eloquent models reactable with any type of emotions in a minutes!

1.2k302.7k1](/packages/cybercog-laravel-love)[cviebrock/eloquent-taggable

Easy ability to tag your Eloquent models in Laravel.

567694.8k3](/packages/cviebrock-eloquent-taggable)[reedware/laravel-relation-joins

Adds the ability to join on a relationship by name.

2121.2M13](/packages/reedware-laravel-relation-joins)[highsolutions/eloquent-sequence

A Laravel package for easy creation and management sequence support for Eloquent models with elastic configuration.

121130.3k](/packages/highsolutions-eloquent-sequence)[toponepercent/baum

Baum is an implementation of the Nested Set pattern for Eloquent models.

3154.7k](/packages/toponepercent-baum)

PHPackages © 2026

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