extranet/docs/README
2013-05-27 08:07:52 +00:00

164 lines
4.3 KiB
Plaintext

SYSTEM REQUIREMENTS
===================
- Apache 2.2
- PHP 5.2.x
- APC
- Chartdir library
- browscap.ini (http://tempdownloads.browserscap.com/)
- wkhtmltopdf (http://code.google.com/p/wkhtmltopdf/)
INSTALLATION
============
Apache configuration
--------------------
See VHOST for example
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.
WKHTMLTOPDF
-----------
- Get the static version of wkhtmltopdf
- On Ubuntu :
sudo apt-get install libxrender1 libfontconfig
- Set execution flag (chmod +x)
- Test
Configure your environment
==========================
Temporary storage - see in scripts/build/configure.php
-----------------
[projet]/
cache
files
infogreffe
log
pages
rss
sessions
wsdl
Static storage
--------------
Local configuration
===================
Voir Configuration vhost
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
Le répertoire config contient la configuration suivant les différentes machines,
à copier dans le repertoire application/configs/ et à modifier suivant votre machine
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.
Répertoire de données (data)
============================
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/pdf => a remplacer par actes et bilans (Nouvelle structure)
data/wkhtml
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