SourceML

Installation

Pré-requis

Pour installer SourceML, vous devez disposer d'un hébergement avec :

  • Php en version 7.0.8 minimum
  • MySql

Récupérez la dernière version de SourceML

Rendez-vous sur la page Télécharger pour récupérer la dernière version.

SourceML est disponible dans un fichier sourceml.<version>.tar.gz. Cette archive, une fois décompressée, fournit un dossier sourceml.

Installez les fichiers sur votre site

Une fois l'archive décompressée, le dossier sourceml a le contenu suivant :

bin/
composer.json
config/
.env
.htaccess
index.php
public/
README.md
src/
templates/
translations/
var/
vendor/

Installez l'ensemble de ces fichiers et dossiers sur votre serveur.

Note : Sourceml a besoin de l'ensemble de ces fichiers pour fonctionner, mais seul le dossier public a besoin d'être accessible via HTTP. L'idéal est de configurer la racine web du serveur pour pointer sur le dossier public.

Attention : Le fichier .env contiendra vos informations de connexion sur votre base de données. Ce fichier NE DOIT PAS être accessible via HTTP.

Si une fois les fichiers installés sur le serveur vous pouvez ouvrir le fichier .env dans un navigateur et voir son contenu, ne faites pas l'installation avant d'avoir interdit l'accès au fichier .env.

Si vous voulez renommer le dossier public 

Vous pouvez renommer le dossier public fourni par l'archive.

Par exemple si sur votre hébergement la racine HTTP se trouve dans le dossier public_html, renommez le dossier public en public_html et précisez ce nom dans le fichier config/packages/app.yaml :

parameters:

(...)

web_dir: public_html 

Vérifiez les droits en écriture

SourceML a besoin de pouvoir créer des dossiers et des fichiers sur votre hébergement.

Si en allant sur votre site vous voyez le message suivant :

some files or directories aren't writable

Assurez-vous que Php a bien accès en écriture sur les dossiers :

  • var/cache
  • var/log
  • public

Ainsi que sur le fichier :

  • .env (*)

(*) Ce fichier n'a besoin d'être accessible en écriture que durant l'installation.

Suivez l'installation en ligne

Rendez-vous sur votre site et suivez l'intallation en ligne.

Renseignez vos information de connection à MySql, choisissez un titre pour votre site ainsi qu'un login et un mot de passe pour votre compte.

Et si tout se passe bien, vous devriez pouvoir commencer à publier vos sources.

En vous souhaitant de bonnes publications !