a-blog cms PHP API Reference

ValidateAuthUrl

メール認証のURLを検証するための機能

Table of Contents

Properties

$key  : string
トークンのキーを削除要に保持
$token  : string
消費対象の平文トークンを保持
$type  : string
トークンのタイプを削除用に保持

Methods

consumeToken()  : bool
検証済みトークンを1回だけ原子的に消費する(単一使用の担保)
getTokenKey()  : string
トークンのキーを取得
getTokenType()  : string
トークンのタイプを取得
isAuthUrl()  : bool
現在のURLが認証URLかチェック
removeToken()  : void
使用したトークンを削除
validateAuthUrl()  : array<string|int, mixed>
認証URLを検証
validateToken()  : array<string|int, mixed>
認証URLのトークンと保存してあるトークンを比較
validateUrl()  : array<string|int, mixed>
認証URlを検証

Properties

$key

トークンのキーを削除要に保持

protected string $key

$token

消費対象の平文トークンを保持

protected string $token = ''

$type

トークンのタイプを削除用に保持

protected string $type

Methods

consumeToken()

検証済みトークンを1回だけ原子的に消費する(単一使用の担保)

protected consumeToken() : bool

validateToken() が保持した対象トークンだけを削除し、削除できた場合のみ true を返す。パスワード更新などの本処理を実行する前にこれで門番することで、 同一リンクの二重送信・使用後の再利用を防ぐ。

Return values
bool —

消費できたら true、既に使用済み・不一致なら false

getTokenKey()

トークンのキーを取得

protected abstract getTokenKey() : string
Return values
string

getTokenType()

トークンのタイプを取得

protected abstract getTokenType() : string
Return values
string

isAuthUrl()

現在のURLが認証URLかチェック

protected isAuthUrl() : bool
Return values
bool

removeToken()

使用したトークンを削除

protected removeToken() : void

token_value まで一致する対象トークンのみを削除する(consumeToken() に委譲し、 戻り値は見ない)。以前は key/type 一致だけで削除しており、同じ区分 (例: signup-confirmation)の他ユーザーのトークンまで巻き込んで消していた (CMS-7923)。消費の成否を判定したい場合は consumeToken() を直接使う。

validateToken()

認証URLのトークンと保存してあるトークンを比較

protected validateToken(string $token) : array<string|int, mixed>
Parameters
$token : string
Return values
array<string|int, mixed>

validateUrl()

認証URlを検証

protected validateUrl(string $key, string $salt, string $context) : array<string|int, mixed>
Parameters
$key : string
$salt : string
$context : string
Tags
throws
BadRequestException
throws
ExpiredException
Return values
array<string|int, mixed>

        
On this page

Search results