You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
161 lines
6.3 KiB
PHTML
161 lines
6.3 KiB
PHTML
|
2 weeks ago
|
<?php
|
||
|
|
|
||
|
|
require dirname(__DIR__) . '/vendor/autoload.php';
|
||
|
|
|
||
|
|
use App\Services\Cloud\CloudObjectStorageS3Client;
|
||
|
|
use App\Services\Cloud\CloudObjectStorageTransferError;
|
||
|
|
use GuzzleHttp\Client;
|
||
|
|
use GuzzleHttp\Exception\ConnectException;
|
||
|
|
use GuzzleHttp\Handler\MockHandler;
|
||
|
|
use GuzzleHttp\HandlerStack;
|
||
|
|
use GuzzleHttp\Middleware;
|
||
|
|
use GuzzleHttp\Psr7\Request;
|
||
|
|
use GuzzleHttp\Psr7\Response;
|
||
|
|
|
||
|
|
$assert = static function (bool $condition, string $message): void {
|
||
|
|
if (!$condition) {
|
||
|
|
throw new RuntimeException($message);
|
||
|
|
}
|
||
|
|
};
|
||
|
|
$config = [
|
||
|
|
'endpoint' => 'https://objects.example.test',
|
||
|
|
'region' => 'us-east-1',
|
||
|
|
'bucket' => 'virt-backups',
|
||
|
|
'path_style' => true,
|
||
|
|
];
|
||
|
|
$credentials = [
|
||
|
|
'access_key_id' => 'LOOKUPACCESSKEY',
|
||
|
|
'secret_access_key' => 'lookup-secret-never-log',
|
||
|
|
];
|
||
|
|
$objectKey = 'vm-backups/fixture/system.qcow2';
|
||
|
|
$client = static function (array $responses, array &$history): CloudObjectStorageS3Client {
|
||
|
|
$stack = HandlerStack::create(new MockHandler($responses));
|
||
|
|
$stack->push(Middleware::history($history));
|
||
|
|
return new CloudObjectStorageS3Client(new Client(['handler' => $stack]));
|
||
|
|
};
|
||
|
|
$expectUnknown = static function (callable $callback) use ($assert): void {
|
||
|
|
try {
|
||
|
|
$callback();
|
||
|
|
} catch (CloudObjectStorageTransferError $error) {
|
||
|
|
$assert($error->publicCode === 'multipart_lookup_unknown'
|
||
|
|
&& $error->effectMayHaveApplied,
|
||
|
|
'Multipart lookup did not preserve unknown-effect semantics.');
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
throw new RuntimeException('Expected multipart lookup failure was not raised.');
|
||
|
|
};
|
||
|
|
|
||
|
|
$history = [];
|
||
|
|
$lookup = $client([
|
||
|
|
new Response(200, ['Content-Type' => 'application/xml'],
|
||
|
|
'<?xml version="1.0" encoding="UTF-8"?>'
|
||
|
|
. '<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">'
|
||
|
|
. '<IsTruncated>true</IsTruncated>'
|
||
|
|
. '<NextKeyMarker>vm-backups/fixture/system.qcow2</NextKeyMarker>'
|
||
|
|
. '<NextUploadIdMarker>marker-one</NextUploadIdMarker>'
|
||
|
|
. '<Upload><Key>vm-backups/fixture/system.qcow2-extra</Key>'
|
||
|
|
. '<UploadId>unrelated-upload</UploadId>'
|
||
|
|
. '<Initiated>2026-11-06T00:00:01Z</Initiated></Upload>'
|
||
|
|
. '<Upload><Key>vm-backups/fixture/system.qcow2</Key>'
|
||
|
|
. '<UploadId>upload-b</UploadId>'
|
||
|
|
. '<Initiated>2026-11-06T00:00:02.123Z</Initiated></Upload>'
|
||
|
|
. '</ListMultipartUploadsResult>'),
|
||
|
|
new Response(200, ['Content-Type' => 'application/xml'],
|
||
|
|
'<?xml version="1.0" encoding="UTF-8"?>'
|
||
|
|
. '<ListMultipartUploadsResult>'
|
||
|
|
. '<IsTruncated>false</IsTruncated>'
|
||
|
|
. '<Upload><Key>vm-backups/fixture/system.qcow2</Key>'
|
||
|
|
. '<UploadId>upload-a</UploadId>'
|
||
|
|
. '<Initiated>2026-11-05T23:59:59.123456Z</Initiated></Upload>'
|
||
|
|
. '</ListMultipartUploadsResult>'),
|
||
|
|
], $history);
|
||
|
|
$matches = $lookup->findMultipartUploadsByExactObjectKey(
|
||
|
|
$config,
|
||
|
|
$credentials,
|
||
|
|
$objectKey
|
||
|
|
);
|
||
|
|
$assert(array_column($matches, 'upload_id') === ['upload-a', 'upload-b']
|
||
|
|
&& $matches[0]['initiated_at'] === 1793923199
|
||
|
|
&& $matches[1]['initiated_at'] === 1793923202,
|
||
|
|
'Exact multipart lookup lost matches, ordering, or initiation time.');
|
||
|
|
$assert(count($history) === 2
|
||
|
|
&& $history[0]['request']->getMethod() === 'GET'
|
||
|
|
&& $history[1]['request']->getMethod() === 'GET',
|
||
|
|
'Multipart lookup did not use bounded read-only requests.');
|
||
|
|
parse_str((string) $history[0]['request']->getUri()->getQuery(), $firstQuery);
|
||
|
|
parse_str((string) $history[1]['request']->getUri()->getQuery(), $secondQuery);
|
||
|
|
$assert(($firstQuery['prefix'] ?? null) === $objectKey
|
||
|
|
&& ($firstQuery['max-uploads'] ?? null) === '100'
|
||
|
|
&& array_key_exists('uploads', $firstQuery)
|
||
|
|
&& ($secondQuery['key-marker'] ?? null) === $objectKey
|
||
|
|
&& ($secondQuery['upload-id-marker'] ?? null) === 'marker-one'
|
||
|
|
&& !str_contains(
|
||
|
|
json_encode($history, JSON_THROW_ON_ERROR),
|
||
|
|
$credentials['secret_access_key']
|
||
|
|
),
|
||
|
|
'Multipart lookup lost exact-prefix pagination or exposed credentials.');
|
||
|
|
|
||
|
|
$emptyHistory = [];
|
||
|
|
$empty = $client([
|
||
|
|
new Response(200, [], '<ListMultipartUploadsResult>'
|
||
|
|
. '<IsTruncated>false</IsTruncated>'
|
||
|
|
. '</ListMultipartUploadsResult>'),
|
||
|
|
], $emptyHistory);
|
||
|
|
$assert($empty->findMultipartUploadsByExactObjectKey(
|
||
|
|
$config,
|
||
|
|
$credentials,
|
||
|
|
$objectKey
|
||
|
|
) === [],
|
||
|
|
'A complete empty multipart listing was not accepted as absence evidence.');
|
||
|
|
|
||
|
|
$invalidTimeHistory = [];
|
||
|
|
$invalidTime = $client([
|
||
|
|
new Response(200, [], '<ListMultipartUploadsResult>'
|
||
|
|
. '<IsTruncated>false</IsTruncated>'
|
||
|
|
. '<Upload><Key>vm-backups/fixture/system.qcow2</Key>'
|
||
|
|
. '<UploadId>upload-invalid-time</UploadId>'
|
||
|
|
. '<Initiated>2026-02-30T25:00:00Z</Initiated></Upload>'
|
||
|
|
. '</ListMultipartUploadsResult>'),
|
||
|
|
], $invalidTimeHistory);
|
||
|
|
$expectUnknown(static fn () => $invalidTime->
|
||
|
|
findMultipartUploadsByExactObjectKey($config, $credentials, $objectKey));
|
||
|
|
|
||
|
|
$missingMarkerHistory = [];
|
||
|
|
$missingMarker = $client([
|
||
|
|
new Response(200, [], '<ListMultipartUploadsResult>'
|
||
|
|
. '<IsTruncated>true</IsTruncated>'
|
||
|
|
. '</ListMultipartUploadsResult>'),
|
||
|
|
], $missingMarkerHistory);
|
||
|
|
$expectUnknown(static fn () => $missingMarker->
|
||
|
|
findMultipartUploadsByExactObjectKey($config, $credentials, $objectKey));
|
||
|
|
|
||
|
|
$capHistory = [];
|
||
|
|
$capResponses = [];
|
||
|
|
for ($index = 1; $index <= 4; $index++) {
|
||
|
|
$capResponses[] = new Response(200, [],
|
||
|
|
'<ListMultipartUploadsResult>'
|
||
|
|
. '<IsTruncated>true</IsTruncated>'
|
||
|
|
. '<NextKeyMarker>vm-backups/fixture/system.qcow2-'
|
||
|
|
. $index . '</NextKeyMarker>'
|
||
|
|
. '<NextUploadIdMarker>marker-' . $index
|
||
|
|
. '</NextUploadIdMarker>'
|
||
|
|
. '</ListMultipartUploadsResult>');
|
||
|
|
}
|
||
|
|
$capped = $client($capResponses, $capHistory);
|
||
|
|
$expectUnknown(static fn () => $capped->
|
||
|
|
findMultipartUploadsByExactObjectKey($config, $credentials, $objectKey));
|
||
|
|
$assert(count($capHistory) === 4,
|
||
|
|
'Multipart lookup exceeded its strict page cap.');
|
||
|
|
|
||
|
|
$transportHistory = [];
|
||
|
|
$transport = $client([
|
||
|
|
new ConnectException(
|
||
|
|
'network unavailable',
|
||
|
|
new Request('GET', 'https://objects.example.test')
|
||
|
|
),
|
||
|
|
], $transportHistory);
|
||
|
|
$expectUnknown(static fn () => $transport->
|
||
|
|
findMultipartUploadsByExactObjectKey($config, $credentials, $objectKey));
|
||
|
|
|
||
|
|
echo "Object-storage exact multipart lookup contracts passed.\n";
|