Laravel 13, $fillable, $table ਅਤੇ $casts ਨੂੰ Native PHP Attributes ਨਾਲ ਬਦਲ ਰਿਹਾ ਹੈ

Laravel 13 ਹੁਣ ਤੁਹਾਨੂੰ $table, $fillable ਅਤੇ $casts ਪ੍ਰੋਪਰਟੀਜ਼ ਨੂੰ, ਜੋ ਕਿ ਜ਼ਿਆਦਾਤਰ ਮਾਡਲਾਂ ਵਿੱਚ ਭਰ ਦਿੱਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, native PHP attributes ਨਾਲ ਬਦਲਣ ਦੀ ਇਜਾਜ਼ਤ ਦਿੰਦਾ ਹੈ। ਇਹ ਬਦਲਾਅ ਇੱਕ ਦਰਜਨ ਤੋਂ ਵੱਧ ਫਰੇਮਵਰਕ ਫੀਚਰਾਂ 'ਤੇ ਲਾਗੂ ਹੁੰਦਾ ਹੈ, ਮਾਡਲ ਕੌਂਫਿਗਰੇਸ਼ਨ ਤੋਂ ਲੈ ਕੇ event listeners ਅਤੇ mailables ਤੱਕ, ਅਤੇ ਇਹ ਮੌਜੂਦਾ ਕੋਡ ਨੂੰ ਤੋੜੇ ਬਿਨਾਂ ਕੰਮ ਕਰਦਾ ਹੈ।

Laravel ਨੇ native attributes ਕਿਉਂ ਜੋੜੇ

Laravel ਲੰਬੇ ਸਮੇਂ ਤੋਂ “magic strings” 'ਤੇ ਨਿਰਭਰ ਰਿਹਾ ਹੈ – ਕਾਲਮ ਦੇ ਨਾਮ ਜਾਂ ਲੁਕਵੇਂ ਫੀਲਡਾਂ ਦੇ ਅਰੇਅ (arrays) ਜੋ ਇੱਕ ਮਾਡਲ ਕਲਾਸ ਦੇ ਉੱਪਰ ਹੁੰਦੇ ਹਨ। ਉਹ ਅਰੇਅ IDE ਨੂੰ ਅੰਡਰਲਾਈਂਗ schema ਬਾਰੇ ਕੋਈ ਸੰਕੇਤ ਨਹੀਂ ਦਿੰਦੇ, ਇਸ ਲਈ ਕਾਲਮ ਦੇ ਨਾਮ ਨੂੰ refactor ਕਰਨਾ ਅਣਗੋਚੇ ਰਹਿ ਸਕਦਾ ਹੈ। ਕੌਂਫਿਗਰੇਸ਼ਨ ਨੂੰ ਅਸਲੀ, typed ਕੋਡ ਵਿੱਚ ਬਦਲ ਕੇ, Laravel ਡਿਵੈਲਪਰਾਂ ਨੂੰ ਕਲਾਸ ਬਾਡੀ ਨੂੰ business logic 'ਤੇ ਕੇਂਦਰਿਤ ਰੱਖਣ ਦਾ ਤਰੀਕਾ ਦਿੰਦਾ ਹੈ, ਜਦੋਂ ਕਿ ਐਡੀਟਰ ਨੂੰ autocomplete, type-checking ਅਤੇ rename-refactor ਟੂਲਸ ਦੀ ਸਹੂਲਤ ਮਿਲਦੀ ਹੈ।

ਫਰੇਮਵਰਕ PHP ਦੇ reflection API ਰਾਹੀਂ attributes ਨੂੰ ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ ਨਤੀਜੇ ਨੂੰ ਕੈਸ਼ (cache) ਕਰਦਾ ਹੈ, ਇਸ ਲਈ runtime overhead ਅਸਲ ਵਿੱਚ ਜ਼ੀਰੋ ਹੈ। ਮੌਜੂਦਾ property-based ਮਾਡਲ ਬਿਲਕੁਲ ਉਸੇ ਤਰ੍ਹਾਂ ਕੰਮ ਕਰਦੇ ਰਹਿਣਗੇ ਜਿਵੇਂ ਉਹ ਅੱਜ ਕਰਦੇ ਹਨ, ਜਿਸਦਾ ਮਤਲਬ ਹੈ ਕਿ ਤੁਸੀਂ ਨਵੇਂ ਸਿੰਟੈਕਸ ਨੂੰ ਹੌਲੀ-ਹੌਲੀ ਅਪਣਾ ਸਕਦੇ ਹੋ।

ਤੁਹਾਨੂੰ ਕੀ ਫਾਇਦਾ ਹੋਵੇਗਾ

• Typed configuration – Attributes typed arguments ਸਵੀਕਾਰ ਕਰਦੇ ਹਨ, ਜਿਸ ਨਾਲ magic strings ਖਤਮ ਹੋ ਜਾਂਦੇ ਹਨ। ਇੱਕ ਕਾਲਮ ਦਾ ਨਾਮ ਬਦਲੋ ਅਤੇ IDE ਤੁਹਾਨੂੰ ਹਰ ਉਸ ਜਗ੍ਹਾ 'ਤੇ ਇਸ਼ਾਰਾ ਕਰੇਗਾ ਜਿੱਥੇ ਤੁਹਾਨੂੰ ਅਪਡੇਟ ਕਰਨ ਦੀ ਲੋੜ ਹੈ।
• Cleaner class bodies – ਸਾਰੀ ਕੌਂਫਿਗਰੇਸ਼ਨ ਕਲਾਸ ਦੇ ਨਾਮ ਦੇ ਉੱਪਰ ਹੁੰਦੀ ਹੈ; ਬਾਡੀ ਵਿੱਚ ਸਿਰਫ਼ ਰਿਲੇਸ਼ਨਸ਼ਿਪਸ, ਸਕੋਪਸ ਅਤੇ ਮੈਥਡਸ ਹੁੰਦੇ ਹਨ।
• Better IDE experience – Autocomplete ਅਤੇ static analysis attribute arguments 'ਤੇ ਕੰਮ ਕਰਦੇ ਹਨ, ਜੋ ਕਿ string ਦੇ ਅਰੇਅ ਨਹੀਂ ਕਰ ਸਕਦੇ।
• No breaking changes – Laravel ਪੁਰਾਣੀਆਂ ਪ੍ਰੋਪਰਟੀਜ਼ ਅਤੇ ਨਵੇਂ attributes ਦੋਵਾਂ ਨੂੰ ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ ਇੱਕ ਮਿਕਸਡ ਕੋਡਬੇਸ ਬਿਨਾਂ ਕਿਸੇ ਸਮੱਸਿਆ ਦੇ ਚੱਲਦਾ ਹੈ।

ਸਟੈਪ-ਬਾਈ-ਸਟੈਪ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ

1. ਮਾਈਗ੍ਰੇਟ ਕਰਨ ਲਈ ਮਾਡਲ ਦੀ ਪਛਾਣ ਕਰੋ
   ਮਾਡਲ ਫਾਈਲ ਖੋਲ੍ਹੋ। ਜੇਕਰ ਪਹਿਲੀਆਂ ਦਰਜਨ ਲਾਈਨਾਂ $table, $fillable, $hidden ਜਾਂ ਇੱਕ casts() ਮੈਥਡ ਦੁਆਰਾ ਘੇਰੀਆਂ ਹੋਈਆਂ ਹਨ, ਤਾਂ ਇਹ ਇੱਕ ਉਮੀਦਵਾਰ ਹੈ।

2. Attribute ਕਲਾਸਾਂ ਜੋੜੋ
   ਫਾਈਲ ਦੇ ਉੱਪਰ, ਉਹ attribute ਕਲਾਸਾਂ ਇੰਪੋਰਟ ਕਰੋ ਜੋ ਉਹਨਾਂ ਪ੍ਰੋਪਰਟੀਜ਼ ਨਾਲ ਮੇਲ ਖਾਂਦੀਆਂ ਹਨ ਜਿਨ੍ਹਾਂ ਨੂੰ ਤੁਸੀਂ ਬਦਲੋਗੇ (ਜਿਵੇਂ ਕਿ Table, Fillable, Casts)। Laravel ਇਹ attributes ਪਹਿਲਾਂ ਤੋਂ ਹੀ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ।

3. ਪ੍ਰੋਪਰਟੀ ਡਿਕਲੇਰੇਸ਼ਨਾਂ ਨੂੰ 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 ਸਿੰਟੈਕਸ ਸਿੱਧਾ ਕਲਾਸ ਡਿਕਲੇਰੇਸ਼ਨ ਦੇ ਉੱਪਰ ਹੁੰਦਾ ਹੈ। ਇਹ ਪੁਸ਼ਟੀ ਕਰਨ ਤੋਂ ਬਾਅਦ ਕਿ attribute ਕੰਮ ਕਰ ਰਿਹਾ ਹੈ, ਅਸਲ ਪ੍ਰੋਪਰਟੀ ਜਾਂ ਮੈਥਡ ਨੂੰ ਹਟਾ ਦਿਓ।

4. ਟੈਸਟ ਸੂਟ ਚਲਾਓ
   ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ mass-assignment, serialization ਅਤੇ ਕੋਈ ਵੀ ਕਸਟਮ casting ਅਜੇ ਵੀ ਪਹਿਲਾਂ ਵਾਂਗ ਹੀ ਕੰਮ ਕਰ ਰਹੀ ਹੈ। Laravel ਦੀ attribute handling ਕੈਸ਼ ਕੀਤੀ ਹੁੰਦੀ ਹੈ, ਇਸ ਲਈ ਅਸਫਲ ਟੈਸਟ ਆਮ ਤੌਰ 'ਤੇ attribute arguments ਵਿੱਚ ਟਾਈਪੋ (typo) ਵੱਲ ਇਸ਼ਾਰਾ ਕਰਦਾ ਹੈ।

5. ਛੋਟੇ ਬੈਚਾਂ ਵਿੱਚ ਕਮਿਟ ਅਤੇ ਡਿਪਲੋਏ ਕਰੋ
   ਮਾਈਗ੍ਰੇਟ ਕੀਤੇ ਹੋਏ ਮਾਡਲ ਨੂੰ ਇੱਕ ਫੀਚਰ ਬ੍ਰਾਂਚ ਵਿੱਚ ਪੁਸ਼ ਕਰੋ, CI ਪਾਈਪਲਾਈਨ ਪਾਸ ਹੋਣ ਤੋਂ ਬਾਅਦ ਇਸਨੂੰ ਮਰਜ ਕਰੋ, ਅਤੇ ਇਸਨੂੰ ਸਰਵਰਾਂ ਦੇ ਇੱਕ ਹਿੱਸੇ ਵਿੱਚ ਲਾਗੂ ਕਰੋ। ਕਿਉਂਕਿ ਪੁਰਾਣਾ property syntax ਅਜੇ ਵੀ ਸਮਰਥਿਤ ਹੈ, ਕੋਈ ਵੀ ਗਲਤ ਰੈਫਰੈਂਸ runtime error ਦਾ ਕਾਰਨ ਨਹੀਂ ਬਣੇਗਾ।

6. ਹਰੇਕ namespace ਲਈ ਦੁਹਰਾਓ
   ਇੱਕੋ ਵਾਰ ਪੂਰੇ ਕੋਡਬੇਸ ਨੂੰ ਦੁਬਾਰਾ ਲਿਖਣ ਦੀ ਬਜਾਏ, ਮਾਡਲਾਂ ਦੇ ਇੱਕ ਤਰਕਪੂਰਨ ਸਮੂਹ (ਜਿਵੇਂ ਕਿ ਸਾਰੇ ਬਿਲਿੰਗ ਨਾਲ ਸਬੰਧਤ ਐਂਟਿਟੀਜ਼) ਨੂੰ attributes ਵਿੱਚ ਬਦਲੋ, ਫਿਰ ਅਗਲੇ ਸਮੂਹ ਲਈ ਦੁਹਰਾਓ। ਇਹ ਕਿਸੇ ਵੀ ਰੈਗਰੈਸ਼ਨ (regression) ਦੇ ਪ੍ਰਭਾਵ ਨੂੰ ਸੀਮਤ ਕਰਦਾ ਹੈ।

ਟੂਲਜ਼ ਅਤੇ ਸੇਫਟੀ ਨੈੱਟਸ

• Rector – ਇੱਕ ਆਟੋਮੇਟਡ ਰੈਫੈਕਟਰੀਂਗ ਟੂਲ ਜੋ ਵਾਰ-ਵਾਰ ਵਰਤੀ ਜਾਣ ਵਾਲੀ property syntax ਨੂੰ attributes ਵਿੱਚ ਬਦਲ ਸਕਦਾ ਹੈ। ਇਸਨੂੰ ਕੋਡਬੇਸ ਦੀ ਇੱਕ ਕਾਪੀ 'ਤੇ ਚਲਾਓ, ਡਿਫ (diff) ਦੀ ਸਮੀਖਿਆ ਕਰੋ, ਅਤੇ ਉਹਨਾਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਲਾਗੂ ਕਰੋ ਜੋ ਸਹੀ ਲੱਗਦੀਆਂ ਹਨ।
• Automated tests – Laravel ਦੇ ਬਿਲਟ-ਇਨ ਟੈਸਟਿੰਗ ਯੂਟੀਲਿਟੀਜ਼ mass-assignment ਅਤੇ JSON ਆਉਟਪੁੱਟ ਵਿੱਚ ਅੰਤਰ ਨੂੰ ਫੜ ਲੈਂਦੇ ਹਨ। ਹਰੇਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਸਟੈਪ ਤੋਂ ਬਾਅਦ ਉਹਨਾਂ ਨੂੰ ਗ੍ਰੀਨ (green) ਰੱਖੋ।
• Feature flags – ਜੇਕਰ ਤੁਹਾਨੂੰ ਤੇਜ਼ੀ ਨਾਲ ਰੋਲ ਬੈਕ (roll back) ਕਰਨ ਦੀ ਲੋੜ ਹੈ, ਤਾਂ ਨਵੇਂ attribute ਦੀ ਵਰਤੋਂ ਨੂੰ ਇੱਕ ਫਲੈਗ ਦੇ ਪਿੱਛੇ ਰੱਖੋ ਜੋ ਪੁਰਾਣੀ ਅਤੇ ਨਵੀਂ ਕੌਂਫਿਗਰੇਸ਼ਨ ਦੇ ਵਿਚਕਾਰ ਟੌਗਲ ਕਰਦਾ ਹੈ।

ਤੁਸੀਂ ਮਾਈਗ੍ਰੇਸ਼ਨ ਕਦੋਂ ਛੱਡ ਸਕਦੇ ਹੋ

ਜੇਕਰ ਕੋਈ ਪ੍ਰੋਜੈਕਟ ਛੋਟਾ, ਸਥਿਰ ਹੈ ਅਤੇ ਬਹੁਤ ਘੱਟ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਸਾਫ਼ ਮਾਡਲਾਂ ਦਾ ਫਾਇਦਾ ਕਨਵਰਸ਼ਨ ਦੀ ਮਿਹਨਤ ਨਾਲੋਂ ਵੱਧ ਨਹੀਂ ਹੋ ਸਕਦਾ। Attribute ਸਿੰਟੈਕਸ ਵਿਕਲਪਿਕ ਹੈ; ਤੁਸੀਂ ਅਨੰਤ ਕਾਲ ਲਈ ਕਲਾਸਿਕ property ਅਪ੍ਰੋਚ ਦੀ ਵਰਤੋਂ ਕਰਨਾ ਜਾਰੀ ਰੱਖ ਸਕਦੇ ਹੋ। ਇਸਦੇ ਉਲਟ, ਸਰਗਰਮ ਰੂਪ ਵਿੱਚ ਵਿਕਸਤ ਹੋ ਰਹੀ ਐਪਲੀਕੇਸ਼ਨਾਂ ਲਈ, ਖਾਸ ਕਰਕੇ ਉਹਨਾਂ ਲਈ ਜਿਨ੍ਹਾਂ ਦੇ ਮਾਡਲ ਵੱਡੇ ਹਨ ਜਾਂ ਅਕਸਰ schema ਵਿੱਚ ਤਬਦੀਲੀਆਂ ਹੁੰਦੀਆਂ ਹਨ, attributes ਨੂੰ ਜਲਦੀ ਅਪਣਾਉਣਾ ਭਵਿੱਖ ਦੀ ਮੁਸ਼ਕਲ ਨੂੰ ਘਟਾਉਂਦਾ ਹੈ।

ਅੱਗੇ ਕੀ ਦੇਖਣਾ ਹੈ

Laravel 13 ਦਾ attribute support ਮਾਡਲਾਂ ਤੋਂ ਅੱਗੇ event listeners, notifications, mailables ਅਤੇ broadcast events ਤੱਕ ਫੈਲਿਆ ਹੋਇਆ ਹੈ। ਜਿਵੇਂ ਹੀ ਕਮਿਊਨਿਟੀ ਉਹਨਾਂ ਖੇਤਰਾਂ ਵਿੱਚ ਇਸ ਸਿੰਟੈਕਸ ਨੂੰ ਅਪਣਾਏਗੀ, ਸਮਾਨ ਰੈਫੈਕਟਰੀਂਗ ਪੈਟਰਨ ਉਭਰਨਗੇ। ਭਵਿੱਖ ਦੇ ਮਾਈਨਰ ਰਿਲੀਜ਼ਾਂ ਵਿੱਚ ਆਉਣ ਵਾਲੇ ਕਿਸੇ ਵੀ ਨਵੇਂ attribute ਕਲਾਸਾਂ ਲਈ ਅਧਿਕਾਰਤ ਅਪਗ੍ਰੇਡ ਗਾਈਡ 'ਤੇ ਨਜ਼ਰ ਰੱਖੋ।

ਮੁੱਖ ਨਿਚੋੜ: Laravel 13 ਤੁਹਾਨੂੰ ਹਲਕੇ ਅਤੇ ਵਧੇਰੇ IDE-friendly ਮਾਡਲਾਂ ਲਈ ਬਿਨਾਂ ਕਿਸੇ ਵਾਧੂ ਲਾਗਤ ਦੇ ਇੱਕ ਰਸਤਾ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ। ਇੱਕ ਸਮੇਂ ਵਿੱਚ ਇੱਕ namespace ਨੂੰ ਬਦਲੋ, Rector ਅਤੇ ਆਪਣੇ test suite ਦੀ ਮਦਦ ਲਓ, ਅਤੇ ਅੰਤ ਵਿੱਚ ਤੁਹਾਡੇ ਕੋਲ ਅਜਿਹੀਆਂ classes ਹੋਣਗੀਆਂ ਜੋ configuration dump files ਦੀ ਬਜਾਏ business specifications ਵਾਂਗ ਪੜ੍ਹਨਯੋਗ ਹੋਣਗੀਆਂ।