Update for SAND app with APP STATE (OPEN CLOSED MAINTAINED)

This commit is contained in:
Emmanuel ROY 2022-03-21 16:03:31 +01:00
parent 10bc015688
commit cbcb0eb22f
58 changed files with 2094 additions and 144 deletions

View file

@ -26,8 +26,21 @@ class Application
$this->url = new Url($this->http->method, $this->browser->isAppRequest());
$dispacher = new Dispacher();
$this->route = $dispacher->route;
switch(APP_STATE) {
case "CLOSED":
case "MAINTAINED":
$this->route = null;
break;
case "OPEN":
if(\MVC\Classe\Application::is_under_update()) {
$this->route = null;
break;
}
default:
$dispacher = new Dispacher();
$this->route = $dispacher->route;
}
}
public function launch()
@ -40,4 +53,15 @@ class Application
\MVC\Object\Alert::remove();
}
}
public static function is_under_update(){
$ajh = new \DateTime('NOW');
$maintenance_begin = new \DateTime(MAINTENANCE_DATE_DEBUT);
$maintenance_fin = new \DateTime(MAINTENANCE_DATE_FIN);
if($maintenance_begin < $ajh && $ajh < $maintenance_fin) {
return true;
}else{
return false;
}
}
}

View file

@ -210,10 +210,22 @@ class Browser
public function isAppRequest()
{
if (preg_match('#App#', $this->user)) {
return true;
} else {
return false;
switch(APP_STATE) {
case "CLOSED":
case "MAINTAINED":
return false;
break;
case "OPEN":
if(\MVC\Classe\Application::is_under_update()) {
return false;
break;
}
default:
if (preg_match('#App#', $this->user)) {
return true;
} else {
return false;
}
}
}
}

View file

@ -62,6 +62,22 @@ class Url
unset($urlParts[1]);
}
//Mise en place du statut de l'application
switch(APP_STATE){
case "CLOSED":
$page['name'] = "error-application-closed";
break;
case "MAINTAINED":
$page['name'] = "error-application-maintained";
break;
case "OPEN":
if(\MVC\Classe\Application::is_under_update()) {
$page['name'] = "error-application-maintained";
break;
}
default:
}
//vérification du nombre de parametres:
$numParts = count($urlParts);
//s'il n'existe pas autant de clé que de valeurs, ce peut ^etre un module symfony ou tout autre module

View file

@ -1,5 +1,6 @@
<?php
// De base laisser vide,
// sauf si l'application est hebergé sur de multiples sous-repertoire en ajoutant le slash_final
// par exemple : "my-app/"
@ -7,6 +8,16 @@
define("BASE_SERVER_DIRECTORY", "");
// Optionnel! il n'est nécessaire que si vous l'utilisez dans les fichiers de traitement ou dans une commande console
define('PATH_URL',"http://www.domain.org/");
define('PATH_URL', $_SERVER['REQUEST_SCHEME'] . "://localhost.localdomain");
define('ENV', "DEV", true);
//Possible values are DEV DEVEL PROD PREPROD TEST
//only PROD send email to right user
define('ENV', "DEV");
//Possible values are OPEN CLOSED MAINTAINED
define('APP_STATE', "OPEN");
define('MAINTENANCE_DATE_DEBUT', '2021-07-30 12:00');
define('MAINTENANCE_DATE_FIN', '2021-07-30 14:00');
define('MAINTENANCE_MESSAGE', "Mise à jour de la base de données");

View file

@ -0,0 +1,6 @@
<?php
define('LDAP_USER','cn=name, ou=group, dc=domain, dc=tld');
define('LDAP_PASSWORD','password');
define('LDAP_URL',"ldap://ldap.domain.tld");
define('LDAP_PORT',"389");

View file

@ -0,0 +1,5 @@
<?php
/**
* Controlleur permettant d'afficher la page d'erreur lors d'une fermeture de l'application
*/

View file

@ -0,0 +1,5 @@
<?php
/**
* Controlleur permettant d'afficher la page d'erreur lors d'une maintenance de l'application
*/

View file

@ -1 +1,6 @@
<?php
/**
* Controlleur permettant d'afficher la page d'erreur 404 page inexistante
*/

View file

@ -0,0 +1,6 @@
name : error-application-closed
page_title : Page de fermeture de l'application
description : UFC - Page de fermeture de l'application
engine : blade
authentification : no

View file

@ -0,0 +1,6 @@
name : error-application-maintained
page_title : Page de maintenance de l'application
description : UFC - Page de maintenance de l'application
engine : blade
authentification : no

View file

@ -0,0 +1,165 @@
{{-- Vue Blade de la page d'erreur lors d'une fermeture de l'application--}}
@extends('body-nomenu')
@section('content')
<div id="access-denied">
<div class="container">
<h1>:) Oops!</h1>
<h2>Temporairement fermée</h2>
<h3>L'application est de retour bientôt!</h3>
<p>
Désolé pour cette gêne mais il se trouve que l'application est fermée à ce moment !
<br/>
Le service
<br/>
<a href="mailto:application@localhost.fr">application@localhost.fr</a>
</p>
<br /><br />
<br /><br />
<div id="gears">
<svg version="1.1" id="svg-animation-example" class="svg-line-drawing rtl-magazine-animation" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0" y="0" width="720" height="310" viewBox="0 0 720 310" xml:space="preserve" aria-hidden="true" >
<defs>
<clipPath id="mask-page">
<path class="stroke-alt stroke-width linecap" d="m240,275 l240,0 0,-217 -240,0z" />
</clipPath>
</defs>
<!-- content page -->
<g clip-path="url(#mask-page)">
<g class="ani-move-page is-animated">
<!-- section one -->
<path class="stroke stroke-width linecap" d="m0,275 m254,-203 l212,0 0,112 -212,0z" fill="none" />
<path class="stroke-alt stroke-width linecap" d="m0,275 m272,-172 a13 13 180 0 1 26,0 a13 13 180 0 1 -26,0" fill="none" />
<path class="stroke stroke-width linecap" d="m0,275 m254,-203 m22,112 l34,-44 a9 9 180 0 1 13,-1 l15,16 38,-48 a5 5 180 0 1 8.4,0 l60,77" fill="none" />
<path class="stroke stroke-width linecap" d="m0,275 m254,-67 l212,0 m-212,10 l54,0 m25,0 l54,0 m25,0 l54,0 m-212,10 l54,0 m25,0 l54,0 m25,0 l54,0" fill="none" />
<!-- button section one -->
<path class="stroke stroke-width linecap" d="m350,250 a10 10 180 0 1 20,0 a10 10 180 0 1 -20,0 m6.8,-1.7 l3.2,3.2 3.2,-3.2" fill="none" />
<path class="stroke stroke-width linecap" d="m318,290 l0,430" fill="none" />
<path class="stroke stroke-width linecap" d="m333,306 l54,0 m-54,10 l54,0 m-54,10 l133,0 m-133,10 l133,0" fill="none" />
<path class="stroke stroke-width linecap" d="m333,356 l133,0 0,78 -133,0 0,-78 m0,90 l54,0 m-54,10 l54,0 m-54,20 133,0 0,78 -133,0 0,-78 m0,90 l54,0 m-54,10 l54,0 m-54,20 133,0 0,78 -133,0 0,-78 m0,90 l54,0 m-54,10 l54,0 m-54,20" fill="none" />
<!-- section two -->
<path class="stroke stroke-width linecap" d="m0,680 m0,275 m254,-203 l212,0 0,112 -212,0z" fill="none" />
<path class="stroke-alt stroke-width linecap" d="m0,680 m0,275 m272,-172 a13 13 180 0 1 26,0 a13 13 180 0 1 -26,0" fill="none" />
<path class="stroke stroke-width linecap" d="m0,680 m0,275 m254,-203 m22,112 l34,-44 a9 9 180 0 1 13,-1 l15,16 38,-48 a5 5 180 0 1 8.4,0 l60,77" fill="none" />
<path class="stroke stroke-width linecap" d="m0,680 m0,275 m254,-67 l212,0 m-212,10 l54,0 m25,0 l54,0 m25,0 l54,0 m-212,10 l54,0 m25,0 l54,0 m25,0 l54,0" fill="none" />
<!-- button section two -->
<path class="stroke stroke-width linecap" d="m0,680 m350,250 a10 10 180 0 1 20,0 a10 10 180 0 1 -20,0 m6.8,-1.7 l3.2,3.2 3.2,-3.2" fill="none" />
</g>
<g class="ani-move-menu is-animated">
<g>
<path class="stroke stroke-width linecap" d="m254,306 l54,0 m-54,10 l54,0 m-54,10 l54,0 m-54,10 l54,0" fill="none" />
</g>
</g>
</g>
<!-- fade button -->
<g class="ani-fade-button is-animated" opacity="0" >
<path class="stroke-background stroke-overlay linecap" d="m350,250 a10 10 180 0 1 20,0 a10 10 180 0 1 -20,0 m6.8,-1.7 l3.2,3.2 3.2,-3.2" fill="none" />
<path class="stroke-alt stroke-width linecap" d="m350,250 a10 10 180 0 1 20,0 a10 10 180 0 1 -20,0 m6.8,-1.7 l3.2,3.2 3.2,-3.2" fill="none" />
</g>
<!-- baseline -->
<path class="stroke stroke-width linecap" d="m0,275 l240,0 0,-230 a5 5 90 0 1 5,-5 l230,0 a5 5 90 0 1 5,5 l0,230 240,0" fill="none" />
<path class="stroke stroke-width linecap" d="m0,275 m240,-217 l240,0" fill="none" />
<path class="stroke stroke-width linecap" d="m0,275 m240,-226 m10,0 a4 4 180 0 1 8,0 a4 4 180 0 1 -8,0 m14,0 a4 4 180 0 1 8,0 a4 4 180 0 1 -8,0 m14,0 a4 4 180 0 1 8,0 a4 4 180 0 1 -8,0" fill="none" />
<defs>
<style>
.svg-line-drawing {
width: 100%;
}
.svg-line-drawing .stroke-background {
stroke: #eddd3e;
}
.svg-line-drawing .stroke {
stroke: #12353C;
}
.svg-line-drawing .stroke-alt {
stroke: #ffffff;
}
.svg-line-drawing .stroke-width {
stroke-width: 2;
}
.svg-line-drawing .stroke-overlay {
stroke-width: 3;
}
.svg-line-drawing .linecap {
stroke-linecap: round;
stroke-linejoin: round;
}
.rtl-magazine-animation .ani-fade-button,
.rtl-magazine-animation .ani-move-page,
.rtl-magazine-animation .ani-move-menu {
-webkit-animation-duration: 5500ms;
animation-duration: 5500ms;
-webkit-animation-timing-function: ease;
animation-timing-function: ease;
-webkit-animation-delay: 100ms;
animation-delay: 100ms;
-webkit-animation-iteration-count: infinite;
animation-iteration-count: infinite;
}
.rtl-magazine-animation .ani-fade-button {
-webkit-animation-name: fade-button;
animation-name: fade-button;
}
.rtl-magazine-animation .ani-move-page {
-webkit-animation-name: move-page;
animation-name: move-page;
}
.rtl-magazine-animation .ani-move-menu {
-webkit-animation-name: move-menu;
animation-name: move-menu;
}
@-webkit-keyframes fade-button {
0%, 12%, 100% { opacity: 0; }
9%, 11% { opacity: 1; }
}
@keyframes fade-button {
0%, 12%, 100% { opacity: 0; }
9%, 11% { opacity: 1; }
}
@-webkit-keyframes move-page {
0%, 14%, 100% { -webkit-transform: translateY(0px); -webkit-animation-timing-function: ease-in; }
28% { -webkit-transform: translateY(-220px); -webkit-animation-timing-function: linear; }
80%, 99.9999% { -webkit-transform: translateY(-680px); -webkit-animation-timing-function: linear; }
}
@keyframes move-page {
0%, 14%, 100% { transform: translateY(0px); animation-timing-function: ease-in; }
28% { transform: translateY(-220px); animation-timing-function: linear; }
80%, 99.9999% { transform: translateY(-680px); animation-timing-function: linear; }
}
@-webkit-keyframes move-menu {
0%, 14%, 100% { -webkit-transform: translateY(0px); -webkit-animation-timing-function: ease-in; }
28%, 68.6957% { -webkit-transform: translateY(-220px); -webkit-animation-timing-function: linear; }
80% { -webkit-transform: translateY(-320px); -webkit-animation-timing-function: linear; }
99.9999% { -webkit-transform: translateY(-680px); -webkit-animation-timing-function: linear; }
}
@keyframes move-menu {
0%, 14%, 100% { transform: translateY(0px); animation-timing-function: ease-in; }
28%, 68.6957% { transform: translateY(-220px); animation-timing-function: linear; }
80% { transform: translateY(-320px); animation-timing-function: linear; }
99.9999% { transform: translateY(-680px); animation-timing-function: linear; }
}
</style>
</defs>
</svg>
</div>
</div>
</div>
@endsection

View file

@ -0,0 +1,612 @@
{{-- Vue Blade de la page d'erreur lors d'une maintenance de l'application--}}
@extends('body-nomenu')
@section('top-css')
@parent
<style>
.crane__list,
.skyscrappers__list,
.tree__container {
position: absolute;
width: 100%;
bottom: 0;
}
.advice {
display: flex;
height: 50vh;
width: 100vw;
flex-flow: column nowrap;
justify-content: center;
align-items: center;
}
.advice__title {
font-size: 3rem;
text-align: center;
}
.advice__description {
margin-top: 1rem;
font-size: 2rem;
text-align: center;
}
.advice__description span:first-child {
margin-right: -0.7rem;
}
.advice__description span:last-child {
margin-left: -0.7rem;
}
.city-stuff {
display: flex;
position: absolute;
justify-content: center;
width: 100%;
height: 100%;
bottom: 0;
overflow: hidden;
box-shadow: inset 0 -60px 0 -30px #969696;
left: 0px;
}
.skyscrappers__list {
width: 100%;
height: 86.6666666667px;
left: 0;
}
.skyscrappers__list .skyscrapper__item {
position: absolute;
height: inherit;
bottom: 15%;
width: 43.3333333333px;
background: linear-gradient(115deg, #969696 73%, #7d7d7d 73%, #7d7d7d 100%);
}
.skyscrappers__list .skyscrapper__item::after {
content: "";
position: absolute;
width: 80%;
height: 80%;
left: 10%;
bottom: 10%;
background: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAMAAAAGCAYAAAAG5SQMAAAAFElEQVQImWP4////fwYYIJKDEwAAfPsP8eFXG40AAAAASUVORK5CYII=") space;
}
.skyscrappers__list .skyscrapper__item:last-child:not(:only-child) {
background: #969696;
}
.skyscrappers__list .skyscrapper-1 {
width: 121.3333333333px;
height: 138.6666666667px;
right: 25%;
bottom: 0;
z-index: 10;
transform: rotate(180deg);
}
@media screen and (max-width: 450px) {
.skyscrappers__list .skyscrapper-1 {
display: none;
}
}
.skyscrappers__list .skyscrapper-2 {
width: 60.6666666667px;
height: 69.3333333333px;
right: 35%;
bottom: 0;
z-index: 10;
transform: rotate(180deg);
bottom: 10%;
}
@media screen and (max-width: 900px) {
.skyscrappers__list .skyscrapper-2 {
display: none;
}
}
@media screen and (max-width: 450px) {
.skyscrappers__list .skyscrapper-1 {
display: none;
}
}
.skyscrappers__list .skyscrapper-3 {
width: 40.4444444444px;
height: 46.2222222222px;
right: 45%;
bottom: 0;
z-index: 10;
transform: rotate(180deg);
height: 115.5555555556px;
}
@media screen and (max-width: 900px) {
.skyscrappers__list .skyscrapper-3 {
display: none;
}
}
@media screen and (max-width: 450px) {
.skyscrappers__list .skyscrapper-1 {
display: none;
}
}
.skyscrappers__list .skyscrapper-4 {
width: 30.3333333333px;
height: 34.6666666667px;
right: 55%;
bottom: 0;
z-index: 10;
transform: rotate(180deg);
height: 86.6666666667px;
}
.skyscrappers__list .skyscrapper-4::after {
width: 20%;
height: 60%;
left: 25%;
}
@media screen and (max-width: 450px) {
.skyscrappers__list .skyscrapper-1 {
display: none;
}
}
.skyscrappers__list .skyscrapper-5 {
width: 24.2666666667px;
height: 27.7333333333px;
right: 65%;
bottom: 0;
z-index: 10;
transform: rotate(180deg);
width: 7%;
right: 67%;
height: 50%;
z-index: 11;
}
.skyscrappers__list .skyscrapper-5::after {
height: 0;
}
@media screen and (max-width: 450px) {
.skyscrappers__list .skyscrapper-1 {
display: none;
}
}
.crane-cabin, .crane-arm, .crane-picker {
transform-origin: 80% center;
-webkit-animation: crane__movement 12s infinite alternate;
animation: crane__movement 12s infinite alternate;
}
.crane__list {
width: 260px;
height: 173.3333333333px;
z-index: 0;
perspective: 600px;
}
.crane__list .crane__item {
position: absolute;
border: solid 1px #969696;
border-radius: 2px;
}
.crane__list .crane-cable {
width: 1px;
height: 1px;
border: none;
outline: 1px solid transparent;
background: #969696;
z-index: 0;
}
.crane__list .crane-cable-1 {
width: 60%;
top: 0;
left: 11%;
transform-origin: right 0;
-webkit-animation: cable-1__movement 12s infinite alternate;
animation: cable-1__movement 12s infinite alternate;
}
.crane__list .crane-cable-2 {
width: 19%;
top: 0;
right: 8%;
transform-origin: top left;
-webkit-animation: cable-2__movement 12s infinite alternate;
animation: cable-2__movement 12s infinite alternate;
}
.crane__list .crane-cable-3 {
height: 30%;
top: 22%;
left: 9%;
transform-origin: right center;
-webkit-animation: cable-3__movement 12s ease-in-out infinite alternate;
animation: cable-3__movement 12s ease-in-out infinite alternate;
}
.crane__list .crane-cable-3::after {
content: "";
display: block;
position: absolute;
height: 0.2em;
width: 9000%;
bottom: 0;
left: -4500%;
background: #c9c9c9;
border: 1px solid #969696;
}
.crane__list .crane-stand {
width: 5%;
height: 100%;
right: 25%;
z-index: 1;
background: linear-gradient(to top, #969696, #e3e3e3);
}
.crane__list .crane-weight {
width: 8%;
height: 20%;
right: 4%;
top: 12%;
z-index: 2;
background: #d6d6d6;
transform-origin: 0 center;
-webkit-animation: crane-weight__movement 12s infinite alternate;
animation: crane-weight__movement 12s infinite alternate;
}
.crane__list .crane-cabin {
width: 12%;
height: 9%;
right: 24%;
top: 20%;
z-index: 2;
background: #d6d6d6;
}
.crane__list .crane-cabin::after {
content: "";
display: block;
position: absolute;
width: 100%;
height: 10%;
top: 60%;
left: 0;
background: white;
}
.crane__list .crane-arm {
width: 100%;
height: 7%;
top: 15%;
border-top-left-radius: 10px;
z-index: 3;
background: #d6d6d6;
}
.crane-1 {
left: 20%;
z-index: 10;
}
.crane-2 {
left: 30%;
z-index: 10;
bottom: -1rem;
z-index: -1;
transform: scale(0.75) scaleX(-1);
}
@media screen and (max-width: 900px) {
.crane-2 {
display: none;
}
}
.crane-2 .crane-cable-3 {
-webkit-animation-delay: 3s;
animation-delay: 3s;
}
.crane-3 {
left: 40%;
z-index: 10;
bottom: -0.5rem;
transform: scale(0.8);
}
@media screen and (max-width: 900px) {
.crane-3 {
z-index: -1;
transform: scale(0.75) scaleX(-1);
}
}
@media screen and (max-width: 900px) {
.crane-3 {
display: none;
}
}
.crane-3 .crane-cable-3 {
-webkit-animation-delay: 4.5s;
animation-delay: 4.5s;
}
.tree__container {
width: 100%;
height: 62.6666666667px;
left: 0;
margin-bottom: 4px;
}
.tree__item {
display: flex;
flex-flow: column nowrap;
position: absolute;
justify-content: flex-end;
align-items: center;
left: 60%;
}
.tree__trunk {
order: 2;
display: block;
position: absolute;
width: 4px;
height: 8px;
margin-top: 8px;
border-radius: 2px;
background: #57473d;
}
.tree__leaves {
order: 1;
position: relative;
border-top: 0 solid transparent;
border-right: 4px solid transparent;
border-bottom: 32px solid #969696;
border-left: 4px solid transparent;
}
.tree__leaves::after {
content: "";
position: absolute;
height: 100%;
left: -4px;
border-top: 0;
border-right: 0;
border-bottom: 32px solid #7d7d7d;
border-left: 4px solid transparent;
}
.tree-1 {
left: 66%;
}
@media screen and (max-width: 768px) {
.tree-1 {
display: none;
}
}
.tree-2 {
left: 67%;
}
@media screen and (max-width: 768px) {
.tree-2 {
display: none;
}
}
.tree-4 {
left: 57%;
}
.tree-5 {
left: 58%;
}
.tree-7 {
left: 51%;
}
@media screen and (max-width: 450px) {
.tree-7 {
display: none;
}
}
.tree-8 {
left: 52%;
}
@media screen and (max-width: 450px) {
.tree-8 {
display: none;
}
}
@-webkit-keyframes cable-1__movement {
0%, 20% {
transform: rotateY(0) rotateZ(-10deg);
}
70%, 100% {
transform: rotateY(45deg) rotateZ(-10deg);
}
}
@keyframes cable-1__movement {
0%, 20% {
transform: rotateY(0) rotateZ(-10deg);
}
70%, 100% {
transform: rotateY(45deg) rotateZ(-10deg);
}
}
@-webkit-keyframes cable-2__movement {
0%, 20% {
transform: rotateY(0) rotateZ(29deg);
}
70%, 100% {
transform: rotateY(15deg) rotateZ(29deg);
}
}
@keyframes cable-2__movement {
0%, 20% {
transform: rotateY(0) rotateZ(29deg);
}
70%, 100% {
transform: rotateY(15deg) rotateZ(29deg);
}
}
@-webkit-keyframes cable-3__movement {
0% {
transform: translate(0, 0);
}
20% {
transform: translate(2500%, -18%);
}
60% {
transform: translate(11000%, -25%);
}
70% {
height: 30%;
transform: translate(9100%, -25%);
}
90%, 100% {
height: 80%;
transform: translate(9100%, -15%);
}
}
@keyframes cable-3__movement {
0% {
transform: translate(0, 0);
}
20% {
transform: translate(2500%, -18%);
}
60% {
transform: translate(11000%, -25%);
}
70% {
height: 30%;
transform: translate(9100%, -25%);
}
90%, 100% {
height: 80%;
transform: translate(9100%, -15%);
}
}
@-webkit-keyframes crane__movement {
0%, 20% {
transform: rotateY(0);
}
70%, 100% {
transform: rotateY(45deg);
}
}
@keyframes crane__movement {
0%, 20% {
transform: rotateY(0);
}
70%, 100% {
transform: rotateY(45deg);
}
}
@-webkit-keyframes crane-weight__movement {
0%, 20% {
transform: rotateY(0) translateX(0);
}
70%, 100% {
transform: rotateY(45deg) translateX(-50%);
}
}
@keyframes crane-weight__movement {
0%, 20% {
transform: rotateY(0) translateX(0);
}
70%, 100% {
transform: rotateY(45deg) translateX(-50%);
}
}
</style>
@endsection
@section('content')
<div id="access-denied" style="overflow: hidden;">
<div class="container">
<h1>:) Oops!</h1>
<br /><br />
<h2>Temporairement fermée pour maintenance</h2>
@if(\MVC\Classe\Application::is_under_update())
<pre>{{MAINTENANCE_MESSAGE}}</pre>
@endif
<br /><br />
<h3>L'application est de retour bientôt!</h3>
<p>
Désolé pour cette gêne mais il se trouve que l'application est en maintenance à ce moment !
<br/>
Le service
<br/>
<a href="mailto:application@localhost.fr">application@localhost.fr</a>
</p>
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<div id="gears">
<section class="city-stuff">
<ul class="skyscrappers__list">
<li class="skyscrapper__item skyscrapper-1"></li>
<li class="skyscrapper__item skyscrapper-2"></li>
<li class="skyscrapper__item skyscrapper-3"></li>
<li class="skyscrapper__item skyscrapper-4"></li>
<li class="skyscrapper__item skyscrapper-5"></li>
</ul>
<ul class="tree__container">
<li class="tree__list">
<ul class="tree__item tree-1">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
<ul class="tree__item tree-2">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
<ul class="tree__item tree-3">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
<ul class="tree__item tree-4">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
<ul class="tree__item tree-5">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
<ul class="tree__item tree-6">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
<ul class="tree__item tree-7">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
<ul class="tree__item tree-8">
<li class="tree__trunk"></li>
<li class="tree__leaves"></li>
</ul>
</li>
</ul>
<ul class="crane__list crane-1">
<li class="crane__item crane-cable crane-cable-1"></li>
<li class="crane__item crane-cable crane-cable-2"></li>
<li class="crane__item crane-cable crane-cable-3"></li>
<li class="crane__item crane-stand"></li>
<li class="crane__item crane-weight"></li>
<li class="crane__item crane-cabin"></li>
<li class="crane__item crane-arm"></li>
</ul>
<ul class="crane__list crane-2">
<li class="crane__item crane-cable crane-cable-1"></li>
<li class="crane__item crane-cable crane-cable-2"></li>
<li class="crane__item crane-cable crane-cable-3"></li>
<li class="crane__item crane-stand"></li>
<li class="crane__item crane-weight"></li>
<li class="crane__item crane-cabin"></li>
<li class="crane__item crane-arm"></li>
</ul>
<ul class="crane__list crane-3">
<li class="crane__item crane-cable crane-cable-1"></li>
<li class="crane__item crane-cable crane-cable-2"></li>
<li class="crane__item crane-cable crane-cable-3"></li>
<li class="crane__item crane-stand"></li>
<li class="crane__item crane-weight"></li>
<li class="crane__item crane-cabin"></li>
<li class="crane__item crane-arm"></li>
</ul>
</section>
</div>
</div>
</div>
@endsection

View file

@ -0,0 +1,227 @@
# Comment installer le framework
## Préambule
Tout d'abord avant de tenter quoi que soit au niveau de l'installation du framework, veuillez prendre en considération ces quatre(4) questions :
Avez-vous installé le logiciel de virtualisation docker ?
Avez-vous installé le logiciel de gestionnaire de version git ?
Avez-vous installé et utilisez-vous le language php au minimum dans sa version 7.4 ?
Avez-vous installé le logiciel de dépendances composer ?
Si la réponse est oui à ces quatre(4) questions alors vous êtes prêt à utiliser ce framework, même si vous ne connaissez pas les frameworks php tel que laravel ou symfony. Et dans ce cas ce sera peut-être pour vous une bonne introduction aux manipulations avancées qu'il est possible de faire avec ces imposants mastodontes.
Pour installer ces quatre(4) composantes nécessaires sous Windows je ne peut que vous donner les liens et vous inviter à consulter les quelques documentations disponible onTheWeb à ce sujet.
Le plus simple pour installer [docker](https://docs.docker.com/) est de se rendre sur [https://hub.docker.com/](https://hub.docker.com/) et de vous créer un compte, il sera obligatoire afin d'obtenir les images docker nécessaires lors de l'installation. Puis installer docker desktop disponible sous [https://hub.docker.com/editions/community/docker-ce-desktop-windows](https://hub.docker.com/editions/community/docker-ce-desktop-windows)
Le plus simple pour installer [git](https://git-scm.com/doc) est de vous rendre sur [https://gitforwindows.org/](https://gitforwindows.org/) et de suivre la procédure d'installation.
Afin de vous aider à installer [php](https://www.php.net/docs.php) facilement vous pouvez utiliser le gestionnaire fournit avec windows : `Microsoft Web Platform installer` disponible à l'adresse [https://docs.microsoft.com/en-us/iis/install/web-platform-installer/web-platform-installer-direct-downloads](https://docs.microsoft.com/en-us/iis/install/web-platform-installer/web-platform-installer-direct-downloads) , une autre manière serait de récupérer [l'archive windows de la version de php](https://windows.php.net/download) qui vous intéresse et de la placer à la racine `C:` et d'ajouter le `PATH` de l'executable `php.exe` dans les variables d'environnement, ainsi dans la console `git-bash` fourni avec git-for-windows vous pourrez commencez à utiliser php en ligne de commande... et Sandyes (le petit nom du sablier de SAND) aime la ligne de commande :)
Enfin pour installer [composer](https://getcomposer.org/doc/) vous pouvez vous rendre sur [https://getcomposer.org/](https://getcomposer.org/)
Voilà vous avez tout [pour commencer à jouer avec le framework](https://sourcesup.renater.fr/wiki/mvc-sand-frame/installdokerlamp) :) Enfin presque...
Vous êtes un linuxien ? cela ne devrait pas vous poser de problèmes alors ? Si ? Dites les man-pages vous connaissez ? Si la réponse est non il vous faudra apprendre la base de tout ce qui existe du monde libre. Dans le cas contraire normalement le gestionnaire de dépendance de votre distribution doit vous permettre de faire le reste, il vous faudra alors lui demander à installer les paquets suivants :
`php8`-full (avec nécessairement les modules ldap, gd, mysql, pdo, zip, xml, et quelques autres que j'aurais oublié lors de cette écriture nocturne)
par exemple : ````apt install php8.0-common php8.0-mysql php8.0-ldap php8.0-xml php8.0-xmlrpc php8.0-curl php8.0-gd php8.0-imagick php8.0-cli php8.0-dev php8.0-imap php8.0-mbstring php8.0-opcache php8.0-soap php8.0-zip php8.0-intl -y````
`docker`
`docker-compose`
par exemple : ````apt install docker docker-compose -y````
`git`
par exemple : ````apt install git -y````
`composer`
par exemple : ````apt install composer -y````
et gros un `apt-get install` ou un `apt install` ou un `yum install` ou un `pacman -S` ou encore `yahourt -S` vous suffira dans bien des cas. A moins que vous soyez sur une distribution spéciale que j'affectionne mais que je n'ai pas réussi à virtualiser par manque de temps [GUIX](https://guix.gnu.org/), à ce moment-là je vous laisse faire : cela ne devrai pas vous poser trop de problèmes...
## Voyons maintenant comment installer l'environnement ainsi que le framework SAND avant de développer et de comprendre ses mécanismes
Afin de pouvoir démarrer un projet SAND, vous devez mettre en place votre environnement de développement. Un bon IDE est déja la base nécessaire afin de programmer. Certains choisissent Eclipse, je vous conseillerais la version [PDT de Eclipse](https://www.eclipse.org/pdt/) qui est spécialisée PHP. D'autres vont vouloir programmer avec [VisualStudioCode](https://code.visualstudio.com/), qui est open source et permet grâce à ses nombreux modules de gérer à la fois `docker` et `git` tout en se concentrant sur ses lignes de programmation. Pour les plus passionnés : vous pouvez tester puis acheter une version annuelle de [PHPStorm](https://www.jetbrains.com/fr-fr/phpstorm/) ou [ZendStudio](https://www.zend.com/products/zend-studio) de puissants IDE provenant des plus grosses communautés de programmeurs PHP passionnées : ce sont les meilleurs sur le marché actuel. Aussi vous pouvez utiliser des éditeurs plus simples tels que [Sublime Text](https://www.sublimetext.com/) ou [Scite](https://www.scintilla.org/SciTE.html) ou encore [Notepad++](https://notepad-plus-plus.org/downloads/). C'est à vous de voir ce qui vous convient le mieux actuellement.
**Entrons maintenant dans le vif du sujet :**
Commençons par cloner le dépot docker nécessaire au framework par la commande `git clone` :
`git clone https://anonymous@git.renater.fr/authscm/eroy5/git/mvc-sand-frame/docker-lamp.git`
puis déplacez-vous dans le dossier www par la commande `cd` :
`cd docker-lamp/www`
et cloner le dépot du framework dans ce dossier sous le nom my-new-project-directory par la commande `git clone` :
`git clone https://anonymous@git.renater.fr/authscm/eroy5/git/mvc-sand-frame/mvc-sand-frame.git my-new-sand-projet-directory`
Voilà vous avez le nécessaire pour scruter le code du Framework et consulter les quelques documentations primales qui se trouvent dans le dossier `www/my-new-sand-projet-directory/data/docs`
## Comment configurer l'environnement afin de commencer à consulter l'interface de base de SAND
Voilà vous avez cloner les dépôts de base, mais il faut maintenant les configurer afin d'obtenir votre première page sur un navigateur. Pour cela nous allons mettre en place la configuration de docker-compose, puis faire le lien avec le dépôt du framework proprement dit.
tout d'abord, veuillez renommer le fichier `sample.env` en `.env` qui est nécessaire afin de définir les variables environnement de `docker-compose` :
`cd ../ mv sample.env .env`
De base, ce fichier comporte les bonnes variables d'environnement pour lancer l'image nécessaire sur windows et linux. En ouvrant le fichier `.env`, vous avez le loisir de modifier les ports de phpmyadmin et du serveur mysql. Plus d'informations sont disponible dans le fichier `README.md`
Je ne peut que vous conseiller d'ouvrir les fichiers `.env` et `docker-compose.yml` après avoir lu le README, et si vous êtes familier avec les lignes de commandes `bash` ce devrait être possible pour vous de comprendre la liaison intime entre ces deux fichiers. En effet, `docker-compose.yml` dépend des variables contenues dans le fichier `.env`
Parallèlement à cela vous devez configurer le fichier `config/vhosts/default.conf` afin de pointer le dossier `my-new-project-directory` à la bonne adresse locale:
ajouter/décommenter simplement les lignes suivantes dans ce fichier :
`nano config/vhosts/default.conf`
````
<VirtualHost *:80>
ServerName my-new-sand-project.dev.local
ServerAdmin webmaster@localhost
DocumentRoot "/var/www/my-new-sand-project-directory/public"
<Directory "/var/www/my-new-sand-project-directory/public/">
AllowOverride all
</Directory>
</VirtualHost>
````
vous pouvez aussi utiliser la commande suivante :
```` echo '<VirtualHost *:80>
ServerName my-new-sand-project.dev.local
ServerAdmin webmaster@localhost
DocumentRoot "/var/www/my-new-sand-project-directory/public"
<Directory "/var/www/my-new-sand-project-directory/public/">
AllowOverride all
</Directory>
</VirtualHost>' >> config/vhosts/default.conf
````
Une fois ceci fait, ouvrez le fichier `docker-compose.yml`
`nano docker-compose.yml`
et ajouter/décommenter la ligne à la suite de la config des extra-hosts :
`#- “my-new-sand-project.dev.local:127.0.0.1”`
Voilà vous êtes presque prêt à utiliser un `[docker-lamp](https://github.com/sprintcube/docker-compose-lamp)`. J'espère néanmoins que vous avez un compte sur docker-hub connecté à votre docker-desktop si sous êtes windows... Avec Linux tout marche tout de bout en bout facilement.
Une petite astuce sous windows cependant : afin d'utiliser les commandes que je vous ai donné sur cette page, vous devez avoir installé et lancer `git bash`.
Une dernière chose avant de configurer les dépendances de SAND : afin que votre navigateur puisse accéder au vhost docker que nous avons configuré, il vous faut ajouter les lignes suivantes au fichier `hosts` de votre OS.
````
127.0.0.1 html.dev.local
127.0.0.1 my-new-sand-project.dev.local
````
Sous windows celui-ci se trouve dans `c:\Windows\System32\drivers\etc` et sous Linux sous `/etc`
## Configurer SAND pour un premier lancement
Allez ! Vous y êtes presque :
Afin de charger toutes les dépendances vous devez avoir `composer` d'installé. Alors déplacez-vous dans le dossier `www/my-new-project-directory`
`cd www/my-new-sand-project-directory`
et lancer la commande `composer update`
Bon et maintenant ?
Il vous faut mettre en place charger les dépendances composer dans trois autres dossiers, un pour faire du [Test Driven Development (TDD)](https://www.test-recette.fr/), un autre pour les [tests fonctionnel BeHat](https://github.com/Halleck45/livre-developpement-pilote-comportement), et enfin un dernier pour réaliser [des builds et des métriques](https://jenkins-le-guide-complet.github.io/) sur votre projet
Suivez et exécutez ces commandes :
````
cd tests
cd phpunit
composer update
cd ../behat
composer update
cd ../../build
composer update
cd ../
````
Voilà tout est prêt, enfin presque : reste à lier les variables de configuration du framework, celles-ci sont toutes dans le dossier `application/config/` : Donc à partir de là :
````
cd application/config
mv app-parameters.php.skel app-parameters.php
mv bdd-parameters.php.skel bdd-parameters.php
mv console-parameters.php.skel console-parameters.php
````
enfin pour finir mettons en place la configuration de l'URL locale et de la base de données Mysql propre au `docker-lamp`:
`nano app-parameters.php`
modifier la constante `PATH_URL` avec la valeur [http://my-new-sand-project.dev.local](http://my-new-sand-project.dev.local/)
sauvegardez, puis
`nano bdd-parameters.php`
modifiez les constantes par défaut de cette manière
````
define('DSN_BDD_DEFAULT', "mysql:host=database;dbname=docker");
define('USER_BDD_DEFAULT', "docker");
define('PASS_BDD_DEFAULT', "docker");
````
sauvegardez, puis...
Voilà, vous êtes prêt à lancer le daemon docker !
## Lancer docker et accéder à l'interface de base du framework SAND-for-Universities
Bon normalement à partir de là, vous devriez être capable de mettre en place la base du framework à l'adresse : [http://my-new-sand-project.dev.local](http://my-new-sand-project.dev.local/) ou tout autre adresse que vous auriez précédemment préférée à celle-ci.
Juste ouvrez votre terminal favori puis lancer la commande suivante depuis la racine contenant le fichier `docker-compose.yml` :
`docker-compose up -d -----build`
si tout se passe bien, vous allez assister à un build parfait et à l'affichage des lignes suivantes ; celles-ci valident que tout s'est bien déroulé :
````
$ docker-compose up -d
[...]
Network docker-lamp_default Creating
Network docker-lamp_default Created
Container docker-lamp-database Creating
Container docker-lamp-database Created
Container docker-lamp-php80 Creating
Container docker-lamp-phpmyadmin Creating
Container docker-lamp-phpmyadmin Created
Container docker-lamp-php80 Created
Container docker-lamp-database Starting
Container docker-lamp-database Started
Container docker-lamp-php80 Starting
Container docker-lamp-phpmyadmin Starting
Container docker-lamp-phpmyadmin Started
Container docker-lamp-php80 Started
````
Voilà ! l'installation est terminée. Rendez-vous sur [http://my-new-sand-project.dev.local](http://my-new-sand-project.dev.local/) pour admirer votre travail :)
Dans le cas ou le build ne fonctionne pas, tentez de regarder dans le dossier `bin/php80` le fichier `DockerFile` et commentez les lignes qui posent problème par un dièse(`#`) . Un peu d'huile de mimines et le tour est joué.
Voici maintenant quelques commandes-astuces avec `Docker` :
`docker ps` permet de voir les conteneurs lancés actuellement
`docker logs` permet de comprendre pourquoi un conteneur n'est pas stable en raison d'une mauvaise configuration
`docker exec` permet d'entrer dans le conteneur et de relancer certains services, à cependant utiliser avec précaution car dès que vous réalisez un rebuild du conteneur, les modifications réalisées à l'intérieur sont effacées.
pour `Docker-compose` maintenant :
vous pouvez utiliser `docker-compose down` et `docker-compose kill`.
A vous de jouer :) !

View file

@ -0,0 +1,80 @@
*SAND est nommé pour l'acronyme récursif (Simplement [AND et] un Autre Nouveau Dossier)*
Tout d'abord, avant même de vouloir ajouter de nouvelles pages, je vais vous présenter la structure, ainsi vous comprendrez où se trouvent les fichiers nécessaires afin d'ajouter une simple page `Hello_World`
## Comment est architecturé le framework SAND ?
La racine de SAND contient les dossiers suivant :
- `application` : dossier contenant différents fichiers, propre à lapplication et au framework dont on détaillera le contenu plus bas.
1. `class` : dossier contenant les fichiers propres au framework. Ne doit pas être modifié.
2. `config` : dossier contenant les fichiers de configuration, normalement lors de la récupération du dépôt, les fichiers sont a renommer et a ancrer avec les bonnes valeurs
3. `include` : dossier de développement contient :
1. `actions` : dossier contenant les actions réutilisables dans les vues de lapplication
2. `conduits` : dossier contenant le contrôleur qui est conduit par le routage symfony, ici utilisé exclusivement pour générer des réponses AJAX
3. `controlleurs` : dossier contenant les contrôleurs de lapplications, nous verrons plus tard le modèles MVC propre au framework, mais il faut savoir que les controlleurs contiennent les accès en bdd de la page correspondant à son nom
4. `modeles` :dossier contenant les modèles de lapplication, il faut savoir que les modèles ont lextension .model et contiennent les variable propres à la page, comme le title, la description ou plus récemment le fil dariane
5. `vues` : dossier contenant les fichiers blade ou twig utilisé dans les pages, les actions et les conduits dont voici le détail :
1. `cache` : dossier contenant les fichiers de cache généré par le moteur de rendu
2. `layout` : dossier contenant les différents layouts des pages
3. `system` : dossier contenant le/les layout(s) système(s)
4. `view` : dossier contenant toutes les vues de lapplication, une convention de nommage peut être établie suivant le domaine de lapplication, par exemple, toutes les vues des actions doivent commencer par action et toutes les vues des conduits doivent commencer par le nom du conduit duquel ils sont appelés
4. `logs` : dossier contenant les logs générer par lapplication, une classe dédiée aux logs est contenue dans le framework
5. `modules` : dossier contenant les modules de lapplication, il faut savoir que le framework peut contenir des applications modulaires, genre des applications symfony, wordpress, etc… toutes applications externe php peut avec un peu de doigté peut être intégré à une application, typiquement on peut intégrer un module de dépôt git genre gitlist à lapplication que lon est en train de développer.
6. `objets` : dossier contenant les objets de session du framework, ce dossier peut être modifié par lutilisateur, il contient des classes qui sont utilisé dans le cadre de la gestion de session, par exemple lauthentification CAS
7. `traitements` : dossier contenant les traitements de formulaire selon le respect du pattern PRG (Post Redirect Get)
- `console` : dossier contenant les commandes console propres au framework et à lapplication*
1. `command` : dossier contenant les commandes console du framework et de lapplication
2. `skel` : dossier contenant les squelettes utilisés lors des appels console
- `data` : dossier contenant des données qui sont chargé par lapplications ou le framework
1. `docs` : dossier contenant la documentation de lapplication
2. `domain` : dossier contenant les classes propres à la manipulation du domaine visé par lapplication, ces classes peuvent être testées unitairement par PHPUnit
3. `output` : dossier contenant les sorties des commandes console de lapplications, ce peut être des logs ou des fichiers de traitement
- `public` : dossier contenant la racine publique de lapplication, le serveur apache doit pointer sur ce dossier pour que le reste ne soit pas accessible, il contient tous les assets (css, js) de lapplication ainsi que le fichier index.php et .htaccess redirigant toutes les requêtes vers lindex.
- `tests` : dossier contenant les fichiers de tests unitaire ou fonctionnels
et :
- `vendor` : dossier créé par composer lors de la récupération des paquets nécessaire à lapplication, contient aussi lautoloader de lapplication généré à la volée par composer
- `node_modules` : dossier créé par npm lors de la récupération des paquets pouvant être nécessaire à lapplication
## Comment ajouter une nouvelle page nommé hello_world ?
Voilà vous êtes prêt, lancez donc la SANDcommande suivante depuis la racine
`php console/bin.php page:add`
puis répondez aux questions en donnant un nom tel que `hello_world`, et... trois(3) nouveaux fichiers sont apparus dans `application/include` : au sein de `controlleurs`, `modeles` et `vues/view`
Ouvrez les et regardez, votre nouvelle page est accessible sur [http://my-new-sand-project.dev.local/hello_world](http://my-new-sand-project.dev.local/hello_world)

View file

@ -0,0 +1,10 @@
** Comment ajouter une page hello_world ? **
Lancez donc la SANDcommande suivante depuis la racine
''php console/bin.php page:add''
puis répondez aux questions en donnant un nom tel que ''hello_world'', et... trois(3) nouveaux fichiers sont apparus dans ''application/include'' : au sein de ''controlleurs'', ''modeles'' et ''vues/view''
Ouvrez les et regardez, votre nouvelle page est accessible sur http://my-new-sand-project.dev.local/hello_world

View file

@ -1,65 +0,0 @@
#Les vues Twig
Elles sont chargées dans cette ordre:
* application/include/vues/system
* application/include/vues/layout
* application/include/vues/view
ainsi la vue standard peut étendre de `application/include/vues/layout/body.html.twig`
```php
{% block body %}
<!-- Body Inner -->
<section id="page-content">
<div class="container">
<!--Alerts-->
{% if $_SESSION['alerts'] is defined %}
{% foreach $_SESSION['alerts'] as alert %}
<div class="alert alert-{{alert.type}} alert-dismissible fade show" role="alert">
<strong>{{alert.title}}</strong> {{alert.message}}.
<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
</div>
{% endforeach %}
{% endif %}
<!--end: Alerts-->
{% block content %}{% endblock %}
</div>
</section>
{% endblock %}}
```
qui étends de `application/include/vues/system/system.html.twig`
```php
<!DOCTYPE html>
<html>
<head>
{% block head %}
<title>{{page_title}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="author" content="" />
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="description" lang="fr" content="{{description}}"/>
{% block top-css %}
<link rel="stylesheet" href="{{ \MVC\Classe\Url::asset_rewrite('assets/bootstrap-5.0.0-beta1-dist/css/bootstrap.min.css')}}">
<link rel="stylesheet" href="{{ \MVC\Classe\Url::asset_rewrite('assets/css/custom.css')}}">
{% endblock %}
{% endblock %}
</head>
<body>
{% block top-javascript %}{% endblock %}
{% block body %}{% endblock %}
{% block bottom-javascript %}
<script src="{{ \MVC\Classe\Url::asset_rewrite('assets/bootstrap-5.0.0-beta1-dist/js/bootstrap.min.js')}}"></script>
<script src="{{ \MVC\Classe\Url::asset_rewrite('assets/js/custom.js')}}"></script>
{% endblock %}
</body>
</html>
```

View file

@ -1,50 +0,0 @@
#Les vues Blade
Elles sont chargées dans cette ordre:
* application/include/vues/system
* application/include/vues/layout
* application/include/vues/view
ainsi la vue standard peut étendre de `application/include/vues/layout/body.blade.php`
```php
@extends('system')
@section('body')
@section('sidebar')
This is the master sidebar.
@show
<div class="container">
@yield('content')
</div>
@endsection
```
qui étends de `application/include/vues/system/system.blade.php`
```php
<html>
<head>
<title>{{$page_title}}</title>
<meta name="description" lang="fr" content="{{$description}}"/>
@section('top-css')
@endsection
</head>
<body>
@section('top-javascript')
@endsection
@yield('body')
@section('bottom-javascript')
@endsection
</body>
</html>
```

View file

@ -1,29 +1,37 @@
#Comment Configurer un module Symfony ou tout autre application php
#Comment Configurer un module ou tout autre application php
il vous faut instancier trois fichiers:
le modèle (.model) contenant le nom de la page qui porte le model
ici : `application/include/modeles/syf51.model`
ici : `application/include/modeles/my_module.model`
```yaml
name : syf51
name : my_module
page_title : Accueil de l'application modulaire
description : zatou stra bracadabla
params : params
engine : blade
ariane : {my_module_name}
arianelink : {my_module}
```
le controlleur (.php) contenant ce code qui doit être automatisé
ici: `application/include/controlleurs/syf51.php`
le controlleur (.php) contenant ce code
ici: `application/include/controlleurs/my_module.php`
```php
<?php
\MVC\Classe\Session::start();
$app = new MVC\Classe\Modular($name);
$templateData = array('app' => $app);
```
et déclarer le module dans `\application\modules\setup\registre.model`
le template (.blade.php) contenant ce code
ici: `application/include/vues/view/my_module.php`
```php
{{$app->load('module_type')}}
```
aussi il vous faudra déclarer le module dans `\application\modules\setup\registre.model`
par une ligne suplémentaire:
```yaml
syf51 : Application permettant de tester l'intégration d'un module avec symfony5.0.99
my_module : Application permettant de tester l'intégration d'un module
```
si besoin et que le module n'existe pas il vous faudras coder et modifier
le fichier `/application/class/Modular.php` voir peut-être `/application/class/ModularRegister.php`
ainsi que le dossier `\application\module\my_module`
si besoin et que le type du module n'existe pas il vous faudra ajouter le type du module en modifiant le fichier `/application/class/Modular.php` et les méthodes `__construct` et `load`
Good Luck !

View file

@ -1 +1,10 @@
#Comment bien utiliser les modules
#Comment bien utiliser les modules
Simplement vous pouvez tester les intégrations prévues dans le FrameWork avec la commande `php bin.php module:add` ainsi vous aurez le choix d'intégrer en quelques modifications à la mimine un module Symfony ou Laravel. Pour cela choisissez les paramètres de base afin que l'installation se passe bien.
Il faut comprendre qu'un module Symfony ne peut fonctionner qu'avec un template `blade`, de même manière un module Laravel ne peut fonctionner qu'avec un template `twig`.
Basiquement toute application utilisant le système de randu `twig` doit être intégré avec un template-sand `blade` et l'inverse.
Au niveau du sysème de routage, il faut absolument inclure le path du module, par exemple pour un module nommé 'SciFi', il faudra inclure dans les routes des controlleurs la chaine de caractères `\SciFi` devant toutes les routes de vos controlleurs.
Il en est de même pour les autres modules : Wordpress, GitList, PhpList, Pretashop, ... ainsi que pour tous les autres modules que vous voudriez intégrer par vous-même.

View file

@ -0,0 +1 @@
#Comment ajouter un module Symfony

View file

@ -0,0 +1,27 @@
__Le squelette de départ d'une application ExtJS__ : sisi c'est possible avec node.js mais l'intégration d'un tel outil n'as absolument pas été commencé lors de mon CDD à l'ufc ni même pendant ma période de convalescence du 15/07/2021 au 18/12/2021 car je me refuse encore actuellement de programmer, elle est un petit peu réfléchie et semble absolument possible avec de nombreuses application reliées mais je ne possède pas toutes les compréhensions techniques nécessaires pour le faire actuellement.
__Un moteur de wiki basé sur wikini__ : si les auteurs du wikini0.5 acceptent...
__Un moteur d'écriture en Markdown et Yaml dans de simples fichiers contenus dans /data__ : une portion de cela a été codé et est disponible sur le github du créateur du framework.
----
//
Une dalle pdo plus performante (voir accueillant un système de choix de l'ORM ou un ORM spécifique)
//
//
Une réécriture complète du système de vue afin d'accueillir les nouvelles versions de Twig et Blade
//
//
Un systeme REST plus capable de faire ce qui doit être fait, imitant un peu Slim
//
//
Des améliorations au niveau de l'intégration de Bootstrap5.0 : par exemple le système de notification push
//
//
Ainsi que d'autres petites choses au niveau des objets de session et des composants de domaine (Composants de domaines qui ne seront accessible que sur RENATER, je garde précieusement ces fichiers...)
//

View file

@ -0,0 +1,227 @@
# Comment installer le framework
## Préambule
Tout d'abord avant de tenter quoi que soit au niveau de l'installation du framework, veuillez prendre en considération ces quatre(4) questions :
Avez-vous installé le logiciel de virtualisation docker ?
Avez-vous installé le logiciel de gestionnaire de version git ?
Avez-vous installé et utilisez-vous le language php au minimum dans sa version 7.4 ?
Avez-vous installé le logiciel de dépendances composer ?
Si la réponse est oui à ces quatre(4) questions alors vous êtes prêt à utiliser ce framework, même si vous ne connaissez pas les frameworks php tel que laravel ou symfony. Et dans ce cas ce sera peut-être pour vous une bonne introduction aux manipulations avancées qu'il est possible de faire avec ces imposants mastodontes.
Pour installer ces quatre(4) composantes nécessaires sous Windows je ne peut que vous donner les liens et vous inviter à consulter les quelques documentations disponible onTheWeb à ce sujet.
Le plus simple pour installer [docker](https://docs.docker.com/) est de se rendre sur [https://hub.docker.com/](https://hub.docker.com/) et de vous créer un compte, il sera obligatoire afin d'obtenir les images docker nécessaires lors de l'installation. Puis installer docker desktop disponible sous [https://hub.docker.com/editions/community/docker-ce-desktop-windows](https://hub.docker.com/editions/community/docker-ce-desktop-windows)
Le plus simple pour installer [git](https://git-scm.com/doc) est de vous rendre sur [https://gitforwindows.org/](https://gitforwindows.org/) et de suivre la procédure d'installation.
Afin de vous aider à installer [php](https://www.php.net/docs.php) facilement vous pouvez utiliser le gestionnaire fournit avec windows : `Microsoft Web Platform installer` disponible à l'adresse [https://docs.microsoft.com/en-us/iis/install/web-platform-installer/web-platform-installer-direct-downloads](https://docs.microsoft.com/en-us/iis/install/web-platform-installer/web-platform-installer-direct-downloads) , une autre manière serait de récupérer [l'archive windows de la version de php](https://windows.php.net/download) qui vous intéresse et de la placer à la racine `C:` et d'ajouter le `PATH` de l'executable `php.exe` dans les variables d'environnement, ainsi dans la console `git-bash` fourni avec git-for-windows vous pourrez commencez à utiliser php en ligne de commande... et Sandyes (le petit nom du sablier de SAND) aime la ligne de commande :)
Enfin pour installer [composer](https://getcomposer.org/doc/) vous pouvez vous rendre sur [https://getcomposer.org/](https://getcomposer.org/)
Voilà vous avez tout [pour commencer à jouer avec le framework](https://sourcesup.renater.fr/wiki/mvc-sand-frame/installdokerlamp) :) Enfin presque...
Vous êtes un linuxien ? cela ne devrait pas vous poser de problèmes alors ? Si ? Dites les man-pages vous connaissez ? Si la réponse est non il vous faudra apprendre la base de tout ce qui existe du monde libre. Dans le cas contraire normalement le gestionnaire de dépendance de votre distribution doit vous permettre de faire le reste, il vous faudra alors lui demander à installer les paquets suivants :
`php8`-full (avec nécessairement les modules ldap, gd, mysql, pdo, zip, xml, et quelques autres que j'aurais oublié lors de cette écriture nocturne)
par exemple : ````apt install php8.0-common php8.0-mysql php8.0-ldap php8.0-xml php8.0-xmlrpc php8.0-curl php8.0-gd php8.0-imagick php8.0-cli php8.0-dev php8.0-imap php8.0-mbstring php8.0-opcache php8.0-soap php8.0-zip php8.0-intl -y````
`docker`
`docker-compose`
par exemple : ````apt install docker docker-compose -y````
`git`
par exemple : ````apt install git -y````
`composer`
par exemple : ````apt install composer -y````
et gros un `apt-get install` ou un `apt install` ou un `yum install` ou un `pacman -S` ou encore `yahourt -S` vous suffira dans bien des cas. A moins que vous soyez sur une distribution spéciale que j'affectionne mais que je n'ai pas réussi à virtualiser par manque de temps [GUIX](https://guix.gnu.org/), à ce moment-là je vous laisse faire : cela ne devrai pas vous poser trop de problèmes...
## Voyons maintenant comment installer l'environnement ainsi que le framework SAND avant de développer et de comprendre ses mécanismes
Afin de pouvoir démarrer un projet SAND, vous devez mettre en place votre environnement de développement. Un bon IDE est déja la base nécessaire afin de programmer. Certains choisissent Eclipse, je vous conseillerais la version [PDT de Eclipse](https://www.eclipse.org/pdt/) qui est spécialisée PHP. D'autres vont vouloir programmer avec [VisualStudioCode](https://code.visualstudio.com/), qui est open source et permet grâce à ses nombreux modules de gérer à la fois `docker` et `git` tout en se concentrant sur ses lignes de programmation. Pour les plus passionnés : vous pouvez tester puis acheter une version annuelle de [PHPStorm](https://www.jetbrains.com/fr-fr/phpstorm/) ou [ZendStudio](https://www.zend.com/products/zend-studio) de puissants IDE provenant des plus grosses communautés de programmeurs PHP passionnées : ce sont les meilleurs sur le marché actuel. Aussi vous pouvez utiliser des éditeurs plus simples tels que [Sublime Text](https://www.sublimetext.com/) ou [Scite](https://www.scintilla.org/SciTE.html) ou encore [Notepad++](https://notepad-plus-plus.org/downloads/). C'est à vous de voir ce qui vous convient le mieux actuellement.
**Entrons maintenant dans le vif du sujet :**
Commençons par cloner le dépot docker nécessaire au framework par la commande `git clone` :
`git clone https://anonymous@git.renater.fr/authscm/eroy5/git/mvc-sand-frame/docker-lamp.git`
puis déplacez-vous dans le dossier www par la commande `cd` :
`cd docker-lamp/www`
et cloner le dépot du framework dans ce dossier sous le nom my-new-project-directory par la commande `git clone` :
`git clone https://anonymous@git.renater.fr/authscm/eroy5/git/mvc-sand-frame/mvc-sand-frame.git my-new-sand-projet-directory`
Voilà vous avez le nécessaire pour scruter le code du Framework et consulter les quelques documentations primales qui se trouvent dans le dossier `www/my-new-sand-projet-directory/data/docs`
## Comment configurer l'environnement afin de commencer à consulter l'interface de base de SAND
Voilà vous avez cloner les dépôts de base, mais il faut maintenant les configurer afin d'obtenir votre première page sur un navigateur. Pour cela nous allons mettre en place la configuration de docker-compose, puis faire le lien avec le dépôt du framework proprement dit.
tout d'abord, veuillez renommer le fichier `sample.env` en `.env` qui est nécessaire afin de définir les variables environnement de `docker-compose` :
`cd ../ mv sample.env .env`
De base, ce fichier comporte les bonnes variables d'environnement pour lancer l'image nécessaire sur windows et linux. En ouvrant le fichier `.env`, vous avez le loisir de modifier les ports de phpmyadmin et du serveur mysql. Plus d'informations sont disponible dans le fichier `README.md`
Je ne peut que vous conseiller d'ouvrir les fichiers `.env` et `docker-compose.yml` après avoir lu le README, et si vous êtes familier avec les lignes de commandes `bash` ce devrait être possible pour vous de comprendre la liaison intime entre ces deux fichiers. En effet, `docker-compose.yml` dépend des variables contenues dans le fichier `.env`
Parallèlement à cela vous devez configurer le fichier `config/vhosts/default.conf` afin de pointer le dossier `my-new-project-directory` à la bonne adresse locale:
ajouter/décommenter simplement les lignes suivantes dans ce fichier :
`nano config/vhosts/default.conf`
````
<VirtualHost *:80>
ServerName my-new-sand-project.dev.local
ServerAdmin webmaster@localhost
DocumentRoot "/var/www/my-new-sand-project-directory/public"
<Directory "/var/www/my-new-sand-project-directory/public/">
AllowOverride all
</Directory>
</VirtualHost>
````
vous pouvez aussi utiliser la commande suivante :
```` echo '<VirtualHost *:80>
ServerName my-new-sand-project.dev.local
ServerAdmin webmaster@localhost
DocumentRoot "/var/www/my-new-sand-project-directory/public"
<Directory "/var/www/my-new-sand-project-directory/public/">
AllowOverride all
</Directory>
</VirtualHost>' >> config/vhosts/default.conf
````
Une fois ceci fait, ouvrez le fichier `docker-compose.yml`
`nano docker-compose.yml`
et ajouter/décommenter la ligne à la suite de la config des extra-hosts :
`#- “my-new-sand-project.dev.local:127.0.0.1”`
Voilà vous êtes presque prêt à utiliser un `[docker-lamp](https://github.com/sprintcube/docker-compose-lamp)`. J'espère néanmoins que vous avez un compte sur docker-hub connecté à votre docker-desktop si sous êtes windows... Avec Linux tout marche tout de bout en bout facilement.
Une petite astuce sous windows cependant : afin d'utiliser les commandes que je vous ai donné sur cette page, vous devez avoir installé et lancer `git bash`.
Une dernière chose avant de configurer les dépendances de SAND : afin que votre navigateur puisse accéder au vhost docker que nous avons configuré, il vous faut ajouter les lignes suivantes au fichier `hosts` de votre OS.
````
127.0.0.1 html.dev.local
127.0.0.1 my-new-sand-project.dev.local
````
Sous windows celui-ci se trouve dans `c:\Windows\System32\drivers\etc` et sous Linux sous `/etc`
## Configurer SAND pour un premier lancement
Allez ! Vous y êtes presque :
Afin de charger toutes les dépendances vous devez avoir `composer` d'installé. Alors déplacez-vous dans le dossier `www/my-new-project-directory`
`cd www/my-new-sand-project-directory`
et lancer la commande `composer update`
Bon et maintenant ?
Il vous faut mettre en place charger les dépendances composer dans trois autres dossiers, un pour faire du [Test Driven Development (TDD)](https://www.test-recette.fr/), un autre pour les [tests fonctionnel BeHat](https://github.com/Halleck45/livre-developpement-pilote-comportement), et enfin un dernier pour réaliser [des builds et des métriques](https://jenkins-le-guide-complet.github.io/) sur votre projet
Suivez et exécutez ces commandes :
````
cd tests
cd phpunit
composer update
cd ../behat
composer update
cd ../../build
composer update
cd ../
````
Voilà tout est prêt, enfin presque : reste à lier les variables de configuration du framework, celles-ci sont toutes dans le dossier `application/config/` : Donc à partir de là :
````
cd application/config
mv app-parameters.php.skel app-parameters.php
mv bdd-parameters.php.skel bdd-parameters.php
mv console-parameters.php.skel console-parameters.php
````
enfin pour finir mettons en place la configuration de l'URL locale et de la base de données Mysql propre au `docker-lamp`:
`nano app-parameters.php`
modifier la constante `PATH_URL` avec la valeur [http://my-new-sand-project.dev.local](http://my-new-sand-project.dev.local/)
sauvegardez, puis
`nano bdd-parameters.php`
modifiez les constantes par défaut de cette manière
````
define('DSN_BDD_DEFAULT', "mysql:host=database;dbname=docker");
define('USER_BDD_DEFAULT', "docker");
define('PASS_BDD_DEFAULT', "docker");
````
sauvegardez, puis...
Voilà, vous êtes prêt à lancer le daemon docker !
## Lancer docker et accéder à l'interface de base du framework SAND-for-Universities
Bon normalement à partir de là, vous devriez être capable de mettre en place la base du framework à l'adresse : [http://my-new-sand-project.dev.local](http://my-new-sand-project.dev.local/) ou tout autre adresse que vous auriez précédemment préférée à celle-ci.
Juste ouvrez votre terminal favori puis lancer la commande suivante depuis la racine contenant le fichier `docker-compose.yml` :
`docker-compose up -d -----build`
si tout se passe bien, vous allez assister à un build parfait et à l'affichage des lignes suivantes ; celles-ci valident que tout s'est bien déroulé :
````
$ docker-compose up -d
[...]
Network docker-lamp_default Creating
Network docker-lamp_default Created
Container docker-lamp-database Creating
Container docker-lamp-database Created
Container docker-lamp-php80 Creating
Container docker-lamp-phpmyadmin Creating
Container docker-lamp-phpmyadmin Created
Container docker-lamp-php80 Created
Container docker-lamp-database Starting
Container docker-lamp-database Started
Container docker-lamp-php80 Starting
Container docker-lamp-phpmyadmin Starting
Container docker-lamp-phpmyadmin Started
Container docker-lamp-php80 Started
````
Voilà ! l'installation est terminée. Rendez-vous sur [http://my-new-sand-project.dev.local](http://my-new-sand-project.dev.local/) pour admirer votre travail :)
Dans le cas ou le build ne fonctionne pas, tentez de regarder dans le dossier `bin/php80` le fichier `DockerFile` et commentez les lignes qui posent problème par un dièse(`#`) . Un peu d'huile de mimines et le tour est joué.
Voici maintenant quelques commandes-astuces avec `Docker` :
`docker ps` permet de voir les conteneurs lancés actuellement
`docker logs` permet de comprendre pourquoi un conteneur n'est pas stable en raison d'une mauvaise configuration
`docker exec` permet d'entrer dans le conteneur et de relancer certains services, à cependant utiliser avec précaution car dès que vous réalisez un rebuild du conteneur, les modifications réalisées à l'intérieur sont effacées.
pour `Docker-compose` maintenant :
vous pouvez utiliser `docker-compose down` et `docker-compose kill`.
A vous de jouer :) !

View file

@ -1,5 +0,0 @@
#Comment faire évoluer une application écrite avec le framework SAND ?
Tout dabord, une fois lapplication créé, toutes les ressources sont téléchargée par composer et le fichier composer.lock est garant de la stabilité des dépôts auxquels lapplication fait appel. Donc normalement il ne sera pas nécessaire de faire évoluer ces ressources.
Néanmoins passer vers une nouvelle version de php par exemple de la 5.6 à la 8 nécessite des connaissances évolué des fonctions dépréciées entre les versions de PHP. SAND framework est php 8 ready, néanmoins certaines lib comme phpCAS ne fonctionne que sur php7.3, mais celles-ci une fois installée ne changent pas au cours du temps car elles sont directement accessibles depuis le dossier vendor.

View file

@ -0,0 +1,80 @@
*SAND est nommé pour l'acronyme récursif (Simplement [AND et] un Autre Nouveau Dossier)*
Tout d'abord, avant même de vouloir ajouter de nouvelles pages, je vais vous présenter la structure, ainsi vous comprendrez où se trouvent les fichiers nécessaires afin d'ajouter une simple page `Hello_World`
## Comment est architecturé le framework SAND ?
La racine de SAND contient les dossiers suivant :
- `application` : dossier contenant différents fichiers, propre à lapplication et au framework dont on détaillera le contenu plus bas.
1. `class` : dossier contenant les fichiers propres au framework. Ne doit pas être modifié.
2. `config` : dossier contenant les fichiers de configuration, normalement lors de la récupération du dépôt, les fichiers sont a renommer et a ancrer avec les bonnes valeurs
3. `include` : dossier de développement contient :
1. `actions` : dossier contenant les actions réutilisables dans les vues de lapplication
2. `conduits` : dossier contenant le contrôleur qui est conduit par le routage symfony, ici utilisé exclusivement pour générer des réponses AJAX
3. `controlleurs` : dossier contenant les contrôleurs de lapplications, nous verrons plus tard le modèles MVC propre au framework, mais il faut savoir que les controlleurs contiennent les accès en bdd de la page correspondant à son nom
4. `modeles` :dossier contenant les modèles de lapplication, il faut savoir que les modèles ont lextension .model et contiennent les variable propres à la page, comme le title, la description ou plus récemment le fil dariane
5. `vues` : dossier contenant les fichiers blade ou twig utilisé dans les pages, les actions et les conduits dont voici le détail :
1. `cache` : dossier contenant les fichiers de cache généré par le moteur de rendu
2. `layout` : dossier contenant les différents layouts des pages
3. `system` : dossier contenant le/les layout(s) système(s)
4. `view` : dossier contenant toutes les vues de lapplication, une convention de nommage peut être établie suivant le domaine de lapplication, par exemple, toutes les vues des actions doivent commencer par action et toutes les vues des conduits doivent commencer par le nom du conduit duquel ils sont appelés
4. `logs` : dossier contenant les logs générer par lapplication, une classe dédiée aux logs est contenue dans le framework
5. `modules` : dossier contenant les modules de lapplication, il faut savoir que le framework peut contenir des applications modulaires, genre des applications symfony, wordpress, etc… toutes applications externe php peut avec un peu de doigté peut être intégré à une application, typiquement on peut intégrer un module de dépôt git genre gitlist à lapplication que lon est en train de développer.
6. `objets` : dossier contenant les objets de session du framework, ce dossier peut être modifié par lutilisateur, il contient des classes qui sont utilisé dans le cadre de la gestion de session, par exemple lauthentification CAS
7. `traitements` : dossier contenant les traitements de formulaire selon le respect du pattern PRG (Post Redirect Get)
- `console` : dossier contenant les commandes console propres au framework et à lapplication*
1. `command` : dossier contenant les commandes console du framework et de lapplication
2. `skel` : dossier contenant les squelettes utilisés lors des appels console
- `data` : dossier contenant des données qui sont chargé par lapplications ou le framework
1. `docs` : dossier contenant la documentation de lapplication
2. `domain` : dossier contenant les classes propres à la manipulation du domaine visé par lapplication, ces classes peuvent être testées unitairement par PHPUnit
3. `output` : dossier contenant les sorties des commandes console de lapplications, ce peut être des logs ou des fichiers de traitement
- `public` : dossier contenant la racine publique de lapplication, le serveur apache doit pointer sur ce dossier pour que le reste ne soit pas accessible, il contient tous les assets (css, js) de lapplication ainsi que le fichier index.php et .htaccess redirigant toutes les requêtes vers lindex.
- `tests` : dossier contenant les fichiers de tests unitaire ou fonctionnels
et :
- `vendor` : dossier créé par composer lors de la récupération des paquets nécessaire à lapplication, contient aussi lautoloader de lapplication généré à la volée par composer
- `node_modules` : dossier créé par npm lors de la récupération des paquets pouvant être nécessaire à lapplication
## Comment ajouter une nouvelle page nommé hello_world ?
Voilà vous êtes prêt, lancez donc la SANDcommande suivante depuis la racine
`php console/bin.php page:add`
puis répondez aux questions en donnant un nom tel que `hello_world`, et... trois(3) nouveaux fichiers sont apparus dans `application/include` : au sein de `controlleurs`, `modeles` et `vues/view`
Ouvrez les et regardez, votre nouvelle page est accessible sur [http://my-new-sand-project.dev.local/hello_world](http://my-new-sand-project.dev.local/hello_world)

View file

@ -0,0 +1,10 @@
** Comment ajouter une page hello_world ? **
Lancez donc la SANDcommande suivante depuis la racine
''php console/bin.php page:add''
puis répondez aux questions en donnant un nom tel que ''hello_world'', et... trois(3) nouveaux fichiers sont apparus dans ''application/include'' : au sein de ''controlleurs'', ''modeles'' et ''vues/view''
Ouvrez les et regardez, votre nouvelle page est accessible sur http://my-new-sand-project.dev.local/hello_world

View file

@ -0,0 +1,229 @@
#Les vues Twig
Elles sont chargées dans cette ordre:
* application/include/vues/system
* application/include/vues/layout
* application/include/vues/view
ainsi la vue standard peut étendre de `application/include/vues/layout/body.html.twig`
```php
{% extends "system.html.twig" %}
{% block body %}
<!-- Body Inner -->
<div class="body-inner">
<!-- Topbar -->
<div id="topbar" class="d-none d-xl-block d-lg-block topbar-transparent topbar-fullwidth dark"
style="background: rgba(0, 0, 0, 0.59);">
<div class="container">
<ul class="top-menu">
{{call('\\MVC\\Object\\Environment','getTextEnvironment',[]) | raw}}
<li {% if name == 'docs_route' or name == 'docs_name_route' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[ false, 'docs', []]) }}">Documentation</a></li>
<li {% if name == 'depots' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[ false, 'gitlist/SAND-FrameWork', []]) }}">Dépot</a></li>
<li {% if name == 'donate' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[ false, 'Donate', []]) }}">Donate</a></li>
<li {% if name == 'cgu' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[ false, 'CGU', []]) }}"> CGU Terms</a></li>
<li {% if name == 'policy' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[ false, 'Policy', []]) }}">Policy</a></li>
</ul>
</div>
</div>
<!-- end: Topbar -->
<!-- Header -->
<header id="header" class="dark" data-transparent="true" data-fullwidth="true"
style="background: rgba(0, 0, 0, 0.59);">
<div class="header-inner">
<div class="container">
<!--Navigation Resposnive Trigger-->
<div id="mainMenu-trigger">
<a class="lines-button x"><span class="lines"></span></a>
</div>
<!--end: Navigation Resposnive Trigger-->
<!--Navigation-->
<div id="mainMenu">
<div class="container">
<!--Logo-->
<div id="logo">
<a href="#">
SAND Framework
</a>
</div>
<!--end: logo-->
<nav>
<ul>
<li {% if name == 'index' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[false, 'Index', []]) }}">Index</a></li>
<li {% if name == 'admin' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[false, 'Admin', []]) }}">Admin</a></li>
<li {% if name == 'laravel' %} class="actual" {% endif %} ><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[false, 'Laravel', []]) }}">Module Laravel</a></li>
</ul>
</nav>
</div>
</div>
<!--end: Navigation-->
</div>
</div>
</header>
<!-- end: Header -->
<!-- Subbar -->
<div id="subbar" class="fullwidth">
<div class="container">
<span style="float:left;">Vous êtes connecté en tant que {{session('user_login')}}</span>
<span style="float:right;"><a href="{{ call("\\MVC\\Classe\\Url","link_rewrite",[ false, 'Logout', []]) }}">Se Deconnecter</a></span>
</div>
</div>
<!-- end: Subbar -->
<!-- Breadcrumbs -->
{%if ariane is defined %}
<div id="breadcrumbs" class="fullwidth">
<div class="container">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
{% for value in ariane %}
{% if value == ariane|last %}
<li class="breadcrumb-item active" aria-current="page">{{value}}</li>
{% else %}
<li class="breadcrumb-item"><a href="{{call("\\MVC\\Classe\\Url","link_rewrite",[false,arianelink[value.index],[] ])}}">{{value}}</a></li>
{% endif %}
{% endfor %}
</ol>
</nav>
</div>
</div>
{% endif %}
<section id="page-content">
<div class="container">
<!--Alerts-->
{% if not session('alerts') == null %}
{% for alert in session('alerts') %}
<div class="alert alert-{{alert.type}} alert-dismissible fade show" role="alert">
<strong>{{alert.title}}</strong> {{alert.message}}.
<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
</div>
{% endfor %}
{% endif %}
<!--end: Alerts-->
{% block content %}{% endblock %}
</div>
</section>
<!-- Footer -->
<footer id="footer">
<div class="footer-content">
<div class="container">
<div class="row">
<div class="col-lg-3">
<div class="widget">
<div class="widget-title"></div>
<p class="mb-5">
<img src="{{ call("\\MVC\\Classe\\Url","asset_rewrite",['assets/img/1007698-ffeb3b.svg']) }}" width="150">
</p>
</div>
</div>
<div class="col-lg-9">
<p>
SAND FrameWork is an CC-licensed or MIT-licenced open source project and completely free to use.
</p>
<p>
However, the amount of effort needed to maintain and develop new features for the project is not
sustainable without proper financial backing.
You can support its ongoing development by being a backer or a sponsor on
<a href="https://www.patreon.com/">Patreon campaign</a>
(recurring, with perks for different tiers), and get your company logo here.
</p>
<p>
Also, you can make a <a href="https://www.paypal.me/">one time donation via PayPal</a>.
</p>
</div>
</div>
</div>
<div class="copyright-content">
<div class="container">
<div class="copyright-text text-center">&copy; 2020-2021 Built with SAND Framework - Responsive SAND Template.</div>
</div>
</div>
</div>
</footer>
<!-- end: Footer -->
</div>
<!-- end: Body Inner -->
{% endblock %}
```
qui étends de `application/include/vues/system/system.html.twig`
```php
<!DOCTYPE html>
<html>
<head>
{% block head %}
<title>{{page_title}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="author" content="" />
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="description" lang="fr" content="{{description}}"/>
<link rel="apple-touch-icon" sizes="57x57" href="/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/apple-icon-72x72.png">
<link rel="apple-touch-icon" sizes="76x76" href="/apple-icon-76x76.png">
<link rel="apple-touch-icon" sizes="114x114" href="/apple-icon-114x114.png">
<link rel="apple-touch-icon" sizes="120x120" href="/apple-icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="/apple-icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="/apple-icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-icon-180x180.png">
<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="96x96" href="/favicon-96x96.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="manifest" href="/manifest.json">
<meta name="msapplication-TileColor" content="#ffffff">
<meta name="msapplication-TileImage" content="/ms-icon-144x144.png">
<meta name="theme-color" content="#ffffff">
{% block topCss %}
<link rel="stylesheet" href="{{ call("\\MVC\\Classe\\Url","asset_rewrite",['assets/bootstrap-5.0.0-beta1-dist/css/bootstrap.min.css'])}}">
<link rel="stylesheet" href="{{ call("\\MVC\\Classe\\Url","asset_rewrite",['assets/css/custom.css'])}}">
{% endblock %}
{% endblock %}
</head>
<body>
{% block topJavascript %}{% endblock %}
{% block body %}{% endblock %}
{% block bottomJavascript %}
<script src="{{ call("\\MVC\\Classe\\Url","asset_rewrite",['assets/bootstrap-5.0.0-beta1-dist/js/bootstrap.min.js'])}}"></script>
<script src="{{ call("\\MVC\\Classe\\Url","asset_rewrite",['assets/js/custom.js'])}}"></script>
{#
SCRIPT JS permettant de ne valider qu'une seule fois un formulaire
ATTENTION tous les formulaires sont affecté
Lors d'une validation bootstrap personnalisé veuillez utilisé
la class do-resubmit sur le formulaire afin de permettre
l'activation supplémentaire du bouton.
#}
<script>
window.onload = function() {
let PreventAllforms = document.querySelectorAll("form");
Array.prototype.slice.call(PreventAllforms)
.forEach(function (PreventForm) {
PreventForm.onsubmit = submitted.bind(PreventForm);
});
}
function submitted(event) {
if (event.target.classList.contains('do-resubmit')) {
event.submitter.disabled = false;
}else{
event.submitter.disabled = true;
}
}
</script>
{% endblock %}
</body>
</html>
```

View file

@ -0,0 +1,257 @@
#Les vues Blade
Elles sont chargées dans cette ordre:
* application/include/vues/system
* application/include/vues/layout
* application/include/vues/view
ainsi la vue standard peut étendre de `application/include/vues/layout/body.blade.php`
```php
@extends('system')
@section('body')
<!-- Body Inner -->
<div class="body-inner">
<!-- Topbar -->
<div id="topbar" class="d-none d-xl-block d-lg-block topbar-transparent topbar-fullwidth dark"
style="background: rgba(0, 0, 0, 0.59);">
<div class="container">
<ul class="top-menu">
{{\MVC\Object\Environment::getTextEnvironment()}}
<li @if($name == 'docs_route' || $name == 'docs_name_route') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'docs', []) }}">Documentation</a></li>
<li @if($name == 'depots') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'gitlist/SAND-FrameWork', []) }}">Dépot</a></li>
<li @if($name == 'donate') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Donate', []) }}">Donate</a></li>
<li @if($name == 'cgu') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'CGU', []) }}"> CGU Terms</a></li>
<li @if($name == 'policy') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Policy', []) }}">Policy</a></li>
<li @if($name == 'feedback') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Feedback', []) }}">Feedback</a></li>
</ul>
</div>
</div>
<!-- end: Topbar -->
<!-- Header -->
<header id="header" class="dark" data-transparent="true" data-fullwidth="true"
style="background: rgba(0, 0, 0, 0.59);">
<div class="header-inner">
<div class="container">
<!--Navigation Resposnive Trigger-->
<div id="mainMenu-trigger">
<a class="lines-button x"><span class="lines"></span></a>
</div>
<!--end: Navigation Resposnive Trigger-->
<!--Navigation-->
<div id="mainMenu">
<div class="container">
<!--Logo-->
<div id="logo">
<a href="#">
SAND Framework
</a>
</div>
<!--end: logo-->
<nav>
<ul>
<li @if($name == 'index') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Index', []) }}">Index</a></li>
<li @if($name == 'admin') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Admin', []) }}">Admin</a></li>
<li @if($name == 'symfony4_4') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Symfony4_4', []) }}"> Module Symfony 4.4</a></li>
<li @if($name == 'symfony5_1') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Symfony5_1', []) }}"> Module Symfony 5.1</a></li>
<li @if($name == 'symfony5_2') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Symfony5_2', []) }}"> Module Symfony 5.2</a></li>
<li @if($name == 'symfony5_3') class="actual" @endif ><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Symfony5_3', []) }}"> Module Symfony 5.3</a></li>
</ul>
</nav>
</div>
</div>
<!--end: Navigation-->
</div>
</div>
</header>
<!-- end: Header -->
<!-- Subbar -->
@if(isset($authentification) && $authentification == 'yes')
<div id="subbar" class="fullwidth">
<div class="container">
<span style="float:left;">Vous êtes connecté en tant que {{$_SESSION['user_login']}}</span>
<span style="float:right;"><a href="{{ \MVC\Classe\Url::link_rewrite( false, 'Logout', []) }}">Se Deconnecter</a></span>
</div>
</div>
@endif
<!-- end: Subbar -->
<!-- Breadcrumbs -->
@if (isset($ariane))
<div id="breadcrumbs" class="fullwidth">
<div class="container">
<nav aria-label="breadcrumb">
<ol class="breadcrumb-sand">
@foreach($ariane as $value)
@if($value == end($ariane))
<li class="breadcrumb-item active" aria-current="page">{{$value}}</li>
@else
<li class="breadcrumb-item"><a href="{{\MVC\Classe\Url::link_rewrite(false,$arianelink[array_search($value,$ariane)])}}">{{$value}}</a></li>
@endif
@endforeach
</ol>
</nav>
</div>
</div>
@endif
<!-- end: BreadCrumbs -->
<section id="page-content">
<div class="container">
<!--Alerts-->
@if(isset($_SESSION['alerts']))
@foreach($_SESSION['alerts'] as $alert)
<div class="alert alert-{{$alert['type']}} alert-dismissible fade show" role="alert">
<strong>{{$alert['title']}}</strong> {{$alert['message']}}.
<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
</div>
@endforeach
@endif
<!--end: Alerts-->
@yield('content')
</div>
</section>
<!-- Footer -->
<footer id="footer">
<div class="footer-content">
<div class="container">
<div class="row">
<div class="col-lg-3">
<div class="widget">
<div class="widget-title"></div>
<p class="mb-5">
<img src="{{ \MVC\Classe\Url::asset_rewrite('assets/img/1007698-ffeb3b.svg') }}" width="150">
</p>
</div>
</div>
<div class="col-lg-9">
<p>
SAND FrameWork is an CC-licensed or MIT-licenced open source project and completely free to use.
</p>
<p>
However, the amount of effort needed to maintain and develop new features for the project is not
sustainable without proper financial backing.
You can support its ongoing development by being a backer or a sponsor on
<a href="https://www.patreon.com/">Patreon campaign</a>
(recurring, with perks for different tiers), and get your company logo here.
</p>
<p>
Also, you can make a <a href="https://www.paypal.me/">one time donation via PayPal</a>.
</p>
</div>
</div>
</div>
<div class="copyright-content">
<div class="container">
<div class="copyright-text text-center">&copy; 2020-2021 Built with SAND Framework - Responsive SAND Template.</div>
</div>
</div>
</div>
</footer>
<!-- end: Footer -->
</div>
<!-- end: Body Inner -->
@endsection
```
qui étends de `application/include/vues/system/system.blade.php`
```php
<!DOCTYPE html>
<html>
<head>
<title>{{$page_title}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="author" content="" />
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="description" lang="fr" content="{{$description}}"/>
<link rel="apple-touch-icon" sizes="57x57" href="/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/apple-icon-72x72.png">
<link rel="apple-touch-icon" sizes="76x76" href="/apple-icon-76x76.png">
<link rel="apple-touch-icon" sizes="114x114" href="/apple-icon-114x114.png">
<link rel="apple-touch-icon" sizes="120x120" href="/apple-icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="/apple-icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="/apple-icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-icon-180x180.png">
<link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="96x96" href="/favicon-96x96.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="manifest" href="/manifest.json">
<meta name="msapplication-TileColor" content="#ffffff">
<meta name="msapplication-TileImage" content="/ms-icon-144x144.png">
<meta name="theme-color" content="#ffffff">
@section('top-css')
<link rel="stylesheet" href="{{ \MVC\Classe\Url::asset_rewrite('assets/bootstrap-5.0.0-beta1-dist/css/bootstrap.min.css')}}">
<link rel="stylesheet" href="{{ \MVC\Classe\Url::asset_rewrite('assets/css/custom.css')}}">
@if(\MVC\Classe\Browser::get() == 'Internet Explorer')
<link rel="stylesheet" href="{{\MVC\Classe\Url::asset_rewrite('assets/html5-simple-date-input-polyfill-master/html5-simple-date-input-polyfill.css')}}">
<!--<link rel="stylesheet" href="{{\MVC\Classe\Url::asset_rewrite('assets/hyperform-0.12.0/css/hyperform.css')}}">-->
@endif
@show
</head>
<body>
@section('top-javascript')
@if(\MVC\Classe\Browser::get() == 'Internet Explorer')
<!-- Polyfill.io will load polyfills your browser needs -->
<script src="https://polyfill.io/v3/polyfill.min.js?features=default%2CNumber.parseInt%2CNumber.parseFloat%2CArray.prototype.find%2CArray.prototype.includes"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/babel-polyfill/7.12.1/polyfill.min.js" integrity="sha512-uzOpZ74myvXTYZ+mXUsPhDF+/iL/n32GDxdryI2SJronkEyKC8FBFRLiBQ7l7U/PTYebDbgTtbqTa6/vGtU23A==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>
<script src="{{\MVC\Classe\Url::asset_rewrite('assets/html5-simple-date-input-polyfill-master/html5-simple-date-input-polyfill.js')}}"></script>
<script src="{{\MVC\Classe\Url::asset_rewrite('assets/hyperform-0.12.0/dist/hyperform.js')}}"></script>
<script>hyperform(window);</script>
@endif
@show
@yield('body')
@section('bottom-javascript')
<script src="{{ \MVC\Classe\Url::asset_rewrite('assets/bootstrap-5.0.0-beta1-dist/js/bootstrap.min.js')}}"></script>
<script src="{{ \MVC\Classe\Url::asset_rewrite('assets/js/custom.js')}}"></script>
@if(\MVC\Classe\Browser::get() !== 'Internet Explorer')
<script>
/*
SCRIPT JS permettant de ne valider qu'une seule fois un formulaire
ATTENTION tous les formulaires sont affecté
Lors d'une validation bootstrap personnalisé veuillez utilisé
la class do-resubmit sur le formulaire afin de permettre
l'activation supplémentaire du bouton.
*/
window.onload = function() {
let PreventAllforms = document.querySelectorAll("form");
Array.prototype.slice.call(PreventAllforms)
.forEach(function (PreventForm) {
PreventForm.onsubmit = submitted.bind(PreventForm);
});
}
function submitted(event) {
if (event.target.classList.contains('do-resubmit')) {
event.submitter.disabled = false;
}else{
event.submitter.disabled = true;
}
}
</script>
@endif
@show
</body>
</html>
```

View file

@ -53,14 +53,17 @@ class DefaultAction extends Action
}
```
avec cet accès dans la vue:
avec cet accès dans une vue blade:
```php
{{\MVC\Classe\ControlleurAction::inserer('default',[])}}
{{\MVC\Classe\ControlleurAction::inserer('default.default',[4,5,6])}}
{{\MVC\Classe\ControlleurAction::inserer('default.variableSlug',['var1','var2'])}}
{{\MVC\Classe\ControlleurAction::inserer('default.makeHttp11',[])}}
```
ou avec cet accès dans une vue twig:
```php
{{ action('default.defaultTwig',[4,5,6]) }}
{{ action('default.makeHttp11',[]) }}
```
il faut absolument que l'action retourne du texte soit par la la méthode `render` soit par un `système de tampon`

View file

@ -5,6 +5,8 @@ un controlleur similaire a Symfony qui est dénomé ici Conduit car il prend
en paramètre une route défini dans le fichier routing.yml.
Cette fonctionnalité permet de choisir la route indépendamment du moteur.
Elle est utlie aussi pour créer des appels Curl et Ajax.
il faut instancier le fichier `application/config/files/routing.yml`
avec la route de base et les routes que vous voulez conduire, par exemple:
```yml

View file

@ -0,0 +1,27 @@
__Le squelette de départ d'une application ExtJS__ : sisi c'est possible avec node.js mais l'intégration d'un tel outil n'as absolument pas été commencé lors de mon CDD à l'ufc ni même pendant ma période de convalescence du 15/07/2021 au 18/12/2021 car je me refuse encore actuellement de programmer, elle est un petit peu réfléchie et semble absolument possible avec de nombreuses application reliées mais je ne possède pas toutes les compréhensions techniques nécessaires pour le faire actuellement.
__Un moteur de wiki basé sur wikini__ : si les auteurs du wikini0.5 acceptent...
__Un moteur d'écriture en Markdown et Yaml dans de simples fichiers contenus dans /data__ : une portion de cela a été codé et est disponible sur le github du créateur du framework.
----
//
Une dalle pdo plus performante (voir accueillant un système de choix de l'ORM ou un ORM spécifique)
//
//
Une réécriture complète du système de vue afin d'accueillir les nouvelles versions de Twig et Blade
//
//
Un systeme REST plus capable de faire ce qui doit être fait, imitant un peu Slim
//
//
Des améliorations au niveau de l'intégration de Bootstrap5.0 : par exemple le système de notification push
//
//
Ainsi que d'autres petites choses au niveau des objets de session et des composants de domaine (Composants de domaines qui ne seront accessible que sur RENATER, je garde précieusement ces fichiers...)
//