# core/adapters/tool.phpmd.adapter.ts

> 27 lines of code and 9 definitions.

Tree: GovLab Quality
Language: typescript
Layer: infrastructure
Canonical: https://banes-lab.com/anatomy/quality#file-quality-core-adapters-tool-phpmd-adapter-ts
Source text: https://banes-lab.com/source/quality/core/adapters/tool.phpmd.adapter.ts.txt

Listed in [core/adapters](https://banes-lab.com/api/source/quality/core/adapters.md), after [core/adapters/tool.phpcs.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.phpcs.adapter.ts.md) and before [core/adapters/tool.pmd.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.pmd.adapter.ts.md).

## Definitions

- `runPhpmd` (lexical_declaration, line 17)
- `TOOL` (lexical_declaration, line 12)
- `VIOLATIONS_EXIT` (lexical_declaration, line 13)
- `OK_STATUSES` (lexical_declaration, line 14)
- `DEFAULT_RULESETS` (lexical_declaration, line 15)
- `rulesets` (lexical_declaration, line 18)
- `advisory` (lexical_declaration, line 19)
- `spec` (lexical_declaration, line 20)
- `args` (lexical_declaration, line 26)

## Contained in

- [core/adapters](https://banes-lab.com/anatomy/quality/folder-quality-core-adapters.md)

## Uses

- [core/adapters/tool.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.adapter.ts.md)

## Linked from

- [core/adapters](https://banes-lab.com/anatomy/quality/folder-quality-core-adapters.md)

## Source

```typescript
import { NO_STDERR_DETAIL, installHint, toolErrorBecause } from "#configuration/strings/tool.strings";
import { messageScan, scanTool } from "#core/adapters/tool.adapter";
import type { RunResult } from "#types/finding.types";
import type { RunnerContext } from "#types/tool.types";
import { defineTool } from "#core/registries/tool.registry";
import { gatingAdvisory } from "#core/factories/tool.factory";
import { parsePhpmdOutput } from "#core/parsers/tool.phpmd.parser";
import { stringArrayFieldOr } from "#core/selectors/record.selector";
import { tailLines } from "#core/selectors/failure.selector";
import { toolSection } from "#core/resolvers/tool.resolver";

const TOOL = "phpmd";
const VIOLATIONS_EXIT = 2;
const OK_STATUSES: ReadonlySet<number> = new Set([0, VIOLATIONS_EXIT]);
const DEFAULT_RULESETS = ["codesize", "design", "unusedcode", "naming"];

const runPhpmd = async function runPhpmd(context: RunnerContext): Promise<RunResult> {
    const rulesets = stringArrayFieldOr(await toolSection(context.root, TOOL), "rulesets", DEFAULT_RULESETS);
    const advisory = gatingAdvisory(context, TOOL, installHint(TOOL));
    const spec = messageScan(
        advisory,
        OK_STATUSES,
        (result) => parsePhpmdOutput(result.stdout, context.ecosystem),
        (exit) => toolErrorBecause(TOOL, exit.status, "a bad ruleset", tailLines(exit.stderr, NO_STDERR_DETAIL)),
    );
    const args = [context.paths.join(","), "json", (rulesets.length > 0 ? rulesets : DEFAULT_RULESETS).join(",")];
    return scanTool(advisory, { args, bin: TOOL, cwd: context.root }, spec);
};

defineTool({ ecosystems: ["php"], run: runPhpmd, tool: TOOL });
```