Adds replaceUser route and remove replaceIfExists option in createUser

[samniisan]

PR has been changed to remove to remove the replaceIfExists option.
fixes: https://github.com/kuzzleio/kuzzle-sdk/issues/21

[codecov-io]

Codecov Report

Merging #62 into 4.x will increase coverage by 0.35%.
The diff coverage is 94%.

@@            Coverage Diff            @@
##             4.x      #62      +/-   ##
=========================================
+ Coverage   88.7%   89.05%   +0.35%     
=========================================
  Files         15       15              
  Lines       1204     1252      +48     
=========================================
+ Hits        1068     1115      +47     
- Misses       136      137       +1

Impacted Files	Coverage Δ
src/Security/Document.php	95.55% <ø> (+4.44%)	⬆️
src/Security/Security.php	96.95% <100%> (+0.12%)	⬆️
src/Security/User.php	91.02% <92.5%> (+1.55%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 6605e07...0412499. Read the comment docs.

[ballinette]

Suggestion for a cleaner code: replace lines 125-147 by following:

if ($options['replaceIfExist']) {
  $fetchResponse = $this->kuzzle->query(
    $this->buildQueryArgs('getUser'),
    ['_id' => $id]
  );

  if ($fetchResponse["error"] === null && $fetchResponse["result"]["_id"] === $id) {
    $action = 'replaceUser';
  }
}

$response = $this->kuzzle->query(
  $this->buildQueryArgs($action),
  $data,
  $options
);

[dbengsch]

Blocking: ReplaceIfExists Does not match with the new auth refactor

The PR has changed a lot

[ballinette]

hmmm. I validated, but... why do we remove the replaceIfExists option ? it should be consistent with other SDKs...

I guess it should be implemented as for Javascript SDK : kuzzleio/sdk-javascript#208

[dbengsch]

We are removing it from all SDKs.