taylora/tincan

体验API (Tin Can API) 库

1.1.2 2020-11-05 17:49 UTC

This package is auto-updated.

Last update: 2024-09-06 03:03:26 UTC


README

这是一个用于实现体验API (Tin Can API) 的PHP库。

Build Status Latest Stable Version License Total Downloads

有关托管API文档、基本使用说明、支持的版本列表等信息,请访问主项目网站:

http://rusticisoftware.github.io/TinCanPHP/

有关体验API的更多信息,请访问:

http://experienceapi.com/

需要PHP 5.5或更高版本。(如果您必须运行更早的版本,您应该查看0.x版本系列或PHP_5_2分支。)

安装

TinCanPHP可以通过Composer获取。

php composer.phar require rusticisoftware/tincan:@stable

当不使用Composer时,需要引入自动加载器

require 'path/to/TinCan/autoload.php';

测试

测试是用最新稳定的PHPUnit版本实现的。当使用Composer时将安装。通过复制tests/config/config.dist.phptests/config/config.php并设置您的LRS值来配置LRS端点和凭据。

配置完成后运行

vendor/bin/phpunit

API文档生成

可以使用phpDocumentor2输出文档。当使用Composer时将安装。要生成文档

vendor/bin/phpdoc

在运行php composer.phar update后从存储库的根目录开始。文档将输出到doc/api

如果您没有在您的php.ini文件中设置默认时区,您可以在存储库的根目录下创建一个时区并使用PHPRC环境变量指向它。例如

export PHPRC="/path/to/repos/TinCanPHP/php.ini"

并使用以下命令在该文件中设置时区

[PHP]

date.timezone = "US/Central"

证书生成

以下说明是在安装了OpenSSL的Mac上创建所需的公钥/私钥对和证书的步骤。请参阅https://www.openssl.org/docs/HOWTO/certificates.txthttps://www.openssl.org/docs/HOWTO/keys.txt

生成不带密码的私钥(不推荐)

openssl genrsa -out privkey.pem 2048

要生成带密码的私钥

openssl genrsa -des3 -out privkey.pem 2048

创建证书签名请求

 openssl req -new -key privkey.pem -out cert.csr

要创建自签名证书(而不是由CA签名的证书),主要用于测试目的

openssl req -new -x509 -key privkey.pem -out cacert.pem -days 1095