لاراول به شما کمک میکند تا در مورد اتفاقاتی که در اپلیکیشنتان میافتد اطلاعات بیشتری کسب کنید و به شما امکان میدهد تا پیامها را به فایلها وارد کنید.
ورود به سیستم لاراول بر اساس "کانال"است. هر کانال نشان دهنده یک روش خاص برای نوشتن اطلاعات ورود به سیستم است. مثلا, تک کانال ورود فایل به یک فایل ورود به سیستم می نویسد, در حالی که کانال شل پیام ورود به سیستم به شل می فرستد. پیام ورود ممکن است به کانال های متعدد بر اساس شدت خود را نوشته شده است.
لاراول در زیر کاپوت از کتابخانه مونولوگ استفاده می کند که از انواع کنترل کننده های قدرتمند چوب پشتیبانی می کند. لاراول پیکربندی این دستگیره ها را به شما امکان می دهد تا ترکیب و مطابقت دهید تا مدیریت ورود به سیستم برنامه خود را سفارشی کنید.
پیکربندی
همه از گزینه های پیکربندی برای رفتار ورود به سیستم نرم افزار خود را در پیکربندی/ورود به سیستم قرار دارد.فایل پیکربندی پی اچ پی. این فایل اجازه می دهد تا شما را به پیکربندی کانال ورود به سیستم نرم افزار خود را, بنابراین حتما به بررسی هر یک از کانال های موجود و گزینه های خود را. در زیر چند گزینه رایج را مرور خواهیم کرد.
به طور پیش فرض لاراول از کانال پشته در هنگام ثبت پیام ها استفاده خواهد کرد. کانال پشته برای جمع کردن چندین کانال ورود به یک کانال استفاده می شود. برای کسب اطلاعات بیشتر در پشته ساختمان, چک کردن اسناد و مدارک زیر.
پیکربندی نام کانال
به طور پیش فرض, مونولوگ با یک "نام کانال" که منطبق بر محیط فعلی نمونه, مانند تولید و یا محلی . برای تغییر این مقدار, اضافه کردن یک گزینه نام به پیکربندی کانال خود را:
درایورهای کانال موجود
هر کانال ورود به سیستم توسط یک "راننده"طراحی شده است. راننده تعیین می کند که چگونه و کجا پیام ورود به سیستم در واقع ثبت شده است. درایورهای کانال ورود به سیستم زیر در هر برنامه لاراول موجود است. ورودی اکثر این درایورها از قبل در پیکربندی/ورود به سیستم برنامه شما وجود دارد.فایل پیکربندی پی اچ پی, پس حتما این فایل را مرور کنید تا از مطالب مطلع شوید:
نام | توضیحات |
---|---|
سفارشی | درایوری که برای ایجاد کانال با یک کارخانه مشخص تماس می گیرد |
روزانه | یک درایور مونوگ مبتنی بر فیلهندلر چرخان که روزانه می چرخد |
خطا | یک درایور مونولوگ مبتنی بر خطا |
مونولوگ | یک درایور کارخانه مونولوگ که ممکن است از هر کنترل کننده مونولوگ پشتیبانی شده استفاده کند |
صفر | درایوری که تمام پیام های گزارش را دور می اندازد |
تریل کاغذی | یک درایور مونولوگ مبتنی بر سیسلوگودفاندلر |
مجرد | یک فایل یا مسیر مبتنی بر کانال چوب (جریان ) |
اسلک | یک درایور مونولوگ مستقر در اسلک وب بوخندلر |
پشته | بسته بندی برای تسهیل ایجاد کانال های "چند کاناله" |
سیسلاگ | یک درایور مونولوگ مبتنی بر سیسلوگاندلر |
توجه داشته باشید اتمام اسناد و مدارک در سفارشی سازی کانال پیشرفته برای کسب اطلاعات بیشتر در مورد رانندگان مونولوگ و سفارشی.
پیش نیازهای کانال
پیکربندی کانال های تک و روزانه
کانال های تک و روزانه سه گزینه پیکربندی اختیاری: حباب, اجازه, و قفل کردن .
نام | توضیحات | پیشفرض |
---|---|---|
حباب | نشان می دهد اگر پیام باید حباب تا کانال های دیگر پس از به کار گرفته | درست است |
قفل کردن | قبل از نوشتن فایل گزارش را قفل کنید | غلط |
مجوز | مجوزهای پرونده ورود به سیستم | 0644 |
علاوه بر این, سیاست حفظ و نگهداری برای کانال روزانه را می توان از طریق گزینه روز پیکربندی:
نام | توضیحات | پیشفرض |
---|---|---|
روزها | تعداد روزهایی که پرونده های گزارش روزانه باید حفظ شوند | 7 |
پیکربندی کانال کاغذ تریل
کانال تریل کاغذی به گزینه های پیکربندی میزبان و پورت نیاز دارد. می توانید این مقادیر را از تریل کاغذی دریافت کنید.
پیکربندی کانال شل
کانال شل نیاز به یک گزینه پیکربندی نشانی وب. این نشانی اینترنتی باید یک نشانی اینترنتی برای یک هوک ورودی که شما برای تیم شل خود را پیکربندی مطابقت.
به طور پیش فرض, شل تنها سیاهههای مربوط در سطح بحرانی و بالاتر دریافت خواهد کرد; با این حال, شما می توانید این را در پیکربندی خود را تنظیم کنید/ورود به سیستم.فایل پیکربندی پی اچ پی با تغییر گزینه پیکربندی سطح در مجموعه پیکربندی شل ورود به سیستم کانال خود را.
هشدارهای استهلاک ورود به سیستم
کتابخانههای پی اچ پی و لاراول و دیگر کتابخانهها اغلب به کاربران خود اطلاع میدهند که برخی از ویژگیهایشان منسوخ شدهاند و در نسخه بعدی حذف خواهند شد. اگر شما می خواهم برای ورود این هشدارهای استهلاک, شما ممکن است استهلاک مورد نظر کانال ورود خود را در پیکربندی نرم افزار خود را مشخص کنید/ورود به سیستم.فایل پیکربندی پی اچ پی:
یا, شما ممکن است یک کانال ورود به سیستم به نام تخفیف تعریف . اگر یک کانال ورود به سیستم با این نام وجود دارد, همیشه برای ورود به سیستم استهلاک استفاده خواهد شد:
پشته های ورود به سیستم ساختمان
همانطور که قبلا ذکر, درایور پشته اجازه می دهد تا شما را به ترکیب کانال های متعدد را به یک کانال ورود به سیستم تنها برای راحتی. برای نشان دادن نحوه استفاده از پشته ورود به سیستم, اجازه دهید نگاهی به یک پیکربندی به عنوان مثال که شما ممکن است در یک برنامه تولید را ببینید:
بیایید این پیکربندی را تشریح کنیم. ابتدا توجه کنید که کانال پشته ما دو کانال دیگر را از طریق گزینه کانال های خود جمع می کند: سیس لاگ و اسلک . بنابراین هنگام ثبت پیام ها هر دوی این کانال ها امکان ثبت پیام را خواهند داشت. با این حال, همانطور که در زیر خواهید دید, چه این کانال در واقع ورود به سیستم پیام ممکن است با شدت پیام تعیین / "سطح".
سطوح ورود
به گزینه پیکربندی سطح موجود در تنظیمات سیس لاگ و کانال شل در مثال بالا توجه کنید. این گزینه حداقل "سطح" یک پیام را تعیین می کند تا توسط کانال وارد شود. مونولوگ که خدمات ورود به سیستم لاراول را تقویت می کند تمام سطوح ورود به سیستم تعریف شده در مشخصات 5424 را فراهم می کند. به ترتیب نزولی از شدت, این سطوح ورود به سیستم هستند: اضطراری , هشدار , بحرانی , اشتباه , هشدار , اطلاع , اطلاعات , و اشکال زدایی .
بنابراین, تصور کنید ما یک پیام ورود با استفاده از روش اشکال زدایی:
با توجه به پیکربندی ما, کانال سیس لاگ پیام را به گزارش سیستم می نویسد; با این حال, زیرا پیام خطا حیاتی نیست یا بالاتر, برای اسلک ارسال نمی شود. با این حال, اگر پیام اضطراری را ثبت کنیم, هم به لاگ سیستم و هم به اسلاک ارسال می شود زیرا سطح اضطراری برای هر دو کانال بالاتر از حد حداقل سطح ما است:
نوشتن پیام های ورود به سیستم
شما ممکن است اطلاعات را به سیاهههای مربوط با استفاده از نمای ورود به سیستم ارسال. همانطور که قبلا ذکر, چوب فراهم می کند هشت سطح ورود به سیستم تعریف شده در ردیاب 5424 مشخصات: اضطراری, هشدار , بحرانی , اشتباه , هشدار , اطلاع, اطلاعات و اشکال زدایی :
برای ثبت پیام برای سطح مربوطه می توانید با هر یک از این روش ها تماس بگیرید. به طور پیش فرض, پیام خواهد شد به کانال ورود به سیستم به طور پیش فرض نوشته شده توسط فایل پیکربندی ورود به سیستم خود را پیکربندی:
اطلاعات متنی
مجموعه ای از داده های متنی ممکن است به روش های ورود به سیستم منتقل شود. این داده های متنی با پیام ورود به سیستم قالب بندی و نمایش داده می شوند:
گاهی اوقات ممکن است بخواهید برخی از اطلاعات متنی را مشخص کنید که باید با تمام ورودی های بعدی در یک کانال خاص گنجانده شود. مثلا, شما ممکن است مایل به ورود یک شناسه درخواست است که با هر درخواست های دریافتی به درخواست شما در ارتباط. برای تحقق این امر می توانید نمای ورود به سیستم را با روش متن:
اگر شما می خواهم برای به اشتراک گذاشتن اطلاعات متنی در تمام کانال های ورود به سیستم, شما ممکن است ورود پاسخ::متن مشترک() روش. این روش اطلاعات متنی را در اختیار همه کانالهای ایجاد شده و کانالهایی که متعاقبا ایجاد می شوند قرار می دهد. به طور معمول روش مشترک متن باید از روش بوت یک سرویس دهنده برنامه فراخوانی شود:
نوشتن در کانال های خاص
گاهی اوقات ممکن است بخواهید پیامی را به کانالی غیر از کانال پیش فرض برنامه خود وارد کنید. شما می توانید از روش کانال در نمای ورود به سیستم برای بازیابی و ورود به هر کانال تعریف شده در فایل پیکربندی خود استفاده کنید:
اگر شما می خواهم برای ایجاد یک پشته ورود به سیستم بر روی تقاضا متشکل از کانال های متعدد, شما ممکن است روش پشته استفاده:
کانال های درخواستی
همچنین امکان ایجاد یک کانال درخواستی با تهیه پیکربندی در زمان اجرا وجود دارد بدون اینکه پیکربندی در پرونده پیکربندی ثبت برنامه شما وجود داشته باشد. برای انجام این کار, شما ممکن است مجموعه ای پیکربندی به روش ساخت نمای ورود به سیستم را منتقل می کند:
همچنین ممکن است بخواهید یک کانال درخواستی را در یک پشته ورود به سیستم درخواستی قرار دهید. این می تواند با درج نمونه کانال درخواستی شما در مجموعه ای که به روش پشته منتقل شده است حاصل شود:
سفارشی سازی کانال مونولوگ
سفارشی کردن مونولوگ برای کانال ها
گاهی اوقات ممکن است به کنترل کامل نحوه پیکربندی مونولوگ برای یک کانال موجود نیاز داشته باشید. برای مثال ممکن است بخواهید یک پیادهسازی رابط فرمت مونولوگ سفارشی را برای یک کانال داخلی لاراول پیکربندی کنید.
برای شروع, تعریف یک مجموعه شیر در پیکربندی کانال. مجموعه شیر باید حاوی لیستی از کلاسها باشد که باید فرصتی برای شخصی سازی (یا "ضربه زدن" به) نمونه تک مونوگ پس از ایجاد داشته باشد. هیچ مکان متعارفی وجود ندارد که این کلاس ها باید قرار داده شوند, بنابراین شما می توانید یک دایرکتوری در برنامه خود ایجاد کنید تا شامل این کلاس ها باشد:
هنگامی که گزینه شیر را در کانال خود پیکربندی کردید, شما می توانید کلاس را تعریف کنید که نمونه مونولوگ شما را سفارشی می کند. این کلاس تنها نیاز به یک روش واحد: __فراخوانی , که دریافت روشن\ورود\به عنوان مثال چوب. روشن\ورود\چوب پروکسی نمونه همه فراخوانی روش به عنوان مثال تک اساسی:
توجه داشته باشید که تمام کلاسهای "شیر" شما توسط کانتینر سرویس حل می شوند بنابراین هرگونه وابستگی سازنده ای که نیاز دارند به طور خودکار تزریق می شود.
ایجاد کانال های کنترل کننده مونولوگ
مونولوگ دارای انواع کنترل کننده های موجود است و لاراول شامل یک کانال داخلی برای هر یک نیست. در بعضی موارد ممکن است بخواهید یک کانال سفارشی ایجاد کنید که صرفا نمونه ای از یک کنترل کننده مونولوگ خاص باشد که درایور لاگ لاراول مربوطه را نداشته باشد. این کانال ها را می توان به راحتی با استفاده از درایور مونولوگ ایجاد کرد.
هنگام استفاده از درایور مونولوگ, گزینه پیکربندی کنترل استفاده می شود تا مشخص کنید که کنترل نمونه خواهد شد. در صورت تمایل, هر پارامتر سازنده نیازهای کنترل ممکن است با استفاده از گزینه با پیکربندی مشخص:
قالب های مونولوگ
هنگام استفاده از درایور مونولوگ از قالب خط مونولوگ به عنوان قالب ساز پیش فرض استفاده می شود. با این وجود می توانید نوع قالب بندی منتقل شده به کنترل کننده را با استفاده از قالب بندی و قالب بندی سفارشی کنید_با گزینه های پیکربندی:
اگر از یک کنترل کننده مونولوگ استفاده می کنید که قادر به تهیه قالب خود است, شما ممکن است مقدار گزینه پیکربندی قالب را به طور پیش فرض تنظیم کنید :
ایجاد کانال های سفارشی از طریق کارخانه ها
اگر شما می خواهید برای تعریف یک کانال کاملا سفارشی که شما باید کنترل کامل بر نمونه و پیکربندی مونولوگ است, شما ممکن است یک نوع درایور سفارشی در پیکربندی/ورود به سیستم خود را مشخص کنید.فایل پیکربندی پی اچ پی. پیکربندی شما باید شامل یک گزینه از طریق باشد که حاوی نام کلاس کارخانه است که برای ایجاد نمونه مونولوگ فراخوانی می شود:
هنگامی که کانال درایور سفارشی شما پیکربندی شده اند, شما اماده به تعریف کلاس است که به عنوان مثال مونولوگ خود را ایجاد کنید. این کلاس تنها نیاز به یک _ _ روش فراخوانی که باید به عنوان مثال چوب تک بازگشت. این روش مجموعه پیکربندی کانال ها را به عنوان تنها استدلال خود دریافت می کند:
لاراول یک چارچوب کاربردی وب با نحو رسا و زیبا است. ما معتقدیم که توسعه باید یک تجربه لذت بخش و خلاقانه باشد تا واقعا تحقق یابد. لاراول تلاش می کند تا درد را از بین ببرد با کاهش وظایف رایج مورد استفاده در اکثر پروژه های وب.