artisanpack-ui/code-style

A custom PHP code style standard based on PHPStorm settings. This package provides custom sniffs for PHP_CodeSniffer that enforce consistent code style across your PHP projects.

Maintainers

Details

gitlab.com/jacob-martella-web-design/artisanpack-ui/artisanpack-ui-code-style

Source

Issues

Installs: 157

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Forks: 0

Type:phpcodesniffer-standard

1.0.5 2025-06-11 17:52 UTC

Requires

Requires (Dev)

GPL-3.0-or-later 0846b13a2932467e6ef7e4877deabe859b25b113

  • Jacob Martella <me.woop@jacobmartella.com>

This package is auto-updated.

Last update: 2025-09-11 23:31:10 UTC

README

A custom PHP code style standard based on PHPStorm settings. This package provides custom sniffs for PHP_CodeSniffer that enforce consistent code style across your PHP projects.

Installation

You can install the ArtisanPack UI Code Standards package by running the following composer command:

composer require artisanpack-ui/code-style --dev

Usage

Configuration

After installation, you can create a phpcs.xml file in your project root with the following content:

<?xml version="1.0"?>
<ruleset name="YourProjectStandard">
    <description>Your project's coding standard</description>

    <!-- Use ArtisanPackUI standard -->
    <rule ref="ArtisanPackUIStandard"/>

    <!-- Specify paths to check -->
    <file>app</file>
    <file>src</file>
    <file>tests</file>

    <!-- Exclude paths -->
    <exclude-pattern>*/vendor/*</exclude-pattern>
    <exclude-pattern>*/node_modules/*</exclude-pattern>
</ruleset>

Running PHP_CodeSniffer

You can run PHP_CodeSniffer with the ArtisanPackUI standard using the following command:

./vendor/bin/phpcs --standard=ArtisanPackUIStandard .

Or if you've set up a custom phpcs.xml file:

./vendor/bin/phpcs

Custom Sniffs

This package includes 16+ custom sniffs covering:

  • Formatting: Indentation, braces, spacing, alignment
  • Code Structure: Classes, control structures, imports, arrays
  • Naming Conventions: PascalCase for classes, camelCase for functions/variables, snake_case for table columns
  • Security: Input validation, output escaping (see Security Sniffs)
  • Best Practices: Yoda conditionals, type declarations, disallowed functions

For complete details on all sniffs with examples, see the Custom Sniffs Reference.

Customizing Sniffs

You can customize the behavior of the sniffs by overriding their properties in your phpcs.xml file:

<rule ref="ArtisanPackUI.Formatting.Indentation">
    <properties>
        <property name="indent" value="2"/>
    </properties>
</rule>

Documentation

📚 Complete Documentation - Comprehensive guides and references

Quick Links

Contributing

🤝 Contributing Guidelines - How to contribute to the project

As an open source project, this package is open to contributions from anyone. Whether you want to report bugs, suggest features, improve documentation, or contribute code, please read through our comprehensive contributing guidelines.

Additional Resources