MD5 validator plugin¶
Entity bodies can sometimes be modified over the wire due to a faulty TCP transport or misbehaving proxy. If an HTTP
response contains a Content-MD5 header, then a MD5 hash of the entity body of a response can be compared against the
Content-MD5 header of the response to determine if the response was delivered intact. The
Guzzle\Plugin\Md5\Md5ValidatorPlugin
will throw an UnexpectedValueException
if the calculated MD5 hash does
not match the Content-MD5 header value:
use Guzzle\Http\Client;
use Guzzle\Plugin\Md5\Md5ValidatorPlugin;
$client = new Client('http://www.test.com/');
$md5Plugin = new Md5ValidatorPlugin();
// Add the md5 plugin to the client object
$client->addSubscriber($md5Plugin);
$request = $client->get('http://www.yahoo.com/');
$request->send();
Calculating the MD5 hash of a large entity body or an entity body that was transferred using a Content-Encoding is an
expensive operation. When working in high performance applications, you might consider skipping the MD5 hash
validation for entity bodies bigger than a certain size or Content-Encoded entity bodies
(see Guzzle\Plugin\Md5\Md5ValidatorPlugin
for more information).