flagrow / flarum-api-client
Standalone package for calling the API of a Flarum installation.
Installs: 4 667
Dependents: 0
Suggesters: 0
Security: 0
Stars: 25
Watchers: 4
Forks: 11
Open Issues: 6
Requires
- php: ^7.1
- guzzlehttp/guzzle: ^6.1.1
- illuminate/cache: ^5.3
- illuminate/support: ^5.3
Requires (Dev)
- phpunit/phpunit: ^6.0
This package is auto-updated.
Last update: 2020-08-27 07:50:27 UTC
README
This is a generic PHP API client for use in any project. You can simply include this package as a dependency to your project to use it.
installation
composer require flagrow/flarum-api-client
configuration
In order to start working with the client you might need a Flarum master key:
- Generate a 40 character random, unguessable string, this is the Token needed for this package.
- Manually add it to the
api_keys
table using phpmyadmin/adminer or another solution.
The master key is required to access non-public discussions and running actions otherwise reserved for Flarum administrators.
examples
A basic example:
<?php require_once "vendor/autoload.php"; use Flagrow\Flarum\Api\Flarum; $api = new Flarum('http://example.com'); // A collection of discussions from the first page of your Forum index. $discussions = $api->discussions()->request(); // Read a specific discussion. $discussion = $api->discussions()->id(1)->request(); // Read the first page of users. $users = $api->users()->request();
An authorized example:
$api = Flarum('http://example.com', ['token' => '<insert-master-token>; userId=1']);
The userId refers to a user that has admin permissions or the user you want to run actions for. Appending the userId setting to the token only works for Master keys.
links
Flagrow is a collaboration of Flarum extension developers to provide quality, maintained extensions.