corbado/php-sdk

Add passkeys to your PHP application with the Corbado PHP SDK.

v4.3.0 2024-10-24 15:09 UTC

This package is auto-updated.

Last update: 2024-11-25 11:03:35 UTC


README

corbado-php

Corbado PHP SDK

License Latest Stable Version Test Status documentation Slack

The Corbado PHP SDK provides convenient access to the Corbado Backend API from applications written in the PHP language.

⚠️ The Corbado PHP SDK is commonly referred to as a private client, specifically designed for usage within closed backend applications. This particular SDK should exclusively be utilized in such environments, as it is crucial to ensure that the API secret remains strictly confidential and is never shared.

🚀 Getting started | 🛠️ Services | 📚 Advanced | 💬 Support & Feedback

🚀 Getting started

Requirements

Installation

Use the following command to install the Corbado PHP SDK:

composer require corbado/php-sdk

Usage

To create a Corbado PHP SDK instance you need to provide your Project ID, API secret, Frontend API URL and Backend API URL which can be found at the Developer Panel.

$config = new Corbado\Config('<Project ID>', '<API secret>', '<Frontend API URL>', '<Backend API URL>');
$sdk = new Corbado\SDK($config);

Examples

A list of examples can be found in the integration tests here.

🛠️ Services

The Corbado PHP SDK provides the following services:

  • sessions for managing sessions
  • users for managing users (examples)
  • identifiers for managing identifiers (examples)

To use a specific service, such as sessions, invoke it as shown below:

$user = $sdk->sessions()->getCurrentUser();

📚 Advanced

Error handling

The Corbado PHP SDK throws exceptions for all errors. The following exceptions are thrown:

  • AssertException for failed assertions (client side)
  • ConfigException for configuration errors (client side)
  • ValidationException for validation errors (client side)
  • ServerException for server errors (server side)
  • StandardException for everything else (client side)

If the Backend API returns an HTTP status code other than 200, the Corbado PHP SDK throws a ServerException. The ServerExceptionclass provides convenient methods to access all important data:

try {
    // Try to get non-existing user with ID 'usr-123456789'
    $user = $sdk->users()->get('usr-123456789');
} catch (ServerException $e) {
    // Show HTTP status code (400 in this case)
    echo $e->getHttpStatusCode() . PHP_EOL;
    
    // Show request ID (can be used in developer panel to look up the full request
    // and response, see https://app.corbado.com/app/logs/requests)
    echo $e->getRequestID() . PHP_EOL;
    
    // Show full request data
    var_dump($e->getRequestData());
    
    // Show runtime of request in seconds (server side)
    echo $e->getRuntime() . PHP_EOL;
    
    // Show validation error messages (server side validation in case of HTTP
    // status code 400 (Bad Request))
    var_dump($e->getValidationMessages());
    
    // Show full error data
    var_dump($e->getError());
}

💬 Support & Feedback

Report an issue

If you encounter any bugs or have suggestions, please open an issue.

Slack channel

Join our Slack channel to discuss questions or ideas with the Corbado team and other developers.

Slack

Email

You can also reach out to us via email at vincent.delitz@corbado.com.

Vulnerability reporting

Please report suspected security vulnerabilities in private to security@corbado.com. Please do NOT create publicly viewable issues for suspected security vulnerabilities.