ÿØÿà JFIF    ÿÛ „  ( %"1!%)+...383,7(-.+  -+++--++++---+-+-----+---------------+---+-++7-----ÿÀ  ß â" ÿÄ     ÿÄ H    !1AQaq"‘¡2B±ÁÑð#R“Ò Tbr‚²á3csƒ’ÂñDS¢³$CÿÄ   ÿÄ %  !1AQa"23‘ÿÚ   ? ôÿ ¨pŸªáÿ —åYõõ\?àÒü©ŠÄï¨pŸªáÿ —åYõõ\?àÓü©ŠÄá 0Ÿªáÿ Ÿå[úƒ ú®ði~TÁbqÐ8OÕpÿ ƒOò¤Oè`–RÂáœá™êi€ßÉ< FtŸI“öÌ8úDf´°å}“¾œ6  öFá°y¥jñÇh†ˆ¢ã/ÃÐ:ªcÈ "Y¡ðÑl>ÿ ”ÏËte:qž\oäŠe÷󲍷˜HT4&ÿ ÓÐü6ö®¿øþßèô Ÿ•7Ñi’•j|“ñì>b…þS?*Óôÿ ÓÐü*h¥£ír¶ü UãS炟[AÐaè[ûª•õ&õj?†Éö+EzP—WeÒírJFt ‘BŒ†Ï‡%#tE Øz ¥OÛ«!1›üä±Í™%ºÍãö]°î(–:@<‹ŒÊö×òÆt¦ãº+‡¦%ÌÁ²h´OƒJŒtMÜ>ÀÜÊw3Y´•牋4ǍýʏTì>œú=Íwhyë,¾Ôò×õ¿ßÊa»«þˆѪQ|%6ž™A õ%:øj<>É—ÿ Å_ˆCbõ¥š±ý¯Ýƒï…¶|RëócÍf溪“t.СøTÿ *Ä¿-{†çàczůŽ_–^XþŒ±miB[X±d 1,é”zEù»& î9gœf™9Ð'.;—™i}!ôšåîqêÛ٤ёý£½ÆA–àôe"A$˝Úsäÿ ÷Û #°xŸëí(l »ý3—¥5m! rt`†0~'j2(]S¦¦kv,ÚÇ l¦øJA£Šƒ J3E8ÙiŽ:cÉžúeZ°€¯\®kÖ(79«Ž:¯X”¾³Š&¡* ….‰Ž(ÜíŸ2¥ª‡×Hi²TF¤ò[¨íÈRëÉ䢍mgÑ.Ÿ<öäS0í„ǹÁU´f#Vß;Õ–…P@3ío<ä-±»Ž.L|kªÀê›fÂ6@»eu‚|ÓaÞÆŸ…¨ááå>åŠ?cKü6ùTÍÆ”†sĤÚ;H2RÚ†õ\Ö·Ÿn'¾ ñ#ºI¤Å´%çÁ­‚â7›‹qT3Iï¨ÖÚ5I7Ë!ÅOóŸ¶øÝñØôת¦$Tcö‘[«Ö³šÒ';Aþ ¸èíg A2Z"i¸vdÄ÷.iõ®§)¿]¤À†–‡É&ä{V¶iŽ”.Ó×Õÿ û?h¬Mt–íª[ÿ Ñÿ ÌV(í}=ibÔ¡›¥¢±b Lô¥‡piη_Z<‡z§èŒ)iÖwiÇ 2hÙ3·=’d÷8éŽ1¦¸c¤µ€7›7Ø ð\á)} ¹fËí›pAÃL%âc2 í§æQz¿;T8sæ°qø)QFMð‰XŒÂ±N¢aF¨…8¯!U  Z©RÊ ÖPVÄÀÍin™Ì-GˆªÅËŠ›•zË}º±ŽÍFò¹}Uw×#ä5B¤{î}Ð<ÙD é©¤&‡ïDbàÁôMÁ.. namespace core; use core\local\guzzle\cache_handler; use core\local\guzzle\cache_storage; use core\local\guzzle\check_request; use core\local\guzzle\redirect_middleware; use GuzzleHttp\Client; use GuzzleHttp\HandlerStack; use GuzzleHttp\RequestOptions; use Kevinrob\GuzzleCache\CacheMiddleware; use Kevinrob\GuzzleCache\Strategy\PrivateCacheStrategy; /** * Guzzle Integration for Moodle. * * @package core * @copyright 2022 Andrew Lyons * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class http_client extends Client { public function __construct(array $config = []) { $config = $this->get_options($config); parent::__construct($config); } /** * Get the custom options and handlers for guzzle integration in moodle. * * @param array $settings The settings or options from client. * @return array */ protected function get_options(array $settings): array { if (empty($settings['handler'])) { // Configure the default handlers. $settings['handler'] = $this->get_handlers($settings); } // Request debugging {@link https://docs.guzzlephp.org/en/stable/request-options.html#debug}. if (!empty($settings[RequestOptions::DEBUG])) { // Accepts either a bool, or fopen resource. if (!is_resource($settings[RequestOptions::DEBUG])) { $settings[RequestOptions::DEBUG] = !empty($settings['debug']); } } // Proxy. $proxy = $this->setup_proxy($settings); if (!empty($proxy)) { $settings[RequestOptions::PROXY] = $proxy; } // Add the default user-agent header. if (!isset($settings['headers'])) { $settings['headers'] = ['User-Agent' => \core_useragent::get_moodlebot_useragent()]; } else if (is_array($settings['headers'])) { $headers = array_keys(array_change_key_case($settings['headers'])); // Add the User-Agent header if one was not already set. if (!in_array('user-agent', $headers)) { $settings['headers']['User-Agent'] = \core_useragent::get_moodlebot_useragent(); } } return $settings; } /** * Get the handler stack according to the settings/options from client. * * @param array $settings The settings or options from client. * @return HandlerStack */ protected function get_handlers(array $settings): HandlerStack { global $CFG; // If a mock handler is set, add to stack. Mainly used for tests. if (isset($settings['mock'])) { $stack = HandlerStack::create($settings['mock']); } else { $stack = HandlerStack::create(); } // Ensure that the first piece of middleware checks the block list. $stack->unshift(check_request::setup($settings), 'moodle_check_initial_request'); // Replace the standard redirect handler with our custom Moodle one. // This handler checks the block list. // It extends the standard 'allow_redirects' handler so supports the same options. $stack->after('allow_redirects', redirect_middleware::setup($settings), 'moodle_allow_redirect'); $stack->remove('allow_redirects'); // Use cache middleware if cache is enabled. if (!empty($settings['cache'])) { $module = 'misc'; if (!empty($settings['module_cache'])) { $module = $settings['module_cache']; } // Set TTL for the cache. if ($module === 'repository') { if (empty($CFG->repositorycacheexpire)) { $CFG->repositorycacheexpire = 120; } $ttl = $CFG->repositorycacheexpire; } else { if (empty($CFG->curlcache)) { $CFG->curlcache = 120; } $ttl = $CFG->curlcache; } $stack->push(new CacheMiddleware (new PrivateCacheStrategy (new cache_storage (new cache_handler($module), $ttl))), 'cache'); } return $stack; } /** * Get the proxy configuration. * * @see {https://docs.guzzlephp.org/en/stable/request-options.html#proxy} * @param array $settings The incoming settings. * @return array The proxy settings */ protected function setup_proxy(array $settings): ?array { global $CFG; if (empty($CFG->proxyhost)) { return null; } $proxy = $this->get_proxy($settings); $noproxy = []; if (!empty($CFG->proxybypass)) { $noproxy = array_map(function(string $hostname): string { return trim($hostname); }, explode(',', $CFG->proxybypass)); } return [ 'http' => $proxy, 'https' => $proxy, 'no' => $noproxy, ]; } /** * Get the proxy server identified. * * @param array $settings The incoming settings. * @return string The URI for the Proxy Server */ protected function get_proxy(array $settings): string { global $CFG; $proxyhost = $CFG->proxyhost; if (!empty($CFG->proxyport)) { $proxyhost = "{$CFG->proxyhost}:{$CFG->proxyport}"; } $proxyauth = ""; if (!empty($CFG->proxyuser) && !empty($CFG->proxypassword)) { $proxyauth = "{$CFG->proxyuser}{$CFG->proxypassword}"; } $protocol = "http://"; if (!empty($CFG->proxytype) && $CFG->proxytype === 'SOCKS5') { $protocol = "socks5://"; } return "{$protocol}{$proxyauth}{$proxyhost}"; } }