Archivi categoria: EzPublish

EzPublish – Come pulire la cache del portale

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

EzPublish – Configurare il sistema per l’invio delle mail

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.

EzPublish – Disabilitare le cache durante lo sviluppo

EzPublish è un prodotto davvero interessante. Proprio per questo motivo, abbiamo deciso di creare una sezione dedicata a questo framework.

E’ un prodotto per certi versi molto complesso, per il quale la curva di apprendimento è sicuramente elevata, ma una volta che si prende possesso delle sue funzionalità, si ha a disposizione un vero e proprio ambiente di sviluppo per portali web.

Prima di iniziare lo sviluppo, è buona norma disabilitare la cache del template di EzPublish. EzPublish infatti usa la cache per velocizzare il caricamento delle pagine, ed incrementare le perfomance del portale in ambiente di produzione.

In ambiente di sviluppo, però, questo meccanismo rallenta di molto il lavoro, perchè con la cache attiva, è necessario ad ogni modifica eseguire il “flush” (ovvero lo svuotamento) della cache per vedere le modifiche al portale.

Per eseguire il “flush” è necessario effettuare l’accesso all’interfaccia di amministrazione e:

  1. Cliccare sul tab Impostazioni.
  2. Cliccare sul bottone Svuota tutte la cache.

In aggiunta, dobbiamo disabilitare il caching del template in fase di compilazione. Per fare questo  e permettere quindi di visualizzare “al primo colpo” le modifiche effettuate dobbiamo disalibitare le seguenti cache:

  • compilazione del template
  • cache della vista
  • cache di override

Le configurazioni per disabilitare queste sono contenuto all’interno del file di configurazione

/settings/site.ini

Le configurazioni da sdisabilitare sono le seguenti:

[TemplateSettings]

TemplateCompile=disabled 

[ContentSettings]

ViewCaching=disabled 

[OverrideSettings]

Cache=disabled

Custom Frontpage Template

Le performance del nostro portale EzPublish saranno notevolmente ribassate, durante la fase di sviluppo, avendo appunto disabilitato le cache. Ovviamente le cache dovranno essere riabilitate prima che il sito passi all’ambiente di produzione.