Installation
The package is registered at Packagist as vinkas/discourse-php and can be installed using composer:
composer require vinkas/discourse-php
Usage
$discourse = new Vinkas\Discourse\PHP\Client('discouse.example.com', true); // set true if ssl enabled
API
$api = $discourse->api('API_KEY', 'API_USERNAME');
$api->topics()->create('TITLE', 'CONTENT', 'CATEGORY_SLUG')
SSO
$payload = $_GET['sso'];
$signature = $_GET['sig'];
$sso = $discourse->sso('SECRET', $payload, $signature);
if (!($sso->isValid())) {
header("HTTP/1.1 403 Forbidden");
echo("Bad SSO request");
die();
}
$userParams = array(
'external_id' => 'USER_ID',
'email' => 'EMAIL_ADDRESS',
'username' => 'USERNAME', // optional
'name' => 'FULL_NAME' // optional
// for more available fields https://meta.discourse.org/t/official-single-sign-on-for-discourse/13045
);
$url = $sso->getResponseUrl($userParams)
header('Location: ' . $url);
exit(0);
6 个赞
Since I committed in other task I didn’t tested the code well and unable to give detailed documentation with usage examples.
I will release next version soon with more options, documentation and examples.
1 个赞
erlend_sh
2016 年10 月 7 日 11:47
3
I haven’t looked closely at this but it sounds like there might be some overlap with @michaeld ’s PHP API client for Discourse:
PHP API client for Discourse
I already aware of this existing package. But I didn’t used it. I used famous GuzzleHttp composer . Also in mine it have SSO option too.
After all I created this package because of I am also creating laravel package (which depends it) for easy implementation with laravel features like eloquent model. Yes few laravel packages also already exist for discourse. But I have something different in my mind for development
1 个赞
michaeld
2016 年10 月 7 日 16:05
5
Too bad you decided to create another, instead of just contributing to what already existed, and making it better.
Sorry @michaeld . Coding structure which I wanted and created is totally different from your existing package. That’s why I created it as new one.
In other words I created this package for my own purpose. Then I decided to open source it.
1 个赞
pnoeric
2020 年3 月 23 日 15:48
7
给刚看到这个话题的朋友（现在是2020年3月……来自居家新冠隔离的问候）——
上面提到的来自 @michaeld 的库似乎仅用于与 API 交互，与 SSO 并无实际关联。
我一直在试用 @vinothkannans 在 GitHub 上分享的库，但正如他自己所述，他尚未进行大量测试。事实上，我发现该库存在不少漏洞，尚未达到可投入生产使用的成熟度。
我找到了这个库，目前运行良好：
https://github.com/cviebrock/discourse-php
9 个赞
