Laravel 13 Replaces $fillable, $table and $casts with Native PHP Attributes

Laravel 13 ഇനി മിക്ക മോഡലുകളിലും കാണപ്പെടുന്ന $table, $fillable, $casts എന്നീ പ്രോപ്പർട്ടികൾക്ക് പകരം നേറ്റീവ് PHP അറ്റ്രിബ്യൂട്ടുകൾ (native PHP attributes) ഉപയോഗിക്കാൻ നിങ്ങളെ അനുവദിക്കുന്നു. മോഡൽ കോൺഫിഗറേഷൻ മുതൽ ഇവന്റ് ലിസണറുകൾ (event listeners), മെയ്‌ലബിളുകൾ (mailables) വരെയുള്ള ഡസറ്റിലധികം ഫ്രെയിംവർക്ക് ഫീച്ചറുകളിൽ ഈ മാറ്റം ബാധകമാണ്. നിലവിലുള്ള കോഡുകളെ ബാധിക്കാതെ തന്നെ ഇത് പ്രവർത്തിക്കും.

എന്തുകൊണ്ടാണ് Laravel നേറ്റീവ് അറ്റ്രിബ്യൂട്ടുകൾ ഉൾപ്പെടുത്തിയത്?

മോഡൽ ക്ലാസുകളുടെ മുകളിൽ കാണപ്പെടുന്ന കോളം പേരുകളുടെയോ (column names) ഹിഡൻ ഫീൽഡുകളുടെയോ (hidden fields) അറേകൾ അഥവാ “മാജിക് സ്ട്രിംഗുകളെ” (magic strings) ആണ് Laravel കാലങ്ങളായി ആശ്രയിച്ചു വരുന്നത്. ഈ അറേകൾ ഉപയോഗിക്കുമ്പോൾ അവയുടെ സ്കീമയെക്കുറിച്ച് (schema) IDE-ക്ക് യാതൊരു സൂചനയും ലഭിക്കില്ല, അതിനാൽ ഒരു കോളം പേര് മാറ്റുമ്പോൾ (refactoring) അത് ശ്രദ്ധിക്കപ്പെടാതെ പോയേക്കാം. കോൺഫിഗറേഷൻ യഥാർത്ഥ ടൈപ്പ് ചെയ്ത കോഡിലേക്ക് (typed code) മാറ്റുന്നതിലൂടെ, ക്ലാസ് ബോഡി ബിസിനസ് ലോജിക്കിൽ മാത്രം ശ്രദ്ധ കേന്ദ്രീകരിക്കാനും ഒപ്പം എഡിറ്ററിലൂടെ ഓട്ടോകംപ്ലീറ്റ് (autocomplete), ടൈപ്പ്-ചെക്കിംഗ് (type-checking), റീനാം-റീഫാക്ടർ (rename-refactor) ടൂളുകൾ എന്നിവ ഉപയോഗിക്കാനും Laravel ഡെവലപ്പർമാരെ സഹായിക്കുന്നു.

ഫ്രെയിംവർക്ക് PHP-യുടെ reflection API വഴി അറ്റ്രിബ്യൂട്ടുകൾ വായിക്കുകയും ഫലം കാഷെ (cache) ചെയ്യുകയും ചെയ്യുന്നു, അതിനാൽ റൺടൈം ഓവർഹെഡ് (runtime overhead) പ്രായോഗികമായി പൂജ്യമാണ്. നിലവിലുള്ള പ്രോപ്പർട്ടി അടിസ്ഥാനമാക്കിയുള്ള മോഡലുകൾ പഴയതുപോലെ തന്നെ പ്രവർത്തിക്കും, അതായത് നിങ്ങൾക്ക് പുതിയ സിന്റാക്സ് ഘട്ടംഘട്ടമായി സ്വീകരിക്കാം.

നിങ്ങൾക്ക് ലഭിക്കുന്ന നേട്ടങ്ങൾ

• ടൈപ്പ് ചെയ്ത കോൺഫിഗറേഷൻ (Typed configuration) – അറ്റ്രിബ്യൂട്ടുകൾ ടൈപ്പ് ചെയ്ത ആർഗ്യുമെന്റുകൾ സ്വീകരിക്കുന്നു, ഇത് മാജിക് സ്ട്രിംഗുകളെ ഒഴിവാക്കുന്നു. ഒരു കോളം പേര് മാറ്റിയാൽ അത് അപ്‌ഡേറ്റ് ചെയ്യേണ്ട എല്ലാ സ്ഥലങ്ങളും IDE കാണിച്ചുതരും.
• വൃത്തിയുള്ള ക്ലാസ് ബോഡികൾ (Cleaner class bodies) – എല്ലാ കോൺഫിഗറേഷനുകളും ക്ലാസ് പേരിന് മുകളിൽ വരുന്നു; ക്ലാസ് ബോഡിയിൽ റിലേഷൻഷിപ്പുകൾ (relationships), സ്കോപ്പുകൾ (scopes), മെത്തേഡുകൾ (methods) എന്നിവ മാത്രം ഉണ്ടാകും.
• മികച്ച IDE അനുഭവം – സ്ട്രിംഗുകളുടെ അറേകൾക്ക് നൽകാൻ കഴിയാത്ത ഓട്ടോകംപ്ലീറ്റ്, സ്റ്റാറ്റിക് അനാലിസിസ് (static analysis) എന്നിവ അറ്റ്രിബ്യൂട്ട് ആർഗ്യുമെന്റുകളിൽ ലഭ്യമാണ്.
• പ്രശ്നങ്ങളില്ലാത്ത മാറ്റങ്ങൾ (No breaking changes) – Laravel പഴയ പ്രോപ്പർട്ടികളും പുതിയ അറ്റ്രിബ്യൂട്ടുകളും ഒരുപോലെ വായിക്കുന്നു, അതിനാൽ പഴയതും പുതിയതും കലർന്ന കോഡ് പ്രശ്നങ്ങളില്ലാതെ പ്രവർത്തിക്കും.

ഘട്ടം ഘട്ടമായുള്ള മൈഗ്രേഷൻ ഗൈഡ്

1. മൈഗ്രേറ്റ് ചെയ്യേണ്ട മോഡൽ കണ്ടെത്തുക
   മോഡൽ ഫയൽ തുറക്കുക. ആദ്യത്തെ കുറച്ച് വരികളിൽ $table, $fillable, $hidden അല്ലെങ്കിൽ casts() മെത്തേഡ് എന്നിവയാണ് കൂടുതലായി കാണുന്നതെങ്കിൽ, അത് മൈഗ്രേറ്റ് ചെയ്യാൻ അനുയോജ്യമാണ്.

2. അറ്റ്രിബ്യൂട്ട് ക്ലാസുകൾ ചേർക്കുക
   ഫയലിന്റെ മുകളിൽ, നിങ്ങൾ മാറ്റാൻ ഉദ്ദേശിക്കുന്ന പ്രോപ്പർട്ടികൾക്ക് അനുയോജ്യമായ അറ്റ്രിബ്യൂട്ട് ക്ലാസുകൾ ഇംപോർട്ട് ചെയ്യുക (ഉദാഹരണത്തിന്: Table, Fillable, Casts). Laravel ഈ അറ്റ്രിബ്യൂട്ടുകൾ നേരിട്ട് നൽകുന്നുണ്ട്.

3. പ്രോപ്പർട്ടി ഡിക്ലറേഷനുകൾക്ക് പകരം അറ്റ്രിബ്യൂട്ടുകൾ ഉപയോഗിക്കുക

   // Before
   protected $table = 'site_deployments';
   protected $fillable = ['site_id', 'server_id', 'status'];
   protected function casts(): array
   {
       return ['is_rollback' => 'boolean'];
   }
   

   // After
   #[Table('site_deployments')]
   #[Fillable(['site_id', 'server_id', 'status'])]
   #[Casts(['is_rollback' => 'boolean'])]
   class Deployment extends Model
   {
       // business logic only
   }
   

   അറ്റ്രിബ്യൂട്ട് സിന്റാക്സ് ക്ലാസ് ഡിക്ലറേഷന് തൊട്ടുമുകളിൽ വരുന്നു. അറ്റ്രിബ്യൂട്ട് ശരിയായി പ്രവർത്തിക്കുന്നു എന്ന് ഉറപ്പുവരുത്തിയ ശേഷം പഴയ പ്രോപ്പർട്ടി അല്ലെങ്കിൽ മെത്തേഡ് നീക്കം ചെയ്യുക.

4. ടെസ്റ്റ് സ്യൂട്ട് റൺ ചെയ്യുക
   മാസ്-അസൈൻമെന്റ് (mass-assignment), സീരിയലൈസേഷൻ (serialization), കസ്റ്റം കാസ്റ്റിംഗ് (custom casting) എന്നിവ പഴയതുപോലെ തന്നെയാണോ പ്രവർത്തിക്കുന്നത് എന്ന് പരിശോധിക്കുക. Laravel-ന്റെ അറ്റ്രിബ്യൂട്ട് ഹാൻഡ്‌ലിംഗ് കാഷെ ചെയ്യപ്പെടുന്നതിനാൽ, ഒരു ടെസ്റ്റ് പരാജയപ്പെട്ടാൽ അത് അറ്റ്രിബ്യൂട്ട് ആർഗ്യുമെന്റുകളിലെ ടൈപ്പിംഗ് പിശക് (typo) കാരണമാകാം.

5. ചെറിയ ബാച്ചുകളായി കമിറ്റ് ചെയ്യുക, ഡിപ്ലോയ് ചെയ്യുക
   മൈഗ്രേറ്റ് ചെയ്ത മോഡൽ ഒരു ഫീച്ചർ ബ്രാഞ്ചിലേക്ക് പുഷ് ചെയ്യുക, CI പൈപ്പ്‌ലൈൻ പാസായ ശേഷം അത് മെർജ് ചെയ്യുക, തുടർന്ന് കുറച്ച് സെർവറുകളിൽ മാത്രം ഇത് നടപ്പിലാക്കുക. പഴയ പ്രോപ്പർട്ടി സിന്റാക്സ് ഇപ്പോഴും സപ്പോർട്ട് ചെയ്യുന്നതിനാൽ, ഏതെങ്കിലും ഭാഗത്ത് പഴയ രീതി ഉപയോഗിച്ചിട്ടുണ്ടെങ്കിൽ പോലും അത് റൺടൈം എററുകൾ ഉണ്ടാക്കില്ല.

6. ഓരോ നെയിംസ്പേസ് (namespace) അനുസരിച്ച് ആവർത്തിക്കുക
   മുഴുവൻ കോഡ്ബേസും ഒരേസമയം മാറ്റുന്നതിന് പകരം, മോഡലുകളുടെ ഓരോ ലോജിക്കൽ ഗ്രൂപ്പുകൾ (ഉദാഹരണത്തിന്: ബില്ലിംഗുമായി ബന്ധപ്പെട്ട എല്ലാ എൻ്റേറ്റികളും) അറ്റ്രിബ്യൂട്ടുകളിലേക്ക് മാറ്റുക, തുടർന്ന് അടുത്ത ഗ്രൂപ്പിലേക്ക് ഇത് ആവർത്തിക്കുക. ഇത് പിശകുകൾ ഉണ്ടാകാനുള്ള സാധ്യത കുറയ്ക്കുന്നു.

ടൂളുകളും സുരക്ഷാ മാർഗങ്ങളും

• Rector – ആവർത്തന സ്വഭാവമുള്ള പ്രോപ്പർട്ടി സിന്റാക്സിനെ അറ്റ്രിബ്യൂട്ടുകളാക്കി മാറ്റാൻ കഴിയുന്ന ഒരു ഓട്ടോമേറ്റഡ് റീഫാക്ടിംഗ് ടൂൾ. കോഡ്ബേസിന്റെ ഒരു കോപ്പിയിൽ ഇത് റൺ ചെയ്യുക, മാറ്റങ്ങൾ (diff) പരിശോധിക്കുക, ശരിയെന്ന് തോന്നുന്ന മാറ്റങ്ങൾ മാത്രം നടപ്പിലാക്കുക.
• ഓട്ടോമേറ്റഡ് ടെസ്റ്റുകൾ – മാസ്-അസൈൻമെന്റിലും JSON ഔട്ട്‌പുട്ടിലും ഉണ്ടാകുന്ന വ്യത്യാസങ്ങൾ കണ്ടെത്താൻ Laravel-ന്റെ ഇൻബിൽറ്റ് ടെസ്റ്റിംഗ് യൂട്ടിലിറ്റികൾ സഹായിക്കും. ഓരോ മൈഗ്രേഷൻ ഘട്ടത്തിന് ശേഷവും ടെസ്റ്റുകൾ പരാജയപ്പെടുന്നില്ലെന്ന് (green) ഉറപ്പാക്കുക.
• ഫീച്ചർ ഫ്ലാഗുകൾ (Feature flags) – വേഗത്തിൽ പഴയ അവസ്ഥയിലേക്ക് മടങ്ങേണ്ടി വന്നാൽ, പഴയതും പുതിയതുമായ കോൺഫിഗറേഷനുകൾക്കിടയിൽ മാറാൻ സഹായിക്കുന്ന ഒരു ഫ്ലാഗ് ഉപയോഗിച്ച് പുതിയ അറ്റ്രിബ്യൂട്ട് ഉപയോഗം നിയന്ത്രിക്കാം.

മൈഗ്രേഷൻ ഒഴിവാക്കാവുന്ന സാഹചര്യങ്ങൾ

ഒരു പ്രോജക്റ്റ് ചെറുതും സ്ഥിരതയുള്ളതും അധികം മാറ്റങ്ങൾ വരുത്താത്തതുമാണെങ്കിൽ, മോഡലുകൾ വൃത്തിയാക്കുന്നതിലൂടെ ലഭിക്കുന്ന നേട്ടം അതിനായി എടുക്കേണ്ട പ്രയത്നത്തേക്കാൾ കുറവായിരിക്കാം. അറ്റ്രിബ്യൂട്ട് സിന്റാക്സ് ഉപയോഗിക്കുന്നത് നിർബന്ധമല്ല; നിങ്ങൾക്ക് പഴയ പ്രോപ്പർട്ടി രീതി തന്നെ തുടർന്നും ഉപയോഗിക്കാം. നേരെമറിച്ച്, സജീവമായി വികസിപ്പിച്ചുകൊണ്ടിരിക്കുന്ന ആപ്ലിക്കേഷനുകൾക്ക്, പ്രത്യേകിച്ച് വലിയ മോഡലുകളോ ഇടയ്ക്കിടെ സ്കീമയിൽ മാറ്റങ്ങളോ വരുന്നവയ്ക്ക്, നേരത്തെ തന്നെ അറ്റ്രിബ്യൂട്ടുകൾ സ്വീകരിക്കുന്നത് ഭാവിയിലെ ബുദ്ധിമുട്ടുകൾ കുറയ്ക്കും.

ഇനി ശ്രദ്ധിക്കേണ്ട കാര്യങ്ങൾ

Laravel 13-ന്റെ അറ്റ്രിബ്യൂട്ട് സപ്പോർട്ട് മോഡലുകൾക്ക് പുറമെ ഇവന്റ് ലിസണറുകൾ, നോട്ടിഫിക്കേഷനുകൾ, മെയ്‌ലബിളുകൾ, ബ്രോഡ്കാസ്റ്റ് ഇവന്റുകൾ എന്നിവയിലേക്കും വ്യാപിക്കുന്നു. കമ്മ്യൂണിറ്റി ഈ സിന്റാക്സ് ഉപയോഗിച്ചു തുടങ്ങുന്നതോടെ സമാനമായ റീഫാക്ടിംഗ് രീതികൾ ഉയർന്നുവരും. ഭാവിയിലെ മൈനർ റിലീസുകളിൽ വരുന്ന പുതിയ അറ്റ്രിബ്യൂട്ട് ക്ലാസുകളെക്കുറിച്ച് അറിയാൻ ഔദ്യോഗിക അപ്‌ഗ്രേഡ് ഗൈഡ് ശ്രദ്ധിക്കുക.

ചുരുക്കത്തിൽ: കൂടുതൽ ലളിതവും IDE-friendly ആയതുമായ മോഡലുകളിലേക്ക് അധിക പ്രയത്നമില്ലാതെ മാറാൻ Laravel 13 നിങ്ങളെ സഹായിക്കുന്നു. ഓരോ namespace-ഉം ഓരോന്നായി മാറ്റിക്കൊണ്ട്, Rector-നെയും നിങ്ങളുടെ test suite-നെയും ആശ്രയിക്കുക; അങ്ങനെ ചെയ്യുമ്പോൾ കോൺഫിഗറേഷൻ ഡമ്പ് ഫയലുകൾക്ക് പകരം ബിസിനസ്സ് സ്പെസിഫിക്കേഷനുകൾ പോലെ വായിക്കാവുന്ന ക്ലാസുകൾ നിങ്ങൾക്ക് ലഭിക്കും.