add stream wrapper to calculate hash on write

This commit is contained in:
Robin Appelman 2019-03-12 10:42:36 +01:00
commit 6c91d3e390
4 changed files with 128 additions and 24 deletions

View file

@ -23,15 +23,8 @@
namespace Icewind\Streams; namespace Icewind\Streams;
/**
* Wrapper that calculates the hash on the stream on read abstract class HashWrapper extends Wrapper {
*
* The stream and hash should be passed in when wrapping the stream.
* On close the callback will be called with the calculated checksum.
*
* For supported hashes see: http://php.net/manual/en/function.hash-algos.php
*/
class HashWrapper extends Wrapper {
/** /**
* @var callable * @var callable
@ -49,15 +42,15 @@ class HashWrapper extends Wrapper {
* @param resource $source * @param resource $source
* @param string $hash * @param string $hash
* @param callable $callback * @param callable $callback
* @return resource * @return resource|bool
* *
* @throws \BadMethodCallException * @throws \BadMethodCallException
*/ */
public static function wrap($source, $hash, $callback) { public static function wrap($source, $hash, $callback) {
$context = array( $context = [
'hash' => $hash, 'hash' => $hash,
'callback' => $callback, 'callback' => $callback,
); ];
return self::wrapSource($source, $context); return self::wrapSource($source, $context);
} }
@ -72,12 +65,8 @@ class HashWrapper extends Wrapper {
return true; return true;
} }
public function stream_read($count) { protected function updateHash($data) {
$data = parent::stream_read($count); hash_update($this->hashContext, $data);
if ($this->hashContext !== false) {
hash_update($this->hashContext, $data);
}
return $data;
} }
public function stream_close() { public function stream_close() {
@ -87,4 +76,5 @@ class HashWrapper extends Wrapper {
} }
return parent::stream_close(); return parent::stream_close();
} }
}
}

40
src/ReadHashWrapper.php Normal file
View file

@ -0,0 +1,40 @@
<?php
/**
* @copyright Copyright (c) 2019, Roeland Jago Douma <roeland@famdouma.nl>
*
* @author Roeland Jago Douma <roeland@famdouma.nl>
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
namespace Icewind\Streams;
/**
* Wrapper that calculates the hash on the stream on read
*
* The stream and hash should be passed in when wrapping the stream.
* On close the callback will be called with the calculated checksum.
*
* For supported hashes see: http://php.net/manual/en/function.hash-algos.php
*/
class ReadHashWrapper extends HashWrapper {
public function stream_read($count) {
$data = parent::stream_read($count);
$this->updateHash($data);
return $data;
}
}

37
src/WriteHashWrapper.php Normal file
View file

@ -0,0 +1,37 @@
<?php
/**
* @copyright Copyright (c) 2019 Robin Appelman <robin@icewind.nl>
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
namespace Icewind\Streams;
/**
* Wrapper that calculates the hash on the stream on write
*
* The stream and hash should be passed in when wrapping the stream.
* On close the callback will be called with the calculated checksum.
*
* For supported hashes see: http://php.net/manual/en/function.hash-algos.php
*/
class WriteHashWrapper extends HashWrapper {
public function stream_write($data) {
$this->updateHash($data);
return parent::stream_write($data);
}
}

View file

@ -24,19 +24,31 @@
namespace Icewind\Streams\Tests; namespace Icewind\Streams\Tests;
class HashWrapperTest extends \PHPUnit_Framework_TestCase { class HashWrapperTest extends \PHPUnit_Framework_TestCase {
const DATA = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.';
/** /**
* @param resource $source * @param resource $source
* @param string $hash * @param string $hash
* @param callable $callback * @param callable $callback
* @return resource * @return resource
*/ */
protected function wrapSource($source, $hash, $callback) { protected function wrapSourceRead($source, $hash, $callback) {
return \Icewind\Streams\HashWrapper::wrap($source, $hash, $callback); return \Icewind\Streams\ReadHashWrapper::wrap($source, $hash, $callback);
}
/**
* @param resource $source
* @param string $hash
* @param callable $callback
* @return resource
*/
protected function wrapSourceWrite($source, $hash, $callback) {
return \Icewind\Streams\WriteHashWrapper::wrap($source, $hash, $callback);
} }
protected function getSource() { protected function getSource() {
$source = fopen('php://temp', 'w+'); $source = fopen('php://temp', 'w+');
fwrite($source, 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.'); fwrite($source, self::DATA);
fseek($source, 0); fseek($source, 0);
return $source; return $source;
} }
@ -56,13 +68,13 @@ class HashWrapperTest extends \PHPUnit_Framework_TestCase {
* @param string $algorithm * @param string $algorithm
* @param string $expectedHash * @param string $expectedHash
*/ */
public function testHash($algorithm, $expectedHash) { public function testReadHash($algorithm, $expectedHash) {
$obtainedHash = null; $obtainedHash = null;
$callback = function($hash) use (&$obtainedHash) { $callback = function($hash) use (&$obtainedHash) {
$obtainedHash = $hash; $obtainedHash = $hash;
}; };
$stream = $this->wrapSource($this->getSource(), $algorithm, $callback); $stream = $this->wrapSourceRead($this->getSource(), $algorithm, $callback);
while(feof($stream) === false) { while(feof($stream) === false) {
fread($stream, 20); fread($stream, 20);
} }
@ -70,4 +82,29 @@ class HashWrapperTest extends \PHPUnit_Framework_TestCase {
$this->assertSame($expectedHash, $obtainedHash); $this->assertSame($expectedHash, $obtainedHash);
} }
/**
* @dataProvider hashData
*
* @param string $algorithm
* @param string $expectedHash
*/
public function testWriteHash($algorithm, $expectedHash) {
$obtainedHash = null;
$callback = function($hash) use (&$obtainedHash) {
$obtainedHash = $hash;
};
$source = fopen('php://temp', 'w+');
$stream = $this->wrapSourceWrite($source, $algorithm, $callback);
$pos = 0;
while ($pos < strlen(self::DATA)) {
fwrite($stream, substr(self::DATA, $pos, 20));
$pos += 20;
}
fclose($stream);
$this->assertSame($expectedHash, $obtainedHash);
}
} }