Quando si lavora con il framework EzPublish, bisogna tenere presente che questo utilizza pesantemente un sistema di caching assai potente quanto fastidioso in fase di sviluppo. L’importanza di questo sistema di caching è tale per cui ci sono degli aspetti che non possono essere tralasciati quando si lavora con questo prodotto.

Supponiamo ad esempio di dover spostare un servizio implementato con questo framework da un dominio in un altro; questo comporta l’obbligo di modificare almeno i seguenti dati:

- le variabili SiteURL contenute nei file di configurazione site.ini.append.php delle cartelle setting/siteaccess/<nome_siteaccess> e setting/override/<nome_siteaccess>

- i dati di accesso alla base di dati, sempre nei medesimi file

- ed infine è necessario svuotare tutte le cache, per azzerare i percorsi e alcuni dati precedentemente memorizzati in cache, appunto

Il problema è che spesso non si può utilizzare il sistema più semplice, ovvero quello di accedere nel pannello di amministrazione e servirsi della sezione dedicata per la gestione della cache. Per questo motivo, vi indichiamo brevemente tutti i metodi che possiamo utilizzare per compiere l’azione di svuotare tutte le cache.

1) Dal pannello di Amministrazione

Utilizziamo il pannello di amministrazione per pulire tutte le cache via GUI:

1. Entrare nel tab “SETUP”
2. Cliccare sull’icona di cancellazione di tutte le cache
3. Aggiornare il browser

2) Dalla Linea di commando

Questo è un processo che spesso passa inosservato, ma che è molto comodo in situazioni come quella di cui sopra, ovvero quando si sposta un’installazione di EzPublish. In sistemi a base Unix, è sufficiente utilizzare i seguenti comandi:

cd /percorso/di/ezpublish;
./bin/php/ezcache.php --clear-all --purge;

Se invece si utilizza un sistema Windows, i comandi da utilizzare sono i seguenti

# cd c:/web/pro/ezpublish/doc;/bin/php/ezcache.php --clear-all --purge;
c:\php\php .

3) Procedimento manuale

E’ anche possibile pulire le cache a mano, nel caso in cui non sia possibile utilizzare uno dei metodi precedenti. Per fare questo, è sufficiente seguire questa procedura (per sistemi Unix – per sistemi Windows è sufficiente cancellare le medesime cartelle):

cd /percorso/di/ezpublish;
rm -vrf /var/cache;
rm -vrf /var/<tipo di installazione(ezwebin_site, ezflow_site,ecc)>/cache

Quando si utilizza il settaggio di default di EzPublish, l’inoltro delle mail (ad esempio quelle per gestire la modifica della password) potrebbe non funzionare correttamente. La ragione è semplice: qmail, per funzionare regolarmente, necessita di configurazioni mail differenti da quelle che EzPublish ha per default.

Per permettere il corretto inoltro delle mail, dobbiamo settare alcuni parametri di configurazione del file

settings/override/site.ini.append.php

Nel caso in cui si utilizzi il protocollo SMTP per l’invio della posta, è necessario utilizzare una configurazione molto simile alla seguente:

[MailSettings]
Transport=SMTP
AdminEmail=tuamail@mail.com
EmailSender=tuamail@mail.com
#Beware about white space at end of each line
TransportServer=localhost
HeaderLineEnding=%0D%0A
TransportPort=25
TransportUser=
TransportPassword=

Nel caso invece si utilizzi sendmail, la configurazione deve essere simile alla seguente:

[MailSettings]
Transport=sendmail
AdminEmail=tuamail@tuamail.com
EmailSender=tuamail@tuamail.com
#Beware about white space at end of each line
HeaderLineEnding=auto

Dopo queste modifiche è necessario svuotare la cache delle impostazioni INI. Se l'invio delle mail
non dovesse ancora funzionare, allora potremmo essere di fronte a uno dei seguenti casi:

1. Problema: Le mail arrivano con una Header scorretta utilizzando sendmail
   Soluzione: E’ nececssario cambiare il valore della direttiva HeaderLineEnding in “auto”
2. Problema: Utilizzando il protocollo SMTP le mail non arrivano a destinazione
3. Soluzione Qualche impostazione potrebbe non essere corretta. Ricontrollare il blocco di codice relativo
4. Problema: La mail non arrivano quando la piattaforma EzPublish e il server mail girano su macchine diversa.
   Soluzione:L’inoltro locale delle mail potrebbe essere ancora attivo. Disabilitarlo dal proprio pannello di hosting ( nel caso di Plesk: Domain->Mail->Disable/Enable Switch )
5. Problema: Il protocollo SMTP non funziona con EzPublish 4.0.0
   Soluzione: Questo è un bug. Eseguiamo l’upgrade a EzPublish 4.0.1 o eseguiamo il path del file ezsmtp.php
6. Problema: Le configurazione di cui sopra non funzionano
   Soluzione: Ci potrebbe essere uno spazio bianco alla fine del codice. Rimuovetelo.