Pour créer un nouveau site avec le framework MVC Staple, téléchargez une version publiée ou tirez une copie récente de Master ou Development. Mettez ces fichiers dans votre répertoire Web de base et indiquez votre serveur dans le dossier /public pour commencer à servir un site Web.
Vous aurez besoin de quelques choses pour que le serveur puisse traiter votre site:
Les règles de réécriture IIS (web.config) et Apache (.htaccess) sont incluses dans le référentiel. Pour Nginx, vous devrez ajouter ce qui suit dans la configuration de votre serveur pour Nginx:
location / {
index index.php index.html index.htm;
try_files $uri $uri/ @staple;
}
location @staple
{
rewrite ^(.*)$ /index.php last;
}
Staple prend également en charge le compositeur. Il n'a pas de dépendances hors de la porte, donc le compositeur est une fonctionnalité facultative pour ajouter toutes les dépendances dont vous pourriez avoir besoin. Ajoutez simplement les dépendances au fichier composer.json inclus.
Plus d'informations sur le compositeur peuvent être trouvées ici: https://getcomposer.org/
Pour démarrer votre nouveau site, le premier fichier avec lequel vous voudrez travailler est l' indexController.php inclus dans /application/controllers . Ce fichier est la page d'accueil par défaut de votre site Web. Et ça ressemble à ceci:
use Staple Controller ;
/** ... */
class indexController extends Controller
{
public function _start ()
{
// Controller Startup Code
}
public function index ()
{
// Index Action Code Goes Here.
}
} Vous placerez de nouveaux contrôleurs dans le dossier application/controllers . À l'intérieur de chaque contrôleur, une nouvelle action de contrôleur est créée en créant une fonction publique qui ne se compose que de lettres et de chiffres.
Pour créer une nouvelle action sur un contrôleur, créez une nouvelle méthode publique qui se compose uniquement de lettres et de numéros pour le nom de la méthode.
class indexController extends Controller
{
...
// Accessible from /index/my-action
public function myAction ()
{
echo " Hello World " ;
}
} La nouvelle action est accessible à partir de /index/my-action par rapport à la racine de votre répertoire Web.
GNU moins gplv3, voir le fichier de licence pour le contenu de la licence.
La documentation est intégrée dans le référentiel et est construite à l'aide de Jekyll. Pour exécuter le site Jekyll, naviguez vers /docs et tapez:
bundle exec jekyll serveSi vous ne l'avez pas déjà fait, vous devriez installer Bundler et les Jekyll Ruby Gems:
gem install bundler jekyllEnsuite, vous devez installer les dépendances avec:
bundle install