$dogpatch = new Dogpatch();

$dogpatch->get("https://api.github.com")
         ->assertStatusCode(200)
         ->assertHeadersExist(array(
            "X-GitHub-Request-Id",
            "ETag"
         ))
         ->assertHeaders(array(
            "Server" => "GitHub.com"
         ))
         ->assertBody(IS_VALID_JSON)
         ->assertTotalTimeLessThan(2)
         ->close();

$dogpatch = new Dogpatch();

$dogpatch->get("https://freegeoip.net/json/8.8.8.8")
         ->assertStatusCode(200)
         ->assertHeadersExist(array(
            "Content-Length"
         ))
         ->assertHeaders(array(
            "Access-Control-Allow-Origin" => "*"
         ))
         ->assertBodyJsonFile(dirname(__DIR__) . "/examples/json/freegeoip.net.json")
         ->close();

Version 5.3.0 or greater.

Curl

$dogpatch = new Dogpatch(array $curlOptions = array());

username: A basic authentication username. Defaults to null.

password: A basic authentication password. Defaults to null.

timeout: Curl HTTP request timeout in seconds. Defaults to 60.

ssl_verifypeer: Attempt to verify ssl peer certificates using included ca-bundle.crt. Defaults to true.

verbose: Turns on verbose curl logging, and log all requests into a file logs/curl_debug.log. Defaults to false.

$dogpatch->get($url, array $headers = array());

url: A compete url including the scheme (HTTP, HTTPS).

headers: An optional associated array of additional request headers to pass. Defaults to an empty array.

$dogpatch->post($url, array $postData = array(), array $headers = array());

url: A compete url including the scheme (HTTP, HTTPS).

postData: An associated array of post data in key => value syntax.

headers: An optional associated array of additional request headers to pass. Defaults to an empty array.

$dogpatch->put($url, array $headers = array());

url: A compete url including the scheme (HTTP, HTTPS).

headers: An optional associated array of additional request headers to pass. Defaults to an empty array.

$dogpatch->delete($url, array $headers = array());

url: A compete url including the scheme (HTTP, HTTPS).

headers: An optional associated array of additional request headers to pass. Defaults to an empty array.

$dogpatch->head($url, array $headers = array());

url: A compete url including the scheme (HTTP, HTTPS).

headers: An optional associated array of additional request headers to pass. Defaults to an empty array.

$dogpatch->assertStatusCode($assertedStatusCode);

assertedStatusCode: An integer representing the expected response status code.

$dogpatch->assertHeadersExist(array $assertedHeaders = array());

assertedHeaders: A standard indexed array of expected response headers. The actual values of the response headers are not checked, only that the header exists. The headers are checked case-insensitive.

$dogpatch->assertHeaders(array $assertedHeaders = array());

assertedHeaders: An associated array of expected response headers and their expected value. The actual values of the response headers are checked. The headers are checked case-insensitive but the header values are checked case-sensitive.

$dogpatch->assertBody($assertedBody, $useRegularExpression = false);

assertedBody: Assert a response body, takes one of four options. A string that is checked case-sensitive. A regular expression that is checked according to the defined expression. A special flag IS_VALID_JSON or IS_EMPTY. IS_VALID_JSON only validates that the response body is proper JSON and able to be decoded. IS_EMPTY validates that the response body is empty.

useRegularExpression: An optional true/false flag which you may reference with globals USE_REGEX and DONT_USE_REGEX. If you wish $assertedBody to be checked via regular expression, you must set this parameter to true. Defaults to false.

$dogpatch->assertBodyPhp($asserted, $onNotEqualVarExport = false);

asserted: Assert a native PHP type (usually a PHP object or array) against the response body. The response body must be valid JSON, which is automatically decoded and compared against $asserted. PHP type keys and values are checked case-sensitive.

onNotEqualVarExport: An optional true/false flag which you may reference with globals VAR_EXPORT and DONT_VAR_EXPORT. If a mismatch is detected between $asserted and the response body, variable export both making it convenient to find discrepancies. Defaults to false.

$dogpatch->assertBodyJsonFile($assertedJsonFile, $onNotEqualPrintJson = false);

assertedJsonFile: Assert a JSON file (the full path) against the response body. The response body must be valid JSON, which is automatically decoded, pretty printed, and compared against the passed-in JSON file which is also pretty printed. Key names and values are checked case-sensitive.

onNotEqualPrintJson: An optional true/false flag which you may reference with globals PRINT_JSON and DONT_PRINT_JSON. If a mismatch is detected between the JSON file and the response body, print both making it convenient to find discrepancies. Defaults to false.

$dogpatch->assertTotalTimeLessThan($assertedTime);

$assertedTime: Float representing the maximum value in seconds of the total request time.

$dogpatch->close();

Closes the curl connection and unsets the curl resource and all dogpatch class variables. Don't call close() until you are completely done making requests with the curl connection. Once you call close() you must instantiate a new dogpatch object. For example, the following is invalid and will throw an exception:

$dogpatch = new Dogpatch();
$dogpatch->get("https://www.google.com")
         ->close()
         ->get("https://github.com")

Instead do the following:

$dogpatch = new Dogpatch();
$dogpatch->get("https://www.google.com")
         ->close();

$dogpatch = new Dogpatch();
$dogpatch->get("https://github.com")
         ->close();

Or, even better, if you'd like to reuse the same curl connection and curl options:

$dogpatch = new Dogpatch();
$dogpatch->get("https://www.google.com")
         ->get("https://github.com")
         ->close();

https://github.com/commando/dogpatch/blob/master/VERSION

https://github.com/commando/dogpatch/blob/master/CHANGELOG.md

Create issues here in GitHub (https://github.com/commando/dogpatch/issues).

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, dogpatch will be maintained under the semantic versioning guidelines.

Releases will be numbered with the follow format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

• Breaking backward compatibility bumps the major (and resets the minor and patch)
• New additions without breaking backward compatibility bumps the minor (and resets the patch)
• Bug fixes and misc changes bumps the patch

For more information on semantic versioning, visit http://semver.org/.

Copyright 2015 NodeSocket, LLC.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.