Guida per installare PrestaShop in locale sul proprio PC

Tutorial per l’installazione di PrestaShop in locale tramite XAMPP sul proprio PC, creare un ambiente di staging PrestaShop in locale.

INDICE DEI CONTEUTI:

1. Predisporre e installare l’ambiente per la Piattaforma
2. Modificare i parametri di configurazione
3. Creazione del DataBase MySql
4. Installare PrestaShop
5. reference: elenco file di installazione di PrestaShop

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:

• Apache
• MySQL

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.

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).

andrò ad aggiungere/modificare delle righe non richieste in fase di installazione ma utili per alcuni temi e addon di cui potremmo aver bisogno.

• realpath_cache_size = 4096k
• realpath_cache_size = 5M
• upload_max_filesize=40M
• upload_max_filesize=750M
• max_execution_time=120
• max_execution_time = 5000
• max_input_time=60
• max_input_time = 5000
• post_max_size=40M
• post_max_size=750M

I parametri di seguito nella maggior parte delle versioni di XAMPP potrebbero essere non presenti (talvolta anche quelli già indicati) se mancanti andremo ad aggiungerli.

• memory_limit = 1000M
• extension=php_intl.dll

Effettuate le modifiche salviamo il file e riavviamo il modulo Apache premendo su Stop e nuovamente su Start.

editare MY.INI

Analogamente a quanto fatto in precedenza andremo ad editare il nostro MY.INI per effettuare le modifiche: Apache > Config > my.ini

I parametri da modificare/aggiungere sono i seguenti:

• innodb_lock_wait_timeout=50
• innodb_lock_wait_timeout=600
• wait_timeout=600
• max_allowed_packet=1M
• max_allowed_packet=64M

Effettuate le modifiche salviamo il file e riavviamo il modulo mySQL premendo su Stop e nuovamente su Start.

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.

scelta della lingua

condizioni d’uso

check compatibilità

dati del negozio

A questo punto ci vengono richiesti i dati del nostro store che sommariamente sono:

questi dati possono variare leggermente a seconda della versione di PrestaShop.

• nome del negozio: identifica la vostra attività;
• attività principale: per fini statistici;
• installazione prodotti dimostrativi: si o no;
• nazione: nazione principale/lingua dello store;
• nome: utente amministratore;
• cognome: cognome utente amministratore;
• indirizzo mail: mail utente amministratore
• password: password amministratore;

mail e la password inserite in questa fase sono quelle del utente Super Admin del nostro store, dobbiamo segnarle e ricordarle perché rappresentano le nostre chiavi di login.

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.

• indirizzo server del database: localhost o 127.0.0.1;
• nome del database: quello scelto
• nome di accesso al database: nel nostro caso analogo al nome del database, se diverso va specificato;
• password: quella scelta
• prefisso delle tabelle: ps_, in realtà su un ambiente online andrebbe modificato per motivi di sicurezza;
• svuota le tabelle esistenti: solitamente spuntato;

mail e la password inserite in questa fase sono quelle del utente Super Admin del nostro store, dobbiamo segnarle e ricordarle perché rappresentano le nostre chiavi di login.

Per sicurezza clicchiamo su Verifica adesso la connessione al tuo database, se tutto è stato fatto correttamente cliccando su Successivo PrestaShop andrà a creare e popolare le nostre tabelle e a completare l’installazione.

Se non si passa la verifica di connessione dovete rivedere passo passo la procedura ed in particolare la fase di creazione del DB e utente su PhpMyAdmin.

creazione tabelle

installazioni moduli

installazione tema

accesso al back-end

Indirizzo di accesso:
http://localhost/{nome-della-nostra-cartella/{nome-cartella-di-admin}

Esempio:
http://localhost/ecommerce/{admin421sfpqma}/

accesso al front-end

Indirizzo front-end: 
http://localhost/{nome-della-nostra-cartella}/

Esempio:
http://localhost/ecommerce/

<DIR> admin
<DIR> app
<DIR> bin
<DIR> cache
<DIR> classes
<DIR> config
<DIR> controllers
<DIR> docs
<DIR> download
<DIR> img
<DIR> install
<DIR> js
<DIR> localization
<DIR> mails
<DIR> modules
<DIR> override
<DIR> pdf
<DIR> src
<DIR> templates
<DIR> themes
<DIR> tools
<DIR> translations
<DIR> upload
<DIR> var
<DIR> vendor
<DIR> webservice
.php-cs-fixer.dist.php
autoload.php
composer.lock
configure_git.sh
error500.html
file.txt
index.php
init.php
INSTALL.txt
LICENSES
Makefile
new_version.sh
phpstan.neon.dist