sunray/coding-standard

The Sunray development coding standard

Maintainers

Details

github.com/sunray/coding-standard

Source

Issues

Installs: 45

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 3

Forks: 0

Open Issues: 0

dev-master 2019-03-07 20:59 UTC

Requires

MIT 0b0737d54d6bc1dfd6c890bc4a2b2f006d066d23

This package is auto-updated.

Last update: 2024-12-08 09:30:58 UTC

README

Downloads License

A coding standard to use for common PHP and JavaScript modules.

The main objectives of this standard are outlined in the Sunray Coding Philosophy which aims to create an efficient development workflow resulting from readable, debuggable, and maintainable code. The general principles are:

PHP

The PHP specific coding standards are outlined in a separate document.

Requirements

  • PHP 7.1+
  • Composer

Installation

  1. Add "sunray/coding-standard": "dev-master" to the require-dev block in your application's composer.json as follows: 
    {
    "require-dev": {
        "sunray/coding-standard": "dev-master"
    }
}
    or automatically: 
    composer require --dev sunray/coding-standard:dev-master

Usage

  1. Create a phpcs.xml file in the root of your application as follows: 
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xml>
<ruleset name="ProjectName">
    <!-- Configure Project Paths -->

    <!-- PHPCS Settings -->
    <arg value="p" />
    <arg value="s" />
    <arg name="basepath" value="." />
    <arg name="colors" />
    <arg name="cache" />
    <arg name="extensions" value="php" />
    <arg name="encoding" value="utf-8"/>
    <arg name="report-width" value="80" />

    <!-- Include the Sunray coding standard -->
    <rule ref="vendor/sunray/coding-standard/ruleset.xml" />
</ruleset>
  2. From your application root execute the following: 
    vendor/bin/phpcs

JavaScript