In Eloquent, accessors and modifiers are used to format or process data when obtaining or setting properties. The accessor is used to modify the attribute values ??retrieved from the database, such as combining fields or formatting dates, and the method is named get{AttributeName}Attribute, such as getFullNameAttribute; the modifier is used to modify the attribute values ??before saving to the database, such as cleaning up the phone number format, and the method is named set{AttributeName}Attribute, such as setPhoneNumberAttribute. Both help maintain data consistency and business logic centralization, and are suitable for data formatting, input standardization, and derived value processing, but should avoid operations that consume time or lead to information loss.

In Eloquent, visitors and mutators are custom methods you can define on your models to format or manipulate data when getting or setting attributes. They're super useful for keeping your data clean and consistent without scattering logic all over your app.

What Are Accessors?

Accessors let you modify the value of an attribute when you retrieve it from the database. You might use them to format dates, combine fields, or apply transformations.

For example, if you have a first_name and last_name field in your database, but often want the full name, you could create an accessor like this:

 public function getFullNameAttribute()
{
    return ucfirst($this->first_name) . ' ' . ucfirst($this->last_name);
}

Now whenever you call $user->full_name , Eloquent will compute and return that value based on the two fields.

• Just make sure the method follows the get{AttributeName}Attribute naming convention.
• The attribute becomes available as if it were a real column in your table.
• It doesn't save to the database — it's only computed on the fly.

This is handy for things like formatting phone numbers, URLs, or any derived values.

What About Mutators?

Mutators do the opposite — they let you change the value of an attribute before it gets saved to the database.

Let's say users input their phone number with dashes or spaces, but you want to store it consistently without any formatting. A mutator would help here:

 public function setPhoneNumberAttribute($value)
{
    $this->attributes['phone_number'] = preg_replace('/[^0-9]/', '', $value);
}

Now, every time someone assigns a phone number using something like $user->phone_number = '(555) 123-4567' , it'll be stripped down to just 5551234567 before saving.

• Naming follows the set{AttributeName}Attribute pattern.
• You're modifying the raw value before it hits the database.
• Great for normalization or validation before storage.

Just be careful not to mutate something in a way that loses important information unintentionally.

When Should You Use Them?

Use accessors and mutators when:

• You want to format data consistently across your app.
• You need to normalize input before storing it.
• You're combining or deriving values ??that don't need to be stored directly.

They help keep your business logic inside your models, which makes your code easier to maintain and test. But remember, these are PHP methods — so avoid doing anything too heavy in them, especially in accessories that might be called frequently.

Also, if you're building APIs or JSON responses, consider using Laravel's resource classes or appending virtual attributes if needed.

Final Thoughts

Accessors and mutators are simple tools that go a long way toward cleaner code. Once you understand how to use them, you'll find plenty of places where they make your models smarter and your controllers lighter.

You don't need to overuse them, but knowing when and how to apply them helps a lot.

The above is the detailed content of What are accessors and mutators in Eloquent?. For more information, please follow other related articles on the PHP Chinese website!