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: {{{

1. what is your Mysql database server
   $database_host = "localhost";

1. what is the name of the database we are using
   $database_name = "phplistdb";

1. who do we log in as?
   $database_user = "phplist";

1. 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.