-
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
12 changed files
with
149 additions
and
77 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,22 @@ | ||
#Les étapes de configurations de SAND | ||
|
||
il vous faut modifier quelques valeurs dans les fichiers de configuration suivant | ||
- `application/config/app-parameters.php.skel` | ||
- `application/config/bdd-parameters.php.skel` | ||
Il vous faudra modifier quelques valeurs dans les fichiers de configuration suivants | ||
|
||
+ `application/config/app-parameters.php.skel` | ||
+ `application/config/bdd-parameters.php.skel` | ||
|
||
> _En l'occurence `app-parameters` permet de configurer les variable de l'application (url, etat de l'application, dossier prefixé, etc.) alors que `bdd-parameters` vous permet de configurer les accès aux bases de données propres à l'application que celles-ci soient distantes ou sur le même serveur. Tout est fait avec pdo, donc il vous est possible suivant la configuration de votre php d'accéder a de nombreuses base de données différentes. Souvent pour le web on utilise simplement `Mysql`, `PostGreSQL` ou `Mariadb` mais il ne tient qu'a vous d'utiliser d'autres base de données ancienne comme `Oracle` qui est la référence dans le domaine._ | ||
> Une fois que vous avez fait cela, vous pouvez enlever l'extension `.skel` afin que l'autoload de composer puisse les prendre en compte. | ||
Vous pouvez totalement tester l'application de base de SAND en générant le dossier `vendor`. Pour cela il faut placer votre console à la racine de l'application et puis lançer | ||
`composer update`. Si votre serveur (`Apache` ou `Nginx`) est correctement configuré pour pointer dans le dossier public sur l'index, vous devriez obtenir une application de test avec les fonctionnalités de base. En triturant un peu les fichier contenus dans le dossier `application/include` vous devriez comprendre comment se contruit une application réalisée avec SAND. | ||
|
||
et enlever l'extension `.skel` afin que l'autoload de composer puisse le prendre en compte | ||
|
||
Vous pouvez tester une application de base simple en générant le dossier vendor en vous mettant à la racine de l'application et en lançant | ||
`composer update`. Si votre serveur est correctement configurer pour pointer dans le dossier public sur l'index, vous devriez obtenir une application de test avec les fonctionnalités de base. En triturant un peu les fichier contenus dans le dossier `application/include` vous devriez comprendre comment se contruit une application faites avec SAND. | ||
Il en va de même pour tous les fichiers de configuration présent dans le dossier `config` portant l'extension `.skel` | ||
En effet les autres fichiers contenus dans `config` servent pour la branche dev, mais peuvent aussi servir pour votre application. | ||
|
||
Les autres fichiers contenus dans config servent pour la branche dev, mais peuvent aussi servir pour votre application. | ||
Dans le cas où vous choisissez d'utiliser les conduits symfony lors du développement de votre application, vous devrez modifier le fichier `application/config/files/routing.yml`. | ||
|
||
Dans le cas où vous choissisez d'utiliser les conduits lors du développement de votre application, | ||
vous devrez modifier le fichier `application/config/files/routing.yml`. | ||
Les conduits Symfony permettent de totalement controler l'aspect de l'adresse ([URL](https://wikini.besançon25.fr/wakka.php?wiki=UrnUriUrlDefinitions)) se trouvant dans la barre de votre butineur. En effet grâce à ce package de la communauté Sf ainsi que de Monsieur Fabien Potencier, vous pouvez vous débarasser d'un nommage classique de la variable. C'est quelquefois plus lisible, mais aussi quelques fois moins.... | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
19 changes: 11 additions & 8 deletions
19
data/docs/01.d. Comment bien utiliser les commandes console.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,18 +1,21 @@ | ||
#Comment bien utiliser les commandes dans le framework SAND | ||
|
||
Les commandes console du framework sont toutes documentée par l'appel de la méthode help | ||
Les commandes `console/bin.php` du framework (le binaire php) sont toutes documentée par l'appel avec la méthode help | ||
|
||
Par exemple pour voir les méthodes associés à la commande page vous pourvez lancer la commande suivante depuis le dossier console: | ||
_En fait : structurellement, les commande sont des classes comportant un nom et des méthodes, vous remarquerez que vos commande de classes peuvent être rangé dans le dossier `Console/App`, ce sont ainsi vos production qu'il faut ici implémenter. | ||
Tout ce qui touche a des commandes propre au framework sont dans `Console/Sand`. Ici, clairement si un contributeur veut modifier les commande des Modules, il pourra le faire dans App ou dans Sand, peut importe, au final le mieux ce serait qu'il les partage avec la communautée par une pull Request_ | ||
|
||
|
||
Par exemple pour voir les méthodes associés à la commande `page` vous pouvez tout à fait taper la commande suivante depuis le dossier `console` : | ||
|
||
`php bin.php page:help` | ||
|
||
et vous verrez les différentes méthodes qui y sont associées. | ||
|
||
Typiquement sur un projet on peut soit ajouter les fichiers manuellement quand on a l'habitude, soit aussi profiter des commandes: | ||
`action`,`conduit`,`module` et `page` | ||
Typiquement sur un projet : l'on peut soit ajouter les fichiers manuellement quand on a l'habitude, soit aussi profiter des commandes utiles en mode console: | ||
`action`, `conduit`, `module` et `page` | ||
|
||
Si vous avez a videz le cache des vues et des logs vous pouvez utiliser la commande | ||
Et, si vous devez vider le cache des vues et/ou des logs vous pouvez totalement vous jetez sur l'utilisation des commandes | ||
`php bin.php cache:clear` | ||
quand a | ||
`php bin.php cache:stabilize` | ||
vous permet de vider le cache des vues blade et/ou twig | ||
et | ||
`php bin.php cache:stabilize` |
64 changes: 36 additions & 28 deletions
64
data/docs/01.e.i Comprendre SAND pour ajouter une nouvelle page.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,19 @@ | ||
#Comment jouer avec les pages avec SANDconsole ? | ||
|
||
Lancez donc la SANDcommande suivante depuis la racine | ||
|
||
`php console/bin.php page:add` | ||
|
||
puis répondez calmement aux questions en donnant un nom tel que `hello_world`, et... c'est trois(3) nouveaux fichiers qui 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` | ||
|
||
Maintenant, à vous de modifier ces trois fichiers ! | ||
|
||
Bon, il faudrait la renommer, pas de panique SOS SANDconsole est là :) `php console/bin.php page:rename` | ||
|
||
Vous voulez en faire une copie ? `php console/bin.php page:duplicate` | ||
|
||
Finalement votre nouvelle ne vous plait plus, baaah ; supprimez là avec `php console/bin.php page:remove` | ||
|
||
|
Oops, something went wrong.