Tutorial per l’installazione di WordPress in locale tramite XAMPP sul proprio PC, creare un ambiente di staging WordPress in locale.
INDICE DEI CONTEUTI:
Predisporre e installare l’ambiente per piattaforma
Prima di installare la nostra piattaforma per ricreare un ambiente in locale simile a quello di cui disporremo se avessi un hostin dobbiamo fare alcuni preparativi e considerazioni.
Quale ambiente scegliere
Per fare questo possiamo utilizzare XAMPP (più indicato per ambiente Windows), MAMPP (più utilizzato su MAC) o EasyPHP.
Per i nostri scopi prediligeremo l’ambiente XAMPP attualmente uno dei più utilizzati, piattaforma software specifica che facilita l’installazione e la gestione degli strumenti più comuni per lo sviluppo di applicazioni web.
In particolar modo avremo a disposizione una suite completa con Apache (web server) il programma che gestisce le richieste che arrivano da un qualsiasi client attraverso il protocollo HTTP, MySQL cioè il DBMS, PHP e Perl, linguaggi utili per lo sviluppo di applicazioni web.
Identificare la versione corretta di XAMPP in base alla versione di WordPress
Nel suo repository XAMPP mette a disposizione svariate versioni, per identificare la versione corretta da utilizzare dovremmo andare ad analizzare i prerequisiti del nostro CMS così da identificare la versione corretta da installare.
Nel caso di WordPress 6.x, come da documentazione ufficiale requirements, i prerequisiti sono i seguenti:
- PHP versione 7.4 o successiva.
- MySQL versione 8.0 o successiva, oppure MariaDB versione 10.5 o successiva.
- HTTPS supportato (nel nostro caso essendo in locale ci basterà utilizzo del HTTP)
Qualora dovessimo installare una versione successiva alla 6.x oppure antecedente è bene verificare i pre-requisiti prima di scaricare il nostro ambiente XAMPP.
Tabella di Compatibilità WordPress vs PHP
| WP Version | 5.2 | 5.3 | 5.4 | 5.5 | 5.6 | 7.0 | 7.1 | 7.2 | 7.3 | 7.4 | 8.0 | 8.1 | 8.2 | 8.3 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 6.6 | N | N | N | N | N | N | Y | Y | Y | Ye | Ye | Ye | Y* | Y* |
| 6.5 | N | N | N | N | N | Y | Y | Y | Y | Y | Ye | Ye | Y* | Y* |
| 6.4 | N | N | N | N | N | Y | Y | Y | Y | Y | Ye | Ye | Y* | Y* |
| 6.3 | N | N | N | N | N | Y | Y | Y | Y | Y | Ye | Ye | Y* | N |
| 6.2 | N | N | N | N | Y | Y | Y | Y | Y | Y | Y* | Y* | Y* | N |
| 6.1 | N | N | N | N | Y | Y | Y | Y | Y | Y | Y* | Y* | Y* | N |
| 6.0 | N | N | N | N | Y | Y | Y | Y | Y | Y | Y* | Y* | N | N |
| 5.9 | N | N | N | N | Y | Y | Y | Y | Y | Y | Y* | Y* | N | N |
| 5.8 | N | N | N | N | Y | Y | Y | Y | Y | Y | Y* | N | N | N |
| 5.7 | N | N | N | N | Y | Y | Y | Y | Y | Y | Y* | N | N | N |
| 5.6 | N | N | N | N | Y | Y | Y | Y | Y | Y | Y* | N | N | N |
| 5.5 | N | N | N | N | Y | Y | Y | Y | Y | Y | N | N | N | N |
| 5.4 | N | N | N | N | Y | Y | Y | Y | Y | Y | N | N | N | N |
| 5.3 | N | N | N | N | Y | Y | Y | Y | Y | Y | N | N | N | N |
| 5.2 | N | N | N | N | Y | Y | Y | Y | Y | N | N | N | N | N |
| 5.1 | Y | Y | Y | Y | Y | Y | Y | Y | Y | N | N | N | N | N |
| 5.0 | Y | Y | Y | Y | Y | Y | Y | Y | Y | N | N | N | N | N |
| 4.9 | Y | Y | Y | Y | Y | Y | Y | Y | N | N | N | N | N | N |
| 4.8 | Y | Y | Y | Y | Y | Y | Y | N | N | N | N | N | N | N |
| 4.7 | Y | Y | Y | Y | Y | Y | Y | N | N | N | N | N | N | N |
| 4.6 | Y | Y | Y | Y | Y | Y | N | N | N | N | N | N | N | N |
| 4.5 | Y | Y | Y | Y | Y | Y | N | N | N | N | N | N | N | N |
| 4.4 | Y | Y | Y | Y | Y | Y | N | N | N | N | N | N | N | N |
| 4.3 | Y | Y | Y | Y | Y | N | N | N | N | N | N | N | N | N |
| 4.2 | Y | Y | Y | Y | Y | N | N | N | N | N | N | N | N | N |
| 4.1 | Y | Y | Y | Y | Y | N | N | N | N | N | N | N | N | N |
| 4.0 | Y | Y | Y | Y | N | N | N | N | N | N | N | N | N | N |
| 3.9 | Y | Y | Y | Y | N | N | N | N | N | N | N | N | N | N |
| 3.8 | Y | Y | Y | Y | N | N | N | N | N | N | N | N | N | N |
| 3.7 | Y | Y | Y | Y | N | N | N | N | N | N | N | N | N | N |
Una volta determinata la versione di cui necessitiamo possiamo scaricarla dal repositori ufficiale :
Esecuzione installatore di XAMPP
Per il nostro tutorial prenderemo il considerazione sistema operativo Microsoft Windows.
Una volta scaricato, cliccare con il pulsante destro sul file e procedere eseguendolo con diritti di amministratore:click destro > esegui come amministratore
E possibile che si riceva un avviso se è attivo ‘UAC (user Access Control) sul nostro PC, possiamo proseguire dandogli l’OK o disattivare/limitare le funzionalità dell’UAC di Windows (i più esperti posso modificare i parametri di sicurezza di UAC o disabilitarlo).
Si riceverà un warning sul fatto che sia sconsigliato installare tale app dentro la directory C:/Program Files/ , è possibile ignorarlo.
Prosegue l’installazione di XAMPP
Procedere con NEXT durante i vari Step del wizard.
Al momento della scelta dei componenti da installare, lasciare la selezione suggerita, eventuali variazioni all’installazione standard sono consigliate per utenti esperti.
Scelta Directory di installazione
Viene proposta come directory di destinazione C:/xampp, possiamo modificare il nome della cartella nel caso desiderassimo installare differenti versioni di XAMPP, quindi clicchiamo su NEXT.
La copia dei file potrà richiedere vari minuti a seconda delle performance del vostro hard disk, basta solo un pochino di pazienza.
Termine dell’installazione
Terminato il processo di installazione ci viene notificato che Windows Firewall ha bloccato alcune funzionalità del Apache HTTP server (un avviso normale), Cliccare su > Allow access così da sbloccare tutte le features
A questo punto ci verrà chiesto di avviare il Control Panel di XAMPP e possiamo dare l’OK.
Control Panel di XAMPP
Una volta avviato il Control Panel di XAMPP dobbiamo decidere quali servizi avviare, per le nostre necessità andremo a cliccare START su:
ApacheMySQL
Premendo su Start e su Stop possiamo avviare e bloccare i nostri servizi in base alle necessità, spuntando “Modules Service” i servizi verranno eseguiti al momento dell’avvio di windows (sconsigliato se non intendiamo utilizzare l’ambiente di staging frequentemente perché i servizi occupano attivamente delle porte di Windows).
I moduli si illuminano di verde
Cliccando su start per Apache e mySQL potranno capitare ulteriori warning del firewall di windows relativi alla concessione delle autorizzazioni, anche in questo caso dovremmo confermare le eccezioni.
IMPORTANTE! se lo sfondo dei moduli Apache e MySQL diventa verde chiaro, siamo certi che stanno funzionando correttamente, in caso ci appiano messaggi di errore, solitamente in rosso, e il servizio non parta bisognerà controllare eventuali porte bloccate, verificare che antivirus o altri servizi installati non blocchino le porte di windows di cui abbiamo bisogno.
NOTE: Per le nostre esigenze non ci servono altri servizi, ma XAMPP mette a disposizione anche FileZilla, Mercury e Tomcat e la completa gestione dei protocolli per l’invio e la ricezione delle mail.
Modificare i parametri di configurazione
A questo punto il nostro ambiente è pronto per funzionare, WordPress non necessita di particolari modifiche ma si può ottimizzarlo, in questo caso dovremmo andare a variare alcuni parametri PHP.ini (gestione del Web Server Apache).
editare PHP.INI
Per prima cosa andiamo ad editare il nostro PHP.INI per effettuare le modifiche: Apache > Config > php.ini
Andiamo quindi a modificare o aggiungere i parametri richiesti, cercando la riga sul nostro file.
qualora il parametro non sia presente lo andremo ad aggiungere in fondo al file (il simbolo “;” è un commento alla riga di comando).
upload_max_filesize=64Mmax_execution_time = 1024memory_limit=256Mpost_max_size=48Mmax_input_vars=1000max_input_time=400
Effettuate le modifiche salviamo il file e riavviamo il modulo mySQL premendo su Stop e nuovamente su Start.
Creazione DataBase e Account Utente
A questo punto non ci resta che creare il nostro DataBase e l’utente autorizzato ad accedervi, per far questo andiamo ad aprire il nostro browser e digitiamo localhost oppure localhost/dashboard o 127.0.0.1 (indirizzo IP corrispondente a localhost) sulla barra degli indirizzi del nostro browser.
Possiamo creare unicamente il DataBase ed utilizzare root come utente di amministrazione, ma è preferibile creare un ambiante separato per ogni sito di staging e di conseguenze un DataBase ed un utente autorizzato ad accedervi in esclusiva.
In questa maniera, per chi non ha familiarità, ci impratichiamo ad usare un ambiente simile a quello che troveremo sul cPanel del nostro hosting e, qualora dovessimo migrare l’ambiente online avremo una situazione più congeniale.
creazione ACCOUNT UTENTE
Andiamo a caricare il modulo PhpMyAdmin
Andiamo quindi a selezionare la creazione dell’utente, cliccando sulla voce Accounti utenti:
Quindi clicchiamo su Aggiunta account utente in basso:
creazione DB associato all’utente
I parametri che ci vengono richiesti sono i seguenti:
- Nome utente:
nome di nostra scelta - Nome host:
localhost - Password:
una password di nostra scelta
IMPORTANTE! Scriviamo un blocco note questi dati che serviranno per l’installazione del CMS, e saranno molto importanti in futuro per l’eventuale trasferimento del sito.
Per semplicità creiamo un DataBase analogo al nome scelto per l’utente, selezionando: Crea un database con lo stesso nome e concedi tutti i privilegi.
E andiamo a selezionare tutti i privilegi globali, cliccando: Seleziona tutto
Ci basterà cliccare su Esegui in basso per confermare l’operazione.
Se tutto è stato fatto correttamente, sulla sinistra troveremo il nostro nuovo DataBase mySQL.
Insallare WordPress
scarichiamo WordPress
A questo punto possiamo procedere con il download della piattaforma ai seguenti link, il primo con l’ultima versione disponibile, il secondo con tutte le versioni antecedenti.
Se siamo curiosi possiamo andare a sbirciare sulla pagine della History di WordPress per vedere tutte le release dal 2003 con la data di pubblicazione.
Effettuato il download ci troveremo con una cartella compressa chiamata: wordpress.zip che andremo a scompattare così da avere la medesima cartella ma non più compressa.
Andremo quindi a copiare i file in una directory che rappresenta il nome del nostro sito locale all’interno di XAMPP e precisamente al seguente percorso c:/xampp/htdocs/nome-della-nostra-cartella ad esempio c:/xampp/htdocs/wordpress.
Utilizzerò come cartella per il mio sito locale “wordpress” per semplicità.
Qualora si sia utilizzato un nome di cartella differente per installare XAMPP il percorso sarà c:/{nome-cartella-xampp}/htdocs/nome-della-nostra-cartella.
Possiamo avere più versioni dei nostri CMS installati in locale, basterà cambiare il nome della cartella contenente con un nome di directory che rappresenta il nostro sito internet in locale, ad esempio: c:/xampp/htdocs/wordhelp.it oppure c:/xampp/htodcs/wordpress.
Lanciamo XAMPP, se non era già attivo, così da avere le due icone Apache e mySQL verdi, qualora non trovaste XAMPP tra le vostre applicazioni, o aveste più versioni installate, potete trovare il pannello di controllo al seguente percorso: c:/{cartella_di_xampp}/htdocs/xampp-control.exe.
Apriamo il nostro browser preferito e digitiamo http://localhost/{nome-della-nostra-cartella} (oppure http://127.0.0.1/{nome-della-nostra-cartella}, ad esempio se la cartella creata all’interno di htdocs era wordpress sarà http://localhost/wordpress.
dati di accesso ad DataBase
Infine ci verranno richiesti i dati di accesso al DataBase precedentemente creato su PhpMyAdmin.
che ci siamo segnati precedentemente nella fase di creazione del DataBase e Utente.
- nome del database: quello scelto;
- nome utente: nel nostro caso analogo al nome del database, se diverso va specificato;
- password: quella scelta
- host del database: localhost o 127.0.0.1
- prefisso delle tabelle: wp_, in realtà su un ambiente online andrebbe modificato per motivi di sicurezza;
Di seguito la schermata di richiesta dati dopo aver cliccato sul bottone Iniziamo!
dati del sito
A questo punto ci vengono richiesti i dati del nostro sito:
questi dati possono variare leggermente a seconda della versione di WordPress.
- titolo del sito: identifica la vostra attività;
- nome utente: nominativo admin del sito;
- password: dell’utente di admin del sito;
- la tua mail: indirizzo dell’utente admin del sito;
- visibilità ai motori di ricerca: se spuntato previene l’indicizzazione del sito finché siamo in fase di costruzione, in ambiente locale è indifferente;
mail e la password inserite in questa fase sono quelle del utente Admin del nostro store, dobbiamo segnarle e ricordarle perché rappresentano le nostre chiavi di login.
come nome utente, password e mail possiamo usare i nostri dati, è IMPORTANTE ricordare che nome utente e password in un ambiente online devono essere complesse per prevenire hacking del sito.
Perfetto! clicchiamo su Installa WordPress ed è fatta!
accesso al back-end
Indirizzo di accesso:http://localhost/{nome-della-nostra-cartella}/wp-admin
Esempio: http://localhost/wordpress/wp-admin/
salvo situazioni particolari molto rare, la cartella di accesso all’amministrazione di WordPress è sempre /wp-admin
accesso al front-end
Indirizzo front-end: http://localhost/{nome-della-nostra-cartella}/
Esempio:http://localhost/wordpress/
reference: file wp-config.php
Per chi vuole conoscere qualcosa in più su come funziona la configurazione di WordPress: i parametri inseriti per la connessione al nostro DataBase sono memorizzati nel file wp-config.php contenuto nella root del sito.
Prima di lanciare l’installazione questo file non è presente ma è presente il file wp-config-sample.php, l’installatore si fa carico in automatico di creare il file wp-config.php con i parametri inseriti nel wizard.
Nulla però ci vieta di creare manualmente il file ed inserire i parametri di connessione, per farlo: rinominiamo il file wp-config-sample.php in wp-config.php e andiamo ad inserire negli appositi spazi indicati i parametri di connessione.
Per gli utenti esperti, tramite questo file possiamo anche impostare il debug di WordPress per verificare eventuali errori.
// ** Database settings – You can get this info from your web host ** //
/** The name of the database for WordPress */define( 'DB_NAME', 'database_name_here' );
/** Database username */define( 'DB_USER', 'username_here' );
/** Database password */define( 'DB_PASSWORD', 'password_here' );
Il file wp-config.php consente molte OPERAZIONI TECNICHE PER UTENTI ESPERTI, indicherò solo le più comuni ma prima di avventurarsi e sempre meglio fare una copia di backup del file e avere piena consapevolezza di ciò che si intende modificare.
In ambiente locale l’hostname è sempre localhost o 127.0.0.1, nella maggioranza dei casi è così anche online, per alcuni hosting il valore potrebbe essere differente, sarà loro premura comunicarlo.
/** Database hostname */define( 'DB_HOST', 'localhost' );
Se desideriamo modificare il prefisso delle tabelle “wp_” per aumentare la sicurezza del sito, troviamo il parametro alla riga 67/68 del file.
Modificare questo valore in fase di installazione farlo successivamente può compromettere accesso al DB ed è un’operazione per utenti esperti.
/** a unique prefix. Only numbers, letters, and underscores please! */$table_prefix = 'wp_';
Se desideriamo passare in modalità Debug per qualche malfunzionamento ci basta modificare il valore della direttiva alla linea 81/82 da false a true.
define( 'WP_DEBUG', false );
ref: elenco file di installazione di WordPress
Per riferimento e verifica di seguito elenco completo di directory e file della root di installazione di WordPress.
Nelle varie versioni di WordPress questo elenco può cambiare, attualmente l’elenco fa riferimento alla 6.x
<DIR> wp-admin
<DIR> wp-content
<DIR> wp-includes
file.txt
index.php
license.txt
readme.html
wp-activate.php
wp-blog-header.php
wp-comments-post.php
wp-config-sample.php
wp-cron.php
wp-links-opml.php
wp-load.php
wp-login.php
wp-mail.php
wp-settings.php
wp-signup.php
wp-trackback.php
xmlrpc.php