Rss-Bridge/lib
logmanoriginal ee78e7613f [contents] Replace file_get_contents by cURL
cURL is a powerful library specifically designed to connect to many
different types of servers with different types of protocols. For
more detailed information refer to the PHP cURL manual:

- http://php.net/manual/en/book.curl.php

Due to this change some parameters for the getContents function were
necessary (also applies to getSimpleHTMLDOM and getSimpleHTMLDOMCached):

> $use_include_path removed

  This parameter has never been used and doesn't even make sense in
  this context; If set to true file_get_contents would also search
  for files in the include_path (specified in php.ini).

> $context replaced by $header and $opts

  The $context parameter allowed for customization of the request in
  order to change how file_get_contents would acquire the data (i.e.
  using POST instead of GET, sending custom header, etc...)

  cURL also provides facilities to specify custom headers and change
  how it communicates to severs. cURL, however, is much more advanced.

  - $header is an optional parameter (empty by default). It receives
    an array of strings to send in the HTTP request header.

    See 'CURLOPT_HTTPHEADER':

    "An array of HTTP header fields to set, in the format
    array('Content-type: text/plain', 'Content-length: 100')"

    - php.net/manual/en/function.curl-setopt.php

  - $opts is an optional parameter (empty by default). It receives
    an array of options, where each option is a key-value-pair of
    a cURL option (CURLOPT_*) and it's associated parameter. This
    parameter accepts any of the CURLOPT_* settings.

    Example (sending POST instead of GET):

    $opts = array(
      CURLOPT_POST => 1,
      CURLOPT_POSTFIELDS => '&action=none'
    );
    $html = getContents($url, array(), $opts);

    Refer to the cURL setopt manual for more information:
    - php.net/manual/en/function.curl-setopt.php

> $offset and $maxlen removed

  These options were supported by file_get_contents, but there doesn't
  seem to be an equivalent in cURL. Since no caller uses them they are
  safe to remove.

Compressed data / Encoding

  By using cURL instead of file_get_contents RSS-Bridge no longer has
  to handle compressed data manually.

  See 'CURLOPT_ENCODING':

  "[...] Supported encodings are "identity", "deflate", and "gzip".
  If an empty string, "", is set, a header containing all supported
  encoding types is sent."

  - http://php.net/manual/en/function.curl-setopt.php

  Notice: By default all encoding types are accepted (""). This can
  be changed by setting a custom option via $opts.

    Example:

    $opts = array(CURLOPT_ENCODING => 'gzip');
    $html = getContents($url, array(), $opts);

Proxy

The proxy implementation should still work, but there doesn't seem
to be an equivalent for 'request_fulluri = true'. To my understanding
this isn't an issue because cURL knows how to handle proxy communication.
2018-04-06 20:42:19 +02:00
..
Bridge.php [Bridge] Remove superfuous variables and statements 2017-08-06 00:04:07 +02:00
BridgeAbstract.php Implement customizable cache timeout (#641) 2018-03-14 18:06:36 +01:00
BridgeInterface.php Implement customizable cache timeout (#641) 2018-03-14 18:06:36 +01:00
Cache.php [phpcs] Add missing rules 2017-07-29 19:55:12 +02:00
CacheInterface.php [cache] Specify cache duration for 'purgeCache' 2016-10-08 16:18:10 +02:00
contents.php [contents] Replace file_get_contents by cURL 2018-04-06 20:42:19 +02:00
error.php [core] Fix typos 2016-11-09 19:10:40 +01:00
Exceptions.php Catch Errors in order to display a message in more cases. We also catch Exceptions to maintain compat with php 5. 2018-04-04 19:02:40 +01:00
FeedExpander.php [FeedExpander] Fix Serialization of 'SimpleXMLElement' is not allowed 2017-08-10 13:35:19 +02:00
Format.php [phpcs] Add missing rules 2017-07-29 19:55:12 +02:00
FormatAbstract.php [phpcs] Add missing rules 2017-07-29 19:55:12 +02:00
FormatInterface.php [FormatInterface] Add missing public functions 2016-11-09 18:41:24 +01:00
html.php Implement customizable cache timeout (#641) 2018-03-14 18:06:36 +01:00
RssBridge.php [phpcs] Add missing rules 2017-07-29 19:55:12 +02:00
validation.php [validation] Fix error on undefined optional numeric value 2017-08-17 19:02:50 +02:00