✎ phpcompta [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== PhpCompta ======

PhpCompta est une application GPL de comptabilité, ERP, CRM destiné aux entrepreneurs, indépendant et moyenne entreprise, elle permet la génération de facture, bon de commande, note de frais, bordereau de livraison,... sur base de modèles, les modèles sont soit en RTF, soit en HTML ou Text ou des documents Write ou Calc (voir le site [[http://OpenOffice.org|OpenOffice]]). Multi-Dossiers et multi-utilisateurs, elle est entièrement paramétrable. La version 5, permet aussi l'ajout d'extension (plugin). Elle est écrite en PHP et javascript (Ajax), la base de données utilisée est Postgresql dont la version est au moins 8.2. Une installation avec Postgresql 8.4 fonctionne.

Elle est très flexible et peut s'adapter à la comptabilité de n'importe quel pays.

Il est possible de la tester sur le site [[http://phpcompta.eu/demo|PhpCompta]] (utilisateur / mot de passe = demo / demo ou phpcompta / phpcompta)

PhpCompta vous donne la possibilité de choisir entre une en comptabilité française ou belge lorsque vous créez vos dossiers.

En cas de problème, le plus simple est sans doute de poser directement vos questions sur le forum PhpCompta ou via la liste dédiée à laquelle vous pouvez vous inscrire (voir site phpcompta.eu dont le lien est en pied de page).

La procédure ci-dessous est très largement inspirée de celle du site [[http://phpcompta.eu/demo|PhpCompta]] que vous pouvez trouver en suivant ce [[http://www.phpcompta.be/index.php?option=com_content&task=view&id=16&Itemid=30|lien]].

===== Installation ======

Voici comment installer le logiciel de compta libre PHPCOMPTA sous Ubuntu (Dapper Drake et postérieures) sur une machine indépendante (toute seule dans son coin, non reliée à un réseau) et connectée à internet.

==== Dépendances nécessaires ====

[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **[[apt://apache2,postgresql-8.4,php5,php5-pgsql,libapache2-mod-php5,php-gettext|apache2, postgresql, php5, php5-pgsql,libapache2-mod-php5, php-gettext]]**.

Pour décompresser l'archive phpcompta que vous aurez téléchargée sur le site (voir ci-dessous), vous aurez besoin d'avoir installé préalablement [[:p7zip|p7zip]] qui se trouve sur le dépôt Universe (à activer le cas échéant).

==== Récupération du fichier PhpCompta et mise en place ====

Les versions de phpcompta évoluant régulièrement, le plus simple est de se rendre sur le site de phpcompta.eu et de télécharger la dernière version depuis le menu "Télécharger" accessible dès la page d'accueil.

Une fois le fichier téléchargé sur votre disque dur, décompressez-le : il suffit de faire un clic droit dessus et de cliquer sur "Extraire ici". Le dossier décompressé est un dossier intitulé "phpcompta".

Si vous avez décompressé le dossier ailleurs que sur votre bureau, déplacez-le ou bien adaptez les commandes qui suivront à l'emplacement où se trouve votre dossier phpcompta fraîchement décompressé.

Vous allez maintenant copier ce dossier phpcompta dans le répertoire ''/srv/www/html''. Ouvrez une console et saisissez :

sudo mv /home/nomutilisateur/Bureau/phpcompta /srv/www/html

Vous pouvez ensuite vérifier que ce dossier est bien au bon endroit (utilisez soit votre navigateur et allez dans -> poste de travail -> système de fichier -> srv -> www -> html ou bien tapez en console ''ls /srv/www/html/'').

NOTE : il faut déjà que le répertoire existe, ce qui n'est généralement pas le cas.

Assurez-vous que les droits du dossier ''/srv/www/html'' sont donnés en écriture pour l'utilisateur ''www-data'' (l'utilisateur d'Apache). Dans une console, vous pouvez saisir :

sudo chown -R www-data:www-data /srv/www/html

==== Configuration de postgresql ====
Prenez la main dans la console en tant qu'utilisateur postgresql. Pour cela, tapez la commande :

<code> sudo su postgres </code>

Le radical avant le prompt devient un truc du genre : //"postgres@nom-du-pc:/$"//

On peut désormais créer un utilisateur phpcompta pour postgres en tapant :

<code> createuser -A -d -P phpcompta </code>

Après l'envoi de cette commande, donnez le mot de passe //dany// (clin d'oeil au créateur du logiciel).

Enfin, tapez la ligne suivante pour terminer de configurer postgres, à faire uniquement si votre version de postgresql est inférieure à 8.4

<code> createlang plpgsql template1 </code>

Revenez alors à la console en tapant ''exit'' ou en opérant la combinaison de touches CTRL+D.

==== Configuration d'Apache2 ====
On considère que vous avez copié phpcompta en suivant le chemin proposé dans ce guide. Le répertoire est donc ici : ''/srv/www/html''.

[[:tutoriel:comment_modifier_un_fichier|Modifiez le fichier]] **''/etc/apache2/conf.d/phpcompta.conf''**.

Collez dans le fichier, le code suivant :

<file> # /srv/www/html/phpcompta/
 Alias /phpcompta /srv/www/html/phpcompta/html
 <Directory /srv/www/html/phpcompta>
 AllowOverride All
 </Directory>

<Location /phpcompta>
    Options +Indexes +FollowSymLinks
    Order allow,deny
    Allow from 127.0.0.1
    #deny from all
 </Location> </file>

Enregistrez et quittez l'éditeur de fichier. Redémarrez Apache2 en faisant : 
<code> sudo /etc/init.d/apache2 restart </code>

==== Lancement de l'installation ====
Ouvrez votre navigateur Internet préféré et, dans la barre d'adresse, pointez vers l'installateur phpcompta :
http://localhost/phpcompta/admin/setup.php

Si tout est ok, lancez la procédure et soyez patient car cela prend un peu de temps sans qu'un indicateur ne vous informe de l'état d'avancement...

NOTE : vous obtiendrez généralement un message du type : On ne peut pas écrire dans le répertoire de phpcompta, changez-en les droits

et là, on fait quoi ?

==== Si vous n'êtes pas parvenu à installer phpcompta... ====
...plusieurs solutions s'offrent à vous.

1°) si vous avez éteint et rallumé votre pc entre temps et que vous pouviez atteindre la fenêtre d'authentification de phpcompta après l'installation, vérifiez d'abord que ce n'est pas un problème lié au serveur apache2 : en mode console tapez :
<code> sudo /etc/init.d/apache2 restart </code>

2°) Si ce n'est pas le cas, désinstallez l'ensemble des paquets initialement cités dont la liste se trouve au début de cette page et reprendre le tutoriel à son début.
<note tip>Désinstaller les paquets les uns après les autres (avec purge - voir l'exemple ci-dessous), en supprimant les fichiers que APTITUDE n'arriveraient pas à effacer automatiquement (APTITUDE vous indique les fichiers qu'il n'arrive pas à effacer), puis ensuite de les ré-installer.

Exemple : pour désintaller un paquet appelé le_petit_paquet en purgeant les fichiers de configuration, il faut ouvrir une console (applications -> Accessoires -> Terminal), et taper la commande : sudo apt-get remove le_petit_paquet --purge (Attention, il y a bien 2 tirets devant "purge"). En remplaçant le_petit_paquet par le vrai nom de votre paquet à désinstaller, vous désinstallez votre paquet en le purgeant.

D'autre part, il est important de savoir que l'utilisation de "purge" aura vraisemblablement comme conséquence de rendre inutilisable d'autres applications que vous auriez installées auparavant et qui utiliseraient l'un des programmes ci-dessus désinstallé avec l'option "purge"</note>

3°) Regardez si les erreurs que vous rencontrez n'ont pas déjà été évoquées sur le forum de phpcompta et déposez alors vos questions.

4°) Regardez en dessous de ce paragraphe l'ancienne procédure d'installation : vous y trouverez peut-être des éléments de réponse.

===== Paramétrages (ancienne procédure) =====

==== paramétrage d'Apache2 ====

Voilà, le répertoire ''/var/phpcompta'' contient le logiciel. Il faut maintenant faire deux petites choses, primo que le propriétaire du répertoire soit bien l'utilisateur d'apache2 (soit www-data) et secundo accéder à phpcompta avec votre navigateur.

??? pourquoi "/var/phpcompta" contient le logiciel puisque ce n'est pas là que vous avez préconisé de l'installer ???

=== Changement de propriétaire du répertoire ===
<code> sudo chown -R www-data /var/phpcompta</code>

=== Création d'un alias ===

Pour que localhost ouvre directement phpcompta, ajoutez un fichier phpcompta.conf puis rendez-le utilisable

[[:tutoriel:comment_modifier_un_fichier|Modification du fichier]] ''**/etc/apache2/sites-available/phpcompta.conf**'', ajoutez la partie de texte suivante.

<file>
Alias /phpcompta /var/phpcompta/html
<Directory /var/phpcompta>
     Options Indexes FollowSymLinks MultiViews
     AllowOverride All
     Order allow,deny
     allow from all
</Directory></file>

Enregistrez ces modifications (fichier -> enregistrer), fermez le fichier (fichier -> fermer), puis, important, quittez Gedit (fichier -> quitter).

Puis rendez-le utilisable
<code>
sudo ln -s /etc/apache2/sites-available/phpcompta.conf /etc/apache2/sites-enabled/009-phpcompta.conf
</code>

Redémarrez apache (cf. [[:apache2#redemarrer_apache2]]).

=== Protéger le répertoire admin ===
 
Vous ne devez surtout pas l'effacer, protégez-le avec .htaccess (cf. http://www.securiteinfo.com/conseils/htaccess.shtml).

==== PostgreSQL ====
=== Erreur de connexion à PostreSQL ===
Il arrive souvent qu'il ne soit pas possible de se connecter correctement à PostgreSQL à cause de la sécurité. Voici la façon de résoudre cela .
<note warning>Adaptez le chemin du fichier suivant votre version de PostgreSQL</note>

[[:tutoriel:comment_modifier_un_fichier|modifiez le fichier]] **''/etc/postgresql/8.4/main/pg_hba.conf''**

Dans la section Database administrative login by UNIX sockets, à la fin du fichier, changez la méthode d'authentification afin d'utiliser md5. 
Explication des changements : tout le monde doit avoir un mot de passe pour se connecter sauf l'utilisateur postgres quand il est connecté sur la machine où PostgreSQL fonctionne.

Vous devriez avoir ceci
<file>
#
# Database administrative login by UNIX sockets
local   all         postgres                          ident
# "local" is for Unix domain socket connections only
local   all         all                               md5
# IPv4 local connections:
host    all         all         127.0.0.1/32          md5
# IPv6 local connections:
host    all         all         ::1/128               md5
</file>

Enregistrez ces modifications, fermez le fichier, puis, important, quittez l'éditeur.
Redémarrez postgresql ; En console saississez
<code>sudo /etc/init.d/postgresql-8.3 restart</code>

===  Optimisation de PostgreSQL: ===

Cette étape n'est pas obligatoire, elle n'est utile que si la comptabilité contient beaucoup d'opérations ( > 100.000).

[[:tutoriel:comment_modifier_un_fichier|Editez le fichier]] **''/etc/postgresql/8.3/main/postgresql.conf''**.
Cherchez et retirez le signe dièse de la ligne << ''#work_mem = 1024'' >>, puis remplacer le nombre 1024 par le nombre 8192. Votre ligne doit être celle-ci après modifications:
<file>
listen_addresses = '*' # Ne focntionne pas si laissé listen_addresses = 'localhost'
work_mem = 8192
</file>
Enregistrez ces modifications, fermez le fichier, puis, important, quittez l'éditeur.
Redémarrez postgresql en saisissant dans la console la ligne de commande:
<code>sudo /etc/init.d/postgresql-8.3 restart</code>

=== Création de l'utilisateur "phpcompta" dans postgresql ===

Dans le terminal, vous allez passer sous postgres et allez créer la base phpcompta, en saisissant les séquences suivantes :
<code>sudo su - postgres</code>

la console se positionne sous une connection du type :   
> postgres@votre_ordi:/home/votre_identifiant_ubuntu$
Saisissez alors :
<code>
psql template1
template1# create user utilisateur_pour_phpcompta createdb password 'mot_de_passe';
</code>
La console vous renvoie normalement "CREATE ROLE"
Vous remplacez utilisateur_pour_phpcompta et mot_de_passe par des valeurs de votre choix, ce sont ces valeurs-là qu'il faudra indiquer dans le admin/setup.php; nous verrons ça un peu plus tard

L'étape suivante est de permettre que toutes les bases de données de postgresql accepte d'utiliser le plpgsql (sql embarqué), donc toujours dans psql faite ce qui suit

<code>
template1# create language plpgsql;
</code>

La console vous renvoie le message "CREATE LANGUAGE"

<code>
template1#\q
</code>

Il vous faut maintenant vous déconnecter de postgres, en appuyant simultanément sur les 2 touches [ctrl] et [d] (ou en tapant "exit")

Vous êtes maintenant revenu dans la console à l'utilisateur par défaut.

=== Résumé visuel de la séquence précédente ===

Je vous glisse ici le résumé visuel de toute la séquence que vous venez d'effectuer

<code>
sudo su postgres
psql template1
template1# create user utilisateur_pour_phpcompta createdb password 'mot_de_passe';
template1# create language plpgsql;
template1#\q
</code>

===== Configuration =====

Ouvrez Firefox et saisissez dans la barre d'adresse : ''http://localhost/phpcompta/admin/setup.php''

Pour une première installation, il vous sera demandé le nom et mot de passe de l'utilisateur_pour_phpcompta, le port sur lequel tourne postgresql : il vous faudra donc vraisemblablement changer l'utilisataur et le mot de passe par défaut que vous trouverez ("phpcompta" et "dany" -au passage le principal développeur de PHPcompta- lors d'une installe avec la phpcompta-4.3-build-2649). Les autres paramètres ne devraient pas être modifiés à priori. Cliquez alors sur ok.

Ensuite vous devriez voir une fenêtre qui s'ouvre dans laquelle vous allez avoir un texte SANS ERREUR du type : 
>
> Info
>
> Vous utilisez le domaine
> Php setting
> magic_quotes_gpc: Ok
> magic_quotes_runtime: Ok
> include_path : ok (.:../include:addon)
> 
> php.ini est bien configuré
> Database version
> string(5) "8.x.x"
> Database Setting
> 
> La base de données est bien configurée
> 
> Prêt à commencer la mise à jour ou l'installation ?

Si vous n'avez pas d'erreur, cliquez sur le bouton : **Prêt à commencer la mise à jour ou l'installation ?**

L'ordinateur travaille quelques secondes et affiche :

> Congratulation : Test successfull
> Patching databases
> Patching Demo from the version 29Upgrading DossierPatching (BE) BasiquePatching (FR) BasiqueUpgrading Repository
> Voilà tout est installé ;-)

===== Utilisation de PhpCompta =====
Ouvrez firefox, tapez dans la barre d'adresse : http://localhost/phpcompta

La mire de connexion phpcompta s'ouvre.

* Login : phpcompta
  * Password : phpcompta

(et non l'utilisateur php et le mot de passe que vous avez choisi précédemment)

et ... vous voici sur phpcompta

===== Liens =====

* Forum Ubuntu : http://forum.ubuntu-fr.org/viewtopic.php?id=128671
  * Forum : http://www.phpcompta.be/index.php?option=com_fireboard&Itemid=42
  * Site web : http://www.phpcompta.eu 
  * wiki Site web : http://wiki.phpcompta.eu 
  * Téléchargement : http://www.phpcompta.be/download.php?file=phpcompta-last.7z
  * Demo : http://www.phpcompta.eu/demo (utilisateur / mdp : demo / phpcompta)
  * Tutoriel du site pour l'installaton sous Unix : http://www.phpcompta.be/index.php?option=com_content&task=view&id=16&Itemid=30
  * Documentation pour développeur  : http://www.phpcompta.eu/doc
  * Mailing list, suivi des tâches et bug Projet : http://www.phpcompta.eu/mantis

----

//Contributeurs : [[:utilisateurs:sparky]] 2008/10/31 14:45//, [[:utilisateurs:Schtroungkipouf]] 2009/08/22 18:00//

Mise en forme : [[:utilisateurs:draco31.fr]]

Merci de recopier le code ci-contre pour prouver que vous êtes humain : H N U T A Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported