Add a PHPDoc post

_posts/15-01-01-PHPDoc.md

@@ -0,0 +1,36 @@
+---
+anchor: phpdoc
+---
+
+# PHPDoc {#phpdoc}
+
+PHPDoc is an informal standard for commenting PHP code. There are a *lot* of different [tags](http://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.pkg.html) available. The full list of tags and examples can be found at the [PHPDoc manual](http://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.pkg.html).
+
+Below is an example of how you might comment a class and a method;
+
+{% highlight php %}
+<?php
+/**
+ * @author A Name <a.name@example.com>
+ * @link http://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.link.pkg.html
+ * @package demo
+ */
+class DateTimeHelper
+{
+    /**
+     * @param mixed $anything
+     *
+     * @return \DateTime
+     * @throws \InvalidArgumentException
+     */
+    public static function dateTimeFromAnything($anything) {
+        $type = gettype($anything);
+
+        switch ($type) {
+            case "object":
+                if ($anything instanceof \DateTime) {
+                    return $anything;
+                }
+                break;
+...
+{% endhighlight %}