最近，在 Sitesauce 现有基础上新增会员系统，就具体实现细节写了这篇文章。
笔记：我将从零开始构建该程序，这样无论你处于什么阶段都可以读懂该文章。 当然如果你已经非常熟悉 Laravel ，你可以在此 Rewardful 之类的平台上完成该工作，这样会节省不少时间。
为了概念明确，下文中 邀请者用上级替代，被邀请者使用下级替代
首先，我们要明确我们的需求：首先用户可以通过程序分享链接邀请好友注册，被邀请者可以通过链接注册，从而绑定邀请关系，其次在下级消费的时候，上级都可以获得相应的佣金。
现在我们要确定如何实现注册。我原本打算使用 Fathom 的方法，只要将用户引导到特定页面，该用户将会被标记为 special referral page ，待用户完注册，并将关系绑定。 但最终采用的是 Rewardful 的做法，通过向链接添加参数 ?via=miguel 来实现推荐页面的构建。
好了，现在让我们创建我们的注册页面，在注册页面程序会通过链接参数 via 匹配上级。 代码很简单，如果 via 存在那么将其存储到 Cookie 30 天，由于我们有几个不同子域名都需要该操作，所以我们将其添加到主域名下，这样所有子域均可使用该 Cookie。下面视具体代码：
import Cookies from 'js-cookie'const via = new URL(location.href).searchParams.get('via')if (via) { Cookies.set('sitesauce_affiliate', via, { expires: 30, domain: '.sitesauce.app', secure: true, sameSite: 'lax' })}
这样做的好处是当会员未通过此次分享注册，而是事后自己注册的时候，可以明确地知道该会员是通过那个上级的引荐而来的。我想更进一步，在新会员注册的时候通过显示一些标语以及上级者信息，从而使用户明确知道这是来自会员（好友）的一个引荐链接，从而使注册成功率更高，所以我添加了提示弹窗。效果如下：
想要实现上面效果的话，现在我们需要的不仅仅是上级标签，还需要上级详细信息，所以我们需要一个 API，该 API 会通过 via 匹配并提供上级详细信息。
import axios from 'axios'import Cookies from 'js-cookie'const via = new URL(location.href).searchParams.get('via')if (via) { axios.post(`https://app.sitesauce.app/api/affiliate/${encodeURIcomponent(this.via)}`).then(response => { Cookies.set('sitesauce_affiliate', response.data, { expires: 30, domain: '.sitesauce.app', secure: true, sameSite: 'lax' }) }).catch(error => { if (!error.response || error.response.status !== 404) return console.log('Something went wrong') console.log('Affiliate does not exist. Register for our referral program here: https://app.sitesauce.app/affiliate') })}
在 URL 中你可以看到 encodeURIComponent，他的作用是保护我们不在受 Path Traversal vulnerability 的影响。 在我们发送请求到 /api/referral/:via，如果过有人恶意修改链接参数，像这样： ?via=../../logout ，用户在点击之后可能会注销，当然这可能没有什么影响，但是不可避免得会有些其他的会带来不可预期影响的操作。
由于 Sitesauce 在一些地方使用了 Alpine，所以我们在此基础之上，将弹窗修改为 Alpine 组件，这样有更好的扩展性。 这里要感谢下 Ryan ，在我的转换无法正常工作时，给我提出了宝贵建议。
import axios from 'axios'import Cookies from 'js-cookie'// 使用模板标签 $nextTick ，进行代码转换，这里特别感谢下我的朋友 Ryan window.component = () => ({ affiliate: null, via: new URL(location.href).searchParams.get('via') init() { if (! this.via) return this.$nextTick(() => this.affiliate = Cookies.getJSON('sitesauce.affiliate')) axios.post(`https://app.sitesauce.app/api/affiliate/${encodeURIComponent(this.via)}`).then(response => { this.$nextTick(() => this.affiliate = response.data) Cookies.set('sitesauce.affiliate', response.data, { expires: 30, domain: '.sitesauce.app', secure: true, sameSite: 'lax' }) }).catch(error => { if (!error.response || error.response.status !== 404) return console.log('Something went wrong') console.log('Affiliate does not exist. Register for our referral program here: https://app.sitesauce.app/affiliate') }) }})![]()
Your friend has invited you to try Sitesauce
现在，完善 API，使其可以获取有效数据。 除此之外，我们还需要新增几个个字段到我们现有的数据库，这个我们将在之后说明。下面是迁移文件：
class AddAffiliateColumnsToUsersTable extends Migration{ /** * 迁移执行 * * @return void */ public function up() { Schema::table('users', function (Blueprint $table) { $table->string('affiliate_tag')->nullable(); $table->string('referred_by')->nullable(); $table->string('paypal_email')->nullable(); $table->timestamp('cashed_out_at')->nullable(); }); } /** * Reverse the migrations. * * @return void */ public function down() { Schema::table('users', function (Blueprint $table) { $table->dropColumn('affiliate_tag', 'referred_by', 'paypal_email', 'cashed_out_at'); }); }}
通过路由自定义键名功能实现参数绑定 (可在 Laravel 7.X 上使用)，构建我们的 API 路由。
讯飞听见会议
科大讯飞推出的AI智能会议系统
19 查看详情 
Route::post('api/affiliate/{user:affiliate_tag}', function (User $user) { return $user->only('id', 'name', 'avatar', 'affiliate_tag');})->middleware('throttle:30,1');
在开始注册操作之前，首先读取我们的 Cookie，由于未进行加密，所以我们需要将其加入到 EncryptCookies 的 except 字段中，将其排除。
// 中间件：app/Http/Middleware/EncryptCookies.phpuse IlluminateCookieMiddlewareEncryptCookies as Middleware;class EncryptCookies extends Middleware{ /** * The names of the cookies that should not be encrypted * * @var array */ protected $except = [ 'sitesauce_referral', ];}
现在通过 RegisterController 的 authenticated 方法执行注册相应的逻辑，其间，我们通过上面的方式获取 Cooke，并通过该 Cooke 找到相应的上级，最终实现将下级与上级关联。
/** * 上级用户已经注册 * * @param IlluminateHttpRequest $request * @param AppUser $user */protected function registered(Request $request, User $user){ if (! $request->hasCookie('sitesauce.referral')) return; $referral = json_decode($request->cookie('sitesauce_referral'), true)['affiliate_tag']; if (! User::where('affiliate_tag', $referral)->exists()) return; $user->update([ 'referred_by' => $referral, ]);}
我们还需要一个方法来获取我的下级用户；列表，通过 ORM 的 hasMany 方法很简单的就实现了。
class User extends Model{ public function referred() { return $this->hasMany(self::class, 'referred_by', 'affiliate_tag'); }}
现在，让我们构建我们的注册页面，在用户注册时候，他们可以选择喜好标签，并需要他们提供 PayPal 电子邮件 以以便之后的提现操作。下面是效果预览：
会员注册后，我们还需要提供电子邮箱的变更，以及标签变更的相关入口。在其变更标签之后，我们需要级联更新其下级用户的的标签，以确保两者的统一。这涉及到了数据库的事务操作，为保证操作的原子性，我们需要在事务中完成以上两个操作。代码如下：
public function update(Request $request) { $request->validate([ 'affiliate_tag' => ['required', 'string', 'min:3', 'max:255', Rule::unique('users')->ignoreModel($request->user())], 'paypal_email' => ['required', 'string', 'max:255', 'email'], ]); DB::transaction(function () use ($request) { if ($request->input('affiliate_tag') != $request->user()->affiliate_tag) { User::where('referred_by', $request->user()->affiliate_tag) ->update(['referred_by' => $request->input('affiliate_tag')]); } $request->user()->update([ 'affiliate_tag' => $request->input('affiliate_tag'), 'paypal_email' => $request->input('paypal_email'), ]); }); return redirect()->route('affiliate'); }
下面我们需要确定会员收益的计算方式，可以通过下级用户的所有消费金额的百分比作为佣金返给上级，为了计算方便，我们仅仅计算自上次结款日期之后的数据。我们使用扩展 Mattias’ percentages package 使计算简单明了。
use MattiasgeniarPercentagePercentage;const COMMISSION_PERCENTAGE = 20;public function getReferralBalance() : int{ return Percentage::of(static::COMISSION_PERCENTAGE, $this->referred ->map(fn (User $user) => $user->invoices(false, ['created' => ['gte' => optional($this->cashed_out_at)->timestamp]])) ->flatten() ->map(fn (StripeInvoice $invoice) => $invoice->subtotal) ->sum() );}
最后我们以月结的方式向上级发放佣金，并更新 cashed_out_at 字段为本次佣金发放时间。效果如下：
至此，希望以上文档对你有帮助。祝你快乐每天。
推荐教程：《Laravel教程》
以上就是基于 Laravel 开发会员分销系统的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/489962.html
微信扫一扫 
支付宝扫一扫 
