Initial commit of MessageCloud Coding Standard.

Author: Ethan Bray

.gitignore

@@ -0,0 +1,2 @@
+.idea
+/vendor/

README.md

@@ -0,0 +1,36 @@
+# MessageCloud Coding Standard
+
+The PHP coding standard for MessageCloud.
+
+## Installation
+
+1. Require the package in your `composer.json`:
+```json
+{
+  "repositories": [
+    {
+      "type": "vcs",
+      "url": "[email protected]:MessageCloud/messagecloud-coding-standard.git"
+    }
+  ],
+  "require-dev": {
+    "messagecloud/messagecloud-coding-standard": "^1.0"
+  }
+}
+```
+
+2. Create a PHP Code Sniffer configuration file `phpcs.xml`:
+```xml
+<?xml version="1.0"?>
+<ruleset name="MessageCloud Coding Standard">
+    <rule ref="./vendor/messagecloud/messagecloud-coding-standard/ruleset.xml"/>
+
+    <!-- Path to check -->
+    <file>./src</file>
+    
+     <!-- Allow test methods to be snake case -->
+     <rule ref="PSR1.Methods.CamelCapsMethodName">
+        <exclude-pattern>./test</exclude-pattern>
+     </rule>
+</ruleset>
+```

composer.json

@@ -0,0 +1,13 @@
+{
+    "name": "messagecloud/messagecloud-coding-standard",
+    "description": "MessageCloud Coding Standard",
+    "require": {
+        "squizlabs/php_codesniffer": "^3.0"
+    },
+    "authors": [
+        {
+            "name": "Ethan Bray",
+            "email": "[email protected]"
+        }
+    ]
+}

ruleset.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0"?>
+<ruleset name="MessageCloud Coding Standard">
+    <description>MessageCloud PHP Coding Standard. Essentially PSR2 with some modifications.</description>
+
+    <arg name="colors"/>
+    <arg value="p"/>
+
+    <!-- PSR2 extends PSR1 -->
+    <rule ref="PSR2"/>
+    <rule ref="Generic.Arrays.DisallowLongArraySyntax"/>
+
+    <!--Extend the line length warning and error to 130 characters -->
+    <rule ref="Generic.Files.LineLength">
+        <properties>
+            <property name="lineLimit" value="130"/>
+            <property name="absoluteLineLimit" value="130"/>
+        </properties>
+    </rule>
+
+    <!--
+    We exclude the PSR2 Use Declaration rule as it clashes with PHP7 style grouped Use statements.
+    This is supposedly being fixed in a proposed PSR (https://github.com/php-fig/fig-standards/blob/master/proposed/extended-coding-style-guide.md)
+    so we'll keep our eye on this.
+     -->
+    <rule ref="PSR2.Namespaces.UseDeclaration">
+        <exclude-pattern>*</exclude-pattern>
+    </rule>
+</ruleset>