חזרה לפיד
articlesמקור: Security Docs — php

Laravel — הגבלת שדות ב-Mass Assignment

אמ;לק

הגבלת שדות הניתנים למילוי ב-Eloquent; יש לבדוק הרשאות בנפרד.

סיכום בעברית: מערכת VibeSec · מדיניות המקורות

נוסף ל-VibeSec:

$cat article.txt

>הגבלת שדות הניתנים למילוי ב-Eloquent; יש לבדוק הרשאות בנפרד.

התוכן המלא בעברית

תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.

אזהרה: אתה גולש בתיעוד עבור גרסה ישנה של Laravel. שקול לשדרג את הפרויקט שלך ל-Laravel 13.x.

• אחזור מודלים בודדים / צבירת נתונים (Aggregates) - אחזור או יצירת מודלים

מבוא

Laravel כולל את Eloquent, ממפה אובייקטים-יחסי (ORM) שהופך את האינטראקציה עם מסד הנתונים לחוויה מהנה. בעת שימוש ב-Eloquent, לכל טבלה במסד הנתונים יש "Model" תואם המשמש לאינטראקציה עם אותה טבלה. מעבר לאחזור רשומות, מודלים של Eloquent מאפשרים לך גם להוסיף, לעדכן ולמחוק רשומות מהטבלה.

לפני שתתחיל, הקפד להגדיר חיבור למסד נתונים בקובץ התצורה ⁦config/database.php⁩ של היישום שלך. למידע נוסף על הגדרת מסד הנתונים שלך, עיין בתיעוד של תצורת מסד הנתונים.

יצירת מחלקות מודל (Generating Model Classes)

כדי להתחיל, בואו ניצור מודל Eloquent. מודלים בדרך כלל נמצאים בספריית app\Models ומרחיבים את המחלקה Illuminate\Database\Eloquent\Model. ניתן להשתמש בפקודת ה-Artisan בשם make:model כדי ליצור מודל חדש:

⁦1 php artisan make:model Flight php artisan make:model Flight⁩

אם תרצה ליצור Migration עבור מסד הנתונים בעת יצירת המודל, תוכל להשתמש באופציה --migration או -m:

⁦1 php artisan make:model Flight --migration php artisan make:model Flight --migration⁩

ניתן ליצור סוגים נוספים של מחלקות בעת יצירת מודל, כגון factories, seeders, policies, controllers ובקשות טופס (form requests). בנוסף, ניתן לשלב את האפשרויות הללו ליצירת מחלקות מרובות בו-זמנית:

⁦1 # Generate a model and a FlightFactory class... 2 php artisan make:model Flight --factory 3 php artisan make:model Flight -f 4 5 # Generate a model and a FlightSeeder class... 6 php artisan make:model Flight --seed 7 php artisan make:model Flight -s 8 9 # Generate a model and a FlightController class... 10 php artisan make:model Flight --controller 11 php artisan make:model Flight -c 12 13 # Generate a model, FlightController resource class, and form request classes... 14 php artisan make:model Flight --controller --resource --requests 15 php artisan make:model Flight -crR 16 17 # Generate a model and a FlightPolicy class... 18 php artisan make:model Flight --policy 19 20 # Generate a model and a migration, factory, seeder, and controller... 21 php artisan make:model Flight -mfsc 22 23 # Shortcut to generate a model, migration, factory, seeder, policy, controller, and form requests... 24 php artisan make:model Flight --all 25 php artisan make:model Flight -a 26 27 # Generate a pivot model... 28 php artisan make:model Member --pivot 29 php artisan make:model Member -p # Generate a model and a FlightFactory class... php artisan make:model Flight --factory php artisan make:model Flight -f # Generate a model and a FlightSeeder class... php artisan make:model Flight --seed php artisan make:model Flight -s # Generate a model and a FlightController class... php artisan make:model Flight --controller php artisan make:model Flight -c # Generate a model, FlightController resource class, and form request classes... php artisan make:model Flight --controller --resource --requests php artisan make:model Flight -crR # Generate a model and a FlightPolicy class... php artisan make:model Flight --policy # Generate a model and a migration, factory, seeder, and controller... php artisan make:model Flight -mfsc # Shortcut to generate a model, migration, factory, seeder, policy, controller, and form requests... php artisan make:model Flight --all php artisan make:model Flight -a # Generate a pivot model... php artisan make:model Member --pivot php artisan make:model Member -p⁩

בדיקת מודלים (Inspecting Models)

לפעמים קשה לקבוע מהן כל התכונות והקשרים הזמינים של מודל רק על ידי רפרוף בקוד. במקום זאת, נסה את פקודת ה-Artisan בשם model:show, המספקת סקירה נוחה של כל התכונות והקשרים של המודל:

⁦1 php artisan model:show Flight php artisan model:show Flight⁩

מוסכמות של מודל Eloquent

מודלים שנוצרו על ידי הפקודה make:model יוצבו בספרייה app/Models. הבה נבחן מחלקת מודל בסיסית ונדון בכמה מהמוסכמות המרכזיות של Eloquent:

⁦1 <?php 2 3 namespace App\Models; 4 5 use Illuminate\Database\Eloquent\ Model ; 6 7 class Flight extends Model 8 { 9 // ... 10 } <?php namespace App\Models; use Illuminate\Database\Eloquent\Model; class Flight extends Model { // ... }⁩

שמות טבלאות

לאחר מבט בדוגמה שלמעלה, אולי שמת לב שלא ציינו בפני Eloquent איזו טבלה במסד הנתונים מתאימה למודל ה-Flight שלנו. על פי המוסכמה, שם המחלקה בפורמט "snake case" וברבים ישמש כשם הטבלה, אלא אם צוין שם אחר במפורש. לכן, במקרה זה, Eloquent יניח שהמודל Flight מאחסן רשומות בטבלת flights, בעוד שמודל AirTrafficController יאחסן רשומות בטבלת air_traffic_controllers.

אם טבלת מסד הנתונים המתאימה למודל שלך אינה תואמת מוסכמה זו, תוכל לציין ידנית את שם הטבלה על ידי הגדרת מאפיין $table במודל:

⁦1 <?php 2 3 namespace App\Models; 4 5 use Illuminate\Database\Eloquent\ Model ; 6 7 class Flight extends Model 8 { 9 /** 10 * The table associated with the model. 11 * 12 * @var string 13 */ 14 protected $table = ' my_flights ' ; 15 } <?php namespace App\Models; use Illuminate\Database\Eloquent\Model; class Flight extends Model { /** * The table associated with the model. * * @var string */ protected $table = 'my_flights'; }⁩

מפתחות ראשיים (Primary Keys)

Eloquent מניח שלכל טבלה תואמת של מודל יש עמודת מפתח ראשי בשם id. במידת הצורך, תוכל להגדיר מאפיין $primaryKey מוגן במודל שלך כדי לציין עמודה אחרת שתשמש כמפתח הראשי:

⁦1 <?php 2 3 namespace App\Models; 4 5 use Illuminate\Database\Eloquent\ Model ; 6 7 class Flight extends Model 8 { 9 /** 10 * The primary key associated with the table. 11 * 12 * @var string 13 */ 14 protected $primaryKey = ' flight_id ' ; 15 } <?php namespace App\Models; use Illuminate\Database\Eloquent\Model; class Flight extends Model { /** * The primary key associated with the table. * * @var string */ protected $primaryKey = 'flight_id'; }⁩

בנוסף, Eloquent מניח שהמפתח הראשי הוא מספר שלם עם הגדלה אוטומטית (auto-incrementing), מה שאומר ש-Eloquent ימיר אוטומטית את המפתח הראשי למספר שלם. אם ברצונך להשתמש במפתח ראשי שאינו מספרי או שאינו בעל הגדלה אוטומטית, עליך להגדיר מאפיין $incrementing ציבורי במודל שלך שערכו false:

⁦1 <?php 2 3 class Flight extends Model 4 { 5 /** 6 * Indicates if the model's ID is auto-incrementing. 7 * 8 * @var bool 9 */ 10 public $incrementing = false ; 11 } <?php class Flight extends Model { /** * Indicates if the model's ID is auto-incrementing. * * @var bool */ public $incrementing = false; }⁩

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

⁦1 <?php 2 3 class Flight extends Model 4 { 5 /** 6 * The data type of the primary key ID. 7 * 8 * @var string 9 */ 10 protected $keyType = ' string ' ; 11 } <?php class Flight extends Model { /** * The data type of the primary key ID. * * @var string */ protected $keyType = 'string'; }⁩

מפתחות ראשיים "מורכבים" (Composite)

Eloquent דורש שכל מודל יכיל לפחות "ID" מזהה ייחודי אחד שיכול לשמש כמפתח ראשי. מודלים של Eloquent אינם תומכים במפתחות ראשיים "מורכבים" (Composite). עם זאת, אתה חופשי להוסיף אינדקסים ייחודיים המורכבים ממספר עמודות לטבלאות מסד הנתונים שלך, בנוסף למפתח הראשי הייחודי של הטבלה.

מפתחות UUID ו-ULID

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

אם תרצה שמודל ישתמש במפתח UUID במקום במפתח מספרי עם הגדלה אוטומטית, תוכל להשתמש ב-trait בשם Illuminate\Database\Eloquent\Concerns\HasUuids במודל. כמובן, עליך לוודא שלמודל יש עמודת מפתח ראשי שתואמת ל-UUID:

⁦1 use Illuminate\Database\Eloquent\Concerns\ HasUuids ; 2 use Illuminate\Database\Eloquent\ Model ; 3 4 class Article extends Model 5 { 6 use HasUuids ; 7 8 // ... 9 } 10 11 $article = Article :: create ([ ' title ' => ' Traveling to Europe ' ]); 12 13 $article ->id ; // "018f2b5c-6a7f-7b12-9d6f-2f8a4e0c9c11" use Illuminate\Database\Eloquent\Concerns\HasUuids; use Illuminate\Database\Eloquent\Model; class Article extends Model { use HasUuids; // ... } $article = Article::create(['title' => 'Traveling to Europe']); $article->id; // "018f2b5c-6a7f-7b12-9d6f-2f8a4e0c9c11"⁩

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

ניתן לעקוף את תהליך יצירת ה-UUID עבור מודל נתון על ידי הגדרת מתודה בשם newUniqueId במודל. בנוסף, תוכל לציין אילו עמודות צריכות לקבל מזהי UUID על ידי הגדרת מתודה בשם uniqueIds במודל:

⁦1 use Ramsey\Uuid\ Uuid ; 2 3 /** 4 * Generate a new UUID for the model. 5 */ 6 public function newUniqueId () : string 7 { 8 return ( string ) Uuid :: uuid4 (); 9 } 10 11 /** 12 * Get the columns that should receive a unique identifier. 13 * 14 * @return array < int , string> 15 */ 16 public function uniqueIds () : array 17 { 18 return [ ' id ' , ' discount_code ' ]; 19 } use Ramsey\Uuid\Uuid; /** * Generate a new UUID for the model. */ public function newUniqueId(): string { return (string) Uuid::uuid4(); } /** * Get the columns that should receive a unique identifier. * * @return array<int, string> */ public function uniqueIds(): array { return ['id', 'discount_code']; }⁩

אם תרצה, תוכל לבחור להשתמש ב-"ULIDs" במקום ב-UUIDs. מזהי ULID דומים ל-UUIDs; עם זאת, אורכם הוא 26 תווים בלבד. בדומה ל-UUIDs מסודרים, מזהי ULID ניתנים למיון לקסיקוגרפי לטובת יצירת אינדקס יעילה במסד הנתונים. כדי להשתמש ב-ULIDs, עליך להשתמש ב-trait מסוג Illuminate\Database\Eloquent\Concerns\HasUlids במודל שלך. עליך גם לוודא שלמודל יש עמודת מפתח ראשי תואמת ל-ULID:

⁦1 use Illuminate\Database\Eloquent\Concerns\ HasUlids ; 2 use Illuminate\Database\Eloquent\ Model ; 3 4 class Article extends Model 5 { 6 use HasUlids ; 7 8 // ... 9 } 10 11 $article = Article :: create ([ ' title ' => ' Traveling to Asia ' ]); 12 13 $article ->id ; // "01gd4d3tgrrfqeda94gdbtdk5c" use Illuminate\Database\Eloquent\Concerns\HasUlids; use Illuminate\Database\Eloquent\Model; class Article extends Model { use HasUlids; // ... } $article = Article::create(['title' => 'Traveling to Asia']); $article->id; // "01gd4d3tgrrfqeda94gdbtdk5c"⁩

חותמות זמן (Timestamps)

כברירת מחדל, Eloquent מצפה שעמודות created_at ו-updated_at יהיו קיימות בטבלה התואמת למודל שלך. Eloquent יגדיר אוטומטית את ערכי עמודות אלו כאשר מודלים נוצרים או מתעדכנים. אם אינך מעוניין שעמודות אלו ינוהלו אוטומטית על ידי Eloquent, עליך להגדיר מאפיין $timestamps במודל שלך עם הערך false:

⁦1 <?php 2 3 namespace App\Models; 4 5 use Illuminate\Database\Eloquent\ Model ; 6 7 class Flight extends Model 8 { 9 /** 10 * Indicates if the model should be timestamped. 11 * 12 * @var bool 13 */ 14 public $timestamps = false ; 15 } <?php namespace App\Models; use Illuminate\Database\Eloquent\Model; class Flight extends Model { /** * Indicates if the model should be timestamped. * * @var bool */ public $timestamps = false; }⁩

אם עליך להתאים אישית את הפורמט של חותמות הזמן במודל, הגדר את המאפיין $dateFormat במודל שלך. מאפיין זה קובע כיצד תכונות תאריך נשמרות במסד הנתונים וכן את הפורמט שלהן כאשר המודל מומר למערך (array) או ל-JSON:

#php#security#official-docs
קרא במקור

קריאה וכלים קשורים

אבטחת PHP / Laravelמונחי אבטחה והסברים בעברית