update doc

This commit is contained in:
sparkyx 2006-07-29 17:01:31 +00:00
parent 25880b7d75
commit 354b254450
6 changed files with 437 additions and 23 deletions

BIN
doc/INSTALL-fr.pdf Normal file

Binary file not shown.

365
doc/INSTALL-fr.txt Normal file
View file

@ -0,0 +1,365 @@
PhpCompta Installation
originally written by Dany De Bontridder
$Revision$ $Date$
Ce document décrit l'installation complète de PhpCompta et explique
comment ont été installés les programmes dont PhpCompta dépend. Php-
Compta PhpCompta <http://www.alchimerys.be/FR/phpcompta>, site savan-
nah PhpCompta Savannah <http://savannah.nongnu.org/projects/php-
compta/>
______________________________________________________________________
Table of Contents
1. Avertissement
2. Postgresql (version 8.0.1 minimum)
2.1 Installation
2.2 Configuration et démarrage de PostgreSql
2.3 Optimisation
2.4 Pour la sécurité
3. Apache
3.1 Installation d'Apache
3.2 Configuration d'Apache
4. PHP
4.1 Installation de PHP 4.3.1
4.2 Configuration de PHP : Fichier php.ini
4.3 configuration de .htaccess
5. Installation de PhpCompta
5.1 Première installation
5.2 Mise à jour
6. Conclusion
______________________________________________________________________
1. Avertissement
Si vous installez sur Linux, l'installation d'apache, postgres et php
peut se faire avec les "packages" standards fournis; ces "packages"
sont largement suffisants. Les explications données ici sur
l'installation de ces produits sont destinées à ceux préfèrant le
faire manuellement.
Si vous installez sous Windows, il est assez compliqué de recompiler.
Il est préférable d'utiliser les programmes fournis sur Postgres
<http://www.postgresql.org> et EasyPhp <http://www.easyphp.org/>.
Cependant, les configurations des différents produits sont importantes
et devraient être lues avant d'appeler à l'aide.
2. Postgresql (version 8.0.1 minimum)
2.1. Installation
Soit avec des binaires préparés, soit à partir du code source
Le plus simple est d'utiliser les binaires de votre distribution, ne
compiler ces programmes que si vraiment vous devez le faire ou que
vous préfèrez avoir la dernière version disponible.
Si vous décidez de le compiler vous-même, les options suivantes
fonctionnent
./configure -with-tk --with-python --with-perl --prefix=/ou_vous_voulez
2.2. Configuration et démarrage de PostgreSql
Comme d'habitude pour postgres, il faut tout d'abord définir, créer
l'utilisateur postgres puis initialiser l'endroit où seront stocké vos
données (variable env. PGDATA), exemple
root#mkdir /data/psql
root#chown postgres /data/psql
root#su - postgres
postgres#initdb -D /data/psql
postgres#pg_ctl -D /data/psql -o '-i' start
Il est impératif que dans le fichier postmaster.conf vous ayez les
options
tcpip_socket = true
port=5432
D'autres options sont conseillées pour l'optimisation de Postgresql
ne pas oublier d'ajouter dans le PATH, l'endroit où se trouve les
binaires de postgres
ex:
export PATH=$PATH:/opt/psql732/bin
Il est impératif d'avoir soit l'option -i soit la directive
tcpip_socket=true , sinon le server HTTP ne pourra pas contacter
PostgreSql.
Dans PGDATA,vous trouverez le fichier nommé pg_hba.conf qui vous
permettra de régler la sécurité
Ce fichier doit au moins contenir la ligne:
# TYPE DATABASE USER IP-ADDRESS IP-MASK METHOD
host all phpcompta 172.16.30.0 255.255.255.0 local
Il vaut mieux remplacer 172.16.30.0 par l'adresse du server HTTP, dans
le cas où vous utilisez un VirtualHost avec une adresse IP, c'est
cette adresse qu'il vous faudra mettre
2.3. Optimisation
Posgresql est une base de données très rapide, cependant, il vous
faudra configurer pour pouvoir en bénéficier. Les paramètres par
défaut sont prévus pour une machine qui n'a que 16 Mb de RAM... Donc,
aller voir la documentation sur Postgresql.org, chapitre Run-time
Configuration.
Les paramètres que vous pouvez utiliser si vous avez une machine d'au
moins 256 Mb:
· Augmenter la zone mémoire pour les tri (dans postgres.conf)
sort_mem = 8192; cette zone mémoire est important car elle a trait
à la mémoire utilisée pour les tris et les jointures! attention ce
paramètre donne la consommation mémoire par session !
· Faites tourner régulièrement vacumdb -a -z grâce au crontab(une
fois par jour)
· Dans postgres.conf, les shared_buffers: calculées en page de 8Kb,
la valeur par défaut est de seulement 64, ce qui correspond à
512Kb, une meilleure valeur est 640
2.4. Pour la sécurité
Vous pouvez ajouter la sécurité à votre server Postgresql en changeant
dans pg_hba.conf. Mais avant de faire cela, ajoutez un mot de passe à
vos utilisateurs avec la commande remplacer .1. par le nom de
l'utilisateur et .2. par son mot de passe
changement mot de passe
alter user .1. password '.2.'
Sécurité
# TYPE DATABASE USER IP-ADDRESS IP-MASK METHOD
host all phpcompta 172.16.30.0 255.255.255.0 md5
local all phpcompta 172.16.30.0 255.255.255.0 md5
Ensuite soit vous utilisez la variable d'environnement PGPASSWORD qui
contient votre mot de passe soit avec le fichier .pgpass dont la syn-
taxe est
host:port:database:username:password
N'oubliez pas de mettre ce fichier en mode 600 !!!! Pour executer sans
demande de mot de passe host = localhost
3. Apache
3.1. Installation d'Apache
Si vous décidez de le compiler vous-même, les options suivantes
fonctionnent
./configure --prefix=/opt/http2/ \
--enable-ssl \
--enable-http \
--enable-cgi \
--enable-so \
--enable-usertrack \
--enable-headers \
--enable-info
3.2. Configuration d'Apache
Le fichier httpd.conf doit au moins contenir.
LoadModule php4_module modules/libphp4.so
AddType application/x-httpd-php .php4 .php3 .php .phtml
Et si vous décidez d'avoir la même configuration que moi, mais ce
n'est pas obligatoire
< VirtualHost 172.16.30.150 >
ServerName site
ErrorLog phpcompta-error.log
TransferLog phpcompta-debug.log
DocumentRoot /home/httpd/compta/html
</VirtualHost >
Note certains ont fait ceci pour configurer Apache
<VirtualHost localhost>
ServerAdmin webmaster@dummy-host.example.com
DocumentRoot /www/phpcompta/html/
ServerName phpcompta
php_flag session.auto_start 1
php_flag magic_quotes_gpc 0
php_flag session.use_trans_sid 1
php_value include_path ".:../include:../addon"
</VirtualHost>
Actuellement, le répertoire html, contient un fichier .htaccess qui
contient le nécessaire pour que les variables php soient correctes
(voir ``configuration de .htaccess'').
Apache se démarre avec apachectl start
Remarque : Pour plus d'information, voir le manuel d'Apache.
4. PHP
4.1. Installation de PHP 4.3.1
Il doit être compilé le dernier !!! Si vous décidez de le compiler
vous-même, les options suivantes fonctionnent
./configure --prefix=/opt/php431 \
--with-apxs2=/opt/http2/bin/apxs \
--with-fastcgi \
--with-zlib \
--with-pgsql=/usr/local/psql \
--with-mysql \
--with-apache2=/software/httpd-2.0.44
le répertoire /software/httpd-2.0.44 est le répertoire ou vous
installer les sources d'apache
4.2. Configuration de PHP : Fichier php.ini
s'il n'existe pas, vous devez le créer, l'endroit où vous le trouverez
dépend des options de compilation. Dans le cas, où vous avez compilé
php de la même manière que moi, il se trouve dans /opt/php431/lib.
Recopier simplement le fichier fourni à cet endroit.
Sinon, adaptez votre fichier, il doit avoir au minimum les options
suivantes
magic_quotes_gpc = Off
magic_quotes_runtime = Off
magic_quotes_sybase = Off
[Session]
session.save_handler = files ; handler used to store/retrieve data
session.save_path = /tmp ; argument passed to save_handler
; in the case of files, this is the
; path where data files are stored
session.use_cookies = 1 ; whether to use cookies
session.name = PHPSESSID
; name of the session
; is used as cookie name
session.auto_start = 1 ; initialize session on request startup
session.cookie_lifetime = 0 ; lifetime in seconds of cookie
; or if 0, until browser is restarted
session.cookie_path = /tmp ; the path the cookie is valid for
allow_call_time_pass_reference = on
register_argc_argv = on
session.bug_compat_42 = 1
session.bug_compat_warn = 0
session.use_trans_sid = 1
include_path=".:../include:addon"
4.3. configuration de .htaccess
Dans le cas où vous ne pouvez pas changer le fichier php.ini, il faut
simplement modifier ls fichier PHPCOMPTA/html/.htaccess qui contient.
php_value include_path ".:../include:addon"
php_value session.use_trans_sid true
php_value session.auto_start true
php_value max_execution_time 120
php_value magic_quotes_gpc 0
Note:Normalement, vous ne devez pas changer ce fichier.
5. Installation de PhpCompta
5.1. Première installation
On suppose que postgresql est installé correctement
Etape
· Se connecter en tant que postgres et taper les commandes
createuser -h localhost -d -P postgres phpcompta
createdb -h localhost -O phpcompta phpcompta
· Décompacter le package dans le répertoire de votre choix, et
configurer Apache pour qu'il puisse accèder au sous-répertoire
html. (voir plus haut la directive DocumentRoot)
· Eventuellement changer dans constant.php votre domaine (voir manuel
: Domaine)
· Vous devez vous connecter sur http://votre_server/admin/setup.php
5.2. Mise à jour
Etape
· Faite un backup de toutes vos bases de données (cf pg_dumpall)
· Décompacter le package dans le répertoire de votre choix, et
configurer Apache pour qu'il puisse accèder au sous-répertoire
html. (voir plus haut la directive DocumentRoot)
· Vous devez connecter sur http://votre_server/admin/setup.php
6. Conclusion
En vous connectant à l'adresse http://votre_server/admin/setup.php;
vous installerez tout ce qu'il faut, testerez votre installation et
surtout met à jour les bases de données dans le cas d'une mise à jour.
En cas de problème, signalez-le nous.
IMPORTANT Vous devez effacer le répertoire html/admin après
installation ou mise à jour !!!!

View file

@ -255,7 +255,11 @@ Poste</LI>
<P>Ce menu permet de demander des impressions.</P>
<H3>JournauxImpression de journaux, les p&eacute;riodes que vous voyez sont celles del'exercice de votre p&eacute;riode par d&eacute;faut (voir pr&eacute;f&eacute;rence). Vous pouvez soit lesavoir comme un listing soit de mani&egrave;re d&eacute;taill&eacute;e c'est-&agrave;-dire en partie double. </H3>
<H3>Journaux</H3>
<P>Impression de journaux, les p&eacute;riodes que vous voyez sont celles de
l'exercice de votre p&eacute;riode par d&eacute;faut (voir pr&eacute;f&eacute;rence). Vous pouvez soit les
avoir comme un listing soit de mani&egrave;re d&eacute;taill&eacute;e c'est-&agrave;-dire en partie double. </P>
<P>option
<UL>
@ -269,9 +273,20 @@ partie double</LI>
l'avoir en pdf soit en CSV. Avec le CSV, vous pouvez l'importez dans un
tableur et faire une autre pr&eacute;sentation</P>
<H3><A NAME="impress_poste"></A> Poste Impression des postes comptables par p&eacute;riode.L'export en PDF et CSV est pr&eacute;vu. Cela fonctionne exactement commeles journaux.</H3>
<H3><A NAME="impress_poste"></A> Poste </H3>
<H3>FicheImpression des fiches, avec ou sans solde, par p&eacute;riode. On peutexporter en PDF. On imprime des cat&eacute;gories de fiches, pour avoir le d&eacute;taild'une fiche en particulier, il faut utiliser impression des poste <A HREF="#impress_poste">impression_poste</A></H3>
<P>Impression des postes comptables par p&eacute;riode. Il est possible de
recherche sur base soit du quickcode soit du poste comptable.</P>
<P>L'export en PDF et CSV est pr&eacute;vu. Cela fonctionne exactement comme
les journaux.</P>
<H3>Fiche</H3>
<P>Impression des fiches, avec ou sans solde, par p&eacute;riode. On peut
exporter en PDF. On imprime des cat&eacute;gories de fiches, pour avoir le d&eacute;tail
d'une fiche en particulier, il faut utiliser impression
des poste
<A HREF="#impress_poste">impression_poste</A></P>
<H3><A NAME="rapport"></A> Les Rapports</H3>
@ -304,6 +319,10 @@ tr&egrave;s utile pour par exemple les d&eacute;clarations de TVA.</LI>
</UL>
</P>
<P>cas particulier : FROM=00.0000 pour indiquer le d&eacute;but de l'exercice
comptable dans lequel vous &ecirc;tes (voir pr&eacute;f&eacute;rence), utile si vous avez
avez plusieurs exercices comptable dans le m&ecirc;me dossier.</P>
<P>Exemples de formule:
<PRE>
R&eacute;sultat d'exploitation brute round([7%]-[6%])

View file

@ -29,9 +29,9 @@ la colonne, vous pourrez modifier la fiche client. </P>
<P>Dans la 3i&egrave;me colonne, vous avez les actions
<UL>
<LI> C pour avoir la liste des contacts</LI>
<LI> A pour acc&egrave;der &agrave; toutes la correspondance avec ce client</LI>
<LI> F pour acc&egrave;der &agrave; toutes les factures au nom de ce client</LI>
<LI> Contact pour avoir la liste des contacts</LI>
<LI> Courrier pour acc&egrave;der &agrave; toutes la correspondance avec ce client</LI>
<LI> Facture pour acc&egrave;der &agrave; toutes les factures au nom de ce client</LI>
</UL>
</P>
@ -57,13 +57,22 @@ Param&egrave;tre
<P>A la derni&egrave;re &eacute;tape, PhpCompta vous permet de charger un fichier, si vous avez g&eacute;n&eacute;r&eacute; une
facture, celle-ci sera alors remplac&eacute;e.</P>
<H2><A NAME="ss7.3">7.3</A> <A HREF="manuel-fr.html#toc7.3">Menu D&eacute;pense</A>
<P>Dans le cas o&ugrave; vous demandez la g&eacute;n&eacute;ration d'une facture, le num&eacute;ro
de facture sera incr&eacute;ment&eacute;. Dans le module comptable, le num&eacute;ro de
facture n'est jamais incr&eacute;ment&eacute; automatiqueme.</P>
<H2><A NAME="ss7.3">7.3</A> <A HREF="manuel-fr.html#toc7.3">Menu Fournisseur </A>
</H2>
<P> Comme menu client</P>
<H2><A NAME="ss7.4">7.4</A> <A HREF="manuel-fr.html#toc7.4">Menu D&eacute;pense</A>
</H2>
<P> Exactement comme dans le module comptable, sauf qu'aucun document n'est
g&eacute;n&eacute;r&eacute; cependant vous pouvez charger une pi&egrave;ce justificative.</P>
<H2><A NAME="ss7.4">7.4</A> <A HREF="manuel-fr.html#toc7.4">Contact</A>
<H2><A NAME="ss7.5">7.5</A> <A HREF="manuel-fr.html#toc7.5">Contact</A>
</H2>
<P> Dans une companie ou dans une administration, vous pouvez avoir
@ -73,7 +82,7 @@ vous pourriez en ajouter via le menu fiche
<A HREF="manuel-fr-6.html#avance_fiche">fiche</A></P>
<H2><A NAME="ss7.5">7.5</A> <A HREF="manuel-fr.html#toc7.5">Administration</A>
<H2><A NAME="ss7.6">7.6</A> <A HREF="manuel-fr.html#toc7.6">Administration</A>
</H2>
<P>Administrations des finances ou une autre, vous avez besoin de
@ -82,15 +91,22 @@ charger les documents que vous envoyez ou que vous recevez, il vaut
toujours mieux garder une trace de toute vos communications avec eux. </P>
<H2><A NAME="ss7.6">7.6</A> <A HREF="manuel-fr.html#toc7.6">Suivi Courrier</A>
<H2><A NAME="ss7.7">7.7</A> <A HREF="manuel-fr.html#toc7.7">Suivi Courrier</A>
</H2>
<P>Comme le dit le titre, garde une trace de toutes les communications
re&ccedil;ues ou envoy&eacute;es. </P>
<P> Apr&egrave;s avoir encod&eacute; un document, vous pouvez soit directement le lier &agrave; un autre,
si vous connaissez la r&eacute;f&eacute;rence (vous pouvez faire une recherche dans une autre fen&ecirc;tre)
ou vous ouvrez un document existant et vous ajoutez un document qui lui sera li&eacute;.</P>
<P>Vous pouvez faire une recherche soit sur le quickcode, cela
sera celui du destinataire ou de l'exp&eacute;diteur, soit sur une
partie du titre soit sur la r&eacute;f&eacute;rence. </P>
<P>Les r&eacute;f&eacute;rences sont cr&eacute;&eacute;s automatiquement, c'est le style du document
puis un num&eacute;ro de s&eacute;quence</P>
<P> Afin de lier deux actions ensemble, il faut rechercher la
premi&egrave;re, voir le d&eacute;tail
puis cliquer sur "Ajout action". Les deux documents seront alors li&eacute;s.</P>
<P>Vous pouvez ici aussi g&eacute;n&eacute;rer un document ou ajouter une pi&egrave;ce justificative en
plus de la note interne. Cette note n'est jamais repris dans le document.</P>

View file

@ -85,10 +85,11 @@ Il ne reprend pas ce qui a d&eacute;j&agrave; &eacute;t&eacute; dit dans l'INST
<UL>
<LI><A NAME="toc7.1">7.1</A> <A HREF="manuel-fr-7.html#ss7.1">Menu : clients</A>
<LI><A NAME="toc7.2">7.2</A> <A HREF="manuel-fr-7.html#ss7.2">Menu Facture</A>
<LI><A NAME="toc7.3">7.3</A> <A HREF="manuel-fr-7.html#ss7.3">Menu D&eacute;pense</A>
<LI><A NAME="toc7.4">7.4</A> <A HREF="manuel-fr-7.html#ss7.4">Contact</A>
<LI><A NAME="toc7.5">7.5</A> <A HREF="manuel-fr-7.html#ss7.5">Administration</A>
<LI><A NAME="toc7.6">7.6</A> <A HREF="manuel-fr-7.html#ss7.6">Suivi Courrier</A>
<LI><A NAME="toc7.3">7.3</A> <A HREF="manuel-fr-7.html#ss7.3">Menu Fournisseur </A>
<LI><A NAME="toc7.4">7.4</A> <A HREF="manuel-fr-7.html#ss7.4">Menu D&eacute;pense</A>
<LI><A NAME="toc7.5">7.5</A> <A HREF="manuel-fr-7.html#ss7.5">Contact</A>
<LI><A NAME="toc7.6">7.6</A> <A HREF="manuel-fr-7.html#ss7.6">Administration</A>
<LI><A NAME="toc7.7">7.7</A> <A HREF="manuel-fr-7.html#ss7.7">Suivi Courrier</A>
</UL>
<P>
<H2><A NAME="toc8">8.</A> <A HREF="manuel-fr-8.html">Le module Param&egrave;tre </A></H2>

View file

@ -947,7 +947,7 @@ Poste
Ce menu permet de demander des impressions.
<sect2>Journaux
Impression de journaux, les périodes que vous voyez sont celles de
<p>Impression de journaux, les périodes que vous voyez sont celles de
l'exercice de votre période par défaut (voir préférence). Vous pouvez soit les
avoir comme un listing soit de manière détaillée c'est-à-dire en partie double.
@ -965,13 +965,15 @@ tableur et faire une autre pr
</sect2>
<sect2>Poste <label id="impress_poste">
Impression des postes comptables par période.
<p>Impression des postes comptables par période. Il est possible de
recherche sur base soit du quickcode soit du poste comptable.
L'export en PDF et CSV est prévu. Cela fonctionne exactement comme
les journaux.
</sect2>
<sect2>Fiche
<p>
Impression des fiches, avec ou sans solde, par période. On peut
exporter en PDF. On imprime des catégories de fiches, pour avoir le détail
d'une fiche en particulier, il faut utiliser impression
@ -1007,6 +1009,10 @@ devez utiliser l'option FROM=MM.YYYY (voir exemple). Ce genre d'option est
très utile pour par exemple les déclarations de TVA.
</itemize>
<p>cas particulier : FROM=00.0000 pour indiquer le début de l'exercice
comptable dans lequel vous êtes (voir préférence), utile si vous avez
avez plusieurs exercices comptable dans le même dossier.
<p>
Exemples de formule:
<verb>
@ -1173,9 +1179,9 @@ la colonne, vous pourrez modifier la fiche client.
<p>Dans la 3ième colonne, vous avez les actions
<itemize>
<item> C pour avoir la liste des contacts
<item> A pour accèder à toutes la correspondance avec ce client
<item> F pour accèder à toutes les factures au nom de ce client
<item> Contact pour avoir la liste des contacts
<item> Courrier pour accèder à toutes la correspondance avec ce client
<item> Facture pour accèder à toutes les factures au nom de ce client
</itemize>
<p>Ajout de client en cliquant sur le bouton ajout
@ -1198,8 +1204,15 @@ Param
<p>A la dernière étape, PhpCompta vous permet de charger un fichier, si vous avez généré une
facture, celle-ci sera alors remplacée.
</sect1>
<p>Dans le cas où vous demandez la génération d'une facture, le numéro
de facture sera incrémenté. Dans le module comptable, le numéro de
facture n'est jamais incrémenté automatiqueme.
</sect1>
<sect1>Menu Fournisseur
<p> Comme menu client
</sect1>
<sect1>Menu Dépense
<p> Exactement comme dans le module comptable, sauf qu'aucun document n'est
généré cependant vous pouvez charger une pièce justificative.