Update to last official version 2.0.0

AUTHORS

@@ -1,11 +1,14 @@
-Monte Ohrt <monte@ispi.net>
+Monte Ohrt <monte@ohrt.com>
 	- main Snoopy work
 
-Andrei Zmievski <andrei@ispi.net>
+Andrei Zmievski <andrei@php.net>
 	- miscellaneous fixes
 	- read timeout support
 	- file submission capability
 
 Gene Wood <gene_wood@users.sourceforge.net>
     - bug fixes
     - security fixes
+
+Thomas Hoger <thoger@redhat.com>
+    - CA certificate checks and security fixes

ChangeLog

@@ -1,3 +1,16 @@
+Version 2.0.0
+-------------
+
+    - remove all dependancies on cUrl, use OpenSSH for SSL connections.
+    - add SSL certificate checking
+    - add getResults() method
+    - make methods chainable
+
+Version 1.2.5
+-------------
+
+    - fix command line escapement vulnerability with execution of curl binary on https fetches (mohrt, mstrokin)
+
 Version 1.2.4
 -------------
 

FAQ

@@ -1,8 +1,8 @@
 Q:	Why can't I fetch https pages?
-A:	Using Snoopy to fetch an https page requires curl. Check if curl is installed on your host. If curl is installed, it may be located in a different place than the default. By default Snoopy looks for curl in /usr/local/bin/curl. Run 'which curl' and find out your location. If it differs from the default, then you'll need to set the $snoopy->curl_path variable to the location of your curl installation. Here's an example of the code :
-		include "Snoopy.class.php";
-		$snoopy = new Snoopy;
-		$snoopy->curl_path="/usr/bin/curl";
+A:	Using Snoopy to fetch an https page requires PHP to be compiled with
+	OpenSSL support.  If installing PHP from source, refer to the PHP manual
+	for instructions for enabling OpenSSL support:
+	http://www.php.net/manual/en/book.openssl.php
 
 Q:	where does the function preg_match_all come from?
 A:	PCRE functions in PHP 3.0.9 and later

NEWS

@@ -1,3 +1,16 @@
+RELEASE NOTE v1.2.6
+
+Snoopy no longer uses cUrl to fetch https requests, but instead uses PHP functions directly
+through the use of openssl. Be sure you have compiled PHP with --with-openssl and openssl is
+enabled in your php.ini.
+
+If either $cafile or $capath is set, SSL certificate verification is enabled. See the README.
+
+Added getResults() method, simple returning $snoopy->results property;
+
+Snoopy methods are now chainable, so for instance this is valid:
+$res = $snoopy->fetch('http://www.google.com')->getResults();
+
 RELEASE NOTE: v1.2.4
 October 22, 2008
 

README

@@ -1,6 +1,6 @@
 NAME:
 
-	Snoopy - the PHP net client v1.2.4
+	Snoopy - the PHP net client v2.0.0
 
 SYNOPSIS:
 
@@ -58,8 +58,7 @@ DESCRIPTION:
 REQUIREMENTS:
 
 	Snoopy requires PHP with PCRE (Perl Compatible Regular Expressions),
-	which should be PHP 3.0.9 and up. For read timeout support, it requires
-	PHP 4 Beta 4 or later. Snoopy was developed and tested with PHP 3.0.12.
+	and the OpenSSL extension for fetching HTTPS requests.	
 
 CLASS METHODS:
 
@@ -121,6 +120,7 @@ CLASS VARIABLES:	(default value in parenthesis)
 	$port			the port to connect to
 	$proxy_host		the proxy host to use, if any
 	$proxy_port		the proxy port to use, if any
+					proxy can only be used for http URLs, but not https
 	$agent			the user agent to masqerade as (Snoopy v0.1)
 	$referer		referer information to pass, if any
 	$cookies		cookies to pass if any
@@ -142,6 +142,11 @@ CLASS VARIABLES:	(default value in parenthesis)
 	$status			http status of fetch
 	$temp_dir		temp directory that the webserver can write to. (/tmp)
 	$curl_path		system path to cURL binary, set to false if none
+					(this variable is ignored as of Snoopy v1.2.6)
+	$cafile			name of a file with CA certificate(s)
+	$capath			name of a correctly hashed directory with CA certificate(s)
+					if either $cafile or $capath is set, SSL certificate
+					verification is enabled
 
 
 EXAMPLES: