class DiagnosticResult

Properties

bool $fixable

Whether this result represents an outcome the diagnostic can fix.

EnvironmentMode> $fixableEnvironments

The environment modes in which the diagnostic's fix may be applied.

string|null $details
string|null $remediation

The remediation message for the result.

$links

The related links for the result.

array<string, mixed> $context

The structured context for the result.

string|null $confirmation
array<string, string> $fixOptions

The choices for the diagnostic's fix, keyed by option value.

string|null $fixDeclineLabel

The label for the select entry that declines a fix offering options.

Methods

__construct(Status $status, string $summary, string|null $code = null)

Create a new diagnostic result instance.

pass(string $summary = 'Passed', string|null $code = null)

Create a passing diagnostic result.

warn(string $summary, string|null $code = null)

Create a warning diagnostic result.

notice(string $summary, string|null $code = null)

Create a notice diagnostic result.

fail(string $summary, string|null $code = null)

Create a failing diagnostic result.

skip(string $summary, string|null $code = null)

Create a skipped diagnostic result.

error(string $summary, string|null $code = null)

Create an error diagnostic result.

withDetails(string $details)

Add evidence to the diagnostic result.

suggest(string $message)

Add remediation text to the diagnostic result.

confirmUsing(string $prompt)

Set the confirmation prompt for the diagnostic fix.

fixable(EnvironmentMode ...$environments)

Mark this result as eligible for the diagnostic's fix.

fixOptions(array $options, string|null $decline = null)

Offer a choice of repairs for the diagnostic's fix.

bool
fixableIn(EnvironmentMode $environment)

Determine whether the fix may be applied in the given environment mode.

link(Link $link)

Add a related link to the diagnostic result.

withContext(string $key, mixed $value)

Add context to the diagnostic result.

Details

at line 70
__construct(Status $status, string $summary, string|null $code = null)

Create a new diagnostic result instance.

Parameters

Status $status
string $summary
string|null $code

at line 80
static DiagnosticResult pass(string $summary = 'Passed', string|null $code = null)

Create a passing diagnostic result.

Parameters

string $summary
string|null $code

Return Value

DiagnosticResult

at line 88
static DiagnosticResult warn(string $summary, string|null $code = null)

Create a warning diagnostic result.

Parameters

string $summary
string|null $code

Return Value

DiagnosticResult

at line 96
static DiagnosticResult notice(string $summary, string|null $code = null)

Create a notice diagnostic result.

Parameters

string $summary
string|null $code

Return Value

DiagnosticResult

at line 104
static DiagnosticResult fail(string $summary, string|null $code = null)

Create a failing diagnostic result.

Parameters

string $summary
string|null $code

Return Value

DiagnosticResult

at line 112
static DiagnosticResult skip(string $summary, string|null $code = null)

Create a skipped diagnostic result.

Parameters

string $summary
string|null $code

Return Value

DiagnosticResult

at line 120
static DiagnosticResult error(string $summary, string|null $code = null)

Create an error diagnostic result.

Parameters

string $summary
string|null $code

Return Value

DiagnosticResult

at line 132
DiagnosticResult withDetails(string $details)

Add evidence to the diagnostic result.

Prefer message tokens for short identifying values like versions, paths, constraints, or counts. Use details for unbounded or multi-line evidence such as exception messages, process output, and bullet lists.

Parameters

string $details

Return Value

DiagnosticResult

at line 142
DiagnosticResult suggest(string $message)

Add remediation text to the diagnostic result.

Parameters

string $message

Return Value

DiagnosticResult

at line 152
DiagnosticResult confirmUsing(string $prompt)

Set the confirmation prompt for the diagnostic fix.

Parameters

string $prompt

Return Value

DiagnosticResult

at line 162
DiagnosticResult fixable(EnvironmentMode ...$environments)

Mark this result as eligible for the diagnostic's fix.

Parameters

EnvironmentMode ...$environments

Return Value

DiagnosticResult

at line 176
DiagnosticResult fixOptions(array $options, string|null $decline = null)

Offer a choice of repairs for the diagnostic's fix.

Parameters

array $options

labels keyed by option value

string|null $decline

label for the entry that declines the fix

Return Value

DiagnosticResult

at line 187
bool fixableIn(EnvironmentMode $environment)

Determine whether the fix may be applied in the given environment mode.

Parameters

EnvironmentMode $environment

Return Value

bool

Add a related link to the diagnostic result.

Parameters

Link $link

Return Value

DiagnosticResult

at line 207
DiagnosticResult withContext(string $key, mixed $value)

Add context to the diagnostic result.

Parameters

string $key
mixed $value

Return Value

DiagnosticResult