README

Casdoor PHP SDK will allow you to easily connect your application to Casdoor authentication system without having to start from scratch.

Step 1: Composer install casdoor-php-sdk

In your php application directory, run the following command:

composer require casdoor/casdoor-php-sdk

Or use composer.json to add the following code:

{
    "require": {
        "vendor/package": "*",
    }
}

Then run composer install to make it take effect. Create a OauthTest. Php file and import the SDK package.

<?php

namespace Casdoor\Tests;

use PHPUnit\Framework\TestCase;
use Casdoor\Auth\Jwt;
use Casdoor\Auth\Token;
use Casdoor\Auth\User;

class OauthTest extends TestCase
{
  public function xxx(){}
}

Step 2: configure parameters

for more information, see initConfig()

Reference code:

public function initConfig()
  {
    $endpoint = 'http://127.0.0.1:8000';
    $clientId = 'c64b12723aefb65a88ce';
    $clientSecret = 'c0c9d483a87332751b2564635765d71c9f6a2e83';
    $certificate = file_get_contents(dirname(__FILE__) . '/public_key.pem');
    $organizationName = 'built-in';
    $applicationName = 'testApp';
    User::initConfig($endpoint, $clientId, $clientSecret, $certificate, $organizationName, $applicationName);
  }

Step 3: obtain the user JWT token

after you log on to the logon page, the page is redirected to a link with code and state, such:https://forum.casbin.com?code=xxx&state=yyyy In the sample file, enter code and state, call the testGetOauthToken() method, and parse the jwt token.

public $code = "cc78dc9953ca6ae6ab58";
public $state = "casdoor";
public function testGetOauthToken()
{
    $this->initConfig();
    $token = new Token();
    $accessToken = $token->getOAuthToken($this->code, $this->state);
    $this->assertIsString($accessToken->getToken());
}

The JWT token represents the user's identity and has the right to call relevant APIs.

Step 4: verify and parse the user token

When a user passes in a JWT token, testParseJwtToken function calls the public key to verify the JWT token. If the verification is passed, the Array object is returned, which contains the account information of the user.

public function testParseJwtToken()
{
    $this->initConfig();
    $token = "eyJhxxxx";	// from testGetOauthToken()
    $jwt = new Jwt();
    $result = $jwt->parseJwtToken($token, User::$authConfig);
    $this->assertIsArray();
}

Step 5: update user information

testModifyUser call the application configuration (non-user token) as the update permission to perform CURD operations on user information.

public function testModifyUser()
{
    $this->initConfig();
    $user = new User();

    # Delete User
    $user->name = 'user_hn99qa';
    $response = $user->deleteUser($user);
    $this->assertTrue($response);

    # Add User
    $response = $user->addUser($user);
    $this->assertTrue($response);

    # Update User
    $user->phone = 'phone';
    $user->displayName = 'display name';
    $response = $user->updateUser($user);
    $this->assertTrue($response);
}

Others: User interaction

User::getUser() , obtain User information by User name
User::getUsers() to obtain information about all users.
User::getUserCount() to obtain the current number of users.

casdoor / casdoor-php-sdk

Maintainers

Details