extranet/docs/README

README
======

 - Project
 - System Requirements
 - Installation
 - Library
 - Translate

Note : Project are define to be use on Linux Server, so take care about path and file name. 


PROJECT
=======
	
	This application is a frontend for the WebService and it's display information graphically.


SYSTEM REQUIREMENTS
===================

 - Apache 2.4
 - PHP 5.5.x
 - Chartdir library
 - browscap.ini (http://tempdownloads.browserscap.com/, http://browscap.org/)
 - wkhtmltopdf (http://wkhtmltopdf.org/)


INSTALLATION
============

See the file scripts/build/configure.php

On server this script is automatically called with the install option.
	configure.php --install

Each servers are reference with a directory, name as the hostname, in config dir and all configure 
file is list here


Environment configuration
-------------------------

 - Variables
 	
 Define application environment in the vhost. This mode activate special features and debugging mode.

	SetEnv APPLICATION_ENV "production" => Production
	SetEnv APPLICATION_ENV "staging" => Recette
	SetEnv APPLICATION_ENV "development" => Developpement
 
 - Persistent Storage 
	
	data/asso
	data/association
	data/bilanclient
	data/bodacc
	data/courrier
	data/giant
	data/greffes
	data/groupes
	data/iris
	data/log
	data/logos
	data/marques
	data/nouveautes
	data/wkhtml 
 
 - Temporary storage
	 
	 [projet]/data/
		cache
		files
		pages
		sessions
		wsdl
		

Apache configuration
--------------------

	=> Development example

	<VirtualHost *:80>
		ServerName extranet.sd.dev
		AddDefaultCharset utf-8
		DocumentRoot "WORKSPACE/extranet/public"	
		SetEnv APPLICATION_ENV "development"		
		<Directory "WORKSPACE/extranet/public/">
			AllowOverride All
			Order allow,deny
			Allow from all  
			<IfModule mod_rewrite.c>
	            RewriteEngine On
	            RewriteCond %{REQUEST_URI} ^/favicon.ico$ [OR]
	            RewriteCond %{REQUEST_FILENAME} -s [OR]
	            RewriteCond %{REQUEST_FILENAME} -l [OR]
	            RewriteCond %{REQUEST_FILENAME} -d
	            RewriteRule ^.*$ - [NC,L]
				RewriteRule ^.*$ index.php [NC,L]
			</IfModule>
		</Directory>		
		# Possible values include: debug, info, notice, warn, error, crit, alert, emerg.
		LogLevel debug
		ErrorLog "logs/extranet-error.log"
		CustomLog "logs/extranet-access.log" common
	</VirtualHost>

	=> Production configuration 
		
		See VHOST file


PHP Configuration
-----------------

File upload 
-----------
    post_max_size = 50M
    file_uploads = On
    upload_max_filesize = 40M
    max_file_uploads = 10

Session
-------
	On sharing plateform, these parameters must be specified to the best value for all web application

    session.gc_maxlifetime = 86400
    session.cookie_lifetime = 86400

	Application must override the session.save_path, soap.wsdl_cache_dir to define it's own path.

Project Configuration
---------------------

	- Autoloader 
		See in the public/index.php. We use Classmpap Autloader which store Class Key and his file 
		path.
		To generate classmap file use bin/classmap_generator.php
	
	- 


WKHTMLTOPDF
-----------
	- Get the static version of wkhtmltopdf
	- On Ubuntu : 
		sudo apt-get install libxrender1 libfontconfig
	- Set execution flag (chmod +x)
	- Test on command line
	
	Page Break with WkhtmlToPdf :
		In print CSS use all theses page-break-* properties	
		
		page-break-before, 
		page-break-after
			Auto	Pas de règle particulière en ce qui concerne les sauts de page.
			Always	Force un saut de page systématiquement avant ou après l'élément.
			Avoid	Evite dans la mesure du possible un saut de page avant ou après l'élément.
			Left	Définit que le prochain saut de page se fera sur la page de gauche.
			Right	Définit que le prochain saut de page se fera sur la page de droite.
			Inherit	Valeur identique à celle de l'élément parent.
		
		page-break-inside
			Auto	Pas de règle particulière en ce qui concerne les sauts de page.
			Avoid	Evite dans la mesure du possible un saut de page au milieu l'élément.
			Inherit	Valeur identique à celle de l'élément parent.
	

WebService 
----------


Partners 
--------


LIBRARY
=======



TRANSLATE
=========

	1. Creating PO file
	--------------------	
 	To create a PO file for different applications, first we need to download and install poedit, 
 	here is the download link http://www.poedit.net/download.php

	2. Set the poedit preferences
	-----------------------------
    File->Preferences : Fill fields to set our identies
    tab Parsers, edit PHP settings, in the list of extension add *.phtml

	3. Open a po file
	------------------	
	PO file configuration for each project. As project as to be share use path that could work everywhere.
	Catalogue->Properties, Set the Base paht to "../../" (to read under the whole project, if po 
	files is located under PROJECT/application/languages/)
	
	Add supplemental paths to look in (application, library,....)
	Add more precise search string by configuring in the Sources keywords these items

	    translate
	    _
	    setLabel
	    setValue
	    setMessage
	    setLegend
	    _refresh
	    append
	    prepend
 
	In PHP source embrace all strings only with these functions.









Gestion des sessions
====================
Pour la gestion des sessions, il est nécessaire de faire une configuration spéciale afin d'éviter 
les conflits entre les différents vhosts.

Les sessions sont stockées dans le même repertoire, les valeurs gc_maxlifetime, cookie_lifetime 
définissent les limites de validité des sessions.
Il faut savoir que chaque modification faites par chaque application, dans chaque vhosts modifie le 
fonctionnement général de PHP.
Pour eviter d'avoir des conflits sur la gestion des sessions, nous stockons les sessions dans un 
répertoire définit.

Voir la configuration dans le fichier application.ini

resources.session.save_path = APPLICATION_PATH "/../cache/sessions"
resources.session.gc_maxlifetime = 86400
resources.session.cookie_lifetime = 86400
resources.session.remember_me_seconds = 86400

Debuggage
=================
Firebug et ChromePHP sont disponible.
Voir dans le fichier Bootstrap pour activer ou non le debuggage.

CONFIGURATION APC
=================
apc.cache_by_default = On
apc.enable_cli = Off
apc.enabled = On
apc.shm_size = 60
apc.max_file_size = 1M
apc.include_once_override = On
apc.stat = Off
apc.stat_ctime = Off

apc.shm_size : Taille du cache en Mo.
apc.num_files_hint : La valeur du nombre maximum de fichiers à cacher est conseillée.
apc.user_entries_hint : La valeur du nombre maximum d'entrées utilisateur 
(cache utilisateur) à stocker est conseillée.

Il n'est pas conseillé de tenter de leurrer APC en doublant (par exemple) 
ces valeurs. APC double déja en interne les valeurs spécifiées, et le gain en 
performances est fortement réduit avec des valeurs non adaptées. 

apc.stat : Se base sur les dates de modifications pour recharger le fichier
apc.stat_ctime : Se base sur les dates de création pour recharger le fichier

apc.max_file_size : Restriction sur la taille maximum d'un fichier à cacher. 
Ceci peut créer des problèmes de performance lors de la demande en cache de ces 
fichiers-là, mais si la mémoire est limitée, l'option demeure intéressante

apc.filters : Expression régulière utilisée pour exclure tout fichier dont le 
nom a une correspondance.

apc.cache_by_default : Inverse la tendance de apc.filters : APC cachera 
uniquement les fichiers qui ont une correspondance sur le filtre, au lieu de les ignorer.

apc.cache_by_default = Off
apc.filters = "+\.php$"

Dans le vhosts d'apache : 
php_flag apc.cache_by_default On