MonarcAppFO/README.md

4.5 KiB

Skeleton Monarc Project

Introduction

Skeleton Monarc Project.

Installation

PHP & MySQL

Install PHP (version 7.0 recommended) with Apache (or Nginx) with extensions : xml, mbstring, mysql, zip, unzip For Apache add mods : rewrite, ssl

Install MySQL (version 5.7 recommended) or MariaDb equivalent

The recommended way to get a working copy of this project is to clone the repository and use composer to install dependencies using the create-project command:

curl -s https://getcomposer.org/installer | php --
php composer.phar create-project -sdev --repository="https://github.com/CASES-LU/skeleton/raw/master/packages.json" monarc/skeleton ./monarc

Alternately, clone the repository and manually invoke composer using the shipped composer.phar:

cd my/project/dir
git clone ssh://github.com/CASES-LU/MonarcAppFO.git ./monarc
cd monarc
php composer.phar self-update
php composer.phar install -o

(The self-update directive is to ensure you have an up-to-date composer.phar available.)

Databases

Create 2 databases:

CREATE DATABASE monarc_cli;
CREATE DATABASE monarc_common;

Change Sql Mode for each database:

SET GLOBAL sql_mode = 'MYSQL40';
SET SESSION sql_mode = 'MYSQL40';

Create 2 symbolics links at project root:

mkdir module
cd module
ln -s ./../vendor/monarc/core MonarcCore;
ln -s ./../vendor/monarc/frontoffice MonarcFO;

Interfaces

Repository for angular at project root:

mkdir node_modules
cd node_modules
git clone https://github.com/CASES-LU/ng-client.git ng_client
git clone https://github.com/CASES-LU/ng-anr.git ng_anr

Web Server Setup

PHP CLI Server

The simplest way to get started if you are using PHP 5.4 or above is to start the internal PHP cli-server in the root directory:

php -S 0.0.0.0:8080 -t public/ public/index.php

This will start the cli-server on port 8080, and bind it to all network interfaces.

**Note: ** The built-in CLI server is for development only.

Apache Setup

To setup apache, setup a virtual host to point to the public/ directory of the project and you should be ready to go! It should look something like below:

<VirtualHost *:80>
    ServerName monarc.localhost
    DocumentRoot /path/to/monarc/public
    SetEnv APPLICATION_ENV "development"
    <Directory /path/to/monarc/public>
        DirectoryIndex index.php
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

Database connection

Create file config/autoload/local.php:

return array(
    'doctrine' => array(
        'connection' => array(
            'orm_default' => array(
                'params' => array(
                    'host' => 'host',
                    'user' => 'user',
                    'password' => 'password',
                    'dbname' => 'monarc_common',
                ),
            ),
            'orm_cli' => array(
                'params' => array(
                    'host' => 'host',
                    'user' => 'user',
                    'password' => 'password',
                    'dbname' => 'monarc_cli',
                ),
            ),
        ),
    ),
);

Configuration

Create file configuration

sudo cp /config/autoload/local.php.dist /config/autoload/local.php

Update connexion information to local.php and global.php

Configuration files are stored in cache. If yours changes have not been considered, empty cache by deleting file in /data/cache

Install Grunt

sudo apt-get install nodejs
sudo apt-get install npm
sudo npm install -g grunt-cli

Only for linux system:

sudo ln -s /usr/bin/nodejs /usr/bin/node (seulement linux)

Update project

Play script (pull and migrations):

sudo sh ./scripts/update-all.sh

This shell script use others shell script. May be you node to change rights of these others files

Create Initial User

Modify email and password of first user in /module/MonarcFO/migrations/seeds/adminUserInit.php

Create first user:

php ./vendor/robmorgan/phinx/bin/phinx seed:run -c ./module/MonarcFO/migrations/phinx.php