Home
NexoPOS

NexoPOS su Hostinger

Hostinger è un popolare provider di hosting compatibile con la maggior parte delle applicazioni web. In effetti, con soli $2,99 puoi iniziare subito a ospitare la tua applicazione, inclusa NexoPOS.

Qui imparerai come installare NexoPOS. Tratteremo soprattutto le nozioni di base della creazione, che include:

  • Creazione di un dominio (o sottodominio).
  • Scaricamento del progetto
  • Creazione di un database
  • Eseguire l’installazione

Creazione di un dominio

La particularité de NexoPOS (et de Laravel) est que le serveur ne doit pas chercher le fichier « index.php » à la racine du projet, mais à l’intérieur du dossier « public ». Lors de la création de notre domaine (ou sous-domaine), nous devons indiquer au serveur d’utiliser le dossier « public » comme répertoire racine du document.

Facciamo un esempio concreto su Hostinger. Supponiamo che tu crei un sottodominio chiamato "pos" e che tu abbia creato il sottodominio come segue:

creating-subdomain-hostinger

Nell’esempio, il file (NexoPOS) verrà rilasciato in “public_html/pos”, ma la cartella “public” inclusa già nel codice sorgente di NexoPOS verrà utilizzata per recuperare il file “index.php”.

Dovresti quindi avere un output come questo:

domain-creation-hostinger

Scaricamento del progetto

Ci sono due modi per farlo. Puoi farlo sia dal file manager sia dalla CLI (interfaccia a riga di comando). La CLI resta la soluzione migliore, perché in ogni caso dovrai usarla per installare le dipendenze di Composer.

Quindi tornerai alla dashboard, scorri verso il basso fino a “Avanzate” e fai clic su “Accesso SSH”.

copy-ssh-access

Questo dovrebbe portarti a una pagina in cui puoi copiare l’accesso SSH per il tuo server. Dovrebbe apparire così:

Puoi utilizzare Putty, PenguiNet o anche VsCode per accedere al server. Nel mio caso, uso Putty. Se non sai ancora come connetterti a Putty, ti invito a leggere questa guida.

Assumendo che tu sia connesso al terminale, cambierai la directory in:

cd /home/uXXXXX/domains/nexopos.com/public_html/pos. 

Tutti i valori in “grassetto” devono essere sostituiti con il tuo valore di hosting effettivo:

  • uXXXXXX sostituito dal nome utente sul server
  • nexopos.com sostituito con il tuo dominio effettivo.

Da ora in poi, andremo su GitHub Releases per scaricare la versione più recente di NexoPOS.

image44824

Dovrai scegliere i file compilati (primo file) oppure il codice sorgente in “zip”. Poi devi solo copiare il link e recarti nel terminale (PuTTY), dove farai:

wget https://github.com/Blair2004/NexoPOS/releases/download/v6.1.2/NexoPOS-6.1.2.zip

Avrai quindi un file chiamato "NexoPOS-6.1.2.zip" nella directory "pos". Ora devi solo decomprimerlo in questo modo:

unzip NexoPOS-6.1.2.zip

Ensuite, nous devons déplacer tout ce qui se trouve dans le dossier « NexoPOS-6.1.2 » vers le dossier « pos », comme ceci :

mv NexoPOS-6.1.2/* .

Assicuriamoci di avere disponibile il file “.env.example”. Se non è presente, puoi comunque scaricarlo da GitHub. Se il file manca, durante l’installazione verrà generato qualche errore mentre si scaricano i pacchetti di Composer.

Ora puoi eliminare in sicurezza la cartella "NexoPOS-6.1.2".

Configurazione di PHP 8.4

Prima di installare le dipendenze di Composer, dobbiamo verificare se la versione PHP predefinita sulla CLI è la 8.4. Il primo passo è definire la versione PHP sull’account Hostinger.

php-version-hostinger

Da lì, abiliteremo PHP 8.4 come versione PHP predefinita.

Cependant, parfois, modifier la version de PHP à cet endroit n’a pas d’incidence sur la version de PHP dans la CLI, qui a tendance à rester à la version 8.2 (au moment où nous écrivons ces lignes). Nous pouvons le vérifier en utilisant la commande suivante.

php -v

Se l’output menziona PHP a una versione diversa da 8.4, dovremo individuare quella versione. Ma se la tua versione di PHP è la 8.4, puoi passare alla sezione successiva.

Per farlo, lo vedremo nella sezione PHP info del tuo account Hostinger. In quella pagina dovremmo vedere PHP 8.4.

screenshot-nimbuswebme-20221027-09-08-57

Da lì, controlleremo la sezione "Configura comando" e useremo il valore di --bindir come in questa immagine.

Da questo, possiamo vedere che il binario PHP (eseguibile) si trova nel percorso /opt/alt/php84/usr/bin. Quando eseguiamo “ls -la” su quel percorso, vediamo tutti i file e poi vediamo che c’è anche PHP.

Il percorso completo per accedere a PHP 8.4 è quindi:

/opt/alt/php84/usr/bin/php

Lo useremo per i comandi successivi che iniziano con “php” e sostituiremo “php” con “/opt/alt/php84/usr/bin/php”. Ad esempio, supponiamo di voler eseguire un comando artisan invece di usare:

php artisan list

Useremo questo:

/opt/alt/php81/usr/bin/php artisan list

Scaricamento delle dipendenze di Composer

Ora procederemo scaricando le dipendenze di Composer. Questo verrà effettuato utilizzando il seguente comando:

composer2 install

Nota che qui stiamo usando “composer2” perché è il modo per accedere a Composer 2, necessario per NexoPOS.

se usando “php -v”, php era a una versione diversa dalla 8.4, useremo i comandi sopra che eseguono php 8.4, così:

/opt/alt/php84/usr/bin/php composer2 install
image-5

Subito dopo, dovrai eseguire:

php artisan key:generate
php artisan storage:link

Al momento, quando accedi al tuo sistema online, dovresti essere in grado di vedere la pagina di benvenuto.

Crea un database su Hostinger

Dobbiamo creare un database per poter utilizzare NexoPOS 4.x. Andiamo nella sezione Database e facciamo clic sull’icona “MySQL Databases”.

image-7

Successivamente, ti verrà chiesto di creare il nome del database e l’utente del database con la password.

image-8-1024x382

Una volta terminato, puoi tornare alla procedura guidata di installazione di NexoPOS per procedere con l’installazione.

Procedura guidata di installazione NexoPOS

Da ora puoi procedere all’installazione seguendo le istruzioni disponibili nella procedura guidata.

Risoluzione dei problemi

File .env mancante

Parfois, en téléchargeant le ZIP puis en l’extrayant, le fichier .env peut manquer pour une raison quelconque. Nous devrons alors créer un fichier à la racine avec le nom suivant « .env » et le contenu de ce fichier doit être pris d’ici.

È stato utile? Se non lo è stato e hai ancora bisogno di aiuto, faccelo sapere all’indirizzo [email protected].