Testing
This package provides a consistent set of Composer scripts for local validation. Use a source checkout with PHP 8.3 or later and development dependencies installed. Record the PHP version, resolved dependency revisions, and any symlinked package path before interpreting results.
Tool references:
- Actionlint for GitHub Actions workflow linting.
- Codespell for spelling checks.
- Composer Require Checker for dependency definition checks.
- Easy Coding Standard (ECS) for coding standards.
- EditorConfig Checker for EditorConfig compliance.
- Gitleaks for secret scanning.
- Infection for mutation testing.
- Markdownlint-cli2 for Markdown linting.
- PHPStan for static analysis.
- PHPUnit for unit tests.
- Prettier for Markdown and YAML formatting checks.
- Rector for automated refactoring.
- Yamllint for YAML linting.
- Zizmor for GitHub Actions security audits.
Install and validate
Section titled “Install and validate”composer installcomposer validate --strictcomposer auditDo not bypass security advisories to obtain a successful install. A consuming application should commit its lock file; this library’s local lock file is ignored.
Automated refactoring (Rector)
Section titled “Automated refactoring (Rector)”Run Rector to apply automated code refactoring. This command modifies files.
composer rectorPreview the refactoring without modifying files.
composer rector-checkCoding standards (ECS)
Section titled “Coding standards (ECS)”Check coding standards without modifying files.
composer ecs-checkApply coding standard fixes. Review the changes before keeping them.
composer ecsDependency definition check
Section titled “Dependency definition check”Verify that runtime dependencies are correctly declared in composer.json.
composer check-dependenciesMutation testing (Infection)
Section titled “Mutation testing (Infection)”Run mutation testing.
composer mutationRun mutation testing with PHPStan static analysis enabled.
composer mutation-staticBoth scripts disable Composer’s process timeout, set PHP’s memory limit to unlimited, use four workers, ignore the MSI
when there are no generated mutations, and require 100% MSI and covered MSI. composer mutation-static additionally
enables PHPStan with an unlimited memory limit. infection.json5 defines the source directory, per-test timeout, and
reporting; it does not contain the command-line thresholds. The shared CI workflow receives the same worker and MSI
options. Infection requires an available coverage driver, and a failed or skipped initial suite is not a passing run.
Repository quality checks
Section titled “Repository quality checks”Make the CLI tools used by the shared quality workflow available on PATH: actionlint with its ShellCheck helper,
codespell, EditorConfig Checker, markdownlint-cli2, Prettier, and yamllint. Run all checks:
composer qualityEach tool also has its own script:
composer actionlintcomposer codespellcomposer editorconfig-checkercomposer markdownlintcomposer prettiercomposer yamllintThe linter configuration lives in .github/linters, and the Prettier configuration lives in .prettierrc.json and
.prettierignore. The shared quality workflow uses those exact files.
Static analysis (PHPStan)
Section titled “Static analysis (PHPStan)”Run static analysis.
composer staticUnit tests (PHPUnit)
Section titled “Unit tests (PHPUnit)”Run the full test suite.
composer testsDocumentation and application verification
Section titled “Documentation and application verification”In an application, also verify that every intended runner consumes the required groups, every intended middleware pipeline contains both debugger middleware IDs in package order, an allowed HTML request receives the toolbar and is retained in History, a known log entry appears in Logs with sensitive keys redacted, an unlisted client is denied, and a production process has no debugger integration. Trigger the real application behavior for optional Mail, User, RBAC, Inertia, or Vite panels; panel registration alone does not prove that an event reached its collector.
Skill distribution
Section titled “Skill distribution”Validate skills/yii3-debug-integration/SKILL.md with a compatible Agent Skills validator. Build a Composer archive and
inspect its file list: the skill must be included, while .agents/, .claude/, AGENTS.md, docs/, and any future
examples/ directory must be absent. Test composer skills:show and synchronization in a disposable application with
llm/skills configured. Native client discovery and activation are separate checks from installation and
synchronization.
Workflow security checks
Section titled “Workflow security checks”Make zizmor and Gitleaks available on PATH. Audit the current workflow files with the same pedantic persona used by
the shared security workflow:
composer zizmorScan Git history for secrets with the repository’s Gitleaks configuration:
composer gitleaksRun both checks. Findings make the command fail; inspect them rather than disabling the checks.
composer securityZizmor needs GitHub API access for its online audits. If the tool runs offline, report that limit separately. To request an offline audit explicitly:
composer zizmor -- --offlineReport hosted CI execution and its PHP/OS matrix separately from these local commands. Keep generated reports in
ignored internal/.
Passing extra arguments
Section titled “Passing extra arguments”Composer scripts support forwarding additional arguments using --.
Run PHPUnit with code coverage report generation.
composer tests -- --coverage-html internal/coverageRun PHPStan with a different memory limit.
composer static -- --memory-limit=512M