Truedoc

h1. Installare e configurare Sabredav

Sabredav è un server CalDAV, CarDAV e WebDAV in PHP molto sviluppato che presenta una buona integrazione con Roundcube per la gestione di calendari integrati con la posta elettronica. Dato lo sviluppo molto intenso pur essendo disponibile un pacchetto @php-sabre-dav@ nei backports di Debian Wheezy, tratteremo l'installazione dai sorgenti. Si presuppone che sia disponibile e configurata, una Debian con PHP ed Apache già in grado di far funzionare Roundcube. 

Il progetto consiglia per l'installazione di utilizzare @composer@, un framework per la gestione delle dipendenze in PHP, che consente anche degli aggiornamenti in maniera abbastanza semplice del programma. Il primo passo è individuare una directory sotto cui installarlo, per l'uso di quest'ultimo è consigliato di installare:

<pre>

apt-get install php5 git php5-curl

</pre> 

poi lo si potrà installare nella directory in cui si installerà anche sabredav, nel nostro caso @/var/www/sabredav/@, con:

<pre>

curl -sS https://getcomposer.org/installer | php

</pre>

una volta installato composer sarà disponibile nella directory stessa il programma @composer.phar@ e si potrà installare sabre con:

<pre>

./composer.phar require sabre/dav ~2.1.0

</pre>

che scaricherà direttamente quanto necessario, ed in questo modo futuri aggiornamenti potranno essere installati semplicemente con @./composer.phar update sabre/dav@. Con questa installazione i file di sabredav verranno installati nella sottodirectory @vendor/sabre@.

Una volta fatto questo occorre configurare Apache, è preferibile utilizzare un dominio dedicato su un virtualhost, ad esempio @sabredav.dominio.tld@ o affini, in modo da poter inserire la configurazione in un file come @/etc/apache2/sites-available/sabredav.dominio.tld@ che dovrà contenere qualcosa del tipo:

<pre>

<VirtualHost *:443>

	ServerName sabredav.dominio.tld

	DocumentRoot /var/www/sabredav

        # include SSL config directives

        Include "/etc/apache2/sites-available/ssl.conf" 

	##

	## Sabredav rules

	##

	<IfModule mod_rewrite.c>

		RewriteEngine On

		RewriteRule (.*) index.php [L]

	</IfModule>

	# Disable eAccelerator

	php_flag eaccelerator.enable 0

	php_flag eaccelerator.optimizer 0

	# Output buffering needs to be off, to prevent high memory usage

	php_flag output_buffering off

	# This is also to prevent high memory usage

	php_flag always_populate_raw_post_data off

	# This is almost a given, but magic quotes is *still* on on some

	# linux distributions

	php_flag magic_quotes_gpc off

	# SabreDAV is not compatible with mbstring function overloading

	php_flag mbstring.func_overload off

	ErrorLog /var/log/apache2/sabredav.dominio.tld-error.log

	# Possible values include: debug, info, notice, warn, error, crit,

	# alert, emerg.

	LogLevel warn

	CustomLog /var/log/apache2/sabredav.dominio.tld-access.log combined

</VirtualHost>

</pre>

Una volta installato il programma sono necessarie due directory scrivibili, evitate di usare i permessi a 777 come indicato nella documentazione di installazione di Sabredav (pensata presumibilmente per un housing) ed invece assegnatene la proprietà all'utente che esegue il web server (@www-data@ per Debian):

<pre>

cd /var/www/sabredav

mkdir data public

chown www-data.www-data data public

</pre>

A questo punto dovremo creare l'index.php (o file equivalente, ma si cambi la *RewriteRule* all'occorrenza) adatto al tipo di servizio che vogliamo offrire. Con il programma vegono forniti (nella directory @vendor/sabre/dav/examples/@) usa serie di possibili esempi, utilizzeremo come base @groupwareserver.php@, che andrà copiato ed opportunamente modificato per fargli utilizzare MySQL come database invece di SQLite che è il default preconfigurato. 

<pre>

cp vendor/sabre/dav/examples/groupwareserver.php index.php

</pre>

Occorrerà poi creare un database dedicato (ma il programma può usare anche SQLite su un file) ed il relativo utente, nel caso si abbia MySQL, si possono usare le istruzioni di [[MySQLInitConf]], e poi si dovrà inizializzare lo stesso con:

<pre>

cat vendor/sabre/dav/examples/sql/mysql.* | mysql -u root -p sabredav

</pre>

e ci si potrà collegare con l'utente di default che è admin con password admin.