Skip to main content

Nouveau projet

Dossier de projet

  1. Créez un dossier vide pour votre projet à l'endroit où vous mettez vos projets web.
  2. Nommez ce dossier selon votre projet.

Composer fonctionne uniquement si le dossier est vide, donc ne pas ajouter Git à cette étape.

Téléchargement

Overdog, dépendances PHP et scripts post-create du projet

Allez à la racine du projet avec votre terminal et faire la commande suivante. Notez que le point à la fin est important pour éviter de créer un sous-dossier.

composer create-project 3ejoueur/overdog .

Paquets Node.js pour le développement et la compilation

Allez à la racine du projet avec votre terminal et faire :

yarn install

Serveur local

Serveur et base de données

  1. Créez un nouveau Host sur votre serveur local.
  2. Créez une base de données MySQL. Vous pouvez utiliser l'utilisateur et mot de passe root / root comme ceci ne sera jamais déployé.
  3. Faites pointer ce host sur le dossier web de votre projet.

Si vous utilisez Mamp, assurez-vous que Allow network access to MySQL est coché dans l'onglet MySQL

Fichier .env

Dans le fichier .env à la racine du projet, allez remplir :

Url de développement et base de données

  • ENVIRONMENT > dev
  • SYSTEM_STATUS > 1
  • SYSTEM_NAME > Nom du client qui sera visible dans le Panneau de contrôle, mettre entre guillemets.
  • SITE_URL > le URL de développement de votre host (sans trailing slash)
  • SITE_GROUP > Nom du groupe de locale(langue). Nom du client, sera visible aux visiteurs comme title dans le head.
  • SECURITY_KEY > Laissez vide, sera générée lors de l'installation
  • DB_DRIVER > mysql
  • DB_SERVER > localhost ou 127.0.0.1 (exemple)
  • DB_PORT > souvent 3306 ou 8889
  • DB_DATABASE > nom de le base de données créée
  • DB_USER> utilisateur (possiblement root)
  • DB_PASSWORD > mot de passe (possiblement root)
  • DB_SCHEMA > public
  • DB_TABLE_PREFIX > laissez vide
  • APP_ID > laissez vide

Informations sur les volumes de stockage

Demandez au responsable de vous créer votre user client pour les assets. Les renseignements suivants vous seront fournis.

  • S3_BUCKET_DOCS > Nom du bucket des documents
  • S3_BUCKET_IMAGES > Nom du bucket des images
  • S3_BUCKET_REGION > ca-central-1
  • S3_BUCKET_SUBFOLDER > Nom du client url friendly en minuscule - sera dans le url des CDN.
  • S3_DOCS_URL > Url du Cloudfront des documents
  • S3_DOCS_DIST_ID > Id du Cloudfront pour les documents
  • S3_IMAGES_URL > Url imgix des images
  • S3_USER_ID > User access Key ID
  • S3_USER_SECRET > Secret Access Key
Les informations des volumes de stockage sont disponibles dans LastPass. Ne JAMAIS conserver cela dans une note sur votre ordinateur.

Installez Craft CMS

Dans votre dossier de projet, faire dans le terminal :

php craft setup/welcome

Cela va générer une SECURITY_KEY dans votre fichier .env et l'application ID. Cette clé sera la même pour tous, donc à ajouter dans LastPass. Plus d'info dans la section fichier .env

Suivre le processus d'installation et inscrire les renseignements de votre base de données, host, etc.

Pour le NOM DU SITE, le SITE URL et la LANGUE, faites seulement Enter. Votre installation va se synchroniser avec les paramètres de Overdog par la suite.

Créez un repo Git chez Gitlab

Créez votre projet sur Gitlab (demandez aux responsables si vous ne pouvez pas).

Ne cochez pas Initialize repository with a readme, le garder complètement vide

Ajoutez Git à votre projet local

  • Ajouter votre dossier de projet précédemment créé dans votre logiciel ou terminal pour ajouter Git (la méthode diffère un peu selon l'outil utilisé).
  • Nommez ou renommez votre branche locale develop.
  • Ajouter le remote (Gitlab), idéalement via SSH, de votre projet créé chez Gitlab.
  • Faire un inital commit de develop et envoyer vers une nouvelle branche develop.