Session Replay برای لاراول: ضبط و پخش رفتار کاربر داخل اپ خودتون
خلاصهٔ کاملتر
طبق مطلبی که تو Laravel News اومده، Session Replay یه پکیج از Packstub هست که یون کالیمان ساخته. این پکیج کارهای کاربر تو مرورگر رو ضبط میکنه تا داخل خود اپ بتونید دوباره ببینیدش. برای ضبط از rrweb استفاده میکنه (یعنی کتابخونهای که تغییرات DOM رو ثبت میکنه، نه ویدیوی واقعی صفحه). ضبطها بهصورت تیکههای gzip روی هر دیسک لاراول ذخیره میشن و فهرستشون تو دیتابیس خودتون میمونه.
برای فعال کردنش فقط کافیه دایرکتیو @sessionReplay رو آخر layout بذارید و نیازی به build فرانتاند نیست. اسکریپت هر تب رو یه ضبط جدا حساب میکنه و چند ثانیه یه بار یه دستهی فشرده میفرسته. سرور کاربر، tenant و ویژگیهای دلخواه رو با app key امضا میکنه و تو یه توکن میذاره. برای همین endpoint دریافت به session، کوکی یا CSRF نیاز نداره. ولی توکن فقط امضا شده و رمزنگاری نشده، پس چیز محرمانه توش نذارید.
روی تایملاین پخشکننده برای اتفاقهای مهم علامت گذاشته میشه: خطاهای جاوااسکریپت، درخواستهای Livewire یا fetch که ۵۰۰ یا بالاتر برگردونن، exceptionهای سمت سرور، web vitalهایی مثل LCP و INP و CLS، و rage click (یعنی سه کلیک یا بیشتر روی یه نقطه تو ۷۰۰ میلیثانیه). با SessionReplay.mark() میشه علامت دلخواه گذاشت و با SessionReplay.send() یه دکمهی «گزارش مشکل» ساخت.
یکی از جالبترین قابلیتها حالت on_error ـه. تو این حالت ضبطکننده یه دقیقهی آخر رو تو حافظهی مرورگر نگه میداره و تا وقتی خطا رخ نده چیزی نمیفرسته:
'mode' => 'on_error',
'on_error' => [
'buffer_seconds' => 60,
'triggers' => ['error', 'request'],
'ask' => false,
],وقتی خطا رخ بده، همون یه دقیقهی قبل فرستاده میشه و ضبط تا آخر تب ادامه پیدا میکنه. اگه ask رو true کنید، قبل از فرستادن از کاربر اجازه گرفته میشه. یعنی هم لحظهی قبل از خطا رو دارید، هم هزینهی ذخیرهی ضبط همهی جلسهها رو نمیدید.
یه middleware سراسری هم شناسه و آدرس ضبط رو به Context لاراول اضافه میکنه، پس تو هر لاگ اون درخواست لینک ضبط هست. ابزارهایی مثل Flare و Sentry و Nightwatch هم همین کلیدها رو میگیرن. از نظر حریم خصوصی، پیشفرضها سختگیرانهست: همهی inputها ماسک میشن، مهمونها ضبط نمیشن، IP ذخیره نمیشه و ضبطها بعد از ۳۰ روز پاک میشن. بیرون از محیط local هم تا gate به اسم viewSessionReplay رو تعریف نکنید، هیچکس نمیتونه ضبطها رو ببینه.
نکات کلیدی:
- نیازمند PHP 8.3 و لاراول ۱۲ یا ۱۳ هست و با packstub/session-replay نصب میشه.
- ضبط با rrweb انجام میشه و دادهها روی دیسک و دیتابیس خود اپ میمونن.
- حالت on_error فقط ۶۰ ثانیهی قبل از خطا و ادامهی جلسه رو میفرسته.
- لینک ضبط از طریق Context به لاگها و ابزارهایی مثل Sentry و Flare میرسه.
- پیشفرضها: ماسک همهی inputها، بدون ضبط مهمون، بدون IP و پاک شدن بعد از ۳۰ روز.
- یه پلاگین جدا به اسم packstub/filament-session-replay هم برای پنل Filament v5 هست.




