1. Go to this page and download the library: Download neooblaster/template library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
neooblaster / template example snippets
<select>
<!-- BEGIN_PHP DAY_NUMBER -->
$_PHP['DAY_LANG'] = 'jour'; // Donnée passé du côté du script, mais ici pour la démo
for($i = 1; $i < 32; $i++){
$ext = ($i == 1) ? 'er' : 'em';
echo "<option value="\"$i\"">$i$ext ".$_PHP['DAY_LANG']."</option>";
}
<!-- END_PHP DAY_NUMBER -->
</select>
function remove_folder($folder_path){
/** Se positionner sur le dossier **/
$ouverture=@opendir($folder_path);
/** Si l'ouverture à échouée, le dossier n'existe pas ou n'est pas un dossier **/
if (!$ouverture) return;
/** Lire son contenu **/
while($fichier=readdir($ouverture)) {
/** Si ce sont les références UNIX, on skip **/
if ($fichier == '.' || $fichier == '..') continue;
/** Si c'est un dossier, on entre en recursion **/
if (is_dir($folder_path."/".$fichier)) {
remove_folder($folder_path."/".$fichier);
}
/** Sinon c'est un fichier, on le supprimer **/
else {
@unlink($folder_path."/".$fichier);
}
}
/** Ferme le pointeur **/
closedir($ouverture);
/** Enfin on supprime le dossier**/
@rmdir($folder_path);
}
/** CHARGEMENT DE LA CLASSE "Template" **/
= new Template();
/** Configuration de base du moteur. **/
/** --- --- --- OBLGATOIRE --- --- --- **/
/** > Rappel, ces paramètres seul suffisent pour que le moteur fonctionne **/
/** - Indication du modèle à utiliser : **/
$moteur->set_template_file('Mes Modeles/fiche_utilisateur.tpl');
/** - Alternative à un fichier template : Une chaine de caractère (texte) **/
// $moteur->set_template_text('Je veux renderiser ce %TEXT% !');
/** - Indication du nom de sortie du fichier : **/
$moteur->set_ouput_name('ficher_utilisateur_2014.html');
/** Configuration "Pseudo-facultative" **/
/** --- --- --- PSEUDO-FACULATIF --- --- --- **/
/** > Rappel, ces paramètres sont pseudo-facultatif, car ils envoient les données qui remplacerons vos variables **/
/** > $variables est là pour schématiser. C'est votre programme qui générera son contenu **/>
$variables = Array();
/** - Envois des données simples : **/
$moteur->set_vars($variables);
/** Configuration des autres paramètres - Affinage de la config du moteur **/
/** --- --- --- --- --- --- --- --- FACUTLATIF --- --- --- --- --- --- --- --- **/
/** - Re-définition du délimiteur de variables : **/
$moteur->set_vars_delim('%'); // Ici on ré-applique le même délims
/** Dans le cas d'un délimiteur de plusieurs caractères **/
/** Seul le symbôle d'ouverture est à définir. Le modèle fermant se compose de lui-même **/
/** Ce ne sont que des exemples **/
$moteur->set_vars_delim('{'); // Utilisation des crochets comme délimiteur >>> {VARIABLE}
$moteur->set_vars_delim('('); // Utilisation des parenthèse comme délimiteur >>> (VARIABLE)
$moteur->set_vars_delim('{('); // Utilisation Combinées >>> {(VARIABLE)}
/** - Configuration du mode de rendu à "permanent" (production de document) **/
$moteur->set_render_type('permanent'); // Valeur possible : temporary, permanent
/** - Définition du dossier de dépot de document final **/
$moteur->set_output_directories('Mes Documents', 'Archives'); // Au minimum un dossier doit être indiqué
/** - Définition du dossier temporaire de travail **/
$moteur->set_temporary_repository('Temps');
/** - Forcer la concervation des fichiers temporaire pour analyser, etude ou debug **/
$moteur->set_keep_temp_file(true); // Par défaut vaut "false"
/** - Définir le type de traiment de caractère lors de l'écriture du document **/
$moteur->set_utf8_write_treatment('none'); // Valeurs possible : none, encode, decode
/** - Définir le type de traiment de caractère lors de la lecture du document **/
$moteur->set_utf8_read_treatment('none'); // Valeurs possible : none, encode, decode
/** - Définition des destinataires lors de l'envois de mail **/
$moteur->set_mail_recipients('[email protected]', '[email protected]', '[email protected]');
/** - Définition de l'objet du mail lors de l'envois de mail **/
$moteur->set_mail_subject('Fichier utilisateur de 2014');
/** - Définition de l'adresse mail de l'émetteur si vous permettez le reply to **/
$moteur->set_mail_sender('[email protected]');
/** - Définition du nom de l'emetteur afficher dans le client de messagerie **/
$moteur->set_mail_sender_name('ressource-humaine de company');
/** EXECUTION DU MOTEUR **/
/** 1. Génération du document **/
$moteur->render();
/** 2. Afficher le document **/
$moteur->display();
/** 3. Envoyer un mail **/
$moteur->sendMail();
/** 4. Récupérer le contenu pour le stocker en BDD **/
$to_bdd = $moteur->get_render_content();
/** EXECUTION DU MOTEUR **/
/** Génère le document et affiche le **/
$moteur->render()->display();
$moteur->set_template_file('Templates/var_bloc.tpl');
$moteur->set_output_name('var_bloc.html');
/** Données à envoyer au moteur **/
$prisonnier = array(
// @Données Globales
'PRI_ID' => '123456789',
'PRI_NOM' => 'Time',
'PRI_PRENOM' => 'Vincent',
'PRI_AGE' => '33',
'PRI_TAILLE' => '172',
// @Données Cloisonnées
// CRIMES = Nom du block concerné
'CRIMES' => array(
// Ce tableau compose le premier tour du bloc
array(
// Couple "Variable -> valeur" pour le premier tour uniquement
'CRIME_DATE' => '01.11.2014',
'CRIME_NAME' => 'Vol à main armée',
'CRIME_AMENDE' => '30000',
'CRIME_PEINE' => '3 ans'
),
// Ce tableau compose le second tour du bloc
array(
// Couple "Variable -> valeur" pour le second tour uniquement
'CRIME_DATE' => '01.11.2013',
'CRIME_NAME' => 'Vol à l\'étalage',
'CRIME_AMENDE' => '500',
'CRIME_PEINE' => '6 mois avec sursis'
)
)
);
/** Envois des données au moteur **/
$moteur->set_vars($prisonnier);
$moteur->render()->display();
$moteur->set_template_file('Templates/var_bloc_i.tpl');
$moteur->set_output_name('var_bloc_i.html');
$prisonnier = array(
// @Global
'PRI_ID' => '123456789',
'PRI_NOM' => 'Time',
'PRI_PRENOM' => 'Vincent',
'PRI_AGE' => '33',
'PRI_TAILLE' => '172',
// @Closure
// CRIMES = Nom du bloc concernée
'CRIMES' => array(
array(
// @Global in @Closure
'CRIME_DATE' => '01.11.2014',
'CRIME_NAME' => 'Vol à main armée',
'CRIME_AMENDE' => '30000',
'CRIME_PEINE' => '3 ans',
// @Closure in @Closure
// COMPLICE = Nom du bloc imbriqué dans CRIMES
'COMPLICES' => array(
// Donnée du complice numéro 1
array(
// @Global in @Closure where is in @closure
'COMPLICE_ID' => '234567891',
'COMPLICE_NOM' => 'Du Jardin',
'COMPLICE_PRENOM' => 'Jean'
),
// Donnée du complice numéro 2
array(
// @Global in @Closure where is in @closure
'COMPLICE_ID' => '3456789121',
'COMPLICE_NOM' => 'Reno',
'COMPLICE_PRENOM' => 'Jean'
),
// Donnée du complice numéro 3
array(
// @Global in @Closure where is in @closure
'COMPLICE_ID' => '456789123',
'COMPLICE_NOM' => 'Les Noix',
'COMPLICE_PRENOM' => 'Jean-Jacques'
)
)
),
array(
'CRIME_DATE' => '01.11.2013',
'CRIME_NAME' => 'Vol à l\'étalage',
'CRIME_AMENDE' => '500',
'CRIME_PEINE' => '6 mois avec sursis',
'COMPLICES' => array()
)
)
);
$moteur->set_vars($prisonnier);
$moteur->render()->display();
$moteur->set_template_file('utf8_explain.tpl');
$moteur->set_output_name('Render/utf8_explain.html');
/** Force le décodage des caractères UTF-8 dans le document finalisé **/
/** Le fichier passe de l'encodage ANSI à ANSI as UTF-8 **/
/** De cette manière l'UTF-8 est déjà décoder et on peut l'afficher simple **/
$moteur->set_utf8_write_treatment('decode'); // Valeurs admise : none, encode, decode
$moteur->render()->display();
# Créer un premier rendu avec un jeu de donnée initial
$moteur->set_vars([
'NOM' => 'DUPRE',
'PRENOM' => 'Nicolas'
]);
$moteur->render()->display();
# Créer un second rendu
$moteur->update_vars([
'PRENOM' => 'Julien',
'AGE' => 29
]);
# Jeu de donnée effectif :
# NOM = DUPRE
# PRENOM = Julien
# AGE = 29
$moteur->render()->display();
$moteur->set_vars([
'SIGNED' => true
'ADMIN' => false
]);
$moteur->xor_vars('SIGNED');
# La valeur SIGNED vaut maintenant FALSE
# Nom de clé purement imaginaire
$moteur->xor_vars(
'SIGNED',
'ADMIN',
[
'ARTICLE_1_READ',
'ARTICLE_2_READ',
'ARTICLE_2_READ'
],
'GRANTED'
);
$moteur->set_vars([
'SIGNED' => true
'ADMIN' => false
]);
$moteur->unset_vars('ADMIN');
# Le registre ne contient plus que la variable SIGNED
$moteur->help();
/** Invocation de la méthode "debugPath" **/
$moteur->debugPath();
/** Génération de la configuration JSON **/
/** (....) **/
/** Récupération du contenu calculé **/
$sse_output = $moteur->get_render_content();
/** Suppression des EOL de la chaine **/
$sse_output = str_replace("\t", "", $sse_output);
$sse_output = str_replace("\n", "", $sse_output);
$sse_output = str_replace("\r", "", $sse_output);
/** Envois des entêtes **/
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
/** Envois du contenu **/
echo "data: $sse_output\n\n";
echo "retry: ".SSE_RETRY."\n";
/** Demande de conservation des fichiers temporaires **/
$moteur->set_keep_temp_file(true);
/** Passer le moteur en tant que générateur de document **/
$moteur->set_render_type('permanent'); // Accepte permanent & temporary
/** Définition du ou des dossiers de dépot (destination) **/
/** Si le script executant la classe se trouve dans le dossier "Appli" **/
/** Les dossiers indiqués doivent se trouver eux-même dans "Appli" **/
$moteur->set_output_directories('Services/Compta', 'Archives/Services/Compta');
/** Utiliser le dossier "Temps" pour créer les environnements de travail temporaire **/
$moteur->set_temporary_repository('Temps'); // Pas de slash de fermeture
/** Fin du script : Afficher les warnings rencontrés **/
$moteur->show_warnings();
/** "Nettoyage" du dossier temporaire **/
$moteur->remove_folder('Temps');
/** Re-création du dossier "Temps" **/
mkdir("Temps", 0705);
`
┌ 03. Classe Template/
└─┬ Classes/
└ Templates/
Template.class.php
Une première ligne comportant une %VARIABLE% valide.
Un seconde ligne avec une autre %variable% valide.
L'ensemble des %variables% du modèle doivent être délimitées avec le même symbôle.
Exemple de délimiteur accepté : %VAR%, @VAR@, $VAR$, _VAR_, -VAR-
Les {ACCOLADES}, les (PARENTHESES) et les [CROCHETS] sont pris en charge.
Ces exemple là sont aussi valables : {{VARIABLE}}, {[VARIABLE]} et {AZ_VARIABLES_ZA}
Cette %VARIABLE est fausse, car ne dispose que d'un seul symbôle.Le tout est vu comme du simple texte.
Cette %VARIABLE@ est fausse, car ne respecte pas l'ordre inverse du délimiteur. Le tout est vu comme du simple texte.
Cette {VARIABLE{ est fausse, car ne respecte pas l'ordre inverse du délimiteur. Le tout est vu comme du simple texte.
Cette VARIABLE n'en est pas une, car ne dispose d'aucun délimiteur !
html
<!-- IF (%CONDITIONS%) AS NOM_TEST_CONDITIONNEL -->
L'utilisateur fait partie du groupe "Admin", il à donc les droits d'accéder à ce contenu :
(...)
<!-- ENDIF NOM_TEST_CONDITIONNEL -->
html
Si ALLOWED = true;
<!-- IF (%ALLOWED%) AS NOM_TEST_CONDITIONNEL --> alors le contenu est affiché
<!-- IF (!%ALLOWED%) AS NOM_TEST_CONDITIONNEL --> alors le contenu est ignoré
Si ALLOWED = false;
<!-- IF (%ALLOWED%) AS NOM_TEST_CONDITIONNEL --> alors le contenu est ignoré
<!-- IF (!%ALLOWED%) AS NOM_TEST_CONDITIONNEL --> alors le contenu est affiché
Si LEVEL = 1
<!-- IF (%LEVEL% > 0) AS NOM_TEST_CONDITIONNEL --> alors le contenu est affiché
<!-- IF (%LEVEL% < 0) AS NOM_TEST_CONDITIONNEL --> alors le contenu est ignoré
Si LEVEL = -1
<!-- IF (%LEVEL% > 0) AS NOM_TEST_CONDITIONNEL --> alors le contenu est ignoré
<!-- IF (%LEVEL% < 0) AS NOM_TEST_CONDITIONNEL --> alors le contenu est affiché
Si ALLOWED = TRUE
Si LEVEL = 1
<!-- IF (%ALLOWED% AND (%LEVEL% > 0)) AS NOM_TEST_CONDITIONNEL --> alors le contenu est affiché
Si ALLOWED = TRUE
Si LEVEL = -1
<!-- IF (%ALLOWED% AND (%LEVEL% > 0)) AS NOM_TEST_CONDITIONNEL --> alors le contenu est ignoré
Si ALLOWED = FALSE
Si LEVEL = 1
<!-- IF (%ALLOWED% AND (%LEVEL% > 0)) AS NOM_TEST_CONDITIONNEL --> alors le contenu est ignoré
`html
DÉCLARATION D'UN BLOCK DE CODE REPETABLE :
<!-- BEGIN_DECLARE (BLOCK) AS NOM_DU_BLOCK -->
Le contenu entre les deux balises sera traité de la même manière qu'un bloc introduit par <!-- BEGIN_BLOCK -->
Notez d'ailleurs que nous ne retrouvons pas les balises du bloc répétable puisque nous sommes en train de le déclarer !
<!-- END_DECLARE NOM_DU_BLOCK -->
`html
DÉCLARATION D'UN BLOCK DE CODE PHP :
<!-- BEGIN_DECLARE (PHP) AS NOM_DU_BLOCK_PHP -->
Le contenu entre les deux balises sera traité de la même manière qu'un bloc PHP introduit par <!-- BEGIN_PHP -->
Notez d'ailleurs que nous ne retrouvons pas les balises du bloc PHP puisque nous sommes en train de le déclarer !
<!-- END_DECLARE NOM_DU_BLOCK_PHP -->
`html
DÉCLARATION D'UN BLOCK CONDITIONNEL
<!-- BEGIN_DECLARE (IF->(%CONDITION%)) AS NOM_DU_BLOCK_CONDITIONNEL -->
La balise d'ouverture du bloc conditionnel est assimilée par l'instruction de déclaration.
Tout comme la balise de fermeture.
Mais pour les cas alternatif "ELSEIF" et "ELSE",
ces instructions doivent être écrite comme dans un <!-- IF (X) AS Y -->
<!-- ELSE -->
Si condition indiquée non remplie, alors c'est cette partie là qui sera affichée
<!-- END_DECLARE NOM_DU_BLOCK_CONDITIONNEL -->
`html
INSTRUCTION D'INCLUSION DE MODELE
<!-- INCLUDE_TEMPLATE (%TEMPLATE_PATH_AND_FILE%) -->
`html
<h1>Fiche Prisonnier N° 123456789</h1>
<ul>
<li>Prénom : Vincent.</li>
<li>Nom : Time.</li>
<li>Age : 33 ans.</li>
<li>Taille : 172 cm.</li>
</ul>
<h2>Crimes :</h2>
<ul>
<li>Le 01.11.2014 : Vol à main armée -> 30000 € - 3 ans - Complice : </li>
<ul>
<li>234567891 : Jean Du Jardin</li>
<li>3456789121 : Jean Reno</li>
<li>456789123 : Jean-Jacques Les Noix</li>
</ul>
<li>Le 01.11.2013 : Vol à l'étalage -> 500 € - 6 mois avec sursis - Complice : </li>
<ul>
<li>04081111215 : Pierre Les Pruniers</li>
</ul>
</ul>
`
La méthode admet en plus le paramètre facultatif ``$strip_blank`` par défaut valant ``false``.
Elle permet d'utiliser dans la foulée de la méthode ``strip_blank`` une fois dépourvue des
commentaire.
#### La méthode statique ``cleanse_sql``
A la manière de la méthode ``cleanse_js``,
la classe ``Template`` dispose de la méthode statique ``cleanse_sql`` qui
a pour but de nettoyer un fichier ou un texte **SQL** de ses commentaires.
La différence est que les commentaires sont autorisés et pas forcément gênant.
Néanmois, utilisée avec l'argument facutlatif ``$strip_blank = true``, cela permet de minifier
le fichier.
et
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.