silverassist/coding-standards

Framework-agnostic PHPCS ruleset (PSR-12 + PHPDoc enforcement) and PHPStan base config shared by all Silver Assist PHP projects, WordPress or not.

1.0.0 2026-08-12 16:54 UTC

Requires

• php: >=8.2
• squizlabs/php_codesniffer: ^3.7 || ^4.0

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^1.0
• phpstan/phpstan: ^2.1

PolyForm-Noncommercial-1.0.0

• Silver Assist

Published on Packagist.org on 2026-08-12 16:56 UTC

README

Framework-agnostic PHPCS ruleset (PSR-12 + mandatory PHPDoc) and a PHPStan base config, shared by every Silver Assist PHP project — WordPress plugin or not.

This package intentionally has zero WordPress dependencies. WordPress plugins should require silverassist/wp-coding-standards instead, which requires this package and layers WordPress-Extra, i18n, and naming-convention sniffs on top.

Install

composer require --dev silverassist/coding-standards

Usage — PHPCS

Create a phpcs.xml in your project (this package never scans files itself — it only ships the rule definitions):

<?xml version="1.0"?>
<ruleset name="YourProject">
    <arg name="colors"/>
    <arg value="p"/>
    <config name="php_version" value="80200"/>

    <file>src</file>

    <rule ref="SilverAssist"/>
</ruleset>

Run it:

vendor/bin/phpcs

Migrating a legacy codebase

If PHPDoc type-hint enforcement is too strict for code that hasn't been typed yet (see senioradvicecom-wp's strangler-fig migration), exclude just those two sub-sniffs locally:

<rule ref="SilverAssist">
    <exclude name="Squiz.Commenting.FunctionComment.TypeHintMissing"/>
    <exclude name="Squiz.Commenting.FunctionComment.ScalarTypeHintMissing"/>
</rule>

Usage — PHPStan

# phpstan.neon
includes:
    - vendor/silverassist/coding-standards/phpstan/base.neon

parameters:
    paths:
        - src
    bootstrapFiles:
        - bootstrap.php

Legacy projects that can't yet run at level 8 can override it after the include:

includes:
    - vendor/silverassist/coding-standards/phpstan/base.neon

parameters:
    level: 6
    paths:
        - src
    includes:
        - phpstan-baseline.neon

What's deliberately NOT here

• WordPress sniffs (WordPress-Extra, i18n, escaping/sanitization, PrefixAllGlobals) — see silverassist/wp-coding-standards.
• The LoadableInterface / Plugin::instance() bootstrap pattern — see silverassist/wp-plugin-kernel.
• CI/CD workflow templates — those live in silverassist/wp-coding-standards too, since the reference implementations (WordPress Test Suite matrix, release ZIP building) are WordPress-plugin specific. A non-WP project like senioradvicecom-wp runs PHPCS/PHPStan/PHPUnit directly in its own pipeline instead of via a reusable workflow.

See also

• AGENTS.md — instructions for AI coding agents working in this repo.