托管 PHP 网站或 API

​

开始之前

• 你的电脑上需要安装 PHP。如果尚未安装，可以从 PHP 官方网站 下载。
• 一个 Square Cloud 账户：使用邮箱或 GitHub 注册。
• 一个有效的计划。查看计划并选择适合你项目的计划。

​

配置 Square Cloud

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

​

Square Cloud 运行什么

• 如果配置文件中未定义 START 字段，将使用命令 php -S 0.0.0.0:80 启动一个本地 PHP 服务器，并以 ZIP 的根目录作为文档根目录。如果定义了 START 字段，则会直接执行其中的值。有关配置文件参数的更多信息，请访问配置参数。
• 如果你的项目根目录中有 composer.json 和 composer.phar 文件，Square Cloud 会在启动应用前运行 php composer.phar install。如果没有 composer.phar，请在 START 字段中安装依赖，例如 START=composer install --no-dev --no-interaction -o && php -S 0.0.0.0:80。运行时中可以通过 composer 使用 Composer。你也可以将 vendor/ 文件夹与项目一起上传。

​

端口和主机

​

PHP 与 Swoole

• Swoole 是一款提升标准 PHP 性能的工具，使 Web 服务器能够异步处理多个请求。
• 借助该工具，你可以创建微服务、websocket、后台队列等。它还允许你像 JavaScript 那样执行事件。
• 值得一提的是，Swoole 与其他 PHP 框架兼容。一个很好的 PHP 框架示例是 Laravel，它借助 Octane 与 Swoole 兼容。
• 你可以通过定义自定义的 START 命令来使用它替代标准 PHP 服务器。示例：

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

• 你可以在 Swoole 手册中查看 Swoole 的所有强大功能。

​

准备项目

​

必需文件

• squarecloud.app，位于 ZIP 的根目录。
• index.php，或 MAIN 中设置的文件。
• composer.json（可选），在你使用 Composer 包时需要。

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

​

不需要包含的文件

• 你本地的 .env 文件：请改为将密钥设置为环境变量。默认服务器以 ZIP 的根目录作为文档根目录，因此你上传到那里的任何文件都可以被下载。
• vendor/ 和 node_modules/，当你的 START 命令会安装它们时。

​

框架指南

​

部署

​

通过控制面板

1

访问上传页面

访问上传页面并上传你的项目 zip 文件。

2

配置你的环境

上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。

3

部署你的项目

最后，点击 “Deploy” 按钮，即可将项目托管到 Square Cloud。
部署完成后，你可以在控制面板中监控项目的状态和日志。

4

确认你的应用已上线

首次部署通常在一分钟内完成。在控制面板中，等待你的应用状态显示为运行中，并检查日志中是否有启动错误。
如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。

应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

​

通过 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

​

后续步骤

​

联系我们