status; } public function getBody(): string { return $this->body; } } class Client { public function __construct(private array $responses = []) { } public function request(string $method, string $url, array $options): HostErrorTestResponse { $response = array_shift($this->responses); if (!$response instanceof HostErrorTestResponse) { throw new \RuntimeException('No fake engine response was queued.'); } return $response; } } } namespace { use App\Services\Cloud\CloudEngineClient; use App\Services\Cloud\CloudError; use GuzzleHttp\Client; use GuzzleHttp\HostErrorTestResponse; require dirname(__DIR__) . '/app/Services/Cloud/CloudError.php'; require dirname(__DIR__) . '/app/Services/Cloud/CloudEngineClient.php'; $assert = static function ($condition, string $message): void { if (!$condition) { throw new RuntimeException($message); } }; $messages = [ 'host_configuration_invalid' => '宿主机配置无效,请检查地址、端口、存储目录和默认网络', 'host_private_key_required' => '首次添加宿主机必须提供现有 SSH 私钥', 'host_private_key_format_invalid' => 'SSH 私钥格式无效,请提供 PEM 或 OpenSSH 格式私钥', 'host_private_key_passphrase_required' => 'SSH 私钥已加密,请填写私钥解锁口令', 'host_private_key_invalid' => 'SSH 私钥或解锁口令无效,请检查后重试', 'host_public_pool_invalid' => '公网地址池配置无效,请完整填写可路由的 IPv4 网段、网关和 DNS(网段前缀 /24 至 /30)', 'host_public_gateway_invalid' => '公网网关无效,必须位于所配置的公网地址池内', 'host_public_dns_invalid' => '公网 DNS 无效,请填写最多 4 个可路由的 IPv4 地址', 'host_public_reserved_ip_invalid' => '保留 IP 配置无效,请填写地址池内的 IPv4 地址,最多 254 个', 'host_vm_prefix_invalid' => '客户机网络前缀无效,必须介于 /24 和地址池前缀之间', ]; $allowlisted = new ReflectionMethod(CloudEngineClient::class, 'safeAllowlistedError'); foreach ($messages as $code => $message) { foreach ([400, 409, 422] as $status) { foreach (['/internal/v1/hosts/1/host', '/internal/v1/hosts/42/host/test'] as $path) { $actual = $allowlisted->invoke(null, $path, [ 'error_code' => $code, 'error' => 'Traceback: host=/root/private key=secret', ], $status); $assert($actual === $message, 'A reviewed host error code was not mapped on its fixed route: ' . $code); $assert(!str_contains($actual, 'private') && !str_contains($actual, '/root'), 'An arbitrary host error body crossed the PHP trust boundary.'); } } } $fabricMessages = [ 'fabric_endpoint_interface_unverified' => '无法唯一确认 Fabric 传输地址对应的宿主机接口', 'fabric_endpoint_interface_unsafe_or_drifted' => 'Fabric 传输接口不安全或与当前配置不一致', 'fabric_endpoint_rp_filter_unverified' => '无法确认 Fabric 传输接口的 rp_filter', ]; foreach ($fabricMessages as $code => $message) { foreach ([400, 409, 422] as $status) { foreach (['/internal/v1/fabric/apply', '/internal/v1/fabric/hk/reconcile'] as $path) { $actual = $allowlisted->invoke(null, $path, [ 'error_code' => $code, 'error' => 'Traceback: host=/root/private key=secret', ], $status); $assert($actual === $message, 'A reviewed Fabric endpoint error was not mapped on its fixed route: ' . $code); $assert(!str_contains($actual, 'private') && !str_contains($actual, '/root'), 'An arbitrary Fabric error body crossed the PHP trust boundary.'); } } } $fabricClient = new CloudEngineClient(new Client([ new HostErrorTestResponse(409, json_encode([ 'error_code' => 'fabric_endpoint_rp_filter_unverified', 'error' => 'Traceback: host=/root/private key=secret', ], JSON_UNESCAPED_UNICODE)), ])); try { $fabricClient->request('POST', '/internal/v1/fabric/apply', [ 'user_id' => 1, 'is_admin' => true, 'can_manage' => true, ], []); throw new RuntimeException('A reviewed Fabric endpoint failure did not raise CloudError.'); } catch (CloudError $error) { $assert($error->getMessage() === $fabricMessages['fabric_endpoint_rp_filter_unverified'] && $error->httpStatus === 409 && !str_contains($error->getMessage(), 'private'), 'A reviewed Fabric endpoint error lost its fixed message or definitive 409 status.'); } foreach ([ ['/internal/v1/hosts/1/host', ['error_code' => 'unknown_host_failure', 'error' => 'secret']], ['/internal/v1/hosts/1/host', ['error_code' => ['host_configuration_invalid'], 'error' => 'secret']], ['/internal/v1/hosts/0/host', ['error_code' => 'host_configuration_invalid']], ['/internal/v1/hosts/hk/host', ['error_code' => 'host_configuration_invalid']], ['/internal/v1/hosts/1/host/extra', ['error_code' => 'host_configuration_invalid']], ['/internal/v1/hosts/1/host?unexpected=true', ['error_code' => 'host_configuration_invalid']], ['/internal/v1/hosts/1/vms', ['error_code' => 'host_configuration_invalid']], ] as [$path, $payload]) { $assert($allowlisted->invoke(null, $path, $payload, 400) === null, 'An unknown code or similar host path crossed the PHP trust boundary.'); } foreach ([500, 502, 503] as $status) { $assert($allowlisted->invoke(null, '/internal/v1/hosts/1/host', [ 'error_code' => 'host_configuration_invalid', 'error' => 'Traceback: host=/root/private key=secret', ], $status) === null, 'A host 5xx response was incorrectly exposed as a client configuration error.'); } $poolPath = '/internal/v1/hosts/42/host/network-pools/' . str_repeat('a', 32); foreach ([400, 409, 422] as $status) { $actual = $allowlisted->invoke(null, $poolPath, [ 'error' => 'Traceback: host=/root/private key=secret', ], $status); $assert($actual === '公网地址池配置未通过引擎校验' && !str_contains($actual, 'private'), 'A public-pool rejection lost its fixed message or leaked raw detail.'); } foreach ([ '/internal/v1/hosts/42/host/network-pools', '/internal/v1/hosts/42/host/network-pools/not-a-key', $poolPath . '?unexpected=true', ] as $path) { $assert($allowlisted->invoke(null, $path, ['error' => 'secret'], 409) === null, 'A similar public-pool path crossed the fixed route boundary.'); } $assert($allowlisted->invoke(null, $poolPath, [ 'error' => 'Traceback: host=/root/private key=secret', ], 500) === null, 'A public-pool 5xx response was incorrectly exposed as a validation error.'); $actor = ['user_id' => 1, 'is_admin' => true, 'can_manage' => true]; $knownClient = new CloudEngineClient(new Client([ new HostErrorTestResponse(400, json_encode([ 'error_code' => 'host_public_gateway_invalid', 'error' => 'Traceback: host=/root/private key=secret', ], JSON_UNESCAPED_UNICODE)), ])); try { $knownClient->request('PUT', '/internal/v1/hosts/1/host', $actor, []); throw new RuntimeException('A reviewed host validation failure did not raise CloudError.'); } catch (CloudError $error) { $assert($error->getMessage() === $messages['host_public_gateway_invalid'] && $error->httpStatus === 400 && !str_contains($error->getMessage(), 'private'), 'A reviewed host error lost its fixed message or original 400 status.'); } $validationClient = new CloudEngineClient(new Client([ new HostErrorTestResponse(422, json_encode([ 'error_code' => 'host_configuration_invalid', 'detail' => [['input' => '-----BEGIN OPENSSH PRIVATE KEY----- secret']], ], JSON_UNESCAPED_UNICODE)), ])); try { $validationClient->request('POST', '/internal/v1/hosts/9/host/test', $actor, []); throw new RuntimeException('A reviewed host payload failure did not raise CloudError.'); } catch (CloudError $error) { $assert($error->getMessage() === $messages['host_configuration_invalid'] && $error->httpStatus === 422 && !str_contains($error->getMessage(), 'PRIVATE KEY'), 'A reviewed host error lost its fixed message or original 422 status.'); } $unknownClient = new CloudEngineClient(new Client([ new HostErrorTestResponse(400, json_encode([ 'error_code' => 'host_traceback', 'error' => 'Traceback: host=/root/private key=secret', ], JSON_UNESCAPED_UNICODE)), ])); try { $unknownClient->request('PUT', '/internal/v1/hosts/1/host', $actor, []); throw new RuntimeException('An unknown host failure did not raise CloudError.'); } catch (CloudError $error) { $assert($error->getMessage() === '虚拟化操作未成功(引擎状态 400)' && !str_contains($error->getMessage(), 'private') && !str_contains($error->getMessage(), '/root'), 'An unknown host error escaped instead of the generic failure.'); } $serverFailureClient = new CloudEngineClient(new Client([ new HostErrorTestResponse(500, json_encode([ 'error_code' => 'host_configuration_invalid', 'error' => 'Traceback: host=/root/private key=secret', ], JSON_UNESCAPED_UNICODE)), ])); try { $serverFailureClient->request('PUT', '/internal/v1/hosts/1/host', $actor, []); throw new RuntimeException('A host engine failure did not raise CloudError.'); } catch (CloudError $error) { $assert($error->getMessage() === '虚拟化操作未成功(引擎状态 500)' && $error->httpStatus === 502 && !str_contains($error->getMessage(), 'private') && !str_contains($error->getMessage(), '/root'), 'A host 5xx response crossed the fixed-message and 502 trust boundary.'); } echo "Cloud host engine error-code contract passed.\n"; }