PHPackages lampge/laravel-invitation - 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. lampge/laravel-invitation ActiveLibrary[Utility & Helpers](/categories/utility) lampge/laravel-invitation ========================= Laravel 邀请码套件 v0.0.8(7y ago)134MITPHPPHP >=7.1.2 Since Oct 31Pushed 7y ago1 watchersCompare [ Source](https://github.com/812913889/laravel-invitation)[ Packagist](https://packagist.org/packages/lampge/laravel-invitation)[ RSS](/packages/lampge-laravel-invitation/feed)WikiDiscussions master Synced yesterday READMEChangelog (6)Dependencies (7)Versions (8)Used By (0) Laravel 邀请码 =========== [](#laravel-邀请码) 介紹 -- [](#介紹) 此套件可用來實作邀请码管理，每個會員可能都會有一個邀请码，或是多個邀请码 本專案參考 [clarkeash/doorman](https://github.com/clarkeash/doorman) 完成，因為作者有些限制與我的需求不合(比方說沒有邀请码製作者、擁有者、狀態、類型等..)，因此此套件參考他的套件擴充，並儘量改成更彈性的使用 安裝 -- [](#安裝) ``` 以 composer 安裝 composer require ariby/invitation ``` config ------ [](#config) ``` table 名稱定義於 config `laravel_invitation` 檔案中，可發佈後進行修改 `invite_table_name` 欄位，預設為`invites` 另一個可修改參數是邀请码長度 `code_length`，預設為 5 ``` Table 結構 -------- [](#table-結構) ``` | 欄位名稱 | 說明 |-------------------------------------------------------------------------- | code | 邀请码 |-------------------------------------------------------------------------- | status | 邀请码的開放狀態 (enum => ['enabled', 'disabled']) ->default('enabled') |-------------------------------------------------------------------------- | for | 邀请码的專屬使用者 (null 表示所有人都可以使用) |-------------------------------------------------------------------------- | belong_to | 邀请码的擁有者 (nullable) |-------------------------------------------------------------------------- | made_by | 邀请码的製作者 (nullable) |-------------------------------------------------------------------------- | max | 邀请码的最大使用次數 (null 表示無限) |-------------------------------------------------------------------------- | uses | 邀请码的已使用次數 ->default('0') |-------------------------------------------------------------------------- | type | 邀请码的類型 (nullable) |-------------------------------------------------------------------------- | valid_until | 邀请码的有效期限 (null 表示永久) ``` ORM 可使用函式 --------- [](#orm-可使用函式) ``` $model->isExpired() => 回傳是否已過期 $model->isEnabled() => 回傳是否狀態為開放使用 $model->isFull() => 回傳是否已超過最大使用次數 $model->isRestricted() => 回傳此推廣碼是否有綁定特定使用者 $model->isRestrictedFor($userId) => 回傳此邀请码是否為此會員專屬 $model->isUseless() => 回傳此邀请码是否已無法使用(超過使用次數或已過期) ``` ORM Query Scope --------------- [](#orm-query-scope) ``` $builder->expired() // 取得已過期的邀请码 $builder->full() // 取得已超過使用次數上限的邀请码 $bulider->useless() // 取得已無法使用的邀请码(超過使用次數或已過期) ``` 建立邀请码 ----- [](#建立邀请码) ``` 使用範例 ``` $inviteCode = LaravelInvitation::generate() ->setCode($code) // 指定邀请码，若不使用會自動隨機產生 ->status('enabled') // 是否開放使用，不使用預設為 enabled ->belongTo($this->id) // 屬於特定代理 id ->madeBy($this->id) // 製作者 id ->expiresOn('2018-11-26 12:00:00') // 過期日期 ->type($type) // 此邀请码類型 ->make() ->first(); ``` ``` 命令與排程 ----- [](#命令與排程) ``` 排程清除已經過期的邀请码 `php artisan routine-clear:clear-expired-invite-codes` 或是將此命令加入 kernel 排程 ``` protected function schedule(Schedule $schedule) { ... // 每天清除已過期的邀请码 $schedule->command('routine-clear:clear-expired-invite-codes')->daily(); ... } ``` ``` ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity51 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 Every ~6 days Recently: every ~0 days Total 8 Last Release 2708d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/dffa3c31e0aff3aec7cc3222df9f682b7b950b3cb6fb99c02760e5b8bb434e14?d=identicon)[lampge](/maintainers/lampge) --- Top Contributors [![defsrisars](https://avatars.githubusercontent.com/u/16033905?v=4)](https://github.com/defsrisars "defsrisars (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/lampge-laravel-invitation/health.svg) ``` [![Health](https://phpackages.com/badges/lampge-laravel-invitation/health.svg)](https://phpackages.com/packages/lampge-laravel-invitation) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas Code Generators for Laravel Applications and Packages 21017.2M158](/packages/orchestra-canvas)[kirschbaum-development/commentions A package to allow you to create comments, tag users and more 12369.2k](/packages/kirschbaum-development-commentions)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum)[glhd/special 1929.4k](/packages/glhd-special)[bjuppa/laravel-blog Add blog functionality to your Laravel project 483.3k2](/packages/bjuppa-laravel-blog) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)