Créer une application

Cet article est un tutoriel pour installer it.rocks et créer une application type “Hello World”.

Pré-requis

Ce tutoriel vous présente l’installation sous l’environnement suivant :

  • Système d’exploitation Linux Ubuntu 14.04 trusty ou plus récent,
  • PHP version 5.6,
  • Apache 2.2 / 2.4,
  • Mysql server 5.5 ou plus récent, moteur InnoDB.

Bien entendu vous pouvez utiliser it.rocks sous d’autres environnements. A vous dans ce cas d’adapter votre installation en tenant compte des contraintes indiquées et en les transposant à votre environnement.

  • il n’y a pas que Ubuntu sur terre,
  • de plus anciennes version d’Apache ou MySQL peuvent très bien fonctionner,
  • d’autres serveurs Web que apache peuvent également fonctionner,
  • Mysql est pour l’instant le seul moteur de base de données supporté,
  • PHP version 5.6 au minimum nécessaire, pour l’instant pas de compatibilité PHP 7.X.

Un certain nombre de programmes supplémentaires sont nécessaires. Pour n’en citer que quelques-uns :

  • git pour télécharger it.rocks et gérer les versions. de votre projet,
  • wget pour télécharger certaines dépendances,
  • gnumeric si vous souhaitez utiliser des fonctionnalités d’import-export de fichiers de tableurs.

Installation sous Debian / Ubuntu / Mint

Installation des paquets nécessaires

sudo apt-get install apache2 mysql-server libapache2-mod-php5 php5-mysqlnd git wget

Configuration d’Apache

Dans /etc/apache2/sites-enabled/000-default.conf ou le fichier de configuration de votre site internet :

  • Ajoutez le type d’application php AddType application/x-httpd-php .php ,
  • Ajoutez le MultiViews à la ligne Options de votre section ; si besoin, rajoutez cette section comme dans l’exemple ci-dessous,

Vous devez avoir les privilèges super-administrateur pour pouvoir modifier ce fichier.

Si vous ne savez pas où insérer ces lignes de configuration, prenez exemple sur ce modèle de fichier 000-default.conf fonctionnel :

<VirtualHost *:80>
        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/html
 
        AddType application/x-httpd-php .php
 
        <Directory /var/www/html>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride None
                Require all granted
        </Directory>
 
        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

  • Relancez ensuite apache avec la commande suivante :
    sudo service apache2 restart

Configuration de Mysql

Le framework a été conçu pour un moteur de bases de données Mysql version inférieure à 5.7. Il est compatible avec cette version et les suivantes du moteur de bases de données, mais vous devrez rajouter la ligne suivante à votre fichier de configuration my.cnf / mysqld.cnf, dans la section [mysqld] :

Vous devez avoir les privilèges super-administrateur pour pouvoir modifier ce fichier.

sql_mode = ""

Relancez ensuite votre serveur de bases de données :

sudo service mysql restart

Installation du framework it.rocks

Téléchargement de it.rocks et initialisation de l’application helloworld

cd /var/www/html
wget https://gitlab.bappli.com/itrocks/framework/raw/master/init.php
php ./init.php yourvendorname helloworld

Note explicative :
Ce qui suit est là pour vous apporter plus de précisions sur ce que vous venez d’effectuer, les opérations décrites sont déjà réalisées, ces informations vous aideront à créer d’autres projets ou adapter l’organisation de vos fichiers à l’architecteur de votre serveur.

  • it.rocks nécessite un script alias pour accéder à votre projet depuis Apache. Dans notre exemple nous accéderons à l’application par le biais de l’adresse localhost/helloworld. Pour cela il est impératif que le dossier dans lequel vous stockez votre projet ne s’appelle PAS helloworld : si c’était le cas, nous ne pourrons pas utiliser de script alias qui aurait le même nom que le dossier. C’est pour cela que le script d’installation init.php créer votre projet sous le dossier yourvendorname-helloworld.
  • init.php est un script d’initialisation pour votre projet : il va créer un squelette d’application identifiée de manière unique par votre identifiant d’auteur d’application yourvendorname et le nom de l’application helloworld. Ces identifiants déterminent le namespace qui sera utilisé pour les classes de votre application, ils sont donc à choisir avec soin, notamment votre yourvendorname doit être celui enregistré au préalable sur http://itrocks.org afin d’en garantir l’unicité, et éviter toute collision entre votre espace de nommage et celui de modules existants que vous souhaitiez utiliser.
  • une base de données MySQL est créée, nommée yourvendorname_helloworld et accessible par l’utilisateur mysql dédié créé à cet effet.

Accès à votre application

Tapez l’adresse de l’application sous votre navigateur internet, par exemple pour un serveur local http://localhost/helloworld, et affichez le résultat.

Et voilà !

Pour aller plus loin

Ecrivez votre première classe métier en suivant ce lien :
Un carnet d’adresses vite fait bien fait

Montrer l'historique