asispts/ptscs

PSR-12 coding standard with stricter rules

Installs: 4 854

Dependents: 2

Suggesters: 0

Security: 0

Stars: 2

Watchers: 2

Forks: 0

Open Issues: 2

Type:phpcodesniffer-standard

2.1.1 2025-09-19 16:27 UTC

This package is auto-updated.

Last update: 2025-09-29 03:53:29 UTC


README

ptscs

» PSR-12 coding standard with stricter rules «

 

CI License PHP Version Stable Version Downloads

 

ptscs is a PHP_CodeSniffer ruleset based on PSR-12 with stricter rules for consistency, readability, and best practices.

 

Installation

composer require --dev asispts/ptscs

 

Usage

Create a phpcs.xml.dist file in your project root with the following configuration (customize as needed for your project structure):

<?xml version="1.0" encoding="UTF-8"?>
<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="vendor/squizlabs/php_codesniffer/phpcs.xsd">

  <arg name="colors" />
  <arg name="parallel" value="8" />
  <arg value="psv" />
  <arg name="extensions" value="php" />

  <file>src</file>
  <file>tests</file>

  <exclude-pattern>vendor</exclude-pattern>

  <rule ref="ptscs" />

  <!-- Example: exclude a rule -->
  <!-- (e.g. disable abstract/final requirement in symfony entities) -->
  <rule ref="SlevomatCodingStandard.Classes.RequireAbstractOrFinal">
    <exclude-pattern>src/Entity</exclude-pattern>
  </rule>

  <!-- Example: add an extra rule -->
  <!-- (e.g. enforce namespace matches file name; useful where PHPStan falls short) -->
  <rule ref="SlevomatCodingStandard.Files.TypeNameMatchesFileName">
    <properties>
      <property name="rootNamespaces" type="array">
        <element key="ptscs" value="Ptscs" />
        <element key="tests" value="Ptscs\Tests" />
      </property>
    </properties>
  </rule>
</ruleset>

 

Notable Rules

This coding standard uses PSR-12 with some changes and stricter requirements:

  1. declare(strict_types=1) is required in all PHP files and must be on the same line as the opening tag:
    <?php declare(strict_types=1)
  2. snake_case is allowed in test method names:
    public function test_something(): void {}
  3. All classes must be declared as final or abstract:
    // Not allowed
    class Foobar {}
  4. Filenames must match class names.

See the full list in RULES.md.

 

Contributing

Contributions are welcome! Please open an issue to discuss major changes before submitting a pull request.

 

License

Released under MIT License.