If you're integrating FusionAuth with a PHP application, this library will speed up your development time. Please also make sure to check our SDK Usage Suggestions page.
For additional information and documentation on FusionAuth refer to https://fusionauth.io.
The most preferred way to use the client library is to install the fusionauth/fusionauth-client
package via Composer by running the command below at your project root folder.
composer require fusionauth/fusionauth-client
Then, include the composer
autoloader in your PHP files.
require __DIR__ . '/vendor/autoload.php';
First, you have to make sure you have a running FusionAuth instance. If you don't have one already, the easiest way to install FusionAuth is via Docker, but there are other ways. By default, it'll be running on localhost:9011
.
Then, you have to create an API Key in the admin UI to allow calling API endpoints.
You are now ready to use this library!
After every request is made, you need to check for any errors and handle them. To avoid cluttering things up, we'll omit the error handling in the next examples, but you should do something like the following.
// $result is the response of one of the endpoint invocations from the examples below
if (!$result->wasSuccessful()) {
echo "Error!" . PHP_EOL;
echo "Got HTTP {$result->status}" . PHP_EOL;
if (isset($result->errorResponse->fieldErrors)) {
echo "There are some errors with the payload:" . PHP_EOL;
var_dump($result->errorResponse->fieldErrors);
}
if (isset($result->errorResponse->generalErrors)) {
echo "There are some general errors:" . PHP_EOL;
var_dump($result->errorResponse->generalErrors);
}
}
To make requests to the API, first you need to create a FusionAuthClient
instance with the API Key created and the server address where FusionAuth is running.
$client = new FusionAuth\FusionAuthClient(
apiKey: "<paste the API Key you generated here>",
baseURL: "http://localhost:9011", // or change this to whatever address FusionAuth is running on
);
To create an Application, use the createApplication()
method.
$result = $client->createApplication(
applicationId: null, // Leave this empty to automatically generate the UUID
request: [
'application' => [
'name' => 'ChangeBank',
],
],
);
// Handle errors as shown in the beginning of the Examples section
// Otherwise parse the successful response
var_dump($result->successResponse->application);
Check the API docs for this endpoint
To add roles to an Application, use createApplicationRole()
.
$result = $client->createApplicationRole(
applicationId: 'd564255e-f767-466b-860d-6dcb63afe4cc', // Existing Application Id
roleId: null, // Leave this empty to automatically generate the UUID
request: [
'role' => [
'name' => 'customer',
'description' => 'Default role for regular customers',
'isDefault' => true,
],
],
);
// Handle errors as shown in the beginning of the Examples section
// Otherwise parse the successful response
var_dump($result->successResponse->role);
Check the API docs for this endpoint
To fetch details about an Application, use retrieveApplication()
.
$result = $client->retrieveApplication(
applicationId: 'd564255e-f767-466b-860d-6dcb63afe4cc',
);
// Handle errors as shown in the beginning of the Examples section
// Otherwise parse the successful response
var_dump($result->successResponse->application);
Check the API docs for this endpoint
To delete an Application, use deleteApplication()
.
$result = $client->deleteApplication(
applicationId: 'd564255e-f767-466b-860d-6dcb63afe4cc',
);
// Handle errors as shown in the beginning of the Examples section
// Otherwise parse the successful response
// Note that $result->successResponse will be empty
Check the API docs for this endpoint
To prevent a User from logging in, use deactivateUser()
.
$result = $client->deactivateUser(
'fa0bc822-793e-45ee-a7f4-04bfb6a28199',
);
// Handle errors as shown in the beginning of the Examples section
// Otherwise parse the successful response
Check the API docs for this endpoint
To register a User in an Application, use register()
.
The code below also adds a customer
role and a custom appBackgroundColor
property to the User Registration.
$result = $client->register(
userId: 'fa0bc822-793e-45ee-a7f4-04bfb6a28199',
request: [
'registration' => [
'applicationId' => 'd564255e-f767-466b-860d-6dcb63afe4cc',
'roles' => [
'customer',
],
'data' => [
'appBackgroundColor' => '#096324',
],
],
],
);
// Handle errors as shown in the beginning of the Examples section
// Otherwise parse the successful response
Check the API docs for this endpoint
If you find any bugs in this library, please open an issue. Note that changes to the FusionAuthClient
class have to be done on the FusionAuth Client Builder repository, which is responsible for generating that file.
But if you have a question or support issue, we'd love to hear from you.
If you have a paid plan with support included, please open a ticket in your account portal. Learn more about paid plan here.
Otherwise, please post your question in the community forum.
Bug reports and pull requests are welcome on GitHub at https://github.com/FusionAuth/fusionauth-php-client.
Note: if you want to change the FusionAuthClient
class, you have to do it on the FusionAuth Client Builder repository, which is responsible for generating all client libraries we support.
This code is available as open source under the terms of the Apache v2.0 License.
This library is built automatically to keep track of the FusionAuth API, and may also receive updates with bug fixes, security patches, tests, code samples, or documentation changes.
These releases may also update dependencies, language engines, and operating systems, as we'll follow the deprecation and sunsetting policies of the underlying technologies that it uses.
This means that after a dependency (e.g. language, framework, or operating system) is deprecated by its maintainer, this library will also be deprecated by us, and will eventually be updated to use a newer version.