Deploy کردن Laravel 13 در پروداکشن؛ cache، queue worker و reload را فراموش نکنید

Deploy لاراول فقط git pull و composer install نیست. در Laravel 13 باید cacheهای production، workerهای طولانی‌مدت، APP_DEBUG و ترتیب reload را بخشی از release process بدانید.

حمید اعراب توسعه‌دهنده ارشد بک‌اند وردپرس و ووکامرس
انتشار
زمان مطالعه
۲ دقیقه مطالعه

حمید اعراب ۱ آذر ۱۴۰۵ ۲ دقیقه مطالعه

کاور ترمینالی Laravel 13 با دستورات deployment و queue worker
فهرست مطالب (7)

Laravel 13 حداقل PHP 8.3 می‌خواهد و مثل نسخه‌های قبلی، deployment سالم آن فقط انتقال فایل نیست. بخش مهم کار بعد از قرار گرفتن کد جدید روی سرور شروع می‌شود: cacheها باید با release جدید ساخته شوند و processهای طولانی‌مدت باید کد جدید را load کنند.

۱. APP_DEBUG در production باید false باشد

این مورد ساده است اما همچنان یکی از خطرناک‌ترین خطاهای deployment است. debug روشن می‌تواند اطلاعات exception، path و configuration را به کاربر نشان دهد. production config را از فایل local developer جدا نگه دارید.

۲. optimize را بخشی از release کنید

Laravel دستور php artisan optimize را برای cache کردن بخش‌های مناسب production دارد. بسته به pipeline شما می‌توانید cacheهای config، event، route و view را جداگانه هم بسازید.

php artisan optimize
# or granularly:
php artisan config:cache
php artisan event:cache
php artisan route:cache
php artisan view:cache

بعد از config:cache، فراخوانی مستقیم env() خارج از configها الگوی درستی نیست؛ مقدارها را از config بخوانید.

۳. Queue worker کد جدید را خودش نمی‌بیند

queue:work یک process طولانی‌مدت است و application boot‌شده را در حافظه نگه می‌دارد. بنابراین deploy شدن فایل جدید به معنی reload شدن worker نیست. اگر worker را restart/reload نکنید، ممکن است web requestها کد جدید و jobها کد قدیمی اجرا کنند.

۴. Laravel 13 یک reload سراسری برای سرویس‌های طولانی‌مدت دارد

مستندات Laravel 13 برای reload کردن سرویس‌هایی مثل queue worker، Reverb و Octane از php artisan reload استفاده می‌کند. خارج از Laravel Cloud همچنان به process monitor نیاز دارید تا processهای خارج‌شده را دوباره بالا بیاورد.

php artisan reload

۵. ترتیب release مهم است

  1. release جدید را در مسیر جدا آماده کنید.
  2. Composer را با flags مناسب production اجرا کنید.
  3. config و cacheهای production را بسازید.
  4. migrationهای backward-compatible را اجرا کنید.
  5. symlink/current release را atomically جابه‌جا کنید.
  6. serviceهای طولانی‌مدت را reload کنید.
  7. health check و log را بررسی کنید.

چرا atomic release؟

اگر فایل‌ها را روی همان directory زنده overwrite کنید، requestی که وسط deploy می‌رسد ممکن است بخشی از نسخه قدیم و بخشی از نسخه جدید را ببیند. release directory + symlink این پنجره ناسازگار را بسیار کوچک‌تر می‌کند.

منابع

$ ./request_review

همین مشکل را در فروشگاه خودتان دارید؟

توسعه‌دهنده ارشد WordPress و WooCommerce برای معماری، اتصال سیستم‌ها و حل مسائل پیچیده production.

درخواست بررسی فنی

دیدگاه‌ها

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *