Mutators is a method to modify data before setting model attributes, with the naming format set{AttributeName}Attribute; Accessors is a method to modify the return data when obtaining attributes, with the naming format get{AttributeName}Attribute. For example, setNameAttribute can convert the user name to lowercase and then store it; getCreatedAtAttribute can format date output. Common uses include cleaning input, encrypting sensitive fields, formatting time amount and other display content. When using it, you should pay attention to the case sensitivity of field names to avoid recursive calls causing dead loops. You should operate the $this->attributes array instead of directly accessing attributes. You can also create field alias through read-only Accessor and combine $casts to achieve more powerful type conversion functions. Mastering them reduces duplicate code and makes the model layer cleaner and more efficient.
In Laravel's Eloquent model, Mutators and Accessors are very practical tools. They allow you to format or process the data when fetching or setting model properties without having to write a lot of extra duplicate code.

What are Mutators and Accessors?
Simply put:

- Mutators are methods that run automatically before you set the model attribute value and are used to modify incoming data.
- Accessors is a method that automatically runs when you get the value of the model attribute, which is used to modify the returned data.
For example, you can use them to automatically convert the name entered by the user to lowercase when storing the user, or format the output when reading the date field.
How to use Mutators
The naming rules of Mutator are: set{AttributeName}Attribute
, where {AttributeName}
is the field name in the model, with the initial letter capitalization.

For example, suppose you have a User
model with a field called name
, and you want to convert the name to lowercase before saving:
public function setNameAttribute($value) { $this->attributes['name'] = strtolower($value); }
This way, when you execute:
$user = new User(); $user->name = 'John Doe'; $user->save();
The final database is johndoe
.
Common uses:
- Clean input data (such as trim, strtolower)
- Automatically encrypt sensitive fields (such as passwords)
- Format the upload file path
How to use Accessors
The naming rule of Accessor is: get{AttributeName}Attribute
, also based on the field name.
For example, you have a created_at
field that wants to return a formatted string when fetched:
public function getCreatedAtAttribute($value) { return date('Ym-d', strtotime($value)); }
Now calling $user->created_at
will return a format similar to 2025-04-05
.
If you also use a library like Carbon, you can write it more elegantly:
use Illuminate\Support\Carbon; public function getCreatedAtAttribute($value) { return Carbon::parse($value)->format('F j, Y'); }
This returns something like April 5, 2025
.
Common uses:
- Format time, amount, status and other display content
- Spliced field combination (such as full name)
- Convert boolean to human-readable formats like "yes/no"
Tips and precautions for use
Field names are case sensitive
- If your database field is underlined (such as
first_name
), then the method name should be written asgetFirstNameAttribute
orsetFirstNameAttribute
.
- If your database field is underlined (such as
Avoid a dead cycle
- Do not call
$this->字段名
directly in Mutator or Accessor, otherwise it may cause recursive calls to cause an error.$this->attributes['字段名']
should be operated.
- Do not call
Use attribute alias
Sometimes you don't want to expose the original field name, you can create an alias by defining a read-only Accessor. For example:
public function getFormattedNameAttribute() { return ucfirst($this->name); }
Then you can use
$user->formatted_name
to get the formatted name.-
Combined with Casts is more powerful
- Laravel also supports the
$casts
attribute for type conversion, such as automatically converting JSON strings into arrays. It works with Mutators/Accessors.
- Laravel also supports the
Basically that's it. Once you have mastered Mutators and Accessors, you will find that they can help you reduce a lot of repetitive logic, making the model layer cleaner and more centralized processing of data transformations.
The above is the detailed content of Using Mutators and Accessors in Laravel Eloquent Models. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

ToworkeffectivelywithpivottablesinLaravel,firstaccesspivotdatausingwithPivot()orwithTimestamps(),thenupdateentrieswithupdateExistingPivot(),managerelationshipsviadetach()andsync(),andusecustompivotmodelswhenneeded.1.UsewithPivot()toincludespecificcol

Laravelprovidesacleanandflexiblewaytosendnotificationsviamultiplechannelslikeemail,SMS,in-appalerts,andpushnotifications.Youdefinenotificationchannelsinthevia()methodofanotificationclass,andimplementspecificmethodsliketoMail(),toDatabase(),ortoVonage

Dependency injection automatically handles class dependencies through service containers in Laravel without manual new objects. Its core is constructor injection and method injection, such as automatically passing in the Request instance in the controller. Laravel parses dependencies through type prompts and recursively creates the required objects. The binding interface and implementation can be used by the service provider to use the bind method, or singleton to bind a singleton. When using it, you need to ensure type prompts, avoid constructor complications, use context bindings with caution, and understand automatic parsing rules. Mastering these can improve code flexibility and maintenance.

Laravel performance optimization can improve application efficiency through four core directions. 1. Use the cache mechanism to reduce duplicate queries, store infrequently changing data through Cache::remember() and other methods to reduce database access frequency; 2. Optimize database from the model to query statements, avoid N 1 queries, specifying field queries, adding indexes, paging processing and reading and writing separation, and reduce bottlenecks; 3. Use time-consuming operations such as email sending and file exporting to queue asynchronous processing, use Supervisor to manage workers and set up retry mechanisms; 4. Use middleware and service providers reasonably to avoid complex logic and unnecessary initialization code, and delay loading of services to improve startup efficiency.

Methods to manage database state in Laravel tests include using RefreshDatabase, selective seeding of data, careful use of transactions, and manual cleaning if necessary. 1. Use RefreshDatabasetrait to automatically migrate the database structure to ensure that each test is based on a clean database; 2. Use specific seeds to fill the necessary data and generate dynamic data in combination with the model factory; 3. Use DatabaseTransactionstrait to roll back the test changes, but pay attention to its limitations; 4. Manually truncate the table or reseed the database when it cannot be automatically cleaned. These methods are flexibly selected according to the type of test and environment to ensure the reliability and efficiency of the test.

LaravelSanctum is suitable for simple, lightweight API certifications such as SPA or mobile applications, while Passport is suitable for scenarios where full OAuth2 functionality is required. 1. Sanctum provides token-based authentication, suitable for first-party clients; 2. Passport supports complex processes such as authorization codes and client credentials, suitable for third-party developers to access; 3. Sanctum installation and configuration are simpler and maintenance costs are low; 4. Passport functions are comprehensive but configuration is complex, suitable for platforms that require fine permission control. When selecting, you should determine whether the OAuth2 feature is required based on the project requirements.

Laravel simplifies database transaction processing with built-in support. 1. Use the DB::transaction() method to automatically commit or rollback operations to ensure data integrity; 2. Support nested transactions and implement them through savepoints, but it is usually recommended to use a single transaction wrapper to avoid complexity; 3. Provide manual control methods such as beginTransaction(), commit() and rollBack(), suitable for scenarios that require more flexible processing; 4. Best practices include keeping transactions short, only using them when necessary, testing failures, and recording rollback information. Rationally choosing transaction management methods can help improve application reliability and performance.

The core of handling HTTP requests and responses in Laravel is to master the acquisition of request data, response return and file upload. 1. When receiving request data, you can inject the Request instance through type prompts and use input() or magic methods to obtain fields, and combine validate() or form request classes for verification; 2. Return response supports strings, views, JSON, responses with status codes and headers and redirect operations; 3. When processing file uploads, you need to use the file() method and store() to store files. Before uploading, you should verify the file type and size, and the storage path can be saved to the database.
