LTIX
in package
This an opinionated LTI class that defines how Tsugi tools interact with LTI
This class deals with all of the session and database/data model details that Tsugi tools make use of during runtime. This makes use of the lower level \Tsugi\Util\LTI class which is focused on meeting the protocol requirements. Most tools will not use LTI at all - just LTIX.
Table of Contents
Constants
- ALL : mixed = "all"
- BROWSER_MARK_COOKIE : mixed = "TSUGI-BROWSER-MARK"
- CONTEXT : mixed = "context_id"
- LINK : mixed = "link_id"
- MAX_ACTIVITY : mixed = 1023
- NONE : mixed = "none"
- ROLE_ADMINISTRATOR : mixed = 5000
- ROLE_INSTRUCTOR : mixed = 1000
- ROLE_LEARNER : mixed = 0
- USER : mixed = "user_id"
Methods
- abort_with_error_log() : mixed
- We are aborting this request. If we are processing a launch request, redirect back.
- adjustData() : mixed
- Make sure that the data in our lti_ tables matches the POST data
- buildLaunch() : mixed
- caliperSend() : mixed
- Send a Caliper Body to the correct URL using the key and secret
- checkOidcNonce() : mixed
- Bind an ID token nonce to the authenticated state from oidc_login.
- curPageUrl() : mixed
- curPageUrl - Returns the URL to the currently executing script with query string
- curPageUrlBase() : string
- curPageUrlBase - Returns the protocol, host, and port for the current URL
- curPageUrlFolder() : mixed
- curPageUrlFolder - Returns the URL to the folder currently executing
- curPageUrlNoQuery() : mixed
- curPageUrlNoQuery - Returns the URL to the currently executing query without query string
- curPageUrlScript() : mixed
- curPageUrlScript - Returns the URL to the currently executing script
- decrypt_secret() : mixed
- Decrypt a secret from the session
- displayNameFromClaim() : mixed
- Get a display name from a LTI 1.3 user claim
- encode_jwt() : mixed
- encode and sign a JWT with a bunch of parameters
- encrypt_secret() : mixed
- Encrypt a secret to put into the session
- ensureCsrfToken() : string
- Session CSRF token for same-origin HTML forms (not LTI launches or signed webhooks).
- extractJWT() : mixed
- Pull the LTI JWT data into our own data structure
- extractPost() : mixed
- Pull the LTI POST data into our own data structure
- getBrowserMark() : mixed
- getBrowserSignature() : mixed
- getBrowserSignatureRaw() : mixed
- getCompositeKey() : mixed
- getConnection() : mixed
- Get a singleton global connection or set it up if not already set up.
- getContentItem() : mixed
- getLaunchData - Get the launch data for am LTI ContentItem launch
- getCoreLaunchData() : mixed
- getCoreLaunchData - Get the launch data common across launch types
- getKeySecretForLaunch() : mixed
- getKeySecretForLaunch - Retrieve a Key/Secret for a Launch
- getKidForKey() : mixed
- Compute the kid has value from a public key
- getLatestHistoryIds() : mixed
- Retrieve the context and link ids for a previous installation of the tool, such as if it were imported from another site during a site import. Returns false, if not.
- getLaunchContent() : mixed
- getLaunchContent - Get the launch data for am LTI ContentItem launch
- getLaunchData() : mixed
- getLaunchData - Get the launch data for a normal LTI 1.x launch
- getLaunchUrl() : mixed
- getLaunchData - Get the launch data for am LTI ContentItem launch
- getPlatformPublicKey() : mixed
- getPlatformPublicKey - Get the platform public key for the various sources
- getTsugiStateCookieName() : mixed
- gradeGet() : mixed
- Load the grade for a particular row and update our local copy (Deprecated - moved to Result)
- gradeSend() : mixed
- Send a grade and update our local copy (Deprecated - moved to Result)
- gradeSendDueDate() : mixed
- Send a grade applying the due date logic and only increasing grades (Deprecated - moved to Result)
- jsonSend() : mixed
- Send a JSON Body to a URL after looking up the key and secret
- launchAuthorizationFlow() : mixed
- Handle the optional LTI pre 1.3 Launch Authorization flow
- launchCheck() : mixed
- Silently check if this is a launch and if so, handle it and redirect back to ourselves
- launchContextApplies() : mixed
- True when this request's course is the course stored on the launch row.
- loadAllData() : mixed
- Load the data from our lti_ tables using one long LEFT JOIN
- ltiCustomGet() : mixed
- Pull out a custom variable from the LTIX session. Do not include the "custom_" prefix - this is automatic.
- ltiLinkUrl() : string
- ltiLinkUrl - Returns true if we can return LTI Links for this launch
- ltiParameter() : mixed
- Pull a keyed variable from the LTI data in the current session with default
- ltiRawParameter() : mixed
- Pull a keyed variable from the original LTI post data in the current session with default
- ltiRawPostArray() : mixed
- Return the original $_POST array
- noteLoggedIn() : mixed
- Update the login_at fields as appropriate
- oauth_parameters() : mixed
- The LTI parameter data
- populateRoster() : bool
- populateRoster
- removeQueryString() : mixed
- removeQueryString - Drop a query string from a url
- requireData() : Launch
- Handle launch and/or set up the LTI session and global variables
- requireDataOverride() : mixed
- Handle the launch, but with the caller given the chance to override defaults
- requireDataPrivate() : mixed
- Internal method to handle the data setup
- session_start() : Launch
- Optionally handle launch and/or set up the LTI session and global variables
- setCookieStrong() : mixed
- settingsSend() : mixed
- Send settings to the LMS using the simple JSON approach
- setupSession() : mixed
- Extract all of the post data, set up data in tables, and set up session.
- signParameters() : mixed
- signParameters - Look up the key and secret and call the underlying code in LTI
- var_dump() : mixed
- Dump out the internal data structures adssociated with the current launch. Best if used within a pre tag.
- checkCSRF() : mixed
- checkHeartBeat() : mixed
- checkReferer() : mixed
- patchNeeded() : mixed
- Patch the value for the list of needed features
- provisionReqScope() : void
- Fill ReqScope from the open session without changing launch globals.
- rejectDeletedContext() : void
- A session launch for a soft-deleted course must not be rebuilt.
- rememberBinaryGuid() : mixed
- Keep a repaired guid on the launch row so the next request does not query again.
- send403() : mixed
Constants
ALL
public
mixed
ALL
= "all"
BROWSER_MARK_COOKIE
public
mixed
BROWSER_MARK_COOKIE
= "TSUGI-BROWSER-MARK"
CONTEXT
public
mixed
CONTEXT
= "context_id"
LINK
public
mixed
LINK
= "link_id"
MAX_ACTIVITY
public
mixed
MAX_ACTIVITY
= 1023
NONE
public
mixed
NONE
= "none"
ROLE_ADMINISTRATOR
public
mixed
ROLE_ADMINISTRATOR
= 5000
ROLE_INSTRUCTOR
public
mixed
ROLE_INSTRUCTOR
= 1000
ROLE_LEARNER
public
mixed
ROLE_LEARNER
= 0
USER
public
mixed
USER
= "user_id"
Methods
abort_with_error_log()
We are aborting this request. If we are processing a launch request, redirect back.
public
static abort_with_error_log(mixed $msg[, mixed $extra = false ][, mixed $prefix = "DIE:" ]) : mixed
If this is a loss of session, show an error page that checks for things like sessionStorage to find the best place to redirect back to.
Parameters
- $msg : mixed
- $extra : mixed = false
- $prefix : mixed = "DIE:"
adjustData()
Make sure that the data in our lti_ tables matches the POST data
public
static adjustData(mixed $p, mixed &$row, mixed $post, mixed $needed) : mixed
This routine compares the POST data to the data pulled from the lti_ tables and goes through carefully INSERTing or UPDATING all the nexessary data in the lti_ tables to make sure that the lti_ table correctly match all the data from the incoming post.
While this looks like a lot of INSERT and UPDATE statements, the INSERT statements only run when we see a new user/course/link for the first time and after that, we only update if something changes. So in a high percentage of launches we are not seeing any new or updated data and so this code just falls through and does absolutely no SQL.
Parameters
- $p : mixed
- $row : mixed
- $post : mixed
- $needed : mixed
buildLaunch()
public
static buildLaunch(mixed $LTI) : mixed
Parameters
- $LTI : mixed
caliperSend()
Send a Caliper Body to the correct URL using the key and secret
public
static caliperSend(mixed $caliperBody[, mixed $content_type = 'application/json' ][, mixed &$debug_log = false ]) : mixed
This is not yet a standard or production - it uses the Canvas extension only.
Parameters
- $caliperBody : mixed
- $content_type : mixed = 'application/json'
- $debug_log : mixed = false
checkOidcNonce()
Bind an ID token nonce to the authenticated state from oidc_login.
public
static checkOidcNonce(mixed $state, mixed $nonce) : mixed
Returns true on success or an error string. This does not consume state: postMessage/postverify may revisit the callback before it forwards to a tool. JWT signature validation and the existing nonce replay check still apply.
Parameters
- $state : mixed
- $nonce : mixed
curPageUrl()
curPageUrl - Returns the URL to the currently executing script with query string
public
static curPageUrl() : mixed
This is useful when we want to do OAuth where we need the exact incoming path but our host, protocol, and port might be messed up by a proxy or CDN.
URL Result http://x.com/data http://x.com/data http://x.com/data/index.php http://x.com/data/index.php http://x.com/data/index.php?y=1 http://x.com/data/index.php?y=1
curPageUrlBase()
curPageUrlBase - Returns the protocol, host, and port for the current URL
public
static curPageUrlBase() : string
This is useful when we are running behind a proxy like ngrok or CloudFlare. These proxies will accept with the http or https version of the URL but our web server will likely only se the incoming request as http. So we need to fall back to $CFG->wwwroot and reconstruct the right URL from there. Since the wwwroot might have some of the request URI, like
http://tsugi.ngrok.com/tsugi
We need to parse the wwwroot and put things back together.
URL Result http://x.com/data http://x.com http://x.com/data/index.php http://x.com http://x.com/data/index.php?y=1 http://x.com
Return values
string —The current page protocol, host, and optionally port URL
curPageUrlFolder()
curPageUrlFolder - Returns the URL to the folder currently executing
public
static curPageUrlFolder() : mixed
This is useful when rest-style files want to link back to "index.php" Note - this will not go up to a parent.
URL Result http://x.com/data/ http://x.com/data/ http://x.com/data/keys http://x.com/data/
curPageUrlNoQuery()
curPageUrlNoQuery - Returns the URL to the currently executing query without query string
public
static curPageUrlNoQuery() : mixed
URL Result http://x.com/data http://x.com/data http://x.com/data/keys http://x.com/data/keys http://x.com/data/keys?x=1 http://x.com/data/keys
curPageUrlScript()
curPageUrlScript - Returns the URL to the currently executing script
public
static curPageUrlScript() : mixed
This is useful when we want to make a URL to another script at this location. Often we use this with str_replace().
URL Result
http://x.com/data http://x.com/data/index.php
http://x.com/data/index.php http://x.com/data/index.php
http://x.com/data/index.php?y=1 http://x.com/data/index.php
http://stackoverflow.com/questions/279966/php-self-vs-path-info-vs-script-name-vs-request-uri
http://example.com/bob
REQUEST_URI = /bob
PHP_SELF = /bob/index.php
decrypt_secret()
Decrypt a secret from the session
public
static decrypt_secret(mixed $secret) : mixed
Parameters
- $secret : mixed
displayNameFromClaim()
Get a display name from a LTI 1.3 user claim
public
static displayNameFromClaim(mixed $claim) : mixed
Parameters
- $claim : mixed
encode_jwt()
encode and sign a JWT with a bunch of parameters
public
static encode_jwt(mixed $params) : mixed
Parameters
- $params : mixed
encrypt_secret()
Encrypt a secret to put into the session
public
static encrypt_secret(mixed $secret) : mixed
Parameters
- $secret : mixed
ensureCsrfToken()
Session CSRF token for same-origin HTML forms (not LTI launches or signed webhooks).
public
static ensureCsrfToken([bool $rotate = false ]) : string
Parameters
- $rotate : bool = false
-
When true, always mint a new token (login / LTI launch).
Return values
stringextractJWT()
Pull the LTI JWT data into our own data structure
public
static extractJWT([mixed $needed = self::ALL ][, mixed $input = false ]) : mixed
We follow our naming conventions that match the column names in our lti_ tables.
Parameters
- $needed : mixed = self::ALL
- $input : mixed = false
extractPost()
Pull the LTI POST data into our own data structure
public
static extractPost([mixed $needed = self::ALL ][, mixed $input = false ]) : mixed
We follow our naming conventions that match the column names in our lti_ tables.
Parameters
- $needed : mixed = self::ALL
- $input : mixed = false
getBrowserMark()
public
static getBrowserMark() : mixed
getBrowserSignature()
public
static getBrowserSignature() : mixed
getBrowserSignatureRaw()
public
static getBrowserSignatureRaw() : mixed
getCompositeKey()
public
static getCompositeKey(mixed $post, mixed $session_secret) : mixed
Parameters
- $post : mixed
- $session_secret : mixed
getConnection()
Get a singleton global connection or set it up if not already set up.
public
static getConnection() : mixed
getContentItem()
getLaunchData - Get the launch data for am LTI ContentItem launch
public
static getContentItem(mixed $contentReturn, mixed $dataProps) : mixed
Parameters
- $contentReturn : mixed
- $dataProps : mixed
getCoreLaunchData()
getCoreLaunchData - Get the launch data common across launch types
public
static getCoreLaunchData() : mixed
getKeySecretForLaunch()
getKeySecretForLaunch - Retrieve a Key/Secret for a Launch
public
static getKeySecretForLaunch(mixed $url) : mixed
Parameters
- $url : mixed
-
- The url to lookup
getKidForKey()
Compute the kid has value from a public key
public
static getKidForKey(mixed $pubkey) : mixed
Parameters
- $pubkey : mixed
getLatestHistoryIds()
Retrieve the context and link ids for a previous installation of the tool, such as if it were imported from another site during a site import. Returns false, if not.
public
static getLatestHistoryIds() : mixed
Tags
getLaunchContent()
getLaunchContent - Get the launch data for am LTI ContentItem launch
public
static getLaunchContent(mixed $endpoint[, mixed $debug = false ]) : mixed
Parameters
- $endpoint : mixed
- $debug : mixed = false
getLaunchData()
getLaunchData - Get the launch data for a normal LTI 1.x launch
public
static getLaunchData() : mixed
getLaunchUrl()
getLaunchData - Get the launch data for am LTI ContentItem launch
public
static getLaunchUrl(mixed $endpoint[, mixed $debug = false ]) : mixed
Parameters
- $endpoint : mixed
- $debug : mixed = false
getPlatformPublicKey()
getPlatformPublicKey - Get the platform public key for the various sources
public
static getPlatformPublicKey(mixed $key_id, mixed $request_kid, mixed $our_kid, mixed $public_key, mixed $our_keyset_url, mixed $our_keyset) : mixed
This will check the current kid, the current keyset, and if nothing matches re-load the keyset url, and check the new keyset url. If new information is retrieved, it is cached until the kid chages for this issuer.
Parameters
- $key_id : mixed
- $request_kid : mixed
- $our_kid : mixed
- $public_key : mixed
- $our_keyset_url : mixed
- $our_keyset : mixed
getTsugiStateCookieName()
public
static getTsugiStateCookieName() : mixed
gradeGet()
Load the grade for a particular row and update our local copy (Deprecated - moved to Result)
public
static gradeGet([mixed $row = false ][, mixed &$debug_log = false ]) : mixed
Call the right LTI service to retrieve the server's grade and update our local cached copy of the server_grade and the date retrieved. This routine pulls the key and secret from the LTIX session to avoid crossing cross tenant boundaries.
Parameters
- $row : mixed = false
-
An optional array with the data that has the result_id, sourcedid, and service (url) if this is not present, the data is pulled from the LTI session for the current user/link combination.
- $debug_log : mixed = false
-
An (optional) array (by reference) that returns the steps that were taken. Each entry is an array with the [0] element a message and an optional [1] element as some detail (i.e. like a POST body)
Return values
mixed —If this work this returns a float. If not you get a string with an error.
gradeSend()
Send a grade and update our local copy (Deprecated - moved to Result)
public
static gradeSend(mixed $grade[, mixed $row = false ][, mixed &$debug_log = false ]) : mixed
Call the right LTI service to send a new grade up to the server. update our local cached copy of the server_grade and the date retrieved. This routine pulls the key and secret from the LTIX session to avoid crossing cross tenant boundaries.
Parameters
- $grade : mixed
-
A new grade - floating point number between 0.0 and 1.0
- $row : mixed = false
-
An optional array with the data that has the result_id, sourcedid, and service (url) if this is not present, the data is pulled from the LTI session for the current user/link combination.
- $debug_log : mixed = false
-
An (optional) array (by reference) that returns the steps that were taken. Each entry is an array with the [0] element a message and an optional [1] element as some detail (i.e. like a POST body)
Return values
mixed —If this works it returns true. If not, you get a string with an error.
gradeSendDueDate()
Send a grade applying the due date logic and only increasing grades (Deprecated - moved to Result)
public
static gradeSendDueDate(mixed $gradetosend[, mixed $oldgrade = false ][, mixed $dueDate = false ]) : mixed
Puts messages in the session for a redirect.
Parameters
- $gradetosend : mixed
-
- The grade in the range 0.0 .. 1.0
- $oldgrade : mixed = false
-
- The previous grade in the range 0.0 .. 1.0 (optional)
- $dueDate : mixed = false
-
- The due date for this assignment
jsonSend()
Send a JSON Body to a URL after looking up the key and secret
public
static jsonSend(mixed $method, mixed $postBody, mixed $content_type, mixed $service_url[, bool &$debug_log = false ]) : mixed
Parameters
- $method : mixed
-
The HTTP Method to use
- $postBody : mixed
- $content_type : mixed
- $service_url : mixed
- $debug_log : bool = false
launchAuthorizationFlow()
Handle the optional LTI pre 1.3 Launch Authorization flow
public
static launchAuthorizationFlow(mixed $request_data) : mixed
Parameters
- $request_data : mixed
launchCheck()
Silently check if this is a launch and if so, handle it and redirect back to ourselves
public
static launchCheck([mixed $needed = self::ALL ][, mixed $request_data = false ]) : mixed
Parameters
- $needed : mixed = self::ALL
- $request_data : mixed = false
launchContextApplies()
True when this request's course is the course stored on the launch row.
public
static launchContextApplies(mixed $LTI) : mixed
A cookieless tool launch is that row. A cookie /courses/{id} request matches when the URL id is the row's context_id. Any other cookie URL matches only when $_SESSION['context_id'] is that same id. A request course of 0 does not match.
Parameters
- $LTI : mixed
loadAllData()
Load the data from our lti_ tables using one long LEFT JOIN
public
static loadAllData(mixed $p, mixed $profile_table, mixed $post) : mixed
This data may or may not exist - hence the use of the long LEFT JOIN.
Parameters
- $p : mixed
- $profile_table : mixed
- $post : mixed
ltiCustomGet()
Pull out a custom variable from the LTIX session. Do not include the "custom_" prefix - this is automatic.
public
static ltiCustomGet(mixed $varname[, mixed $default = false ]) : mixed
Session access should be through the Launch Object
Parameters
- $varname : mixed
- $default : mixed = false
ltiLinkUrl()
ltiLinkUrl - Returns true if we can return LTI Links for this launch
public
static ltiLinkUrl([mixed $postdata = false ]) : string
Parameters
- $postdata : mixed = false
Return values
string —The content_item_return_url or false
ltiParameter()
Pull a keyed variable from the LTI data in the current session with default
public
static ltiParameter(mixed $varname[, mixed $default = false ]) : mixed
Session access should be through the Launch Object
Parameters
- $varname : mixed
- $default : mixed = false
ltiRawParameter()
Pull a keyed variable from the original LTI post data in the current session with default
public
static ltiRawParameter(mixed $varname[, mixed $default = false ]) : mixed
Session access should be through the Launch Object
Parameters
- $varname : mixed
- $default : mixed = false
ltiRawPostArray()
Return the original $_POST array
public
static ltiRawPostArray() : mixed
Session access should be through the Launch Object
noteLoggedIn()
Update the login_at fields as appropriate
public
static noteLoggedIn(mixed $row) : mixed
Parameters
- $row : mixed
oauth_parameters()
The LTI parameter data
public
static oauth_parameters() : mixed
This code is taken from OAuthRequest
populateRoster()
populateRoster
public
static populateRoster([bool $groups = false ][, bool $insert = false ]) : bool
If the LTI Extension: Context Memberships Service is supported in the launch, get the memberships information and insert the information into lti_user and lti_membership
Parameters
- $groups : bool = false
-
, whether or not to get groups in the Memberships
- $insert : bool = false
-
, whether or not to insert the members found into lti_user, lti_membership
Return values
bool —true if successful, false if not possible
removeQueryString()
removeQueryString - Drop a query string from a url
public
static removeQueryString(mixed $url) : mixed
Parameters
- $url : mixed
requireData()
Handle launch and/or set up the LTI session and global variables
public
static requireData([mixed $needed = self::ALL ]) : Launch
Make sure we have the values we need in the LTI session This routine will not start a session if none exists. It will die is there if no session_name() (PHPSESSID) cookie or parameter. No need to create any fresh sessions here.
Parameters
- $needed : mixed = self::ALL
-
(optional, mixed) Indicates which of the data structures are * needed. If this is omitted, this assumes that CONTEXT, LINK, and USER data are required. If LTIX::NONE is present, then none of the three are rquired. If some combination of the three are needed, this accepts an array of the LTIX::CONTEXT, LTIX: LINK, and LTIX::USER can be passed in.
Return values
Launch —A Tsugi Launch object.
requireDataOverride()
Handle the launch, but with the caller given the chance to override defaults
public
static requireDataOverride(mixed $needed, mixed $pdox, mixed $current_url, mixed $request_data) : mixed
Parameters
- $needed : mixed
- $pdox : mixed
-
array - aproperly initialized PDO object. Can be null.
- $current_url : mixed
- $request_data : mixed
-
array - This must merge the $_POST, $_GET, and OAuth Header data (in that order - header data has highest priority). See self::oauth_parameters() for the way this data is normally pulled from the three sources and merged into a single array. Can be null.
requireDataPrivate()
Internal method to handle the data setup
public
static requireDataPrivate([mixed $needed = self::ALL ][, mixed $pdox = null ][, mixed $current_url = null ][, mixed $request_data = null ]) : mixed
Parameters
- $needed : mixed = self::ALL
- $pdox : mixed = null
- $current_url : mixed = null
- $request_data : mixed = null
session_start()
Optionally handle launch and/or set up the LTI session and global variables
public
static session_start() : Launch
This will set up as much of the $USER, $CONTEXT, $LINK, and $RESULT data as it can including leaving them all null if this is called on a request with no LTI launch and no LTI data in the session. This functions as and performs a PHP session_start().
Return values
Launch —A Tsugi Launch object.
setCookieStrong()
public
static setCookieStrong(mixed $name, mixed $value, mixed $expires[, mixed $partitioned = true ]) : mixed
Parameters
- $name : mixed
- $value : mixed
- $expires : mixed
- $partitioned : mixed = true
settingsSend()
Send settings to the LMS using the simple JSON approach
public
static settingsSend(mixed $settings, mixed $settings_url[, mixed &$debug_log = false ]) : mixed
Parameters
- $settings : mixed
- $settings_url : mixed
- $debug_log : mixed = false
setupSession()
Extract all of the post data, set up data in tables, and set up session.
public
static setupSession([mixed $needed = self::ALL ][, mixed $request_data = false ]) : mixed
Parameters
- $needed : mixed = self::ALL
- $request_data : mixed = false
signParameters()
signParameters - Look up the key and secret and call the underlying code in LTI
public
static signParameters(mixed $oldparms, mixed $endpoint, mixed $method[, mixed $submit_text = false ][, mixed $org_id = false ][, mixed $org_desc = false ]) : mixed
Parameters
- $oldparms : mixed
- $endpoint : mixed
- $method : mixed
- $submit_text : mixed = false
- $org_id : mixed = false
- $org_desc : mixed = false
var_dump()
Dump out the internal data structures adssociated with the current launch. Best if used within a pre tag.
public
static var_dump() : mixed
checkCSRF()
private
static checkCSRF() : mixed
checkHeartBeat()
private
static checkHeartBeat() : mixed
checkReferer()
private
static checkReferer() : mixed
patchNeeded()
Patch the value for the list of needed features
private
static patchNeeded(mixed $needed) : mixed
Note - causes no harm if called more than once.
Parameters
- $needed : mixed
provisionReqScope()
Fill ReqScope from the open session without changing launch globals.
private
static provisionReqScope(mixed $LTI) : void
A cookieless tool session is read from the stored launch row, including the link when that row has one. A cookie site session is read from $_SESSION['id'] and $_SESSION['context_id']. The link is copied only when the stored launch names that same course. A missing user or course is stored as null.
Parameters
- $LTI : mixed
rejectDeletedContext()
A session launch for a soft-deleted course must not be rebuilt.
private
static rejectDeletedContext(object $PDOX, mixed $LTI) : void
Login, CSRF, and the stored LTI return URL stay. Only the course is dropped.
Parameters
- $PDOX : object
- $LTI : mixed
rememberBinaryGuid()
Keep a repaired guid on the launch row so the next request does not query again.
private
static rememberBinaryGuid(string $alias, string|null $hex) : mixed
The constructor returns hex. The launch row keeps the BINARY(16) form.
Parameters
- $alias : string
- $hex : string|null
send403()
private
static send403() : mixed