IMSGlobal\LTI\OAuth\OAuthUtil Class Reference

Class to provide OAuth utility methods. More...

Collaboration diagram for IMSGlobal\LTI\OAuth\OAuthUtil:

Static Public Member Functions
static	urlencode_rfc3986 ($input)
static	urldecode_rfc3986 ($string)
static	split_header ($header, $only_allow_oauth_parameters=true)
static	get_headers ()
static	parse_parameters ( $input)
static	build_http_query ($params)

Detailed Description

Class to provide OAuth utility methods.

Copyright

Andy Smith

Version

2008-08-04 https://opensource.org/licenses/MIT The MIT License

Definition at line 12 of file OAuthUtil.php.

Member Function Documentation

build_http_query()

static IMSGlobal\LTI\OAuth\OAuthUtil::build_http_query (   $params )

static

Definition at line 127 of file OAuthUtil.php.

References $keys, $params, array, and IMSGlobal\LTI\OAuth\OAuthUtil\urlencode_rfc3986().

Referenced by IMSGlobal\LTI\OAuth\OAuthRequest\get_signable_parameters(), and IMSGlobal\LTI\OAuth\OAuthRequest\to_postdata().

                                                     {

        if (!$params) return '';

        // Urlencode both keys and values
        $keys = OAuthUtil::urlencode_rfc3986(array_keys($params));
        $values = OAuthUtil::urlencode_rfc3986(array_values($params));
        $params = array_combine($keys, $values);

        // Parameters are sorted by name, using lexicographical byte value ordering.
        // Ref: Spec: 9.1.1 (1)
        uksort($params, 'strcmp');

        $pairs = array();
        foreach ($params as $parameter => $value) {
            if (is_array($value)) {
                // If two or more parameters share the same name, they are sorted by their value
                // Ref: Spec: 9.1.1 (1)
                // June 12th, 2010 - changed to sort because of issue 164 by hidetaka
                sort($value, SORT_STRING);
                foreach ($value as $duplicate_value) {
                    $pairs[] = $parameter . '=' . $duplicate_value;
                }
            } else {
                $pairs[] = $parameter . '=' . $value;
            }
        }

        // For each parameter, the name is separated from the corresponding value by an '=' character (ASCII code 61)
        // Each name-value pair is separated by an '&' character (ASCII code 38)
        return implode('&', $pairs);

    }

Here is the call graph for this function:

Here is the caller graph for this function:

get_headers()

static IMSGlobal\LTI\OAuth\OAuthUtil::get_headers ( )

static

Definition at line 54 of file OAuthUtil.php.

References $_SERVER, $key, $out, and array.

Referenced by IMSGlobal\LTI\OAuth\OAuthRequest\from_request().

                                         {

        if (function_exists('apache_request_headers')) {
            // we need this to get the actual Authorization: header
            // because apache tends to tell us it doesn't exist
            $headers = apache_request_headers();

            // sanitize the output of apache_request_headers because
            // we always want the keys to be Cased-Like-This and arh()
            // returns the headers in the same case as they are in the
            // request
            $out = array();
            foreach ($headers AS $key => $value) {
                $key = str_replace(" ", "-", ucwords(strtolower(str_replace("-", " ", $key))));
                $out[$key] = $value;
            }
        } else {
            // otherwise we don't have apache and are just going to have to hope
            // that $_SERVER actually contains what we need
            $out = array();
            if( isset($_SERVER['CONTENT_TYPE']) )
                $out['Content-Type'] = $_SERVER['CONTENT_TYPE'];
            if( isset($_ENV['CONTENT_TYPE']) )
                $out['Content-Type'] = $_ENV['CONTENT_TYPE'];

            foreach ($_SERVER as $key => $value) {
                if (substr($key, 0, 5) == 'HTTP_') {
                    // this is chaos, basically it is just there to capitalize the first
                    // letter of every word that is not an initial HTTP and strip HTTP
                    // code from przemek
                    $key = str_replace(' ', '-', ucwords(strtolower(str_replace('_', ' ', substr($key, 5)))));
                    $out[$key] = $value;
                }
            }
        }
        return $out;
    }

Here is the caller graph for this function:

parse_parameters()

static IMSGlobal\LTI\OAuth\OAuthUtil::parse_parameters (   $input )

static

Definition at line 95 of file OAuthUtil.php.

References array.

Referenced by IMSGlobal\LTI\OAuth\OAuthRequest\__construct(), and IMSGlobal\LTI\OAuth\OAuthRequest\from_request().

                                                      {

        if (!isset($input) || !$input) return array();

        $pairs = explode('&', $input);

        $parsed_parameters = array();
        foreach ($pairs as $pair) {
            $split = explode('=', $pair, 2);
            $parameter = self::urldecode_rfc3986($split[0]);
            $value = isset($split[1]) ? self::urldecode_rfc3986($split[1]) : '';

            if (isset($parsed_parameters[$parameter])) {
                // We have already recieved parameter(s) with this name, so add to the list
                // of parameters with this name

                if (is_scalar($parsed_parameters[$parameter])) {
                    // This is the first duplicate, so transform scalar (string) into an array
                    // so we can add the duplicates
                    $parsed_parameters[$parameter] = array($parsed_parameters[$parameter]);
                }

                $parsed_parameters[$parameter][] = $value;
            } else {
                $parsed_parameters[$parameter] = $value;
            }
        }

        return $parsed_parameters;

    }

Here is the caller graph for this function:

split_header()

static IMSGlobal\LTI\OAuth\OAuthUtil::split_header (   $header,   $only_allow_oauth_parameters = true  )

static

Definition at line 37 of file OAuthUtil.php.

References $h, $header, $i, $params, array, and IMSGlobal\LTI\OAuth\OAuthUtil\urldecode_rfc3986().

Referenced by IMSGlobal\LTI\OAuth\OAuthRequest\from_request().

                                                                                      {

        $params = array();
        if (preg_match_all('/('.($only_allow_oauth_parameters ? 'oauth_' : '').'[a-z_-]*)=(:?"([^"]*)"|([^,]*))/', $header, $matches)) {
            foreach ($matches[1] as $i => $h) {
                $params[$h] = OAuthUtil::urldecode_rfc3986(empty($matches[3][$i]) ? $matches[4][$i] : $matches[3][$i]);
            }
            if (isset($params['realm'])) {
                unset($params['realm']);
            }
        }

        return $params;

    }

Here is the call graph for this function:

Here is the caller graph for this function:

urldecode_rfc3986()

static IMSGlobal\LTI\OAuth\OAuthUtil::urldecode_rfc3986 (   $string )

static

Definition at line 28 of file OAuthUtil.php.

Referenced by IMSGlobal\LTI\OAuth\OAuthUtil\split_header().

                                                      {
        return urldecode($string);
    }

Here is the caller graph for this function:

urlencode_rfc3986()

static IMSGlobal\LTI\OAuth\OAuthUtil::urlencode_rfc3986 (   $input )

static

Definition at line 14 of file OAuthUtil.php.

References array.

Referenced by IMSGlobal\LTI\OAuth\OAuthUtil\build_http_query(), IMSGlobal\LTI\OAuth\OAuthSignatureMethod_HMAC_SHA1\build_signature(), IMSGlobal\LTI\OAuth\OAuthSignatureMethod_HMAC_SHA256\build_signature(), IMSGlobal\LTI\OAuth\OAuthRequest\get_signature_base_string(), IMSGlobal\LTI\OAuth\OAuthRequest\to_header(), and IMSGlobal\LTI\OAuth\OAuthToken\to_string().

                                                     {

        if (is_array($input)) {
            return array_map(array('IMSGlobal\LTI\OAuth\OAuthUtil', 'urlencode_rfc3986'), $input);
        } else if (is_scalar($input)) {
            return str_replace('+', ' ', str_replace('%7E', '~', rawurlencode($input)));
        } else {
            return '';
        }
    }

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• libs/composer/vendor/imsglobal/lti/src/OAuth/OAuthUtil.php