Ospita un sito web o un'API PHP

​

Prima di iniziare

• PHP sul tuo computer. Se non lo hai, scaricalo dal sito ufficiale di PHP.
• Un account Square Cloud: registrati con la tua email o con GitHub.
• Un piano attivo. Consulta i piani e scegli quello adatto al tuo progetto.

​

Configurare Square Cloud

MAIN=index.php
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website
SUBDOMAIN=mywebsite

​

Cosa esegue Square Cloud

• Se il campo START non è definito nel file di configurazione, verrà avviato un server PHP locale con il comando php -S 0.0.0.0:80, con la radice del tuo ZIP come document root. Se il campo START è definito, il valore in esso contenuto verrà eseguito direttamente. Per maggiori informazioni sui parametri del file di configurazione, visita parametri di configurazione.
• Se il tuo progetto ha un composer.json e il file composer.phar nella radice, Square Cloud esegue php composer.phar install prima di avviare l’applicazione. Senza composer.phar, installa le dipendenze nel campo START, ad esempio START=composer install --no-dev --no-interaction -o && php -S 0.0.0.0:80. Composer è disponibile nel runtime come composer. Puoi anche caricare la cartella vendor/ insieme al tuo progetto.

​

Porta e host

​

PHP con Swoole

• Swoole è uno strumento che migliora le prestazioni standard di PHP consentendo al webserver di gestire più richieste in modo asincrono.
• Con questo strumento, puoi creare microservizi, websocket, code in background, tra gli altri. Ti permette inoltre di eseguire eventi proprio come fa JavaScript.
• È inoltre importante ricordare che Swoole è compatibile con altri framework PHP. Un buon esempio di framework PHP è Laravel, compatibile con Swoole grazie a Octane.
• Puoi utilizzarlo al posto del server PHP standard definendo il tuo comando START personalizzato. Esempio:

npm install && npm run build && composer install --no-interaction --prefer-dist --optimize-autoloader && php artisan optimize && php -v && php artisan octane:start --host=0.0.0.0 --port=80 --workers=4 --task-workers=8 --server=swoole

• Puoi consultare tutte le potenti funzioni di Swoole nel manuale di Swoole.

​

Preparare il progetto

​

File richiesti

• squarecloud.app, nella radice dello ZIP.
• index.php, o il file indicato in MAIN.
• composer.json, facoltativo, quando usi pacchetti Composer.

START=npm install && npm run build && composer install --no-dev --no-interaction -o && php -S 0.0.0.0:80

​

Cosa lasciare fuori

• Il tuo file .env locale: imposta invece i tuoi segreti come variabili d’ambiente. Il server predefinito usa la radice dello ZIP come document root, quindi qualsiasi file caricato lì può essere scaricato.
• vendor/ e node_modules/, quando il tuo comando START li installa.

​

Guide ai framework

​

Deploy

​

Tramite dashboard

1

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.

2

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.

3

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​

Tramite CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Prossimi passi

​

Contattaci