Installare Joomla!® 5 su Mac con XAMPP

In questo tutorial vedremo insieme i passaggi da seguire per un'installazione locale di Joomla!® 5 su Mac OS utilizzando XAMPP di "Apache Friends".
XAMPP è un progetto no profit ed Open source creato per promuovere il web server Apache, molto usato per sviluppare applicazioni e poterle testare in locale.
In pratica è un pacchetto contenente MariaDB, PHP e Perl che, una volta installato, simula un vero e proprio server nel nostro computer (sono disponibili versioni per Windows, Linux e OS X) e attraverso un semplice pannello di controllo ci consente di controllarne le funzioni.

Ho cercato di essere il più chiaro possibile per venire incontro a chi per la prima volta si approccia al nostro amato CMS Joomla!®.
Se poi vi rimane ancora qualche dubbio, contattemi pure.

Ora facciamo doppio click nell'icona del file xampp-osx-8.1.17-0-installer.dmg per aprire l'immagine disco e di nuovo doppio click per far partire l'installer.
Se il Mac ci blocca con un avviso di sicurezza proviamo ancora cliccando "Apri" dal menù contestuale, ci verrà richiesta la password di amministratore e poi potremo procedere con il Wizard dell'installazione guidata.

Procediamo con Next fino alla conclusione dell'installazione, click su Finish per lanciare XAMPP.

Apriamo con un editor di codice (io uso BBEdit) il file php.ini, che troviamo in: .../Applications/XAMPP/xamppfiles/etc/php.ini
e modifichiamo il valore della variabile output_buffering settandola, come raccomandato da Joomla!®, da 4096 a:

riga 226 output_buffering=Off

Visto che ho il file aperto, controllo anche il corretto settaggio delle variabili sotto indicate prima di salvare la modifica.

riga 377 max_execution_time=120
riga 471 display_errors=Off
riga 646 post_max_size=40M
riga 798 upload_max_filesize=40M

Nota:

• se utilizzate php 8.2, i numeri di riga potrebbero differire, fate riferimento ai nomi delle variabili;
• il valore di max_execution_time (espresso in secondi) è un parametro di sicurezza e indica il tempo massimo in cui uno script PHP deve essere completato. Nei server di solito è impostato a 30" quindi 120" è un buon margine, ma in casi particolari come ad esempio l'eccessiva lentezza nell'elaborare la richiesta potresti provare ad aumentarlo per evitare l'errore "504 Gateway Timeout".

Ora torniamo nel pannellino di controllo di XAMPP e facciamo ripartire con Start i servizi MySQL Database e Apache Web Server e attendiamo i led verdi.

Prima di passare finalmente all'installazione vera e propria di Joomla!® 5 vi lascio qualche appunto:

• Se volessimo portarci l'icona di XAMPP nel dock, quella a cui fare riferimento è "manager-osx" in: Applicazioni/XAMPP/xamppfiles/manager-osx;
• Prendiamo nota di queste URL che ci consentiranno di accedere via browser ai servizi di XAMPP (con le porte di default):
  http://localhost/dashboard/ per andare alla dashboard via browser
  http://localhost/phpmyadmin/ per accedere a phpMyAdmin e gestire i database
• Nella cartella XAMPP è presente anche l'icona "uninstall", nel caso si volesse disinstallare l'applicazione.

Per prima cosa andiamo alla pagina ufficiale di download di joomla.org: https://downloads.joomla.org/
e selezioniamo Upgrade Packages perché da qui è possibile sia scaricare che verificare il Checksum del file.
Procediamo con il download dell'ultima versione di tipo Full Package (.zip) disponibile nella sezione New Joomla! Installations e mi raccomando, dopo averlo scaricato, controlliamo autenticità ed integrità del file col metodo descritto sopra (Checksum md5).

Terminato il download portiamo il file .zip sulla scrivania e avviamo la decompressione dell'archivio.
Ci troveremo con una cartella (nel mio caso Joomla_5.0.3-Stable-Full_Package) che andremo a rinominare con il nome che abbiamo deciso di dare al nostro sito locale di Joomla!®. In questo tutorial lo chiameremo: testj5.

Nota: è ovvio che, rinominandola con nomi sempre diversi e ripetendo l'installazione guidata di Joomla!®, potrò far girare in locale tutti i siti di cui ho bisogno.

A questo punto sposto la cartella testj5 nella cartella htdocs del mio server locale, path: Applicazioni/XAMPP/xamppfiles/htdocs
Questa è la cartella che ospiterà i nostri siti locali, nei server remoti di solito viene denominata htdocs, httpdocs o public_html.

È buona norma impostare il Time zone del php in modo che mostri l'orario corretto adeguando il fuso orario del server (che magari è situato all'estero) con quello italiano. Nella nostra installazione locale non sarebbe necessario ma lo inserisco nel tutorial prevedendo che un'installazione locale possa essere il primo passo per una futura installazione a remoto.

Dalla Dashboard System → Setup → Global Configuration, selezioniamo il tab Server, dalla tendina Website Time Zone selezioniamo Rome e Salviamo.

Dalla Dashboard, menù laterale Content → Articles → bottone Options (in alto a dx)

Qui possiamo scegliere cosa deve essere visualizzato nei diversi layout di pagina. In pratica possiamo nascondere o mostrare alcune informazioni nel momento in cui viene visualizzato un articolo nella pagina. I layout più comuni sono Articles e Blog/Featured Layouts. Agendo da qui le impostazioni saranno estese a livello globale (per tutto il sito). Eventuali specifiche variazioni potremo sempre farle a livello di voce di menù o di singolo articolo.
Per fare un esempio posso fare in modo che di default non vengano visualizzate la data di pubblicazione e l'autore di un articolo tranne che in quelli della sezione News o Blog (dove è utile che ci siano). I settaggi sono molto intuitivi, la cosa migliore è quella di fare delle prove per trovare la configurazione migliore per noi.

Anche questa è una configurazione non necessaria al funzionamento della nostra installazione locale ma ci tengo ad inserirla nel tutorial perché potrebbe essere utile per familiarizzare con la riscrittura delle URL (URL rewrite). In pratica attivandola le URL delle pagine verranno riscritte per essere meglio indicizzate dai motori di ricerca. Una URL del tipo www.miosito/index.php/articolo-1 diventerà www.miosito/articolo-1.html, sicuramente più leggibile e indicizzabile.

È importante sapere che a remoto l'attivazione dell'htaccess è di fondamentale importanza, non solo per la riscrittura delle URL, ma soprattutto per questioni di sicurezza. È un file presente nella root con la denominazione htaccess.txt. Con questa estensione è inerte, viene attivato rinominandolo in .htaccess (cun un "." davanti e senza il .txt finale). Nei server è facile rinominarlo, basta cambiarne il nome via FTP o dal File manager del server, ma in locale è un pò più complicato.

Andiamo nella cartella testj5 in htdocs di XAMPP. Troveremo qui il file htaccess.txt

1. Apriamo il file con un editor di codice (nel mio caso BBEdit)
2. Diamo il comando Save as... e impostiamo .htaccess (accertiamoci che lo salvi nella cartella del sito, testj5)
3. Confermiamo di volerlo far precedere da un "." (diventerà così un file di sistema di Apache)
4. Controlliamo ora che sia presente nella cartella (sarà visualizzato in grigio) con la combinazione dei tre tasti ⇑+command+.
   Poi ripremerli per tornare alla visualizzazione normale.

Note:

1. La combinazione di tasti Shift+command+. (Shift, command e punto contemporaneamente) nel Mac mostra i file di sistema normalmente nascosti.
   
2. Potete provare a rinominarlo direttamente dal Finder (senza aprire e salvare da BBEdit), ma così facendo potrebbe non attivarsi correttamente.

A questo punto possiamo entrare nel backend e passare alle configurazioni SEO.

Dalla Dashboard System → Global Configuration → tab Site, finestra SEO. Qui portiamo a "Yes" i campi sotto specificati e salviamo il tutto.

• Search Engine Friendly URLs
• Use URL Rewriting
• Add Suffix to URL

Bene, a questo punto non mi resta che augurarti Buon lavoro! ...e se hai ancora qualche dubbio, contattami pure.