Download the PHP package kseven/userstamps without Composer
On this page you can find all versions of the php package kseven/userstamps. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kseven/userstamps
More information about kseven/userstamps
Files in kseven/userstamps
Package userstamps
Short Description 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.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package 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
Este pacote requer Laravel 9 ou superior executando em PHP 8.2 ou superior.
Ele pode ser instalado usando o Composer:
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:
Agora você pode usar a trait no seu model, e os userstamps serão mantidos automaticamente:
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:
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:
Methods are also available to temporarily stop the automatic maintaining of userstamps on your models:
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:
O método Userstamps::resolveUsing é ideal para ser utilizado no método boot do AppServiceProvider.
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:
Neste exemplo, os relacionamentos são atualizados em massa, ignorando o Eloquent. Os userstamps não serão mantidos:
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:
Neste exemplo, os modelos são atualizados em massa com o método auxiliar e os userstamps serão mantidos:
Licença
Este software de código aberto está licenciado sob a MIT Licença.
