<?php
/**
 * Template
 * @file Template_class.php
 * @author Jaakko S
 * @version 0.2
 * @access public
 **/
class Template{

        var $_muuttujat;
        var $_cached;
        var $_cachedir;
 
 
        function Template(){
              $this->_muuttujat=array();
                 $this->_cached = false;
                 $this->_cachedir = 'cache/';
        }

        /**
         * Asettaa cachen päälle/pois
         *
         **/
        function setCached($arvo=false){
                $this->_cached = $arvo;
        }

        function isCached(){
                return $this->_cached;
        }
        /**
         * Asettaa hakemiston johon kakutetut templatet tallennetaan.
         *
         **/
        function setCachedir($arvo){
                if (strlen(strrchr($arvo,'/'))!=1) {
                    $arvo .= '/';
                }
                $this->_cachedir = $arvo;
        }

        /**
         * Tyhjentää cachen, eli poistaa kaikki cache päätteiset tiedostot
         * $this->_cachedir muuttujan määrittelemästä hakemistosta
         **/
        function tyhjenna_cache(){
                if (is_dir($this->_cachedir)) {
                  if ($d = opendir($this->_cachedir)) {
          while (($f = readdir($d)) !== false) {
                                //Poistetaan ainoastaan tiedostot joiden pääte on .cache
                                        if (is_file($this->_cachedir.$f) && substr($f, strrpos($f, '.') + 1)=='cache')
                                                unlink($this->_cachedir.$f);
          }
         closedir($d);
                  }
                }
        }

        /**
         *
         * Tallentaa parametrina annetun muuttujan templaten muuttujataulukkoon.
         * $arvo parametri voi olla mikä tahansa muuttuja, taulukko tai olio.
         * $nimi on templatelle näkyvä muuttujan nimi
          *
         **/
        function aseta_muuttuja($arvo,$nimi){
        $this->_muuttujat[$nimi]=$arvo;
        }
        
        /**
         *
         * Lisää parametrina annetun taulukon alkiot templaten muuttujataulukkoon.
         *
         **/
        function aseta_muuttujat_taulukkona($taulukko){
               $this->_muuttujat = array_merge($this->_muuttujat,$taulukko);
        }
        
        /**
         *
         * Käy läpi muuttujataulukon rekursiivisesti ja muuntaa mahdolliset erikoismerkit html-entiteeteiksi.
         *
         **/
        function muunna_erikoismerkit(){
               
                function magic_entities($element){
                if (is_array($element)){
                 return array_map("magic_entities", $element);
                }
                        elseif (is_object($element)){
                                $jasenet = get_object_vars($element);
                                foreach($jasenet as $nimi => $arvo ){
                                        if (is_string($element->$nimi)) {
                                                $element->$nimi = htmlentities($arvo);
                                        }
                                }
                                return $element;
                        }
                        else{
                                return htmlentities($element);
                        } 
                }
        
                $this->_muuttujat = array_map("magic_entities", $this->_muuttujat);
        }
        
        /**
         *
         * Suorittaa/tulostaa parametrina annetun templatetiedoston.
         * Jos cache on päällä ensimmäisellä kerralla tallennetaan template cacheen
          * Ja seuraavilla kerroilla käytetään cachesta löytynyttä templatea
         **/
        function suorita($template){
        // Tähän voidaan listätä funktiokirjastoja jotka halutaan templatetiedostojen käyttöön.
        //    require_once(html_generointi.inc.php');

                if ($this->_cached) {
                        $cachetemplate = $this->_cachedir.basename($template).'.cache';
                    if (file_exists($cachetemplate)) {
                        require_once($cachetemplate);
                                return;
                    }
                        else{
                                extract($this->muuttujat,EXTR_REFS);
                                ob_start();
                                require_once($template);
                                $f = fopen($cachetemplate,'w');
                                fwrite($f, ob_get_flush());
                                fclose($f);
                                return;
                        }
                }

                extract($this->_muuttujat,EXTR_REFS);
             require_once($template);
        }
}
?>

************** ESIMERKKI *****************
(jossa ei ole mitään järkeä)

<?php
require_once('template_class.php');

$t =& new Template();

$taulukko = array('1' => 'yksi','2' => 'kaksi','3'=> 'kolme','4'=> 'neljä');
$olio->muuttuja = 'Tähän erikoismerkkejä <textarea>  </textarea>';

//Alustetaan muuttujat templatelle
$t->aseta_muuttuja('oletusarvo','syote');
$t->aseta_muuttuja($olio,'olio');
$t->aseta_muuttuja('Otsikkohan tämä','otsikko');
$t->aseta_muuttuja($taulukko,'numerot');

//Jos syöte on 'testi' muutetaan otsikkoa
if (isset($_POST['syote']) && $_POST['syote'] == 'testi') {
    $t->aseta_muuttuja('Näin se homma etenee.','otsikko');
}else{ //Muuten jätetään arvo entiselleen.
        $t->aseta_muuttujat_taulukkona($_POST); //Kaikki POST taulukon muuttujat templaten käyttöön.
}
$t->muunna_erikoismerkit(); //Muunnetaan html-entiteetit
$t->suorita('esimerkki.tpl.php');
?>

********** TEMPLATE TIEDOSTO *************
esimerkki.tpl.php

<HTML>
<HEAD>
        <TITLE><?=$otsikko?></TITLE>
</HEAD>
<BODY>
<h2><?=$otsikko?></h2>

<?php foreach($numerot as $numero){ ?>
        <br><?=$numero ?>
<?php } ?>
<br>
<br>

<?=$olio->muuttuja?>

<FORM action="<?=$_SERVER['PHP_SELF']?>" method="post">
        Arvo tulee POST taulukosta: <INPUT type="text" name="syote" value="<?=$syote?>"/>
        <INPUT type="submit" name="laheta" value="Laheta" />
</FORM>

</BODY>
</HTML>