Aloja un sitio web o API en PHP

​

Antes de empezar

• PHP en tu máquina. Si no lo tienes, descárgalo desde el sitio web oficial de PHP.
• Una cuenta de Square Cloud: regístrate con tu email o GitHub.
• Un plan activo. Consulta los planes y elige el que se ajuste a tu proyecto.

​

Configurar Square Cloud

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

​

Qué ejecuta Square Cloud

• Si el campo START no está definido en el archivo de configuración, se iniciará un servidor PHP local con el comando php -S 0.0.0.0:80, con la raíz de tu ZIP como raíz de documentos. Si el campo START está definido, el valor que contenga se ejecutará directamente. Para obtener más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.
• Si tu proyecto tiene un composer.json y el archivo composer.phar en su raíz, Square Cloud ejecuta php composer.phar install antes de iniciar tu app. Sin composer.phar, instala las dependencias en el campo START, por ejemplo START=composer install --no-dev --no-interaction -o && php -S 0.0.0.0:80. Composer está disponible en el runtime como composer. También puedes subir la carpeta vendor/ con tu proyecto.

​

Puerto y host

​

PHP con Swoole

• Swoole es una herramienta que mejora el rendimiento estándar de PHP permitiendo que el servidor web maneje múltiples solicitudes de forma asíncrona.
• Con esta herramienta, puedes crear microservicios, websockets, colas en segundo plano, entre otros. También te permite ejecutar eventos tal como lo hace JavaScript.
• También es importante mencionar que Swoole es compatible con otros frameworks de PHP. Un buen ejemplo de un framework de PHP es Laravel, que es compatible con Swoole gracias a Octane.
• Puedes usarlo en lugar del servidor PHP estándar definiendo tu comando START personalizado. Ejemplo:

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

• Puedes consultar todas las funciones de Swoole en el manual de Swoole.

​

Preparar el proyecto

​

Archivos necesarios

• squarecloud.app, en la raíz del ZIP.
• index.php, o el archivo definido en MAIN.
• composer.json, opcional, cuando usas paquetes de Composer.

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

​

Qué dejar fuera

• Tu archivo .env local: define tus secretos como variables de entorno. El servidor predeterminado usa la raíz del ZIP como raíz de documentos, así que cualquier archivo que subas ahí se puede descargar.
• vendor/ y node_modules/, cuando tu comando START los instala.

​

Guías de frameworks

​

Hacer deploy

​

A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​

A través de 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

​

Próximos pasos

​

Contáctanos