Tutorial:'Templating' auf Basis von sprintf

<?
class MyError
  {
  static $sFormat = '%6$s %2$s (error %1$d) in %4$s line %5$d'; // Logline format, swapped arguments
  static $sLogfile = 'path/to/logfile';
 
  public function __construct ($iType , $sMessage , $aBackTrace , $sFile , $sLine)
    {
    $this->iType = $iType;
    $this->sMessage = $sMessage;
    $this->aBackTrace = $aBackTrace;
    $this->sFile = $sFile;
    $this->sLine = $sLine;
    }
 
  static function create ($iType , $sMessage)
    {
    // get BackTrace, File, Line ...
    return (new MyError ($iType , $sMessage , $aBackTrace , $sFile , $sLine));
    }
 
  public function log ()
    {
    $sMessage = sprintf (self::$sFormat ,
                         $this->iType ,
                         $this->sMessage ,
                         $this->aBackTrace ,
                         $this->sFile ,
                         $this->sLine ,
                         date ('Y-m-d H:i:s') );
    // check log file ...
    error_log ($sMessage , 3 , self::$sLogfile);
    }
  }

<?
define ('PRINT_FORMATTED_TAG_MIN_LENGTH' , 1);
 
/*
string = vsprintf_assoc (string Format , array Settings)
 
    Liefert einen formatierten String, dessen Platzhalter mit Werten
    aus Settings gefüllt wurden. Die Funktion ist weitgehend identisch
    mit vsprintf (), lediglich die Art der Platzhalter ist anders.
 
    Die Platzhalter wurden hier zu 'sprechenden' Bezeichnern erweitert,
    die den Schlüsseln des assoziativen Arrays Settings entsprechen. 
    Die Platzhalter-Syntax entspricht derjenigen von printf, die Platzhalter 
    werden durch die jeweiligen Array Schüssel und ein abschließendes % Zeichen 
    ersetzt. Die Funktionalität bleibt erhalten.
 
    Bsp.
 
      vsprintf Syntax
      ('%02d Personen namens %s' , array (7 , 'Heinz'));
 
      vsprintf_assoc Syntax
      ('%02dAnzahl% Personen namens %sName%' , 
       array ('Anzahl' => 7 , 'Name' => 'Heinz'));
 
    vsprintf_assoc unterstützt auch Array-Werte in beliebiger Dimension. Wichtig
    ist hierbei, die Platzhalterangabe ohne Leerzeichen zwischen Variablennamen 
    und Klammer zu machen (ebenso zwischen Klammern mehrdimensionaler Angaben).
 
      ('%dAnzahl% Tage: %sTag[0]%, %sTag[1]%' , 
       array ('Anzahl' => 2 , 'Tage' => array ('Montag' , 'Mittwoch')));
 
 
    Parameter:            Format       Formatstring, siehe Beschreibung
                                       und printf Syntaxschema
                          Settings     assoziatives Array
    Abhängigkeiten:       PRINT_FORMATTED_TAG_MIN_LENGTH
                                       definiert die minimale Länge für 
                                       Variablennamen
    Rückgabe:             String mit in die Platzhalter eingesetzten Werten.
    Hinweise:             - Diese Funktion unterstützt kein Argument swapping 
                          im Formatstring (ist ja auch nicht sinnvoll)!
                          - Zur Performancesteigerung generiert die Funktion für
                          jeden neuen Formatstring eine eigene Lambdafunktion,
                          die sie selbst verwaltet.
                          - Auf abschließende % achten! Fehlende % werden mit 
                          einem 'Too few arguments' Warning quittiert
--------------------------------------------------------------------------- */
function vsprintf_assoc ($sFormat , $aSettings)
  {
  static $aLambda = array ();
 
  $sIndex = md5 ($sFormat);
 
  # -- passende Lambda Funktion noch nicht vorhanden
  if (false === isset ($aLambda[$sIndex]))
    {
    # -- Suchpattern für Platzhalter
    $sPattern = '#(%[\-\+]?(?:\s|0|\\\'.)?\-?\d*(?:\.\d+)?[bcdeufFosxX])' .
                '([_A-Za-z][_A-Za-z0-9]{' . 
                min (PRINT_FORMATTED_TAG_MIN_LENGTH - 1 , 0) . 
                ',}(?:\[\d+\]|\[[\\\'\\"][^\\\'\\"]+?[\\\'\\"]\])*)%#';
 
    # -- Platzhalter suchen
    preg_match_all ($sPattern , $sFormat , $aOrder);
 
    # -- Parameterliste für Lambda Funktion zusammenstellen
    #    führendes Komma als Komma zwischen Formatstring und 1. Parameter
    $sParameters = '';
    foreach ($aOrder[2] as $sVariable)
      {
      $sParameters .= ',$' . $sVariable;
      }
 
    # -- Body der Lambda Funktion:
    #    extract ($aSettings);
    #    return (sprintf (...));
    $sFuncBody = 'extract($aSettings); return (sprintf (\'' . 
                  # -- ' escapen
                  addcslashes (
                              # -- Platzhalter auf printf Format reduzieren
                              str_replace ($aOrder[0] , $aOrder[1] , $sFormat) ,
                              '\'' 
                              ) . 
                  '\' ' . $sParameters . '));';
 
    # -- Lambda Funktion erstellen und im static Array speichern
    $aLambda[$sIndex] = create_function ('$aSettings' , $sFuncBody);
    }
 
  return ($aLambda[$sIndex] ($aSettings));
  }