PHPackages uteq/signature - 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. [Utility & Helpers](/categories/utility) 4. / 5. uteq/signature ActiveLibrary[Utility & Helpers](/categories/utility) uteq/signature ============== A Package that gives the ability to create (temporary) links for usage on websites, emails and more 1.1.0(5y ago)18171MITPHPPHP ^7.4|^8.0CI failing Since Dec 21Pushed 5y ago1 watchersCompare [ Source](https://github.com/uteq/signature)[ Packagist](https://packagist.org/packages/uteq/signature)[ Docs](https://github.com/uteq/signature)[ GitHub Sponsors](https://github.com/uteq)[ RSS](/packages/uteq-signature/feed)WikiDiscussions master Synced 3w ago READMEChangelog (3)Dependencies (4)Versions (4)Used By (0) Signature ========= [](#signature) [![Latest Version on Packagist](https://camo.githubusercontent.com/b40ef6495d91ea322c1a0a5ed681c3f28842970995aa1448d4e40439e3146351/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f757465712f7369676e61747572652e737667)](https://packagist.org/packages/uteq/signature)[![Tests](https://github.com/uteq/signature/workflows/Tests/badge.svg)](https://github.com/uteq/signature/actions?query=workflow%3ATests+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/2b6a2d4a373f419653957c8148358fac6872a451d5b19de4d8629786de68a335/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f757465712f7369676e61747572652e737667)](https://packagist.org/packages/uteq/signature) This laravel package gives you the ability to create action links that can be used everywhere on your site (including emails). A simple url can be created by the example below. The first parameter is the class to execute the action when the user visits the link, the second parameter is an array that holds all the data to be provided to the action class. The payload automatically gets encrypted when entering the database. ``` $url = SignatureFacade::make(Action::class, ['email' => 'dirk@example.com'])->get(); ``` The get() function returns a complete url based on the APP\_URL in the .env file and the 'action\_route' in the signature config Example action class: ``` class Action { public function __invoke($payload) { // Do something return redirect('login'); } } ``` Installation ------------ [](#installation) You can install the package via composer: ``` composer require uteq/signature ``` You can publish and run the migrations with: ``` php artisan vendor:publish --provider="Uteq\Signature\SignatureServiceProvider" --tag="migrations" php artisan migrate ``` You can publish the config file with: ``` php artisan vendor:publish --provider="Uteq\Signature\SignatureServiceProvider" --tag="config" ``` This is the contents of the published config file: ``` return [ /* * This will be the url Signature will use to handle the actions * if the action_route is action the url will for example be https://example.com/action/{key} */ 'action_route' => '/action/{key}', /* * Here you can optionaly define the actions, for example: 'action => '\App\SignatureActions\Action' * When making a url you can provide the key instead of the class path, * when using the example above it would look like SignatureFacade::make('action', $payload)->get(); */ 'actions' => [ ] ]; ``` Usage ----- [](#usage) You can create a link with the examples provided below. All options are optional and can be used independently. ``` $urlExample = SignatureFacade::make(Action::class) ->payload(['variable_1' => 'information', 'variable_2' => 'even more information']) ->expirationDate(now()->addWeek()) ->password('secretPassword') ->oneTimeLink() ->get(); $longerKeyUrlExample = SignatureFacade::make(Action::class) ->longerKey(64) ->group('1234') ->get(); $customKeyExample = SignatureFacade::make(Action::class) ->customKey('veryCoolCustomKey') ->get(); ``` - payload(): Alternative way to pass variables to the link - expirationDate(): Option to allow you to specify the expiration date (defaults to 2 weeks from creating the link) - password(): Protects the link by asking for the password set in this function when using the link - oneTimeLink(): Deletes the link when the action has successfully executed - get(): Makes a complete url based on the APP\_URL in the .env file and the 'action\_route' in the signature config (defaults to /action/{key}) - longerKey(): uses a longer key in the url with changeable length (max. 254). This is recommended when handling sensitive data. - group(): groups signatures together via the string given to the function, when a signature is deleted, all signatures with the same group also get deleted. - customKey(): grants the ability to use a custom key, if both longerKey() and customKey() are used in the same signature, the last function will override the other. Action class: ``` class Action { public function __invoke($payload) { // from here on you can use the variables in $payload to make the link actually do something; return redirect('/login'); // If no return is provided the user will be redirected to "/". } } ``` Commands -------- [](#commands) This command deletes all the signatures that have expired. ``` php artisan signature:clean ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Stef van den Berg](https://github.com/stef1904berg) - [Nathan Jansen](https://github.com/uteq) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 29 — LowBetter than 57% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community10 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 94.1% 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 ~9 days Total 3 Last Release 2002d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1e9390c24b53926dfe0f57b44d2b09cce785f2295dadee3654d940d71cd3ec20?d=identicon)[uteq](/maintainers/uteq) --- Top Contributors [![stef1904berg](https://avatars.githubusercontent.com/u/55401301?v=4)](https://github.com/stef1904berg "stef1904berg (32 commits)")[![nathanjansen](https://avatars.githubusercontent.com/u/73473323?v=4)](https://github.com/nathanjansen "nathanjansen (2 commits)") --- Tags signatureuteq ### Code Quality TestsPHPUnit Static AnalysisPsalm Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/uteq-signature/health.svg) ``` [![Health](https://phpackages.com/badges/uteq-signature/health.svg)](https://phpackages.com/packages/uteq-signature) ``` ### Alternatives [brinley/jsignature Signature For Javascript 70033.1k1](/packages/brinley-jsignature)[sop/crypto-types A PHP library of various ASN.1 types for cryptographic applications. 121.4M35](/packages/sop-crypto-types)[falseclock/advanced-cms A PHP Library that allows you to decode and manipulate CAdES or in other words CMS Advanced Electronic Signatures described in ETSI standart TS 101 733. 223.5k](/packages/falseclock-advanced-cms)[uteq/laravel-query-builder-macros A set of common Laravel Uteq helpers and macros 201.5k1](/packages/uteq-laravel-query-builder-macros) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)