SDK
SDK PHP v3.x
1

You are currently looking at the documentation of a previous version of Kuzzle. We strongly recommend that you use the latest version. You can also use the version selector in the top menu.

createProfile #

Create a new profile in Kuzzle.

There is a small delay between profile creation and its availability in our search layer (usually a couple of seconds). That means that a profile that was just created might not be returned immediately by the searchProfiles function.


createProfile(id, content, [options], callback) #

Arguments Type Description
id string Unique profile identifier
policies array of JSON objects List of policies to apply to this profile
options string (Optional) Optional arguments
callback function Callback handling the response

Options #

Filter Type Description Default
queuable boolean Make this request queuable or not true
replaceIfExist boolean If the same profile already exists: throw an error if sets to false. Replace the existing profile otherwise false
refresh string If set to wait_for, Kuzzle will wait the persistence layer to finish indexing (available with Elasticsearch 5.x and above) undefined

Callback Response #

Returns a security Profile object.

Usage #

Copied to clipboard!
<?php
use \Kuzzle\Kuzzle;
use \Kuzzle\Security\Profile;
$profileId = 'myProfile';
$policies = [
  [
    'roleId' => 'myRole'
  ],
  [
    'roleId' => 'anonymous',
    'restrictedTo' => [
      ['index' => 'my-second-index', 'collection' => ['my-collection']]
    ]
  ]
];
$kuzzle = new Kuzzle('localhost');
$security = $kuzzle->security();
try {
  $profile = $security->createProfile($profileId, $profileDefinition);
  // $profile instanceof Profile
}
catch (ErrorException $e) {
}