Commit ID در لاراول 13.40: خوندن از replica بدون حدس زدن
خلاصهٔ کاملتر
وقتی تو لاراول اتصال دیتابیس read/write داری، نوشتنها میرن روی سرور اصلی (primary) و خوندنها از یک یا چند replica (یعنی کپیهایی که تغییرات primary رو با کمی تأخیر میگیرن). مشکل اینجاست که کاربر فرم رو ذخیره میکنه، میره صفحهٔ بعد و دادهٔ قدیمی میبینه، چون اون صفحه از replicaیی خونده که هنوز write رو نگرفته.
راهحل رایج یه پنجرهٔ زمانیه. لاراول 13.38 میدلور PreventStaleDatabaseReads رو آورد که تا دو ثانیه بعد از نوشتن، خوندنهای اون کاربر رو میفرسته سمت primary. نویسنده میگه این دو ثانیه فقط یه تخمین ثابت از تأخیر replication هست: اگه از تأخیر واقعی کوتاهتر باشه کاربر باز دادهٔ قدیمی میبینه، اگه بلندتر باشه بیدلیل بار رو میندازی روی primary.
لاراول 13.40 با مشارکت Tobias Petry سه متد اضافه کرده. getLastCommitId() همیشه از اتصال write، موقعیت فعلی replication رو بهصورت string برمیگردونه: تو MySQL یه GTID set، تو MariaDB یه GTID position و تو PostgreSQL یه WAL position. hasCommitId() چک میکنه که replica تا اون commit ID رو اعمال کرده یا نه، و mergeCommitIds() چند تا ID رو یکی میکنه.
$order = Order::create([...]);
$commitId = DB::getLastCommitId();
DB::hasCommitId($commitId); // checks once and returns at once
DB::hasCommitId($commitId, wait: 2); // waits up to 2 seconds for the replicaآرگومان wait تعداد ثانیهست. با مقدار پیشفرض صفر فقط یه بار چک میکنه؛ با مقدار بیشتر، دیتابیس صبر میکنه تا replica برسه یا timeout بشه و بعد false برمیگردونه. پیشنیازها مهمن: MySQL به log_bin، gtid_mode = ON و enforce_gtid_consistency = ON نیاز داره و MariaDB به log_bin. wait تو PostgreSQL فقط از نسخهٔ 19 کار میکنه. SQLite و SQL Server پشتیبانی نمیشن و سرویسهای managed شاید اجازهٔ تغییر این تنظیمات رو ندن.
مقاله یه میدلور ReadYourOwnWrites پیشنهاد میده که بهجای timestamp، commit ID رو تو session نگه میداره. تو هر درخواست از replica میپرسه رسیده یا نه. اگه رسیده، از replica میخونه و کلید session پاک میشه، وگرنه خوندنها میرن سمت primary. اگه کاربر قبل از رسیدن replica دوباره بنویسه، mergeCommitIds() دو تا ID رو یکی میکنه. نویسنده توصیه میکنه تو درخواست وب از wait استفاده نکنی، چون جواب رو معطل نگه میداره.
برای queued jobها چون session وجود نداره، commit ID رو بعد از commit شدن transaction به job پاس میدی و تو handle() با wait: 2 صبر میکنی؛ اگه نرسید، با usingWritePdo() از primary میخونی. نکتهٔ ظریف اینه که job باید ID سفارش رو بگیره نه خود مدل Order، چون SerializesModels قبل از چک کردن، مدل رو از replica لود میکنه و ممکنه ModelNotFoundException بده.
نکات کلیدی:
- لاراول 13.40 متدهای getLastCommitId()، hasCommitId() و mergeCommitIds() رو اضافه کرده
- جایگزین دقیقتری برای پنجرهٔ ثابت دوثانیهای PreventStaleDatabaseReads از نسخهٔ 13.38
- MySQL به gtid_mode = ON و enforce_gtid_consistency = ON نیاز داره و wait تو PostgreSQL از نسخهٔ 19 کار میکنه
- SQLite و SQL Server پشتیبانی نمیشن
- تو queued job، getLastCommitId() رو بعد از commit شدن transaction صدا بزن و بهجای مدل، ID پاس بده




