yadakhov/insert-on-duplicate-key

A trait for MySQL INSERT ON DUPLICATE KEY UPDATE.

Thursday, April 27, 2017
by yadakhov
Repository
6 Watchers
119 Stars
92,608 Installations

PHP
1 Dependents
0 Suggesters
25 Forks
12 Open issues
15 Versions
23 % Grown

The README.md

MySQL Insert On Duplicate Key Update Eloquent Trait

, _(*1)

Insert Duplicate Key Update is a quick way to do mass insert., _(*2)

It's a trait meant to be used with Laravel's Eloquent ORM., _(*3)

Code Example

use Illuminate\Database\Eloquent\Model;
use Yadakhov\InsertOnDuplicateKey;

/**
 * Class User.
 */
class User extends Model
{
    // The function is implemented as a trait.
    use InsertOnDuplicateKey;
}

Multi values insert.

    $users = [
        ['id' => 1, 'email' => 'user1@email.com', 'name' => 'User One'],
        ['id' => 2, 'email' => 'user2@email.com', 'name' => 'User Two'],
        ['id' => 3, 'email' => 'user3@email.com', 'name' => 'User Three'],
    ];

Important: the order of the keys are important. It should be the same for every arrays. The reason is the code uses array_values()., _(*4)

Do not do this:, _(*5)

    $users = [
        ['id' => 1, 'email' => 'user1@email.com', 'name' => 'User One'],
        ['email' => 'user2@email.com', 'id' => 2, 'name' => 'User Two'],
        ['email' => 'user3@email.com', 'name' => 'User Three', 'id' => 3],
    ];

INSERT ON DUPLICATE KEY UPDATE

    User::insertOnDuplicateKey($users);

```sql -- produces this query INSERT INTO users(id,email,name) VALUES (1,'user1@email.com','User One'), (2,'user3@email.com','User Two'), (3,'user3email.com','User Three') ON DUPLICATE KEY UPDATE id = VALUES(id), email = VALUES(email), name = VALUES(name), _(*6)


```php
    User::insertOnDuplicateKey($users, ['email']);


If users have a numeric column we would like, for example, to sum:

```php
    $users = [
        ['id' => 1, 'name' => 'User One', 'heritage' => 1000],
        ['id' => 2, 'name' => 'User Two', 'heritage' => 2000],
        ['id' => 3, 'name' => 'User Three', 'heritage' => 1500],
    ];

```php User::insertOnDuplicateKey($users, ['heritage' => DB::raw('heritage + VALUES(heritage)')]);, _(*8)

```sql
    -- produces this query
    INSERT INTO `users`(`id`,`email`,`name`) VALUES
    (1,'user1@email.com','User One'), (2,'user3@email.com','User Two'), (3,'user3email.com','User Three')
    ON DUPLICATE KEY UPDATE `heritage` = `heritage` + VALUES(`heritage`)

INSERT IGNORE

    User::insertIgnore($users);

```sql -- produces this query INSERT IGNORE INTO users(id,email,name) VALUES (1,'user1@email.com','User One'), (2,'user3@email.com','User Two'), (3,'user3email.com','User Three');, _(*9)


#### REPLACE INTO
```php
    User::replace($users);

```sql -- produces this query REPLACE INTO users(id,email,name) VALUES (1,'user1@email.com','User One'), (2,'user3@email.com','User Two'), (3,'user3email.com','User Three');, _(*10)


### created_at and updated_at fields.

created_at and updated_at will *not* be updated automatically.  To update you can pass the fields in the insert array.

```php
['id' => 1, 'email' => 'user1@email.com', 'name' => 'User One', 'created_at' => Carbon::now(), 'updated_at' => Carbon::now()]

Run unit tests

./vendor/bin/phpunit

Will this work on Postgresql?

No. On Duplicate Key Update is only available on MySQL. Postgresql 9.4 has a similar feature called UPSERT. Implementing UPSERT is left as an exercise for the reader., _(*11)

Isn't this the same as updateOrCreate()?

It is similar but not the same. The updateOrCreate() will only work for one row at a time which doesn't allow bulk insert. InsertOnDuplicateKey will work on many rows., _(*12)

The Versions

27/04 2017

dev-master

9999999-dev https://github.com/yadakhov/insert-on-duplicate-key

A trait for MySQL INSERT ON DUPLICATE KEY UPDATE.

library insert-on-duplicate-key

A trait for MySQL INSERT ON DUPLICATE KEY UPDATE.

yadakhov/insert-on-duplicate-key

The README.md

MySQL Insert On Duplicate Key Update Eloquent Trait

Code Example

Multi values insert.

INSERT ON DUPLICATE KEY UPDATE

INSERT IGNORE

Run unit tests

Will this work on Postgresql?

Isn't this the same as updateOrCreate()?

The Versions

dev-master

The Development Requires

by Yada Khov

v1.2.0

The Development Requires

by Yada Khov

v1.1.0

The Development Requires

by Yada Khov

v0.1.0

The Development Requires

by Yada Khov

v1.0.0

The Development Requires

by Yada Khov

v0.0.10

The Development Requires

by Yada Khov

v0.0.9

The Development Requires

by Yada Khov

v0.0.8

The Requires

The Development Requires

by Yada Khov

v0.0.7

The Requires

The Development Requires

by Yada Khov

v0.0.6

The Requires

The Development Requires

by Yada Khov

v0.0.5

The Requires

The Development Requires

by Yada Khov

v0.0.4

The Requires

The Development Requires

by Yada Khov

v0.0.3

The Requires

The Development Requires

by Yada Khov

v0.0.2

The Requires

The Development Requires

by Yada Khov

0.0.1

The Requires

The Development Requires

by Yada Khov