Gists

扩展 AbstractPackage

Joomla 框架的 GitHub API Gists 类。

链接

1.0

只读属性 Comments

GitHub API 对象用于 gist 评论。

Joomla 框架

方法

__construct

构造函数。

__construct(\Joomla\Registry\Registry options = null, \Joomla\Http\Http client = null) : 
继承

1.0

参数

options

Registry|nullGitHub 选项对象。

client

Http|nullHTTP 客户端对象。

响应

混合

__get

魔术方法用于延迟创建 API 对象

__get( name) : \Joomla\Github\AbstractPackage
继承

1.0

抛出

InvalidArgumentException

参数

name

string要检索的属性名称

响应

AbstractPackageGitHub API 包对象。

buildFileData

方法用于为基于文件路径输入数组或文件名和内容对的文件列表获取用于传输到 GitHub API 的数据数组。

buildFileData(mixed||string|int files) : mixed||string|int

1.0

抛出

InvalidArgumentException

参数

files

array<string|int, mixed>文件路径列表或文件名和内容。

响应

array<string|int, mixed>

create

创建一个 gist。

create( files,  public = false,  description = null) : 

1.0

抛出

DomainException

参数

files

mixed文件路径数组或作为字符串的单个文件路径。

public

bool如果 gist 应该是公开的,则为真。

description

stringgist 的可选描述。

响应

对象

delete

删除一个 gist。

delete( gistId) : 

1.0

抛出

DomainException

参数

gistId

intgist 编号。

响应

void

edit

编辑一个 gist。

edit( gistId,  files = null,  public = null,  description = null) : 

1.0

抛出

DomainException

参数

gistId

intgist 编号。

files

mixed文件路径数组或作为字符串的单个文件路径。

public

bool如果 gist 应该是公开的,则为真。

description

stringgist 的描述。

响应

对象

fetchUrl

方法用于构建并返回请求的完整请求 URL。此方法将根据需要添加适当的分页详细信息,并将 API URL 作为前缀以获得请求的完整 URL。

fetchUrl( path,  page,  limit) : \Joomla\Uri\Uri
继承

1.0

参数

path

string要变形的 URL

page

int要请求的页面

limit

int每页返回的结果数

响应

Uri

fork

分叉一个 gist。

fork( gistId) : 

1.0

抛出

DomainException

参数

gistId

intgist 编号。

响应

对象

get

获取单个 gist。

get( gistId) : 

1.0

抛出

DomainException

参数

gistId

intgist 编号。

响应

对象

getCommitList

列出 gist 提交。

getCommitList( gistId,  page,  limit) : mixed||string|int

1.4.0

抛出

DomainException

参数

gistId

intgist 编号。

page

int要获取项目的页码。

limit

int每页的项目数。

响应

array<string|int, mixed>

getForkList

列出 gist 分叉。

getForkList( gistId,  page,  limit) : mixed||string|int

1.4.0

抛出

DomainException

参数

gistId

intgist 编号。

page

int要获取项目的页码。

limit

int每页的项目数。

响应

array<string|int, mixed>

getList

列出 gist。

getList( page,  limit) : mixed||string|int

如果用户已通过身份验证,它将返回用户的 gist,否则它将返回所有公共 gist。

1.0

抛出

DomainException

参数

page

int要获取项目的页码。

limit

int每页的项目数。

响应

array<string|int, mixed>

getListByUser

列出用户的 gist。

getListByUser( user,  page,  limit, \DateTime since = null) : mixed||string|int

1.0

抛出

DomainException

参数

user

string要列出 gist 的 GitHub 用户名。

page

int要获取项目的页码。

limit

int每页的项目数。

DateTime|null仅返回在此时间或之后更新的 gist。

响应

array<string|int, mixed>

getListPublic

列出所有公共 gist。

getListPublic( page,  limit, \DateTime since = null) : mixed||string|int

1.0

抛出

DomainException

参数

page

int要获取项目的页码。

limit

int每页的项目数。

DateTime|null仅返回在此时间或之后更新的 gist。

响应

array<string|int, mixed>

getListStarred

列出加星标的 gist。

getListStarred( page,  limit, \DateTime since = null) : mixed||string|int

1.0

抛出

DomainException

参数

page

int要获取项目的页码。

limit

int每页的项目数。

DateTime|null仅返回在此时间或之后更新的 gist。

响应

array<string|int, mixed>

getRevision

获取 gist 的特定修订版。

getRevision( gistId,  sha) : 

1.4.0

抛出

DomainException

参数

gistId

intgist 编号。

sha

string要获取的修订版的 SHA。

响应

对象

isStarred

检查 gist 是否加星标。

isStarred( gistId) : 

1.0

抛出

UnexpectedResponseException

参数

gistId

intgist 编号。

响应

bool如果 gist 已加星标,则为真

processResponse

处理响应并对其进行解码。

processResponse(\Joomla\Http\Response response,  expectedCode = 200) : 
继承

1.0

抛出

UnexpectedResponseException

参数

response

Response响应。

expectedCode

int预期的“好”代码。

响应

混合

star

将 gist 加星标。

star( gistId) : 

1.0

抛出

DomainException

参数

gistId

intgist 编号。

响应

void

unstar

取消 gist 的星标。

unstar( gistId) : 

1.0

抛出

DomainException

参数

gistId

intgist 编号。

响应

void

属性

comments

GitHub API 对象用于 gist 评论。

类型

Comments

options

GitHub 对象的选项。

继承

1.0

类型

Registry

client

用于发送 HTTP 请求的 HTTP 客户端对象。

继承

1.0

类型

Http

对象所在的包

继承

1.0

类型

string

hookEvents

包含允许的挂钩事件的数组

继承

1.5.2

链接
note

从 1.4.0 到 1.5.1,它被称为 $events,它被重命名为因为与包子类的命名冲突

类型

array<string|int, mixed>