Saltar al contenido principal

​
🚀 Introducción

  • Antes de empezar, asegúrate de que PHP esté instalado en tu sistema. Si aún no lo tienes, puedes descargarlo desde el sitio web oficial de PHP.
  • A continuación, deberás crear una cuenta en Square Cloud, lo cual puedes hacer a través de la página de inicio de sesión. Puedes usar tu correo electrónico, GitHub o ambos para crear la cuenta.
  • Por último, necesitas tener un plan de pago activo en tu cuenta. Puedes ver nuestros planes y adquirir uno según tus necesidades aquí.

​
⚙️ Configuración del archivo squarecloud.app

Si estás subiendo tu aplicación a través del sitio web de Square Cloud, puedes ignorar esta sección. El sitio crea automáticamente el archivo de configuración squarecloud.app por ti.

Más información: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; servirá para definir el nombre, la descripción, la versión, el archivo principal, entre otras cosas.

​
📄 Archivos requeridos

  • index.php (Ejemplo de archivo principal).
  • composer.json (Archivo de dependencias opcional).
  • squarecloud.app (archivo que contiene la configuración de Square Cloud).

​
▶️ Cómo iniciar tu aplicación

  • 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. Si el campo START está definido, se ejecutará directamente el valor que contenga. Para más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.
  • Si existe el archivo composer.json, todas las dependencias se instalarán usando el comando php composer.phar install.

​
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 run build && composer install --no-interaction --prefer-dist --optimize-autoloader && php artisan optimize && php artisan migrate --force && php -v && php artisan octane:start --host=0.0.0.0 --port=80 --workers=4 --task-workers=8 --server=swoole
  • Puedes consultar todas las potentes funciones de Swoole aquí.

​
🖥️ Preparando el proyecto

Antes de alojar tu proyecto en Square Cloud, primero verifica que los archivos del proyecto estén correctamente configurados para el alojamiento. Si tu proyecto incluye un archivo composer.json, Square Cloud instalará automáticamente las dependencias usando Composer. Sin embargo, si tu proyecto también tiene dependencias de Node (es decir, un package.json), debes especificar el proceso de instalación en el campo START de tu archivo squarecloud.app. Por ejemplo: 
START=npm install && php .....
El archivo de configuración (squarecloud.app/.config) debe estar ubicado en la raíz del archivo zip. De lo contrario, Square Cloud no podrá encontrarlo durante el deploy.

​
📤 Cómo alojar tu proyecto

Ahora que has preparado todos los archivos para tu proyecto PHP, el siguiente paso es subirlos a Square Cloud y poner tu aplicación en línea. Hay varias formas de subir, pero cubriremos dos: a través del Dashboard o a través de la CLI.

​
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.
Subiendo aplicación a Square Cloud

​
A través de la CLI

Para usar este método, necesitas crear un archivo de configuración llamado squarecloud.app en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.

Aprende más sobre: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se utilizará para definir tu entorno.
1

Instala la CLI

Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:
npm install -g @squarecloud/cli
Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
squarecloud update
2

Autentícate

Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización aquí haciendo clic en “Request API Key”. Después de obtener tu clave de autorización, ejecuta el siguiente comando:
squarecloud auth login
3

Sube tu proyecto

Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:
squarecloud upload
O si creaste el zip manualmente, puedes usar:
squarecloud upload --file <path/to/zip>

​
Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema.