PHPackages                             cdkwtech/askpsyc - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. cdkwtech/askpsyc

ActiveLibrary

cdkwtech/askpsyc
================

妙知心理开放平台 SDK（量表/题目/测评报告）

1.0.0(today)01↑2900%MITPHPPHP >=7.4

Since Aug 28Pushed todayCompare

[ Source](https://github.com/lind87614/open-askpsyc)[ Packagist](https://packagist.org/packages/cdkwtech/askpsyc)[ RSS](/packages/cdkwtech-askpsyc/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (2)Versions (2)Used By (0)

cdkwtech/askpsyc
================

[](#cdkwtechaskpsyc)

妙知心理开放平台 SDK（PHP >= 7.4，零第三方依赖）。

安装
--

[](#安装)

```
composer require cdkwtech/askpsyc
```

本地开发（path 仓库方式）：

```
{
    "repositories": [{"type": "path", "url": "../askpsyc", "options": {"symlink": true}}]
}
```

快速开始
----

[](#快速开始)

```
use Cdkwtech\Askpsyc\AskpsycClient;

$client = new AskpsycClient('你的appid', '你的appsecret');

// 量表列表（分页）
foreach ($client->scales(1, 20) as $scale) {
    echo $scale->getId(), ' ', $scale->getTitle(), ' ¥', $scale->getDiscountedPrice(), PHP_EOL;
}

// 量表总数（分页用）
$count = $client->scaleCount();

// 量表详情
$detail = $client->scaleDetail(35);
echo $detail->getTitle(), ' 共 ', $detail->getScale()->getQuestionNum(), ' 题', PHP_EOL;

// 量表题目（answers 键用于交卷）
$questions = $client->questions(35);

// 提交答卷拿报告地址
$report = $client->submit(35, 3, array_fill(0, 100, 'A'));
echo $report->getUrl(), PHP_EOL;
```

签名
--

[](#签名)

与官方文档一致：参数（含 `appid`、`timestamp`，不含 `sign`）按 key 排序 → `http_build_query` → 拼接 `appsecret` → `md5`。SDK 内部自动完成，无需手工参与。

配置
--

[](#配置)

```
$client = new AskpsycClient($appid, $appSecret, [
    'base_url' => 'http://business.askpsyc.com/',  // 默认值
    'timeout'  => 10,                               // 秒，默认 10
]);
```

注意：实测服务端 /scale 接口当前忽略分页参数（详见 docs/usage.md 已知服务端行为）。

错误处理
----

[](#错误处理)

- 网络错误 / HTTP 非 2xx / 非法 JSON / 信封 `status != success` 或 `code != 200`→ 抛 `Cdkwtech\Askpsyc\Exception\AskpsycException`（`getCode()` 为错误码， `getRawResponse()` 携带服务端原始响应）
- 参数非法 → `InvalidArgumentException`

测试
--

[](#测试)

```
composer test      # PHPUnit（离线，不打真实接口）
composer analyse   # PHPStan level 5（PHP 7.4 语法校验）
```

接口与字段详情见 [docs/usage.md](docs/usage.md)。

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/69eaf03f246fc11ef0fc0e82d1b6111a235a0b2e50314fbcb0009e739e9e04d1?d=identicon)[liaodan](/maintainers/liaodan)

---

Top Contributors

[![liaodan100](https://avatars.githubusercontent.com/u/15657113?v=4)](https://github.com/liaodan100 "liaodan100 (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cdkwtech-askpsyc/health.svg)

```
[![Health](https://phpackages.com/badges/cdkwtech-askpsyc/health.svg)](https://phpackages.com/packages/cdkwtech-askpsyc)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)