PHP SDK

Install and use the fakecloud SDK for PHP tests (PHPUnit, Pest, Laravel, Symfony).

Install

composer require fakecloud/fakecloud

Requires PHP 8.1+. Uses the built-in curl extension and json_decode/json_encode. No external dependencies.

Initialize

use FakeCloud\FakeCloud;

$fc = new FakeCloud();                         // defaults to http://localhost:4566
$fc = new FakeCloud('http://localhost:5000');   // explicit base URL

Top-level

$fc->lambda()

$fc->rds()

$fc->elasticache()

$fc->ecr()

$fc->logs()

$fc->ses()

$fc->sns()

$fc->sqs()

$fc->applicationAutoscaling()

$fc->athena()

$fc->events()

$fc->scheduler()

$fc->glue()

$fc->s3()

$fc->dynamodb()

$fc->secretsmanager()

$fc->cognito()

$fc->apigatewayv2()

$fc->stepfunctions()

$fc->bedrock()

$fc->bedrockAgent()

$fc->bedrockAgentRuntime()

$fc->ecs()

$fc->elbv2()

$fc->route53()

$fc->acm()

$fc->organizations()

$fc->ssm()

$fc->kms()

$fc->wafv2()

$fc->cloudfront()

Error handling

All methods throw FakeCloudError (a RuntimeException) on non-2xx responses:

use FakeCloud\FakeCloudError;
use FakeCloud\ConfirmUserRequest;

try {
    $fc->cognito()->confirmUser(new ConfirmUserRequest('pool-1', 'nobody'));
} catch (FakeCloudError $err) {
    echo $err->status; // 404
    echo $err->body;   // error body from fakecloud
}

Example: full test loop

use FakeCloud\FakeCloud;
use FakeCloud\BedrockFaultRule;
use FakeCloud\BedrockResponseRule;

$fc = new FakeCloud();
$modelId = 'anthropic.claude-3-haiku-20240307-v1:0';

// PHPUnit setUp
$fc->reset();

// Test: classifier branches on spam vs ham
$fc->bedrock()->setResponseRules($modelId, [
    new BedrockResponseRule('buy now', '{"label":"spam"}'),
    new BedrockResponseRule(null, '{"label":"ham"}'),
]);

classify('hello friend');
classify('buy now cheap pills');

$invocations = $fc->bedrock()->getInvocations()->invocations;
$this->assertCount(2, $invocations);
$this->assertStringContainsString('ham', $invocations[0]->output);
$this->assertStringContainsString('spam', $invocations[1]->output);

// Test: retries on throttling
$fc->reset();
$fc->bedrock()->queueFault(
    new BedrockFaultRule('ThrottlingException', 'Rate exceeded', 429, 1)
);

classify('hello');

$invocations = $fc->bedrock()->getInvocations()->invocations;
$this->assertCount(2, $invocations);
$this->assertStringContainsString('ThrottlingException', $invocations[0]->error);
$this->assertNull($invocations[1]->error);

Source

• sdks/php
• Source README — always-current method list