[School 42] Documentation & traits

Doc.trait.php

<?php
trait Doc {

  public static function doc() {
    $filler = str_repeat('-', 80 - strlen(__CLASS__) - 4);

    return '<- ' . __CLASS__ . ' ' . $filler . PHP_EOL
      . file_get_contents(dirname(__FILE__) . '/' . __CLASS__ . '.doc.txt') . PHP_EOL
      . $filler . ' ' . __CLASS__ . ' ->' . PHP_EOL;
  }

}

MyClass.class.php

<?php
require_once dirname(__FILE__) . '/Doc.trait.php'; // In same directory as class files

class MyClass {

  use Doc;

  // [...]
}

MyClass.doc.txt

A class that doesn't do anything.

Call its documentation (MyClass.doc.txt) with:
echo MyClass::doc();

Note that MyClass.doc.txt should not end with an empty line (Git removes them).