Skip to main content
PHP ランタイムは PHP のウェブサイトと API を配信します。Composer、アセットのビルド用の Node.js、Swoole 拡張機能が含まれています。

始める前に

  • 手元のマシンに PHP。まだの場合は、PHP 公式サイトからダウンロードしてください。
  • Square Cloud のアカウント。メールアドレスまたは GitHub で登録できます。
  • 有効なプラン。プランを確認し、プロジェクトに合うものを選んでください。

Square Cloud の設定

ダッシュボードからアプリケーションをアップロードする場合、このセクションは飛ばしてかまいません。ダッシュボードが squarecloud.app 設定ファイルを自動で作成します。

設定ファイルのリファレンス

squarecloud.app ファイルは、アプリケーションの実行方法を Square Cloud に伝えます。メインファイル、メモリ、ランタイムのバージョン、名前、そして Web サイトの場合はサブドメインを指定します。
ウェブサイトまたは API 向けの完全な設定ファイルです。
squarecloud.app

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/ フォルダをプロジェクトと一緒にアップロードすることもできます。

ポートとホスト

デフォルトのコマンドは、すでにポート 80 ですべてのネットワークインターフェース (0.0.0.0) をリッスンしています。独自の START を書く場合も、この両方を維持してください。Square Cloud は環境変数 PORT を 80 に設定します。127.0.0.1 だけでリッスンしているサーバーには、リクエストが届きません。

PHP と Swoole

  • Swoole は標準の PHP パフォーマンスを向上させるツールで、Web サーバーが複数のリクエストを非同期に処理できるようにします。
  • このツールを使うと、マイクロサービス、WebSocket、バックグラウンドキューなどを作成できます。また、JavaScript と同様にイベントを実行することもできます。
  • Swoole は他の PHP フレームワークとも互換性があることも重要な点です。PHP フレームワークの良い例としては Laravel があり、Octane のおかげで Swoole と互換性があります。
  • 標準の PHP サーバーの代わりに、カスタムの START コマンドを定義して使用できます。例:

プロジェクトの準備

必要なファイル

  • ZIP のルートに置いた squarecloud.app。
  • index.php、または MAIN に設定したファイル。
  • composer.json (任意): Composer のパッケージを使う場合。
プロジェクトに composer.json ファイルが含まれている場合は、squarecloud.app ファイルの START フィールドで composer install を実行してください(または vendor/ フォルダをアップロードします)。アセットのビルド用に Node の依存関係(つまり package.json)もある場合は、それらのインストールとビルドも START で行ってください。例:
squarecloud.app
設定ファイル(squarecloud.app)は zip ファイルのルートに配置する必要があります。そうでない場合、Square Cloud はデプロイ時にそれを見つけることができません。

含めないもの

  • ローカルの .env ファイル: シークレットは代わりに環境変数として設定してください。デフォルトのサーバーは ZIP のルートをドキュメントルートとして使うため、そこにアップロードしたファイルはすべてダウンロードできてしまいます。
  • vendor/ と node_modules/ (START コマンドでインストールする場合)。

フレームワークガイド

Laravel

デプロイ

ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
Square Cloud へのアプリケーションのアップロード
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか?よくある原因と修正方法はトラブルシューティングガイドを参照してください。

CLI 経由

この方法を使用するには、プロジェクトのルートに squarecloud.app という名前の設定ファイルが必要です。このファイルは、アプリケーションの実行方法を Square Cloud に伝えます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。
1

CLI をインストール

Square Cloud CLI をインストールします。すでにお持ちの場合は、同じコマンドを実行すると更新されます:
2

ログイン

次のコマンドを実行します。ブラウザが開くので、そこでログインを承認すれば CLI の準備は完了です。API キーをコピーする必要はありません。スクリプトや CI については、CLI の認証を参照してください。
3

プロジェクトをアップロード

プロジェクトのフォルダで次のコマンドを実行します。CLI は squarecloud.ignore に記載されたものを除いて現在のフォルダを zip にし、アップロードします:
自分で作成した zip をアップロードするには、--file で指定します:
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか?よくある原因と修正方法はトラブルシューティングガイドを参照してください。

次のステップ

環境変数

シークレットや設定をコードから切り離し、実行時に読み込みます。

カスタムドメイン

Standard プラン以上で、独自ドメインからアプリを配信します。

トラブルシューティング

起動しないアプリや応答しないサイトを修正します。

お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします。サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に402 件のレビューで 4.9/5という評価をつけている理由の 1 つです。