rusticisoftware / tincan
体验API (Tin Can API) 库
Requires
- php: ~5.5 || ^7.0.3
- ext-openssl: *
- namshi/jose: ^7.2.1
- willdurand/negotiation: ^2.0
Requires (Dev)
README
一个用于实现体验API (Tin Can API) 的PHP库。
有关托管API文档、基本使用说明、支持的版本列表等信息,请访问主项目网站:
http://rusticisoftware.github.io/TinCanPHP/
有关体验API的更多信息,请访问:
需要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.php
复制到tests/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.txt和https://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