Otimizando operações CRUD com Laravel Eloquent

Ao trabalhar com um banco de dados no Laravel, é comum inserir ou atualizar registros. Para conseguir isso, os desenvolvedores muitas vezes recorrem a instruções condicionais que verificam se um registro existe antes de decidir realizar uma inserção ou atualização.

O método firstOrNew()

Felizmente, Eloquent fornece uma solução mais eficiente através do método firstOrNew(). Este método verifica a existência de um registro com base em critérios especificados e retorna o primeiro registro correspondente, se encontrado; caso contrário, ele cria uma nova instância do modelo.

Exemplo de uso

Considere o seguinte exemplo:

$shopOwner = ShopMeta::where('shopId', '=', $theID)
    ->where('metadataKey', '=', 2001)
    ->firstOrNew();

if ($shopOwner->exists) {
    // Update the existing record
} else {
    // Insert a new record
}

Neste exemplo, o método firstOrNew() é usado para localizar um registro ShopMeta com base em shopId e metadataKey. Se o registro existir, o bloco if será executado e o registro existente será atualizado. Caso contrário, o bloco else é executado e um novo registro é inserido.

Exemplo Estendido

Aqui está um exemplo mais abrangente que mostra o poder de firstOrNew():

$user = User::firstOrNew(array('name' => Input::get('name')));
$user->foo = Input::get('foo');
$user->save();

Documentação atualizada

Observe que o link da documentação fornecido na resposta não está mais atualizado. Para a versão mais recente do Laravel, consulte a seguinte documentação:

[Documentação atualizada do Laravel](https://laravel.com/docs/8.x/eloquent)