Truedoc

[[TracNav(TOC)]]

= Installazione di PHPlist = 

[http://www.phplist.com/ PHPlist] è un ottimo programma di gestione di invio di newsletter, ma la documentazione di installazione è come minimo assai vaga e generica. Per questo si sono riportate delle istruzioni più dettagliate su come installarlo e configurarlo su una Debian Lenny. 

Occorre anzitutto scaricare l'ultima versione stabile dal sito del progetto su http://www.phplist.com/ nella sezione download. Una volta scaricato il {{{tar.gz}}} questo dovrà essere scompattato, si otterrà una directory al cui interno il programma è contenuto interamente nella directory {{{public_html}}}, che è quella che andrà spostata sulla destinazione finale. Si dovrà pertanto avere qualcosa del tipo:

{{{

wget http://garr.dl.sourceforge.net/sourceforge/phplist/phplist-2.10.9.tgz

tar -xvzf phplist-2.10.9.tgz

mv phplist-2.10.9/public_html/ /usr/local/share/phplist

}}}

Il programma necessita di PHP e mysql ed Apache, pertanto si abbia cura di installare il tutto, per questo sarà sufficiente eseguire il comando:

{{{

aptitude install mysql-server libapache2-mod-php5 php5-mysql

}}}

con la scelta precedente per l'installazione occorrerà poi inserire nella configurazione di Apache (nel default o nell'eventuale Virtual Host scelto) la la riga di configurazione:

{{{

Alias /phplist /usr/local/share/phplist

}}}

Per eseguire la configurazione occorre anzitutto creare un database per PHPlist, e costruirne la struttura con il file {{{phplist.sql}}} che si trova distribuito insieme ai sorgenti (nella directory in cui li si sono scompattati), questo può esser fatto con le seguenti operazioni:

{{{

cd phplist-2.10.9

mysqladmin -u root -p create phplistdb

mysql -u root -p phplistdb < phplist.sql

}}}

occorre poi creare un utente per dare accesso al database, cosa da fare con le seguenti istruzioni:

{{{

mysql -u root -p

Enter password: 

Welcome to the MySQL monitor.  Commands end with ; or \g.

Your MySQL connection id is 49

Server version: 5.0.51a-24 (Debian)

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE, ALTER \ 

  ON phplistdb.* TO 'phplist'@'localhost' IDENTIFIED BY 'pwdcomplediff';

}}}

Dopo queste operazioni sarà poi sufficiente modificare il file di configurazione del programma per inserire la password scelta. Il file in questione, a partire dalla directory dove si è installato il programma (nel nostro caso {{{/usr/local/share/phplist}}}), è {{{lists/config/config.php}}}, qui ci sono le seguenti righe che identificano l'accesso al database:

{{{

# what is your Mysql database server

$database_host = "localhost";

# what is the name of the database we are using

$database_name = "phplistdb";

# who do we log in as?

$database_user = "phplist";

# and what password do we use

$database_password = 'pwdcomplediff';

}}}

(dove, a parte la password, si sono mantenuti i valori di default distribuiti con i sorgenti, che invece può essere opportuno modificare). 

A questo punto ci si potrà collegare al servizio accedendo alla URL {{{https://indirizzo,macchinaphplist.my/phplist/lists/admin/}}} (si abbia cura comunque di mettere il servizio sotto SSL) e cambiare la password dell'utente di amministrazione {{{admin}} dal default {{{phplist}}} ad un valore personalizzato.