מהן הפעלות ב-Laravel, תצורה ושימוש עם דוגמאות

הפעלות של Laravel מאפשרות לך לאחסן מידע ולהחליף אותו בין בקשות באפליקציית האינטרנט שלך. 

הם דרך קלה להתמיד בנתונים עבור המשתמש הנוכחי. מדריך זה ייתן לך את היסודות לעבודה עם הפעלות ב-Laravel.

מהו סשן Laravel

ב-Laravel, הפעלה היא דרך לאחסן מידע, לטפל נכון בבקשות שנעשו על ידי משתמש. כאשר משתמש מתחיל יישום Laravel, הפעלה אוטומטית מתחילה עבור אותו משתמש. נתוני הפעלה מאוחסנים בשרת ועוגיה קטנה עם מזהה ייחודי נשלחת לדפדפן המשתמש לזיהוי ההפעלה.

אתה יכול להשתמש בהפעלה כדי לאחסן נתונים שבהם ברצונך להשתמש על פני מספר דפים או בקשות. לדוגמה, תוכל להשתמש בהפעלה לאימות משתמשים או לאחסן מידע אחר שבו תרצה להשתמש במהלך ההפעלה באפליקציה שלך.

תצורת הפעלה ב-Laravel

כדי להשתמש בהפעלות ב-Laravel, תחילה עליך להפעיל אותן בקובץ config/session.php של תצורה. בקובץ זה ניתן להגדיר פרמטרים של תצורה הקשורים להפעלות. לדוגמה, משך הפגישה, מנהל ההתקן שישמש לאחסון נתוני הפגישה ומיקום האחסון של נתוני הפגישה. 

לקובץ יש את אפשרויות התצורה הבאות:

• נהג: מציין את מנהל ההתקן לפני הפגישהdefiמוכן לשימוש. Laravel תומך במספר מנהלי התקנים של הפעלה: קובץ, קובץ Cookie, מסד נתונים, apc, memcached, redis, dynamodb ומערך;
• פעם בחיים: מציין את מספר הדקות שבהן יש לראות בפגישה תקינה;
• פג_בסגירה: אם מוגדר כ-true, ההפעלה יפוג כאשר הדפדפן של המשתמש ייסגר;
• להצפין: true פירושו שהמסגרת תצפין נתוני הפעלה לפני שהם יאוחסנו;
• קבצים: אם נעשה שימוש במנהל ההתקן של הפעלת הקבצים, אפשרות זו מציינת את מיקום אחסון הקבצים;
• הקשר: אם נעשה שימוש במנהל ההתקן של הפעלת מסד הנתונים, אפשרות זו מציינת את חיבור מסד הנתונים לשימוש;
• שולחן: אם נעשה שימוש במנהל ההתקן של הפעלת מסד הנתונים, אפשרות זו מציינת את טבלת מסד הנתונים לשימוש לאחסון נתוני הפעלה;
• הגרלה: מערך ערכים המשמש לבחירה אקראית של ערך קובץ Cookie של מזהה הפעלה;
• עוגייה: אפשרות זו מציינת את שם קובץ ה-cookie שישמש לאחסון מזהה ההפעלה. אפשרויות הנתיב, הדומיין, מאובטח, http_only ו-same_site משמשות להגדרת הגדרות ה-cookie עבור ההפעלה.

להלן דוגמה לקובץ sessions.php עם משך הפעלה 120 שניות, שימוש בקבצים המאוחסנים בספרייה framework/sessions:

<?php

use Illuminate\Support\Str;

return [
    'driver' => env('SESSION_DRIVER', 'file'),
    'lifetime' => env('SESSION_LIFETIME', 120),
    'expire_on_close' => false,
    'encrypt' => false,
    'files' => storage_path('framework/sessions'),
    'connection' => env('SESSION_CONNECTION', null),
    'table' => 'sessions',
    'store' => env('SESSION_STORE', null),
    'lottery' => [2, 100],
    'cookie' => env(
        'SESSION_COOKIE',
        Str::slug(env('APP_NAME', 'laravel'), '_').'_session'
    ),
    'path' => '/',
    'domain' => env('SESSION_DOMAIN', null),
    'secure' => env('SESSION_SECURE_COOKIE'),
    'http_only' => true,

    'same_site' => 'lax',

];

אתה יכול גם להגדיר את ההפעלה באמצעות משתני סביבה בקובץ .env. לדוגמה, כדי להשתמש במנהל ההתקן של הפעלת מסד הנתונים ולאחסן נתוני הפעלה בטבלת הפעלה, עם DB מסוג MySQL, אתה יכול להגדיר את משתני הסביבה הבאים:

SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_CONNECTION=mysql
SESSION_TABLE=sessions

הגדרת הפעלה של Laravel

יש שלוש דרכים לעבוד עם נתוני הפעלה ב-Laravel: 

• באמצעותhelper של global session;
• באמצעות חזית הסשן;
• דרך אחד Request instance. 

בכל המקרים הללו, הנתונים שאתה מאחסן בסשן יהיו זמינים בבקשות עוקבות שיבוצעו על ידי אותו משתמש עד שהסשן יפוג או יושמד ידנית.

עוזר הפעלה גלובלי

ב-Laravel, באמצעות הפונקציה Global Session Helper זוהי דרך נוחה לגשת לשירותי הפגישה שמספקת המסגרת. זה מאפשר לך לאחסן ולאחזר נתונים מההפעלה באפליקציה שלך. להלן דוגמה כיצד להשתמש ב- session helper:

// Store data in the session
session(['key' => 'value']);

// Retrieve data from the session
$value = session('key');

// Remove data from the session
session()->forget('key');

// Clearing the Entire Session
session()->flush();

אתה יכול גם להעביר ערך מקדיםdefinite כארגומנט השני לפונקציה session, שיוחזר אם המפתח שצוין לא יימצא בהפעלה:

$value = session('key', 'default');

מופע של Session Request

ב-Laravel, מופע בקשת הפעלה מתייחס לאובייקט המייצג בקשת HTTP ומכיל מידע על הבקשה, כגון שיטת הבקשה (GET, POST, PUT וכו'), כתובת URL של בקשה, כותרות הבקשה וגוף הבקשה. . הוא מכיל גם שיטות שונות שניתן להשתמש בהן כדי לאחזר ולתפעל מידע זה.

בדרך כלל אתה ניגש למופע של ה Session Request דרך המשתנה $request ביישום Laravel. לדוגמה, ניתן לגשת להפעלה דרך מופע בקשה באמצעות פונקציית העזר session().

use Illuminate\Http\Request;

class ExampleController extends Controller
{
   public function example(Request $request)
   {
       // Store data in the session using the put function
       $request->session()->put('key', 'value');

       // Retrieve data from the session using the get function
       $value = $request->session()->get('key');

       // Check if a value exists in the session using the has function:
       if ($request->session()->has('key')) {
           // The key exists in the session.
       }

       // To determine if a value exists in the session, even if its value is null:
       if ($request->session()->exists('users')) {
           // The value exists in the session.
       }

       // Remove data from the session using the forget function
       $request->session()->forget('key');
    }
}

בדוגמה זו, המשתנה  $request זה מופע של הכיתה Illuminate\Http\Request, המייצג את בקשת ה-HTTP הנוכחית. הפונקציה session request instance מחזיר מופע של המחלקה Illuminate\Session\Store, המספק פונקציות שונות לעבודה עם הפגישה.

Ercole Palmeri