divinity76/archivedl.php

## archivedl.php
#!/usr/bin/php
<?php
declare(strict_types = 1);
// require_once ('hhb_.inc.php');
hhb_init ();
if ($argc !== 3) {
	fprintf ( STDERR, "usage: %s timestamp url\n", $argv [0] );
	fprintf ( STDERR, "example: %s 20091012061648 http://www.p4w.se\n", $argv [0] );
	die ( 1 );
}
// var_dump($argc, $argv) & die();
$timestamp = $argv [1];
if (! preg_match ( '/^[1-9][0-9]+$/', ( string ) $timestamp )) {
	throw new \InvalidArgumentException ( 'invalid timestamp! (failed regex validation /^[1-9][0-9]+$/ )' );
}
$timestamp = ( int ) $timestamp;
if (! filter_var ( $argv [2], FILTER_VALIDATE_URL )) {
	throw new \InvalidArgumentException ( 'invalid url! (failed FILTER_VALIDATE_URL ) ' );
}
$archive_url = 'https://web.archive.org/web/' . $timestamp . 'id_/';
define ( "ARCHIVE_URL", $archive_url );
$url = $argv [2]; // https://web.archive.org/web/20091012061648id_/http://www.p4w.se
$master_dir = parse_url ( $url ) ['host'];
define ( "MASTER_DIR", $master_dir );
system ( "rm -rfv " . escapeshellarg ( $master_dir ) );
mkdir ( $master_dir );
chdir ( $master_dir );
makeShittyMasterRedirect ();
$downloaded = array ();
$to_download = array (
		$url
);
$total = 1;
$thus_far = 0;

$hc = new hhb_curl ( '', true );
$hc->setopt_array ( array (
		CURLOPT_TIMEOUT => 20,
		CURLOPT_CONNECTTIMEOUT => 10
) ); // sometimes archive.org lags for quite a bit, so account for that.
hhb_init ();
while ( ! empty ( $to_download ) ) {
	reset ( $to_download );
	$key = key ( $to_download );
	$url = $raw_url = $to_download [$key];
	unset ( $to_download [$key] );
	++ $thus_far;
	$file = absolute_url_to_filepath ( $raw_url );
	$url = geturl ( $url );
	$downloaded [] = $raw_url;
	echo 'file: ' . $file . ' url: ' . $raw_url . '..' . PHP_EOL;
	try {
		$headers = implode ( " ", $hc->exec ( $url )->getResponseHeaders () );
	} catch ( Exception $ex ) {
		try {
			$headers = implode ( " ", $hc->exec ( $url )->getResponseHeaders () );
		} catch ( Exception $ex ) {
			// sometimes connection fails for no good reason, and a retry (or 2) fixes it...
			// here we give up and deliberately not catch the 3rd exception (if any)
			$headers = implode ( " ", $hc->exec ( $url )->getResponseHeaders () );
		}
	}

	// var_dump($headers) & die();
	$response = $hc->getinfo ( CURLINFO_RESPONSE_CODE );
	if ($response !== 200) {
		// ...
		fprintf ( STDERR, "warning: because http response code %d, ignoring url %s\n", $response, $url );
		continue;
	}
	$html = $hc->getResponseBody ();
	if (false !== stripos ( $headers, 'Content-Type: text/html' )) {
		$domd = @DOMDocument::loadHTML ( $html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD );
		if (! $domd) {
			// seriously malformed HTML, or not actually a HTML at all (like ico served with text/html content header... yes, that actually happened on http://www.gravatar.com/blavatar/2e776b945e937c41193b102c956044c8s=16&d=http:/s.wordpress.com/favicon.ico )
		} else {
			foreach ( $domd->getElementsByTagName ( "*" ) as $ele ) {
				if (! $ele->hasAttributes ()) {
					continue;
				}
				$tmpname = "src";
				$tmp = $ele->getAttribute ( $tmpname );
				if (empty ( $tmp )) {
					$tmpname = "href";
					$tmp = $ele->getAttribute ( $tmpname );
					if (empty ( $tmp )) {
						continue;
					}
				}
				$tmp = relative_to_absolute ( $tmp, $raw_url );
				if (empty ( $tmp )) {
					// unsupported url (like mailto: or javascript )
					continue;
				}
				$ele->setAttribute ( $tmpname, absolute_to_relaitve ( $tmp, $raw_url ) );
				if (in_array ( $tmp, $to_download, true )) {
					// already queued to download
					continue;
				}
				if (in_array ( $tmp, $downloaded, true )) {
					// already downloaded.
					continue;
				}
				echo 'adding ' . $tmp, PHP_EOL;
				++ $total;
				$to_download [] = $tmp;
				continue;
			}
			$html = $domd->saveHTML ();
		}
	}
	file_force_contents ( $file, $html );
	echo ' done. (' . $thus_far . '/' . $total . ')', PHP_EOL;
}
function absolute_url_to_filepath(string $url): string {
	$info = parse_url ( $url );
	$uri = preg_replace ( '/[\\\\\\/]+/u', DIRECTORY_SEPARATOR, '/' . $info ['host'] . '/' . ($info ['path'] ?? '') );
	// hhb_var_dump($uri, basename($uri));
	if (DIRECTORY_SEPARATOR === substr ( $uri, - 1 ) || empty ( basename ( $uri ) )) {
		if (DIRECTORY_SEPARATOR !== substr ( $uri, - 1 )) {
			$uri .= DIRECTORY_SEPARATOR;
		}
		$uri .= 'index.html';
	}
	// hhb_var_dump($uri);
	return /* getcwd() . */
substr ( $uri, 1 );
}
function absolute_to_relaitve(string $absolute, string $source): string {
	$absolute_ = $absolute;
	$source_ = $source;
	//
	$source = parse_url ( $source );
	$source = $source ['host'] . ((isset ( $source ['port'] )) ? (':' . $source ['port']) : '') . '/' . ($source ['path'] ?? ''); // . ($source['query'] ?? '');
	$source = preg_replace ( '/[\\/]+/', '/', $source );
	// hhb_var_dump($absolute, $source) & die();
	$absolute = parse_url ( $absolute );
	// hhb_var_dump($absolute, $source) & die();
	$absolute = $absolute ['host'] . ((isset ( $absolute ['port'] )) ? (':' . $absolute ['port']) : '') . '/' . ($absolute ['path'] ?? '') . ($absolute ['query'] ?? '');
	$absolute = preg_replace ( '/[\\/]+/', '/', $absolute );
	// hhb_var_dump($absolute, $source) & die();
	if (0 === strpos ( $absolute, $source )) {
		$absolute = substr ( $absolute, strlen ( $source ) );
		if (substr ( $absolute, - 1 ) === '/') {
			// .........$absolute = substr ( $absolute, 0, - 1 );
		} elseif (false === strpos ( $absolute, '.' ) || (false !== strpos ( $absolute, '/' ) && substr ( $absolute, - 1 ) !== '/' && false === strpos ( basename ( $absolute ), '.' ))) {
			// for foo containing .. vs foo/ containing .. , makes a subtle but page-breaking difference
			$absolute .= '/';
		}
	} else {
		if (0 === stripos ( $absolute, MASTER_DIR . '/' )) {
			// EWIQJWQI
			// $absolute = substr ( $absolute, strlen ( MASTER_DIR ) + 1 );
		}
		$amt = substr_count ( $source, '/' );
		$str = '';
		// EWIQJWQI
		for($i = 0; $i < $amt; ++ $i) {
			$str .= '../';
		}
		if (false === strpos ( $absolute, '.' ) || (false !== strpos ( $absolute, '/' ) && substr ( $absolute, - 1 ) !== '/' && false === strpos ( basename ( $absolute ), '.' ))) {
			// for foo containing .. vs foo/ containing .. , makes a subtle but page-breaking difference
			if (substr ( $absolute, - 1 ) !== '/') {
				$absolute .= '/';
			}
		}
		$absolute = $str . $absolute;
	}
	// hhb_var_dump($absolute_, $absolute, $source, $source_) & (rand(2, 30) === 1 ? die() : 1);
	return $absolute;
}
function relative_to_absolute(string $relative, string $source): string {
	if (empty ( $relative )) {
		return "";
	}
	$info = parse_url ( $relative );
	$whitelist = array (
			'http',
			'https',
			'ftp'
	);
	if (! empty ( $info ['scheme'] ) && ! in_array ( strtolower ( $info ['scheme'] ), $whitelist, true )) {
		// like mailto: or tlf: or whatever, unsupported
		return "";
	}
	if ($relative [0] === '#') {
		return "";
	}
	if (false !== strpos ( $relative, '(' ) && false !== strpos ( $relative, ')' )) {
		// PROBABLY javascript (otherwise these characters would be urlencoded to %whatever)
		return "";
	}
	$sourceinfo = parse_url ( $source );
	$relainfo = parse_url ( $relative );
	$ret = '';
	if (empty ( $relainfo ['host'] )) {
		$ret = $sourceinfo ['host'] . dirname ( $sourceinfo ['path'] ?? '') . '/' . $relainfo ['path'];
		again:
		$ret = explode ( "/", $ret );
		for($i = 0, $count = count ( $ret ); $i < $count; ++ $i) {
			if ($ret [$i] === '.') {
				unset ( $ret [$i] );
				$ret = implode ( '/', $ret );
				goto again;
			}
			if ($ret [$i] === '..') {
				unset ( $ret [$i] );
				unset ( $ret [$i - 1] );
				$ret = implode ( '/', $ret );
				goto again;
			}
			continue;
		}
		$ret = implode ( '/', $ret );
		$ret = preg_replace ( '/[\\/]+/', '/', $ret );
		$ret = $sourceinfo ['scheme'] . '://' . $ret;
		unset ( $i, $count );
	} else {
		$ret = ($relainfo ['host'] ?? $sourceinfo ['host']) . ((isset ( $relainfo ['port'] ) || isset ( $sourceinfo ['port'] )) ? (':' . ($relainfo ['port'] ?? $sourceinfo ['port'])) : '') . '/' . ($relainfo ['path'] ?? $sourceinfo ['path'] ?? '') . ($relainfo ['query'] ?? '');
		$ret = preg_replace ( '/[\\/]+/', '/', $ret );

		$ret = ($relainfo ['scheme'] ?? $sourceinfo ['scheme']) . '://' . $ret;
	}
	// hhb_var_dump($sourceinfo, $relainfo, $ret) & die(); //

	return $ret;
}
function geturl(string $url): string {
	return ARCHIVE_URL . $url;
}
function makeShittyMasterRedirect() {
	$foo = MASTER_DIR . '/index.html';
	$html = <<<HTML
<!DOCTYPE HTML>
<html lang="en-US">
<head>
<meta charset="UTF-8">
<meta http-equiv="refresh" content="1; url=$foo">
<script type="text/javascript">
	window.location.href = "$foo";
			</script>
			<title>Page Redirection</title>
			</head>
			<body>
			<a href='$foo'>uhh, due to a bug, click here. this is a demo, ofc there is some bugs.</a>
        </body>
        </html>
HTML;
	file_put_contents ( 'index.html', $html );
}
function file_force_contents(string $filename, string $data, int $flags = 0) {
	if (0 === strpos ( $filename, MASTER_DIR . DIRECTORY_SEPARATOR )) {
		// EWIQJWQI
		// $filename = substr ( $filename, strlen ( MASTER_DIR ) + 1 );
	}
	$tmp = dirname ( $filename );
	if (! is_dir ( $tmp )) {
		if (file_exists ( $tmp )) {
			$tmpf = file_get_contents ( $tmp );
			unlink ( $tmp );
			mkdir ( $tmp . DIRECTORY_SEPARATOR, 0777, TRUE );
			file_put_contents ( $tmp . DIRECTORY_SEPARATOR . 'index.html', $tmpf );
		} else {
			mkdir ( $tmp . DIRECTORY_SEPARATOR, 0777, TRUE );
		}
	}
	return file_put_contents ( $filename, $data, $flags );
}

// ///////////////////////////////////// - below here is stuff from hhb_.inc.php
// ///////////////////////////////////// - below here is stuff from hhb_.inc.php
// ///////////////////////////////////// - below here is stuff from hhb_.inc.php
// ///////////////////////////////////// - below here is stuff from hhb_.inc.php
// ///////////////////////////////////// - below here is stuff from hhb_.inc.php
// ///////////////////////////////////// - below here is stuff from hhb_.inc.php
// ///////////////////////////////////// - below here is stuff from hhb_.inc.php
// ///////////////////////////////////// - below here is stuff from hhb_.inc.php

/**
 * enhanced var_dump
 *
 * @param mixed $mixed...
 * @return void
 */
function hhb_var_dump() {
	// informative wrapper for var_dump
	// <changelog>
	// version 5 ( 1372510379573 )
	// v5, fixed warnings on PHP < 5.0.2 (PHP_EOL not defined),
	// also we can use xdebug_var_dump when available now. tested working with 5.0.0 to 5.5.0beta2 (thanks to http://viper-7.com and http://3v4l.org )
	// and fixed a (corner-case) bug with "0" (empty() considders string("0") to be empty, this caused a bug in sourcecode analyze)
	// v4, now (tries to) tell you the source code that lead to the variables
	// v3, HHB_VAR_DUMP_START and HHB_VAR_DUMP_END .
	// v2, now compat with.. PHP5.0 + i think? tested down to 5.2.17 (previously only 5.4.0+ worked)
	// </changelog>
	// <settings>
	$settings = array ();
	$PHP_EOL = "\n";
	if (defined ( 'PHP_EOL' )) { // for PHP >=5.0.2 ...
		$PHP_EOL = PHP_EOL;
	}

	$settings ['debug_hhb_var_dump'] = false; // if true, may throw exceptions on errors..
	$settings ['use_xdebug_var_dump'] = true; // try to use xdebug_var_dump (instead of var_dump) if available?
	$settings ['analyze_sourcecode'] = true; // false to disable the source code analyze stuff.
	                                         // (it will fallback to making $settings['analyze_sourcecode']=false, if it fail to analyze the code, anyway..)
	$settings ['hhb_var_dump_prepend'] = 'HHB_VAR_DUMP_START' . $PHP_EOL;
	$settings ['hhb_var_dump_append'] = 'HHB_VAR_DUMP_END' . $PHP_EOL;
	// </settings>

	$settings ['use_xdebug_var_dump'] = ($settings ['use_xdebug_var_dump'] && is_callable ( "xdebug_var_dump" ));
	$argv = func_get_args ();
	$argc = count ( $argv, COUNT_NORMAL );
	if (version_compare ( PHP_VERSION, '5.4.0', '>=' )) {
		$bt = debug_backtrace ( DEBUG_BACKTRACE_IGNORE_ARGS, 1 );
	} else if (version_compare ( PHP_VERSION, '5.3.6', '>=' )) {
		$bt = debug_backtrace ( DEBUG_BACKTRACE_IGNORE_ARGS );
	} else if (version_compare ( PHP_VERSION, '5.2.5', '>=' )) {
		$bt = debug_backtrace ( false );
	} else {
		$bt = debug_backtrace ();
	}
	;
	$analyze_sourcecode = $settings ['analyze_sourcecode'];
	// later, $analyze_sourcecode will be compared with $config['analyze_sourcecode']
	// to determine if the reason was an error analyzing, or if it was disabled..
	$bt = $bt [0];
	// <analyzeSourceCode>
	if ($analyze_sourcecode) {
		$argvSourceCode = array (
				0 => 'ignore [0]...'
		);
		try {
			if (version_compare ( PHP_VERSION, '5.2.2', '<' )) {
				throw new Exception ( "PHP version is <5.2.2 .. see token_get_all changelog.." );
			}
			;
			$xsource = file_get_contents ( $bt ['file'] );
			if (empty ( $xsource )) {
				throw new Exception ( 'cant get the source of ' . $bt ['file'] );
			}
			;
			$xsource .= "\n<" . '?' . 'php ignore_this_hhb_var_dump_workaround();'; // workaround, making sure that at least 1 token is an array, and has the $tok[2] >= line of hhb_var_dump
			$xTokenArray = token_get_all ( $xsource );
			// <trim$xTokenArray>
			$tmpstr = '';
			$tmpUnsetKeyArray = array ();
			ForEach ( $xTokenArray as $xKey => $xToken ) {
				if (is_array ( $xToken )) {
					if (! array_key_exists ( 1, $xToken )) {
						throw new LogicException ( 'Impossible situation? $xToken is_array, but does not have $xToken[1] ...' );
					}
					$tmpstr = trim ( $xToken [1] );
					if (empty ( $tmpstr ) && $tmpstr !== '0' /*string("0") is considered "empty" -.-*/ ) {
						$tmpUnsetKeyArray [] = $xKey;
						continue;
					}
					;
					switch ($xToken [0]) {
						case T_COMMENT :
						case T_DOC_COMMENT : // T_ML_COMMENT in PHP4 -.-
						case T_INLINE_HTML :
							{
								$tmpUnsetKeyArray [] = $xKey;
								continue;
							}
							;
						default :
							{
								continue;
							}
					}
				} else if (is_string ( $xToken )) {
					$tmpstr = trim ( $xToken );
					if (empty ( $tmpstr ) && $tmpstr !== '0' /*string("0") is considered "empty" -.-*/ ) {
						$tmpUnsetKeyArray [] = $xKey;
					}
					;
					continue;
				} else {
					// should be unreachable..
					// failed both is_array() and is_string() ???
					throw new LogicException ( 'Impossible! $xToken fails both is_array() and is_string() !! .. ' );
				}
				;
			}
			;
			ForEach ( $tmpUnsetKeyArray as $toUnset ) {
				unset ( $xTokenArray [$toUnset] );
			}
			;
			$xTokenArray = array_values ( $xTokenArray ); // fixing the keys..
			                                              // die(var_dump('die(var_dump(...)) in '.__FILE__.':'.__LINE__,'before:',count(token_get_all($xsource),COUNT_NORMAL),'after',count($xTokenArray,COUNT_NORMAL)));
			unset ( $tmpstr, $xKey, $xToken, $toUnset, $tmpUnsetKeyArray );
			// </trim$xTokenArray>
			$firstInterestingLineTokenKey = - 1;
			$lastInterestingLineTokenKey = - 1;
			// <find$lastInterestingLineTokenKey>
			ForEach ( $xTokenArray as $xKey => $xToken ) {
				if (! is_array ( $xToken ) || ! array_key_exists ( 2, $xToken ) || ! is_integer ( $xToken [2] ) || $xToken [2] < $bt ['line'])
					continue;
				$tmpkey = $xKey; // we don't got what we want yet..
				while ( true ) {
					if (! array_key_exists ( $tmpkey, $xTokenArray )) {
						throw new Exception ( '1unable to find $lastInterestingLineTokenKey !' );
					}
					;
					if ($xTokenArray [$tmpkey] === ';') {
						// var_dump(__LINE__.":SUCCESS WITH",$tmpkey,$xTokenArray[$tmpkey]);
						$lastInterestingLineTokenKey = $tmpkey;
						break;
					}
					// var_dump(__LINE__.":FAIL WITH ",$tmpkey,$xTokenArray[$tmpkey]);

					// if $xTokenArray has >=PHP_INT_MAX keys, we don't want an infinite loop, do we? ;p
					// i wonder how much memory that would require though.. over-engineering, err, time-wasting, ftw?
					if ($tmpkey >= PHP_INT_MAX) {
						throw new Exception ( '2unable to find $lastIntperestingLineTokenKey ! (PHP_INT_MAX reached without finding ";"...)' );
					}
					;
					++ $tmpkey;
				}
				break;
			}
			;
			if ($lastInterestingLineTokenKey <= - 1) {
				throw new Exception ( '3unable to find $lastInterestingLineTokenKey !' );
			}
			;
			unset ( $xKey, $xToken, $tmpkey );
			// </find$lastInterestingLineTokenKey>
			// <find$firstInterestingLineTokenKey>
			// now work ourselves backwards from $lastInterestingLineTokenKey to the first token where $xTokenArray[$tmpi][1] == "hhb_var_dump"
			// i doubt this is fool-proof but.. cant think of a better way (in userland, anyway) atm..
			$tmpi = $lastInterestingLineTokenKey;
			do {
				if (array_key_exists ( $tmpi, $xTokenArray ) && is_array ( $xTokenArray [$tmpi] ) && array_key_exists ( 1, $xTokenArray [$tmpi] ) && is_string ( $xTokenArray [$tmpi] [1] ) && strcasecmp ( $xTokenArray [$tmpi] [1], $bt ['function'] ) === 0) {
					// var_dump(__LINE__."SUCCESS WITH",$tmpi,$xTokenArray[$tmpi]);
					if (! array_key_exists ( $tmpi + 2, $xTokenArray )) { // +2 because [0] is (or should be) "hhb_var_dump" and [1] is (or should be) "("
						throw new Exception ( '1unable to find the $firstInterestingLineTokenKey...' );
					}
					;
					$firstInterestingLineTokenKey = $tmpi + 2;
					break;
					/* */
				}
				;
				// var_dump(__LINE__."FAIL WITH ",$tmpi,$xTokenArray[$tmpi]);
				-- $tmpi;
			} while ( - 1 < $tmpi );
			// die(var_dump('die(var_dump(...)) in '.__FILE__.':'.__LINE__,$tmpi));
			if ($firstInterestingLineTokenKey <= - 1) {
				throw new Exception ( '2unable to find the $firstInterestingLineTokenKey...' );
			}
			;
			unset ( $tmpi );
			// Note: $lastInterestingLineTokeyKey is likely to contain more stuff than only the stuff we want..
			// </find$firstInterestingLineTokenKey>
			// <rebuildInterestingSourceCode>
			// ok, now we have $firstInterestingLineTokenKey and $lastInterestingLineTokenKey....
			$interestingTokensArray = array_slice ( $xTokenArray, $firstInterestingLineTokenKey, (($lastInterestingLineTokenKey - $firstInterestingLineTokenKey) + 1) );
			unset ( $addUntil, $tmpi, $tmpstr, $tmpi, $argvsourcestr, $tmpkey, $xTokenKey, $xToken );
			$addUntil = array ();
			$tmpi = 0;
			$tmpstr = "";
			$tmpkey = "";
			$argvsourcestr = "";
			// $argvSourceCode[X]='source code..';
			ForEach ( $interestingTokensArray as $xTokenKey => $xToken ) {
				if (is_array ( $xToken )) {
					$tmpstr = $xToken [1];
					// var_dump($xToken[1]);
				} else if (is_string ( $xToken )) {
					$tmpstr = $xToken;
					// var_dump($xToken);
				} else {
					/* should never reach this */
					throw new LogicException ( 'Impossible situation? $xToken fails is_array() and fails is_string() ...' );
				}
				;
				$argvsourcestr .= $tmpstr;

				if ($xToken === '(') {
					$addUntil [] = ')';
					continue;
				} else if ($xToken === '[') {
					$addUntil [] = ']';
					continue;
				}
				;

				if ($xToken === ')' || $xToken === ']') {
					if (false === ($tmpkey = array_search ( $xToken, $addUntil, false ))) {
						$argvSourceCode [] = substr ( $argvsourcestr, 0, - 1 ); // -1 is to strip the ")"
						if (count ( $argvSourceCode, COUNT_NORMAL ) - 1 === $argc) /*-1 because $argvSourceCode[0] is bullshit*/ {
							break;
							/* We read em all! :D (.. i hope) */
						}
						;
						/* else... oh crap */
						throw new Exception ( 'failed to read source code of (what i think is) argv[' . count ( $argvSourceCode, COUNT_NORMAL ) . '] ! sorry..' );
					}
					unset ( $addUntil [$tmpkey] );
					continue;
				}

				if (empty ( $addUntil ) && $xToken === ',') {
					$argvSourceCode [] = substr ( $argvsourcestr, 0, - 1 ); // -1 is to strip the comma
					$argvsourcestr = "";
				}
				;
			}
			;
			// die(var_dump('die(var_dump(...)) in '.__FILE__.':'.__LINE__,
			// $firstInterestingLineTokenKey,$lastInterestingLineTokenKey,$interestingTokensArray,$tmpstr
			// $argvSourceCode));
			if (count ( $argvSourceCode, COUNT_NORMAL ) - 1 != $argc) /*-1 because $argvSourceCode[0] is bullshit*/ {
				throw new Exception ( 'failed to read source code of all the arguments! (and idk which ones i missed)! sorry..' );
			}
			;
			// </rebuildInterestingSourceCode>
		} catch ( Exception $ex ) {
			$argvSourceCode = array (); // clear it
			                            // TODO: failed to read source code
			                            // die("TODO N STUFF..".__FILE__.__LINE__);
			$analyze_sourcecode = false; // ERROR..
			if ($settings ['debug_hhb_var_dump']) {
				throw $ex;
			} else {
				/* exception ignored, continue as normal without $analyze_sourcecode */
			}
			;
		}
		unset ( $xsource, $xToken, $xTokenArray, $firstInterestingLineTokenKey, $lastInterestingLineTokenKey, $xTokenKey, $tmpi, $tmpkey, $argvsourcestr );
	}
	;
	// </analyzeSourceCode>
	$msg = $settings ['hhb_var_dump_prepend'];
	if ($analyze_sourcecode != $settings ['analyze_sourcecode']) {
		$msg .= ' (PS: some error analyzing source code)' . $PHP_EOL;
	}
	;
	$msg .= 'in "' . $bt ['file'] . '": on line "' . $bt ['line'] . '": ' . $argc . ' variable' . ($argc === 1 ? '' : 's') . $PHP_EOL; // because over-engineering ftw?
	if ($analyze_sourcecode) {
		$msg .= ' hhb_var_dump(';
		$msg .= implode ( ",", array_slice ( $argvSourceCode, 1 ) ); // $argvSourceCode[0] is bullshit.
		$msg .= ')' . $PHP_EOL;
	}
	// array_unshift($bt,$msg);
	echo $msg;
	$i = 0;
	foreach ( $argv as &$val ) {
		echo 'argv[' . ++ $i . ']';
		if ($analyze_sourcecode) {
			echo ' >>>' . $argvSourceCode [$i] . '<<<';
		}
		echo ':';
		if ($settings ['use_xdebug_var_dump']) {
			xdebug_var_dump ( $val );
		} else {
			var_dump ( $val );
		}
		;
	}

	echo $settings ['hhb_var_dump_append'];
	// call_user_func_array("var_dump",$args);
}

/**
 * works like var_dump, but returns a string instead of priting it (ob_ based)
 *
 * @param mixed $args...
 * @return string
 */
function hhb_return_var_dump(): string // works like var_dump, but returns a string instead of printing it.
{
	$args = func_get_args (); // for <5.3.0 support ...
	ob_start ();
	call_user_func_array ( 'var_dump', $args );
	return ob_get_clean ();
}

/**
 * enables hhb_exception_handler and hhb_assert_handler and sets error_reporting to max
 */
function hhb_init() {
	static $firstrun = true;
	if ($firstrun !== true) {
		return;
	}
	$firstrun = false;
	error_reporting ( E_ALL );
	set_error_handler ( "hhb_exception_error_handler" );
	// ini_set("log_errors",'On');
	// ini_set("display_errors",'On');
	// ini_set("log_errors_max_len",'0');
	// ini_set("error_prepend_string",'<error>');
	// ini_set("error_append_string",'</error>'.PHP_EOL);
	// ini_set("error_log",__DIR__.DIRECTORY_SEPARATOR.'error_log.php.txt');
	assert_options ( ASSERT_ACTIVE, 1 );
	assert_options ( ASSERT_WARNING, 0 );
	assert_options ( ASSERT_QUIET_EVAL, 1 );
	assert_options ( ASSERT_CALLBACK, 'hhb_assert_handler' );
}
function hhb_exception_error_handler($errno, $errstr, $errfile, $errline) {
	if (! (error_reporting () & $errno)) {
		// This error code is not included in error_reporting
		return;
	}
	throw new ErrorException ( $errstr, 0, $errno, $errfile, $errline );
}
function hhb_assert_handler($file, $line, $code, $desc = null) {
	$errstr = 'Assertion failed at ' . $file . ':' . $line . ' ' . $desc . ' code: ' . $code;
	throw new ErrorException ( $errstr, 0, 1, $file, $line );
}
class hhb_curl {
	protected $curlh;
	protected $curloptions = [ ];
	protected $response_body_file_handle;

	// CURLOPT_FILE
	protected $response_headers_file_handle;

	// CURLOPT_WRITEHEADER
	protected $request_body_file_handle;

	// CURLOPT_INFILE
	protected $stderr_file_handle;

	// CURLOPT_STDERR
	protected function truncateFileHandles() {
		$trun = ftruncate ( $this->response_body_file_handle, 0 );
		assert ( true === $trun );
		$trun = ftruncate ( $this->response_headers_file_handle, 0 );
		assert ( true === $trun );
		// $trun = ftruncate ( $this->request_body_file_handle, 0 );
		// assert ( true === $trun );
		$trun = ftruncate ( $this->stderr_file_handle, 0 );
		assert ( true === $trun );
		return /*true*/;
	}

	/**
	 * returns the internal curl handle
	 *
	 * its probably a bad idea to mess with it, you'll probably never want to use this function.
	 *
	 * @return resource_curl
	 */
	public function _getCurlHandle()/*: curlresource*/ {
		return $this->curlh;
	}

	/**
	 * replace the internal curl handle with another one...
	 *
	 * its probably a bad idea. you'll probably never want to use this function.
	 *
	 * @param resource_curl $newcurl
	 * @param bool $closeold
	 * @throws InvalidArgumentsException
	 *
	 * @return void
	 */
	public function _replaceCurl($newcurl, bool $closeold = true) {
		if (! is_resource ( $newcurl )) {
			throw new InvalidArgumentsException ( 'parameter 1 must be a curl resource!' );
		}
		if (get_resource_type ( $newcurl ) !== 'curl') {
			throw new InvalidArgumentsException ( 'parameter 1 must be a curl resource!' );
		}
		if ($closeold) {
			curl_close ( $this->curlh );
		}
		$this->curlh = $newcurl;
		$this->_prepare_curl ();
	}

	/**
	 * mimics curl_init, using hhb_curl::__construct
	 *
	 * @param string $url
	 * @param bool $insecureAndComfortableByDefault
	 * @return hhb_curl
	 */
	public static function init(string $url = null, bool $insecureAndComfortableByDefault = false): hhb_curl {
		return new hhb_curl ( $url, $insecureAndComfortableByDefault );
	}

	/**
	 *
	 * @param string $url
	 * @param bool $insecureAndComfortableByDefault
	 * @throws RuntimeException
	 */
	function __construct(string $url = null, bool $insecureAndComfortableByDefault = false) {
		$this->curlh = curl_init ( '' ); // why empty string? PHP Fatal error: Uncaught TypeError: curl_init() expects parameter 1 to be string, null given
		if (! $this->curlh) {
			throw new RuntimeException ( 'curl_init failed!' );
		}
		if ($url !== null) {
			$this->_setopt ( CURLOPT_URL, $url );
		}
		$fhandles = [ ];
		$tmph = NULL;
		for($i = 0; $i < 4; ++ $i) {
			$tmph = tmpfile ();
			if ($tmph === false) {
				// for($ii = 0; $ii < $i; ++ $ii) {
				// // @fclose($fhandles[$ii]);//yay, potentially overwriting last error to fuck your debugging efforts!
				// }
				throw new RuntimeException ( 'tmpfile() failed to create 4 file handles!' );
			}
			$fhandles [] = $tmph;
		}
		unset ( $tmph );
		$this->response_body_file_handle = $fhandles [0]; // CURLOPT_FILE
		$this->response_headers_file_handle = $fhandles [1]; // CURLOPT_WRITEHEADER
		$this->request_body_file_handle = $fhandles [2]; // CURLOPT_INFILE
		$this->stderr_file_handle = $fhandles [3]; // CURLOPT_STDERR
		unset ( $fhandles );
		$this->_prepare_curl ();
		if ($insecureAndComfortableByDefault) {
			$this->_setComfortableOptions ();
		}
	}
	function __destruct() {
		curl_close ( $this->curlh );
		fclose ( $this->response_body_file_handle ); // CURLOPT_FILE
		fclose ( $this->response_headers_file_handle ); // CURLOPT_WRITEHEADER
		fclose ( $this->request_body_file_handle ); // CURLOPT_INFILE
		fclose ( $this->stderr_file_handle ); // CURLOPT_STDERR
	}

	/**
	 * sets some insecure, but comfortable settings..
	 *
	 * @return self
	 */
	public function _setComfortableOptions(): self {
		$this->setopt_array ( array (
				CURLOPT_AUTOREFERER => true,
				CURLOPT_BINARYTRANSFER => true,
				CURLOPT_FOLLOWLOCATION => true,
				CURLOPT_HTTPGET => true,
				CURLOPT_SSL_VERIFYPEER => false,
				CURLOPT_CONNECTTIMEOUT => 4,
				CURLOPT_TIMEOUT => 8,
				CURLOPT_COOKIEFILE => "", // <<makes curl save/load cookies across requests..
				CURLOPT_ENCODING => "", // << makes curl post all supported encodings, gzip/deflate/etc, makes transfers faster
				CURLOPT_USERAGENT => 'hhb_curl_php; curl/' . $this->version () ['version'] . ' (' . $this->version () ['host'] . '); php/' . PHP_VERSION
		) ); //
		return $this;
	}

	/**
	 * curl_errno — Return the last error number
	 *
	 * @return int
	 */
	public function errno(): int {
		return curl_errno ( $this->curlh );
	}

	/**
	 * curl_error — Return a string containing the last error
	 *
	 * @return string
	 */
	public function error(): string {
		return curl_error ( $this->curlh );
	}

	/**
	 * curl_escape — URL encodes the given string
	 *
	 * @param string $str
	 * @return string
	 */
	public function escape(string $str): string {
		return curl_escape ( $this->curlh, $str );
	}

	/**
	 * curl_unescape — Decodes the given URL encoded string
	 *
	 * @param string $str
	 * @return string
	 */
	public function unescape(string $str): string {
		return curl_unescape ( $this->curlh, $str );
	}

	/**
	 * executes the curl request (curl_exec)
	 *
	 * @param string $url
	 * @throws RuntimeException
	 * @return self
	 */
	public function exec(string $url = null): self {
		$this->truncateFileHandles ();
		// WARNING: some weird error where curl will fill up the file again with 00's when the file has been truncated
		// until it is the same size as it was before truncating, then keep appending...
		// hopefully this _prepare_curl() call will fix that.. (seen on debian 8 on btrfs with curl/7.38.0)
		$this->_prepare_curl ();
		if (is_string ( $url ) && strlen ( $url ) > 0) {
			$this->setopt ( CURLOPT_URL, $url );
		}
		$ret = curl_exec ( $this->curlh );
		if ($this->errno ()) {
			throw new RuntimeException ( 'curl_exec failed. errno: ' . var_export ( $this->errno (), true ) . ' error: ' . var_export ( $this->error (), true ) );
		}
		return $this;
	}

	/**
	 * Create a CURLFile object for use with CURLOPT_POSTFIELDS
	 *
	 * @param string $filename
	 * @param string $mimetype
	 * @param string $postname
	 * @return CURLFile
	 */
	public function file_create(string $filename, string $mimetype = null, string $postname = null): CURLFile {
		return curl_file_create ( $filename, $mimetype, $postname );
	}

	/**
	 * Get information regarding the last transfer
	 *
	 * @param int $opt
	 * @return mixed
	 */
	public function getinfo(int $opt) {
		return curl_getinfo ( $this->curlh, $opt );
	}

	// pause is explicitly undocumented for now, but it pauses a running transfer
	public function pause(int $bitmask): int {
		return curl_pause ( $this->curlh, $bitmask );
	}

	/**
	 * Reset all options
	 */
	public function reset(): self {
		curl_reset ( $this->curlh );
		$this->curloptions = [ ];
		$this->_prepare_curl ();
		return $this;
	}

	/**
	 * curl_setopt_array — Set multiple options for a cURL transfer
	 *
	 * @param array $options
	 * @throws InvalidArgumentException
	 * @return self
	 */
	public function setopt_array(array $options): self {
		foreach ( $options as $option => $value ) {
			$this->setopt ( $option, $value );
		}
		return $this;
	}

	/**
	 * gets the last response body
	 *
	 * @return string
	 */
	public function getResponseBody(): string {
		return file_get_contents ( stream_get_meta_data ( $this->response_body_file_handle ) ['uri'] );
	}

	/**
	 * returns the response headers of the last request (when auto-following Location-redirect, only the last headers are returned)
	 *
	 * @return string[]
	 */
	public function getResponseHeaders(): array {
		$text = file_get_contents ( stream_get_meta_data ( $this->response_headers_file_handle ) ['uri'] );
		// ...
		return $this->splitHeaders ( $text );
	}

	/**
	 * gets the response headers of all the requets for the last execution (including any Location-redirect autofollow headers)
	 *
	 * @return string[][]
	 */
	public function getResponsesHeaders(): array {
		// var_dump($this->getStdErr());die();
		// CONSIDER https://bugs.php.net/bug.php?id=65348
		$Cr = "\x0d";
		$Lf = "\x0a";
		$CrLf = "\x0d\x0a";
		$stderr = $this->getStdErr ();
		$responses = [ ];
		while ( FALSE !== ($startPos = strpos ( $stderr, $Lf . '<' )) ) {
			$stderr = substr ( $stderr, $startPos + strlen ( $Lf ) );
			$endPos = strpos ( $stderr, $CrLf . "<\x20" . $CrLf );
			if ($endPos === false) {
				// ofc, curl has ths quirk where the specific message "* HTTP error before end of send, stop sending" gets appended with LF instead of the usual CRLF for other messages...
				$endPos = strpos ( $stderr, $Lf . "<\x20" . $CrLf );
			}
			// var_dump(bin2hex(substr($stderr,279,30)),$endPos);die("HEX");
			// var_dump($stderr,$endPos);die("PAIN");
			assert ( $endPos !== FALSE ); // should always be more after this with CURLOPT_VERBOSE.. (connection left intact / connecton dropped /whatever)
			$headers = substr ( $stderr, 0, $endPos );
			// $headerscpy=$headers;
			$stderr = substr ( $stderr, $endPos + strlen ( $CrLf . $CrLf ) );
			$headers = preg_split ( "/((\r?\n)|(\r\n?))/", $headers ); // i can NOT explode($CrLf,$headers); because sometimes, in the middle of recieving headers, it will spout stuff like "\n* Added cookie reg_ext_ref="deleted" for domain facebook.com, path /, expire 1457503459"
			                                                           // if(strpos($headerscpy,"report-uri=")!==false){
			                                                           // //var_dump($headerscpy);die("DIEDS");
			                                                           // var_dump($headers);
			                                                           // //var_dump($this->getStdErr());die("DIEDS");
			                                                           // }
			foreach ( $headers as $key => &$val ) {
				$val = trim ( $val );
				if (! strlen ( $val )) {
					unset ( $headers [$key] );
					continue;
				}
				if ($val [0] !== '<') {
					// static $r=0;++$r;var_dump('removing',$val);if($r>1)die();
					unset ( $headers [$key] ); // sometimes, in the middle of recieving headers, it will spout stuff like "\n* Added cookie reg_ext_ref="deleted" for domain facebook.com, path /, expire 1457503459"
					continue;
				}
				$val = trim ( substr ( $val, 1 ) );
			}
			unset ( $val ); // references can be scary..
			$responses [] = $headers;
		}
		unset ( $headers, $key, $val, $endPos, $startPos );
		return $responses;
	}

	// we COULD have a getResponsesCookies too...
	/*
	 * get last response cookies
	 *
	 * @return string[]
	 */
	public function getResponseCookies(): array {
		$headers = $this->getResponsesHeaders ();
		$headers_merged = array ();
		foreach ( $headers as $headers2 ) {
			foreach ( $headers2 as $header ) {
				$headers_merged [] = $header;
			}
		}
		return $this->parseCookies ( $headers_merged );
	}

	// explicitly undocumented for now..
	public function getRequestBody(): string {
		return file_get_contents ( stream_get_meta_data ( $this->request_body_file_handle ) ['uri'] );
	}

	/**
	 * return headers of last execution
	 *
	 * @return string[]
	 */
	public function getRequestHeaders(): array {
		$requestsHeaders = $this->getRequestsHeaders ();
		$requestCount = count ( $requestsHeaders );
		if ($requestCount === 0) {
			return array ();
		}
		return $requestsHeaders [$requestCount - 1];
	}

	// array(0=>array(request1_headers),1=>array(requst2_headers),2=>array(request3_headers))~
	/**
	 * get last execution request headers
	 *
	 * @return string[]
	 */
	public function getRequestsHeaders(): array {
		// CONSIDER https://bugs.php.net/bug.php?id=65348
		$Cr = "\x0d";
		$Lf = "\x0a";
		$CrLf = "\x0d\x0a";
		$stderr = $this->getStdErr ();
		$requests = [ ];
		while ( FALSE !== ($startPos = strpos ( $stderr, $Lf . '>' )) ) {
			$stderr = substr ( $stderr, $startPos + strlen ( $Lf . '>' ) );
			$endPos = strpos ( $stderr, $CrLf . $CrLf );
			if ($endPos === false) {
				// ofc, curl has ths quirk where the specific message "* HTTP error before end of send, stop sending" gets appended with LF instead of the usual CRLF for other messages...
				$endPos = strpos ( $stderr, $Lf . $CrLf );
			}
			assert ( $endPos !== FALSE ); // should always be more after this with CURLOPT_VERBOSE.. (connection left intact / connecton dropped /whatever)
			$headers = substr ( $stderr, 0, $endPos );
			$stderr = substr ( $stderr, $endPos + strlen ( $CrLf . $CrLf ) );
			$headers = explode ( $CrLf, $headers );
			foreach ( $headers as $key => &$val ) {
				$val = trim ( $val );
				if (! strlen ( $val )) {
					unset ( $headers [$key] );
				}
			}
			unset ( $val ); // references can be scary..
			$requests [] = $headers;
		}
		unset ( $headers, $key, $val, $endPos, $startPos );
		return $requests;
	}

	/**
	 * return last execution request cookies
	 *
	 * @return string[]
	 */
	public function getRequestCookies(): array {
		return $this->parseCookies ( $this->getRequestHeaders () );
	}

	/**
	 * get everything curl wrote to stderr of the last execution
	 *
	 * @return string
	 */
	public function getStdErr(): string {
		return file_get_contents ( stream_get_meta_data ( $this->stderr_file_handle ) ['uri'] );
	}

	/**
	 * alias of getResponseBody
	 *
	 * @return string
	 */
	public function getStdOut(): string {
		return $this->getResponseBody ();
	}
	protected function splitHeaders(string $headerstring): array {
		$headers = preg_split ( "/((\r?\n)|(\r\n?))/", $headerstring );
		foreach ( $headers as $key => $val ) {
			if (! strlen ( trim ( $val ) )) {
				unset ( $headers [$key] );
			}
		}
		return $headers;
	}
	protected function parseCookies(array $headers): array {
		$returnCookies = [ ];
		$grabCookieName = function ($str, &$len) {
			$len = 0;
			$ret = "";
			$i = 0;
			for($i = 0; $i < strlen ( $str ); ++ $i) {
				++ $len;
				if ($str [$i] === ' ') {
					continue;
				}
				if ($str [$i] === '=' || $str [$i] === ';') {
					-- $len;
					break;
				}
				$ret .= $str [$i];
			}
			return urldecode ( $ret );
		};
		foreach ( $headers as $header ) {
			// Set-Cookie: crlfcoookielol=crlf+is%0D%0A+and+newline+is+%0D%0A+and+semicolon+is%3B+and+not+sure+what+else
			/*
			 * Set-Cookie:ci_spill=a%3A4%3A%7Bs%3A10%3A%22session_id%22%3Bs%3A32%3A%22305d3d67b8016ca9661c3b032d4319df%22%3Bs%3A10%3A%22ip_address%22%3Bs%3A14%3A%2285.164.158.128%22%3Bs%3A10%3A%22user_agent%22%3Bs%3A109%3A%22Mozilla%2F5.0+%28Windows+NT+6.1%3B+WOW64%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F43.0.2357.132+Safari%2F537.36%22%3Bs%3A13%3A%22last_activity%22%3Bi%3A1436874639%3B%7Dcab1dd09f4eca466660e8a767856d013; expires=Tue, 14-Jul-2015 13:50:39 GMT; path=/
			 * Set-Cookie: sessionToken=abc123; Expires=Wed, 09 Jun 2021 10:18:14 GMT;
			 * //Cookie names cannot contain any of the following '=,; \t\r\n\013\014'
			 * //
			 */
			if (stripos ( $header, "Set-Cookie:" ) !== 0) {
				continue;
				/* */
			}
			$header = trim ( substr ( $header, strlen ( "Set-Cookie:" ) ) );
			$len = 0;
			while ( strlen ( $header ) > 0 ) {
				$cookiename = $grabCookieName ( $header, $len );
				$returnCookies [$cookiename] = '';
				$header = substr ( $header, $len );
				if (strlen ( $header ) < 1) {
					break;
				}
				if ($header [0] === '=') {
					$header = substr ( $header, 1 );
				}
				$thepos = strpos ( $header, ';' );
				if ($thepos === false) { // last cookie in this Set-Cookie.
					$returnCookies [$cookiename] = urldecode ( $header );
					break;
				}
				$returnCookies [$cookiename] = urldecode ( substr ( $header, 0, $thepos ) );
				$header = trim ( substr ( $header, $thepos + 1 ) ); // also remove the ;
			}
		}
		unset ( $header, $cookiename, $thepos );
		return $returnCookies;
	}

	/**
	 * Set an option for curl
	 *
	 * @param int $option
	 * @param mixed $value
	 * @throws InvalidArgumentException
	 * @return self
	 */
	public function setopt(int $option, $value): self {
		switch ($option) {
			case CURLOPT_VERBOSE :
				{
					trigger_error ( 'you should NOT change CURLOPT_VERBOSE. use getStdErr() instead. we are working around https://bugs.php.net/bug.php?id=65348 using CURLOPT_VERBOSE.', E_USER_WARNING );
					break;
				}
			case CURLOPT_RETURNTRANSFER :
				{
					trigger_error ( 'you should NOT use CURLOPT_RETURNTRANSFER. use getResponseBody() instead. expect problems now.', E_USER_WARNING );
					break;
				}
			case CURLOPT_FILE :
				{
					trigger_error ( 'you should NOT use CURLOPT_FILE. use getResponseBody() instead. expect problems now.', E_USER_WARNING );
					break;
				}
			case CURLOPT_WRITEHEADER :
				{
					trigger_error ( 'you should NOT use CURLOPT_WRITEHEADER. use getResponseHeaders() instead. expect problems now.', E_USER_WARNING );
					break;
				}
			case CURLOPT_INFILE :
				{
					trigger_error ( 'you should NOT use CURLOPT_INFILE. use setRequestBody() instead. expect problems now.', E_USER_WARNING );
					break;
				}
			case CURLOPT_STDERR :
				{
					trigger_error ( 'you should NOT use CURLOPT_STDERR. use getStdErr() instead. expect problems now.', E_USER_WARNING );
					break;
				}
			case CURLOPT_HEADER :
				{
					trigger_error ( 'you NOT use CURLOPT_HEADER. use  getResponsesHeaders() instead. expect problems now. we are working around https://bugs.php.net/bug.php?id=65348 using CURLOPT_VERBOSE, which is, until the bug is fixed, is incompatible with CURLOPT_HEADER.', E_USER_WARNING );
					break;
				}
			case CURLINFO_HEADER_OUT :
				{
					trigger_error ( 'you should NOT use CURLINFO_HEADER_OUT. use  getRequestHeaders() instead. expect problems now.', E_USER_WARNING );
					break;
				}

			default :
				{
				}
		}
		return $this->_setopt ( $option, $value );
	}

	/**
	 *
	 * @param int $option
	 * @param unknown $value
	 * @throws InvalidArgumentException
	 * @return self
	 */
	private function _setopt(int $option, $value): self {
		$ret = curl_setopt ( $this->curlh, $option, $value );
		if (! $ret) {
			throw new InvalidArgumentException ( 'curl_setopt failed. errno: ' . $this->errno () . '. error: ' . $this->error () . '. option: ' . var_export ( $this->_curlopt_name ( $option ), true ) . ' (' . var_export ( $option, true ) . '). value: ' . var_export ( $value, true ) );
		}
		$this->curloptions [$option] = $value;
		return $this;
	}

	/**
	 * return an option previously given to setopt(_array)
	 *
	 * @param int $option
	 * @param bool $isset
	 * @return mixed|NULL
	 */
	public function getopt(int $option, bool &$isset = NULL) {
		if (array_key_exists ( $option, $this->curloptions )) {
			$isset = true;
			return $this->curloptions [$option];
		} else {
			$isset = false;
			return NULL;
		}
	}

	/**
	 * return a string representation of the given curl error code
	 *
	 * (ps, most of the time you'll probably want to use error() instead of strerror())
	 *
	 * @param int $errornum
	 * @return string
	 */
	public function strerror(int $errornum): string {
		return curl_strerror ( $errornum );
	}

	/**
	 * gets cURL version information
	 *
	 * @param int $age
	 * @return array
	 */
	public function version(int $age = CURLVERSION_NOW): array {
		return curl_version ( $age );
	}
	private function _prepare_curl() {
		$this->truncateFileHandles ();
		$this->_setopt ( CURLOPT_FILE, $this->response_body_file_handle ); // CURLOPT_FILE
		$this->_setopt ( CURLOPT_WRITEHEADER, $this->response_headers_file_handle ); // CURLOPT_WRITEHEADER
		$this->_setopt ( CURLOPT_INFILE, $this->request_body_file_handle ); // CURLOPT_INFILE
		$this->_setopt ( CURLOPT_STDERR, $this->stderr_file_handle ); // CURLOPT_STDERR
		$this->_setopt ( CURLOPT_VERBOSE, true );
	}

	/**
	 * gets the constants name of the given curl options
	 *
	 * useful for error messages (instead of "FAILED TO SET CURLOPT 21387" , you can say "FAILED TO SET CURLOPT_VERBOSE" )
	 *
	 * @param int $option
	 * @return mixed|boolean
	 */
	public function _curlopt_name(int $option)/*:mixed(string|false)*/{
		// thanks to TML for the get_defined_constants trick..
		// <TML> If you had some specific reason for doing it with your current approach (which is, to me, approaching the problem completely backwards - "I dug a hole! How do I get out!"), it seems that your entire function there could be replaced with: return array_flip(get_defined_constants(true)['curl']);
		$curldefs = array_flip ( get_defined_constants ( true ) ['curl'] );
		if (isset ( $curldefs [$option] )) {
			return $curldefs [$option];
		} else {
			return false;
		}
	}

	/**
	 * gets the constant number of the given constant name
	 *
	 * (what was i thinking!?)
	 *
	 * @param string $option
	 * @return int|boolean
	 */
	public function _curlopt_number(string $option)/*:mixed(int|false)*/{
		// thanks to TML for the get_defined_constants trick..
		$curldefs = get_defined_constants ( true ) ['curl'];
		if (isset ( $curldefs [$option] )) {
			return $curldefs [$option];
		} else {
			return false;
		}
	}
}