Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
<?php
> /** > declare(strict_types=1);
* SimplePie * * A PHP-Based RSS and Atom Feed Framework. * Takes the hard work out of managing a complete RSS/Atom solution. *
< * Copyright (c) 2004-2016, Ryan Parman, Geoffrey Sneddon, Ryan McCue, and contributors
> * Copyright (c) 2004-2022, Ryan Parman, Sam Sneddon, Ryan McCue, and contributors
* All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, are * permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, this list of * conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above copyright notice, this list * of conditions and the following disclaimer in the documentation and/or other materials * provided with the distribution. * * * Neither the name of the SimplePie Team nor the names of its contributors may be used * to endorse or promote products derived from this software without specific prior * written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS * AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * * @package SimplePie
< * @copyright 2004-2016 Ryan Parman, Geoffrey Sneddon, Ryan McCue
> * @copyright 2004-2016 Ryan Parman, Sam Sneddon, Ryan McCue
* @author Ryan Parman
< * @author Geoffrey Sneddon
> * @author Sam Sneddon
* @author Ryan McCue * @link http://simplepie.org/ SimplePie * @license http://www.opensource.org/licenses/bsd-license.php BSD License */
< /** < * Used for fetching remote files and reading local files < * < * Supports HTTP 1.0 via cURL or fsockopen, with spotty HTTP 1.1 support < * < * This class can be overloaded with {@see SimplePie::set_file_class()} < * < * @package SimplePie < * @subpackage HTTP < * @todo Move to properly supporting RFC2616 (HTTP/1.1) < */ < class SimplePie_File < { < var $url; < var $useragent; < var $success = true; < var $headers = array(); < var $body; < var $status_code; < var $redirects = 0; < var $error; < var $method = SIMPLEPIE_FILE_SOURCE_NONE; < var $permanent_url; < < public function __construct($url, $timeout = 10, $redirects = 5, $headers = null, $useragent = null, $force_fsockopen = false, $curl_options = array()) < { < if (class_exists('idna_convert')) < { < $idn = new idna_convert(); < $parsed = SimplePie_Misc::parse_url($url); < $url = SimplePie_Misc::compress_parse_url($parsed['scheme'], $idn->encode($parsed['authority']), $parsed['path'], $parsed['query'], NULL); < } < $this->url = $url; < $this->permanent_url = $url; < $this->useragent = $useragent; < if (preg_match('/^http(s)?:\/\//i', $url)) < { < if ($useragent === null) < { < $useragent = ini_get('user_agent'); < $this->useragent = $useragent; < } < if (!is_array($headers)) < { < $headers = array(); < } < if (!$force_fsockopen && function_exists('curl_exec')) < { < $this->method = SIMPLEPIE_FILE_SOURCE_REMOTE | SIMPLEPIE_FILE_SOURCE_CURL; < $fp = curl_init(); < $headers2 = array(); < foreach ($headers as $key => $value) < { < $headers2[] = "$key: $value"; < } < if (version_compare(SimplePie_Misc::get_curl_version(), '7.10.5', '>=')) < { < curl_setopt($fp, CURLOPT_ENCODING, ''); < } < curl_setopt($fp, CURLOPT_URL, $url); < curl_setopt($fp, CURLOPT_HEADER, 1); < curl_setopt($fp, CURLOPT_RETURNTRANSFER, 1); < curl_setopt($fp, CURLOPT_FAILONERROR, 1); < curl_setopt($fp, CURLOPT_TIMEOUT, $timeout); < curl_setopt($fp, CURLOPT_CONNECTTIMEOUT, $timeout); < curl_setopt($fp, CURLOPT_REFERER, $url); < curl_setopt($fp, CURLOPT_USERAGENT, $useragent); < curl_setopt($fp, CURLOPT_HTTPHEADER, $headers2); < if (!ini_get('open_basedir') && !ini_get('safe_mode') && version_compare(SimplePie_Misc::get_curl_version(), '7.15.2', '>=')) < { < curl_setopt($fp, CURLOPT_FOLLOWLOCATION, 1); < curl_setopt($fp, CURLOPT_MAXREDIRS, $redirects); < } < foreach ($curl_options as $curl_param => $curl_value) { < curl_setopt($fp, $curl_param, $curl_value); < } < < $this->headers = curl_exec($fp); < if (curl_errno($fp) === 23 || curl_errno($fp) === 61) < { < curl_setopt($fp, CURLOPT_ENCODING, 'none'); < $this->headers = curl_exec($fp); < } < if (curl_errno($fp)) < { < $this->error = 'cURL error ' . curl_errno($fp) . ': ' . curl_error($fp); < $this->success = false; < } < else < { < // Use the updated url provided by curl_getinfo after any redirects. < if ($info = curl_getinfo($fp)) { < $this->url = $info['url']; < } < curl_close($fp); < $this->headers = SimplePie_HTTP_Parser::prepareHeaders($this->headers, $info['redirect_count'] + 1); < $parser = new SimplePie_HTTP_Parser($this->headers); < if ($parser->parse()) < { < $this->headers = $parser->headers; < $this->body = trim($parser->body); < $this->status_code = $parser->status_code; < if ((in_array($this->status_code, array(300, 301, 302, 303, 307)) || $this->status_code > 307 && $this->status_code < 400) && isset($this->headers['location']) && $this->redirects < $redirects) < { < $this->redirects++; < $location = SimplePie_Misc::absolutize_url($this->headers['location'], $url); < $previousStatusCode = $this->status_code; < $this->__construct($location, $timeout, $redirects, $headers, $useragent, $force_fsockopen); < $this->permanent_url = ($previousStatusCode == 301) ? $location : $url; < return; < } < } < } < } < else < { < $this->method = SIMPLEPIE_FILE_SOURCE_REMOTE | SIMPLEPIE_FILE_SOURCE_FSOCKOPEN; < $url_parts = parse_url($url); < $socket_host = $url_parts['host']; < if (isset($url_parts['scheme']) && strtolower($url_parts['scheme']) === 'https') < { < $socket_host = "ssl://$url_parts[host]"; < $url_parts['port'] = 443; < } < if (!isset($url_parts['port'])) < { < $url_parts['port'] = 80; < } < $fp = @fsockopen($socket_host, $url_parts['port'], $errno, $errstr, $timeout); < if (!$fp) < { < $this->error = 'fsockopen error: ' . $errstr; < $this->success = false; < } < else < { < stream_set_timeout($fp, $timeout); < if (isset($url_parts['path'])) < { < if (isset($url_parts['query'])) < { < $get = "$url_parts[path]?$url_parts[query]"; < } < else < { < $get = $url_parts['path']; < } < } < else < { < $get = '/'; < } < $out = "GET $get HTTP/1.1\r\n"; < $out .= "Host: $url_parts[host]\r\n"; < $out .= "User-Agent: $useragent\r\n"; < if (extension_loaded('zlib')) < { < $out .= "Accept-Encoding: x-gzip,gzip,deflate\r\n"; < } < < if (isset($url_parts['user']) && isset($url_parts['pass'])) < { < $out .= "Authorization: Basic " . base64_encode("$url_parts[user]:$url_parts[pass]") . "\r\n"; < } < foreach ($headers as $key => $value) < { < $out .= "$key: $value\r\n"; < } < $out .= "Connection: Close\r\n\r\n"; < fwrite($fp, $out);
> use SimplePie\File;
< $info = stream_get_meta_data($fp);
> class_exists('SimplePie\File');
< $this->headers = ''; < while (!$info['eof'] && !$info['timed_out']) < { < $this->headers .= fread($fp, 1160); < $info = stream_get_meta_data($fp); < } < if (!$info['timed_out']) < { < $parser = new SimplePie_HTTP_Parser($this->headers); < if ($parser->parse()) < { < $this->headers = $parser->headers; < $this->body = $parser->body; < $this->status_code = $parser->status_code; < if ((in_array($this->status_code, array(300, 301, 302, 303, 307)) || $this->status_code > 307 && $this->status_code < 400) && isset($this->headers['location']) && $this->redirects < $redirects) < { < $this->redirects++; < $location = SimplePie_Misc::absolutize_url($this->headers['location'], $url); < $previousStatusCode = $this->status_code; < $this->__construct($location, $timeout, $redirects, $headers, $useragent, $force_fsockopen); < $this->permanent_url = ($previousStatusCode == 301) ? $location : $url; < return; < } < if (isset($this->headers['content-encoding'])) < { < // Hey, we act dumb elsewhere, so let's do that here too < switch (strtolower(trim($this->headers['content-encoding'], "\x09\x0A\x0D\x20"))) < { < case 'gzip': < case 'x-gzip': < $decoder = new SimplePie_gzdecode($this->body); < if (!$decoder->parse()) < { < $this->error = 'Unable to decode HTTP "gzip" stream'; < $this->success = false; < } < else < { < $this->body = trim($decoder->data); < } < break;
> // @trigger_error(sprintf('Using the "SimplePie_File" class is deprecated since SimplePie 1.7.0, use "SimplePie\File" instead.'), \E_USER_DEPRECATED);
< case 'deflate': < if (($decompressed = gzinflate($this->body)) !== false) < { < $this->body = $decompressed; < } < else if (($decompressed = gzuncompress($this->body)) !== false) < { < $this->body = $decompressed; < } < else if (function_exists('gzdecode') && ($decompressed = gzdecode($this->body)) !== false)
> if (\false) { > /** @deprecated since SimplePie 1.7.0, use "SimplePie\File" instead */ > class SimplePie_File extends File
{
< $this->body = $decompressed; < } < else < { < $this->error = 'Unable to decode HTTP "deflate" stream'; < $this->success = false; < } < break; < < default: < $this->error = 'Unknown content coding'; < $this->success = false; < } < } < } < } < else < { < $this->error = 'fsocket timed out'; < $this->success = false; < } < fclose($fp); < } < } < } < else < { < $this->method = SIMPLEPIE_FILE_SOURCE_LOCAL | SIMPLEPIE_FILE_SOURCE_FILE_GET_CONTENTS; < if (empty($url) || !($this->body = trim(file_get_contents($url)))) < { < $this->error = 'file_get_contents could not read the file'; < $this->success = false; < } < }
} }