[11.x] Add IncrementOrCreate method to Eloquent

[carloeusebi]

Laravel has methods like updateOrCreate, firstOrCreate and such. I think incrementOrCreate fits Eloquent, and to be fair I expected it existed already.

The use case:

Let's imagine we are tracking the exceptions in our application, but we don't want to add a new record every time the same exception occurred but we want to update the number of times the exception happened.

BackendException::incrementOrCreate(['name' => $name, 'file' => $file, 'line' => $line]);

This method will create a new model with ['count' => 1] the first time the exception happens, and increment the count attribute for the next occurencies.

The column name and the default increment value can also be customized.

BackendException::incrementOrCreate($attributes, 'occurrences', 0);

You can also pass increment() $step and $extra parameters.

BackendException::incrementOrCreate($attributes, step: 2, extra: ['trace' => $trace]);

[shaedrich]

You may want to add a $step argument, defaulting to 1, to specify by which the column should be incremented, mimicking the behavior of increment(), which it wraps. It furthermore offers to provide an array of columns to update alongside the increment operation.

[carloeusebi]

@shaedrich thank you for your feedback, I didn't think of that.