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

Laravel 13 இப்போது பெரும்பாலான மாடல்களில் (models) காணப்படும் $table, $fillable மற்றும் $casts போன்ற பண்புகளை (properties), PHP-ன் இயல்பான attributes மூலம் மாற்ற அனுமதிக்கிறது. இந்த மாற்றம் மாடல் கட்டமைப்பு (model configuration) முதல் event listeners மற்றும் mailables வரை ஒரு டஜன் மேற்பட்ட framework அம்சங்களுக்குப் பொருந்தும், மேலும் இது ஏற்கனவே உள்ள குறியீட்டைப் பாதிக்காமல் (without breaking existing code) செயல்படும்.

ஏன் Laravel இயல்பான attributes-களைச் சேர்த்தது

Laravel நீண்டகாலமாக "magic strings" எனப்படும் முறையையே நம்பி வந்தது - அதாவது மாடல் வகுப்பின் (model class) தொடக்கத்தில் இருக்கும் நெடுவரிசைப் பெயர்கள் (column names) அல்லது மறைக்கப்பட்ட புலங்களின் (hidden fields) வரிசைகள் (arrays). அந்த வரிசைகள் அடிப்படையான ஸ்கீமா (schema) பற்றிய எந்தத் தகவலையும் IDE-க்குத் தருவதில்லை, எனவே ஒரு நெடுவரிசைப் பெயரை மாற்றும்போது (refactoring) அது கவனிக்கப்படாமல் விடுபடக்கூடும். கட்டமைப்பை (configuration) உண்மையான, வகைப்படுத்தப்பட்ட குறியீடாக (typed code) மாற்றுவதன் மூலம், டெவலப்பர்கள் தங்கள் வகுப்பின் உடலை (class body) வணிகத் தர்க்கத்தில் (business logic) மட்டும் கவனம் செலுத்தவும், அதே நேரத்தில் எடிட்டர் மூலம் autocomplete, type-checking மற்றும் rename-refactor போன்ற கருவிகளைப் பயன்படுத்தவும் Laravel வழிவகை செய்கிறது.

இந்த framework, PHP-ன் reflection API மூலம் attributes-களைப் படித்து அதன் முடிவைச் சேமித்து (cache) வைப்பதால், runtime overhead கிட்டத்தட்ட பூஜ்ஜியமாகும். தற்போதுள்ள property-அடிப்படையிலான மாடல்கள் இன்றும் போலவே தொடர்ந்து செயல்படும், எனவே நீங்கள் புதிய முறையைத் படிப்படியாகப் பின்பற்றலாம்.

நீங்கள் பெறும் நன்மைகள்

• வகைப்படுத்தப்பட்ட கட்டமைப்பு (Typed configuration) – Attributes வகைப்படுத்தப்பட்ட வாதங்களை (typed arguments) ஏற்றுக்கொள்கின்றன, இதனால் magic strings தவிர்க்கப்படுகின்றன. ஒரு நெடுவரிசைப் பெயரை மாற்றினால், அதை எங்கு மாற்ற வேண்டும் என்பதை IDE சுட்டிக்காட்டும்.
• சுத்தமான வகுப்ப bodies (Cleaner class bodies) – அனைத்து கட்டமைப்புகளும் class name-க்கு மேலே இருக்கும்; வகுப்பின் உடல் (body) உறவுகள் (relationships), scopes மற்றும் முறைகளை (methods) மட்டுமே கொண்டிருக்கும்.
• சிறந்த IDE அனுபவம் – Autocomplete மற்றும் static analysis ஆகியவை attribute வாதங்களில் வேலை செய்யும், இது string வரிசைகளால் (arrays of strings) சாத்தியமில்லை.
• பாதிப்பற்ற மாற்றங்கள் (No breaking changes) – Laravel பழைய properties மற்றும் புதிய attributes ஆகிய இரண்டையும் படிப்பதால், கலவையான codebase எந்தப் பிரச்சனையும் இன்றி இயங்கும்.

படிப்படியான இடமாற்ற வழிகாட்டி (Step-by-step migration guide)

1. இடமாற்ற வேண்டிய மாடலைக் கண்டறியவும்
   மாடல் கோப்பைத் திறக்கவும். முதல் பன்னிரண்டு வரிகளில் $table, $fillable, $hidden அல்லது casts() முறை ஆகியவை அதிகமாக இருந்தால், அது மாற்றத்திற்குத் தகுதியானது.

2. Attribute வகுப்புகளைச் சேர்க்கவும்
   கோப்பின் தொடக்கத்தில், நீங்கள் மாற்றப் போகும் properties-க்கு இணையான attribute வகுப்புகளை இறக்குமதி (import) செய்யவும் (உதாரணமாக, Table, Fillable, Casts). Laravel இந்த attributes-களைத் தானாகவே வழங்குகிறது.

3. Property அறிவிப்புகளை attributes மூலம் மாற்றவும்

   // 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
   }
   

   Attribute syntax நேரடியாக class declaration-க்கு மேலே இருக்கும். Attribute சரியாக வேலை செய்வதை உறுதி செய்த பிறகு, அசல் property அல்லது முறையை நீக்கிவிடவும்.

4. Test suite-ஐ இயக்கவும்
   mass-assignment, serialization மற்றும் ஏதேனும் தனிப்பயன் casting ஆகியவை முன்பைப் போலவே செயல்படுகின்றனவா என்பதைச் சரிபார்க்கவும். Laravel-ன் attribute கையாளுதல் cache செய்யப்படுவதால், ஒரு test தோல்வியடைந்தால், அது பெரும்பாலும் attribute வாதங்களில் உள்ள எழுத்துப் பிழையைக் (typo) குறிக்கும்.

5. சிறிய தொகுதிகளாக commit செய்து deploy செய்யவும்
   இடமாற்றம் செய்யப்பட்ட மாடலை ஒரு feature branch-க்கு அனுப்பவும், CI pipeline தேர்ச்சி பெற்ற பிறகு அதை merge செய்யவும், பின்னர் ஒரு குறிப்பிட்ட சர்வர் தொகுப்பிற்கு மட்டும் அறிமுகப்படுத்தவும். பழைய property syntax இன்னும் ஆதரிக்கப்படுவதால், ஏதேனும் தவறு நடந்தாலும் runtime error ஏற்படாது.

6. ஒவ்வொரு namespace-க்கும் இதைத் திரும்பச் செய்யவும்
   முழு codebase-ஐயும் ஒரே நேரத்தில் மாற்றுவதற்குப் பதிலாக, ஒரு தர்க்கரீதியான மாடல் தொகுப்பை (உதாரணமாக, அனைத்து billing தொடர்பான நிறுவனங்களையும்) attributes-க்கு மாற்றவும், பின்னர் அடுத்த தொகுப்பிற்கு இதைத் திரும்பச் செய்யவும். இது ஏதேனும் பிழைகள் ஏற்பட்டால் அதன் பாதிப்பைக் குறைக்க உதவும்.

கருவிகள் மற்றும் பாதுகாப்பு வலைப்பின்னல்கள்

• Rector – மீண்டும் மீண்டும் வரும் property syntax-ஐ attributes ஆக மாற்றக்கூடிய ஒரு தானியங்கி refactoring கருவி. codebase-ன் நகலில் இதை இயக்கி, மாற்றங்களைச் சரிபார்த்து, சரியான மாற்றங்களைச் செயல்படுத்தவும்.
• தானியங்கி சோதனைகள் (Automated tests) – Laravel-ன் உள்ளமைக்கப்பட்ட testing utilities, mass-assignment மற்றும் JSON output ஆகியவற்றில் உள்ள முரண்பாடுகளைக் கண்டறியும். ஒவ்வொரு இடமாற்றப் படிக்குப் பிறகும் அவற்றைச் சரியாகச் செயல்பட வைக்கவும்.
• Feature flags – நீங்கள் விரைவாக பழைய நிலைக்குத் திரும்பத் தேவைப்பட்டால், பழைய மற்றும் புதிய கட்டமைப்புகளுக்கு இடையே மாறுவதற்கு ஒரு flag-ஐப் பயன்படுத்தவும்.

எப்போது நீங்கள் இடமாற்றத்தைத் தவிர்க்கலாம்

ஒரு திட்டம் சிறியதாகவும், நிலையானதாகவும், அரிதாகவே மாற்றப்படுபதாகவும் இருந்தால், சுத்தமான மாடல்களைப் பெறுவதற்கான பயன், அதை மாற்ற எடுக்கும் முயற்சியை விட அதிகமாக இருக்காது. Attribute syntax என்பது விருப்பத்தேர்வு மட்டுமே; நீங்கள் பழைய property முறையையே தொடர்ந்து பயன்படுத்தலாம். மாறாக, தீவிரமாக உருவாக்கப்படும் பயன்பாடுகளுக்கு, குறிப்பாகப் பெரிய மாடல்கள் அல்லது அடிக்கடி ஸ்கீமா மாற்றங்கள் கொண்டவற்றுக்கு, ஆரம்பத்திலேயே attributes-களைப் பயன்படுத்துவது எதிர்காலச் சிரமங்களைக் குறைக்கும்.

அடுத்து கவனிக்க வேண்டியவை

Laravel 13-ன் attribute ஆதரவு மாடல்களைத் தாண்டி event listeners, notifications, mailables மற்றும் broadcast events ஆகியவற்றிற்கும் விரிவடைகிறது. சமூகம் (community) அந்தத் துறைகளிலும் இந்த முறையைப் பின்பற்றத் தொடங்கும் போது, இதே போன்ற refactoring முறைகள் உருவாகும். எதிர்கால சிறு வெளியீடுகளில் (minor releases) அறிமுகமாகும் புதிய attribute வகுப்புகள் குறித்து அதிகாரப்பூர்வ upgrade guide-ஐக் கவனித்துக் கொண்டே இருங்கள்.

முக்கியக் குறிப்பு: Laravel 13 உங்களுக்குக் குறைவான சுமை கொண்ட மற்றும் IDE-க்கு ஏற்ற மாடல்களைப் பெறுவதற்கான எளிதான வழியை வழங்குகிறது. ஒவ்வொரு namespace-ஆக மாற்றவும், Rector மற்றும் உங்கள் test suite-ஐப் பயன்படுத்தவும்; இதன் மூலம், உங்கள் வகுப்புகள் (classes) வெறும் configuration dump கோப்புகளைப் போல இல்லாமல், வணிக விவரக்குறிப்புகளைப் (business specifications) போன்றே வாசிக்கக்கூடியதாக மாறும்.