herojhc/xxh-sdk
Composer 安装命令:
composer require herojhc/xxh-sdk
包简介
xinxihua.com sdk.
README 文档
README
| title | 信息化平台SDK使用说明 |
|---|---|
| tags | 信息化、SDK |
| grammar_mindmap | true |
环境
laravel 5.5 或 5.6 以及他们需要的环境
安装
composer require herojhc/xxh-sdk
配置
发布配置
php artisan vendor:publish --provider="XinXiHua\SDK\XXHServiceProvider" --tag="xxh-sdk-config"
运行迁移
php artisan vendor:publish --provider="XinXiHua\SDK\XXHServiceProvider" --tag="xxh-sdk-migrations"
php artisan migrate
修改User模型主键
protected $primaryKey = 'user_id';
参数说明
配置环境变量
#----------- #AppId,具体见应用详情 REST_CLIENT_ID=cd188ae7d6344beb8ccc660643bf886f #AppSecret,具体见应用详情 REST_CLIENT_SECRET=138fa802f76c4f0ba472cfe9d9ebf852 #Api 地址 REST_CLIENT_API_URL=https://api.xinxihua.com #具体API的HOST,不同的API分支对应不同的HOST,具体见信息化平台API总览 REST_CLIENT_API_HOST=api.v2.services.xinxihua.com #------------- #应用的ID(信息化平台),具体见应用详情 AUTH_AGENT_ID=10000 #前台回调地址 AUTH_CALLBACK_HOME_URL=http://crm.xinxihua.com/callback #登录后前台跳转页面 AUTH_REDIRECT_HOME_URL=http://crm.xinxihua.com/home #后台回调地址 AUTH_CALLBACK_ADMIN_URL=http://crm.xinxihua.com/admin/callback #登录后后台跳转地址 AUTH_REDIRECT_ADMIN_URL=http://crm.xinxihua.com/admin #信息化平台地址 AUTH_PALTFORM_URL=https://oa.xinxihua.com #信息化平台授权登陆地址 AUTH_GATEWAY_URL=https://oa.xinxihua.com/sso-login #应用通讯的TOKEN AUTH_TOKEN=1QchOH0JQ6PGTCcFSapG #应用通讯的加密字符串 AUTH_ENCODING_KEY=ZOFV3OSokCBmaC34zP3FM41B88dccl7AC65RuaoyuaB
使用
路由配置
- 在web路由中配置
XXH::routes();
说明:XXH::routes() 包含以下路由,如果要控制权限,可以通过中间件方式
Route::get('login', '\XinXiHua\SDK\Http\Controllers\LoginController@login')->name('login'); Route::post('logout', '\XinXiHua\SDK\Http\Controllers\LoginController@logout')->name('logout'); Route::get('callback', '\XinXiHua\SDK\Http\Controllers\LoginController@callback')->name('callback'); Route::get('admin/login', '\XinXiHua\SDK\Http\Controllers\Admin\LoginController@login')->name('admin.login'); Route::post('admin/logout', '\XinXiHua\SDK\Http\Controllers\Admin\LoginController@logout')->name('admin.logout'); Route::get('admin/callback', '\XinXiHua\SDK\Http\Controllers\Admin\LoginController@callback')->name('admin.callback'); Route::any('serve', '\XinXiHua\SDK\Http\Controllers\ServeController@serve')->name('serve');
- 将 serve 添加到 VerifyCsrfToken 中间件中
<?php namespace App\Http\Middleware; use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware; class VerifyCsrfToken extends Middleware { /** * The URIs that should be excluded from CSRF verification. * * @var array */ protected $except = [ // 'serve' ]; }
用法
<?php /** * Created by PhpStorm. * User: JHC * Date: 2018-07-24 * Time: 11:51 */ namespace XinXiHua\SDK\Services; use Illuminate\Support\Facades\Log; use XinXiHua\SDK\Exceptions\ApiException; class ContactService extends BaseService { public function all() { $response = $this->client->get('/contacts'); Log::info($response->getResponse()); if ($response->isResponseSuccess()) { return $response->getResponseData()['data']; } throw new ApiException($response->getResponseData()['message']); } }
herojhc/xxh-sdk 适用场景与选型建议
herojhc/xxh-sdk 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 39 次下载、GitHub Stars 达 3, 最近一次更新时间为 2018 年 07 月 24 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「api」 「client」 「oauth2」 「laravel」 「xinxihua」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 herojhc/xxh-sdk 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 herojhc/xxh-sdk 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 herojhc/xxh-sdk 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
A lightweight and powerful OAuth 2.0 authorization and resource server library with support for all the core specification grants. This library will allow you to secure your API with OAuth and allow your applications users to approve apps that want to access their data from your API.
A PSR-7 compatible library for making CRUD API endpoints
Mock PSR-18 HTTP client
Email Toolkit Plugin for CakePHP
Asynchronous MQTT client built on React
The missing social authentication for thephpleague/oauth2-server, adapted from schedula/league-oauth2-social
统计信息
- 总下载量: 39
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 3
- 点击次数: 1
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2018-07-24