Héberger un site web ou une API PHP

​

Avant de commencer

• PHP sur votre machine. Si ce n’est pas le cas, téléchargez-le depuis le site officiel de PHP.
• Un compte Square Cloud : inscrivez-vous avec votre e-mail ou GitHub.
• Un plan actif. Consultez les plans et choisissez celui qui convient à votre projet.

​

Configurer Square Cloud

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

​

Ce que Square Cloud exécute

• Si le champ START n’est pas défini dans le fichier de configuration, un serveur PHP local sera démarré avec la commande php -S 0.0.0.0:80, avec la racine de votre ZIP comme racine des documents. Si le champ START est défini, sa valeur sera exécutée directement. Pour plus d’informations sur les paramètres du fichier de configuration, consultez les paramètres de configuration.
• Si votre projet a un composer.json à sa racine, Square Cloud exécute composer install avant chaque démarrage : vous n’avez donc pas besoin de l’ajouter dans START. Il utilise le composer.phar de votre ZIP s’il y en a un, et sinon le Composer inclus dans le runtime. Envoyez aussi composer.lock, pour que le serveur installe les mêmes versions que celles que vous avez testées.

​

Port et hôte

​

PHP avec Swoole

• Swoole est un outil qui améliore les performances standard de PHP en permettant au serveur web de traiter plusieurs requêtes de manière asynchrone.
• Avec cet outil, vous pouvez créer des microservices, des websockets, des files d’attente en arrière-plan, entre autres. Il vous permet également d’exécuter des événements tout comme le fait JavaScript.
• Il est également important de mentionner que Swoole est compatible avec d’autres frameworks PHP. Un bon exemple de framework PHP est Laravel, qui est compatible avec Swoole grâce à Octane.
• Vous pouvez l’utiliser à la place du serveur PHP standard en définissant votre commande START personnalisée. Exemple :

npm install && npm run build && php artisan optimize && php artisan octane:start --host=0.0.0.0 --port=80 --workers=4 --task-workers=8 --server=swoole

• Vous pouvez découvrir toutes les puissantes fonctions de Swoole dans le manuel de Swoole.

​

Préparer le projet

​

Fichiers requis

• squarecloud.app, à la racine du ZIP.
• index.php, ou le fichier défini dans MAIN.
• composer.json et composer.lock, lorsque vous utilisez des paquets Composer.

START=npm install && npm run build && php -S 0.0.0.0:80

​

Ce qu’il faut exclure

• Votre fichier .env local : définissez plutôt vos secrets comme variables d’environnement. Le serveur par défaut utilise la racine du ZIP comme racine des documents : tout fichier que vous y envoyez peut donc être téléchargé.
• vendor/ : Square Cloud l’installe à partir de composer.json.
• node_modules/, lorsque votre commande START l’installe.

​

Guides des frameworks

​

Déployer

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via la 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

​

Prochaines étapes

​

Contactez-nous