PHP スタートガイド

このチュートリアルは、Google Cloud への適用において、主なアプリ開発のコンセプトを学習したいと考えているエンジニアやウェブ デベロッパーなど、初めてクラウドにアプリをビルドする方々を対象にしています。

目標

アプリのビルドに関する言語固有の他のチュートリアルについては、以下のガイドをご覧ください。

費用

このチュートリアルでは、課金対象である次の Google Cloud コンポーネントを使用します。

このチュートリアルでは、Google Cloud の Always Free 枠の上限内でリソースの使用が維持されるよう設計されています。 料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。新しい Google Cloud ユーザーは無料トライアルをご利用いただけます。

このチュートリアルを終了した後、作成したリソースを削除すると、それ以上の請求は発生しません。詳しくは、クリーンアップをご覧ください。

始める前に

  1. Google アカウントにログインします。

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  2. Cloud Console のプロジェクト セレクタページで、Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタのページに移動

  3. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する

  4. Firestore データベースをネイティブ モードで作成するには、次の手順に沿って操作してください。
    1. Cloud Console で、[Firestore Viewer] ページに移動します。
      Firestore Viewer に移動
    2. [Cloud Firestore モードの選択] 画面から、[ネイティブ モードを選択] をクリックします。
    3. Firestore データベースのロケーションを選択します。このロケーション設定は、Cloud プロジェクトのデフォルトの Google Cloud リソースのロケーションです。このロケーションは、特にデフォルトの Cloud Storage バケットおよび App Engine アプリの、ロケーション設定を必要とする Cloud プロジェクト内の Google Cloud サービスで使用されます。
    4. [データベースを作成] をクリックします。
  5. App Engine Admin, Cloud Storage, Cloud Logging, and Error Reporting API を有効にします。

    API を有効にする

  6. Cloud Shell で、アプリのソースコードを開きます。
    Cloud Shell に移動

    Cloud Shell を使用すると、ブラウザからコマンドラインで直接 Google Cloud リソースにアクセスできます。

  7. サンプルコードをダウンロードしてアプリのディレクトリに移動するには、[続行] をクリックします。
  8. Cloud Shell で、gcloud ツールを構成して新しい Google Cloud プロジェクトを使用します。

    # Configure gcloud for your project
    gcloud config set project PROJECT_ID
    

    PROJECT_ID は、Cloud Console を使用して作成した Google Cloud プロジェクト ID に置き換えます。

    コマンドラインから Google Cloud リソースを操作するには、基本的にgcloudコマンドライン ツールを使用します。このチュートリアルでは、gcloud ツールを使用してアプリをデプロイおよびモニタリングします。

アプリを実行する

  1. composer を使用してアプリの依存関係をインストールします。

    composer install
    

  2. PHP ビルトイン ウェブサーバーを実行します。
    GOOGLE_CLOUD_PROJECT=PROJECT_ID php -S localhost:8080
    
    PROJECT_ID は、作成した Google Cloud プロジェクト ID で置き換えます。
  3. Cloud Shell で、[ウェブでプレビュー] をクリックし、[ポート 8080 でプレビュー] を選択します。新しいウィンドウが開き、実行中のアプリが表示されます。

アプリを App Engine にデプロイする

Google Cloud には、コードを実行するためのいくつかのオプションが用意されています。この例では、App Engine を使用してスケーラブルなアプリを Google Cloud にデプロイします。App Engine では、開発環境の構成もサーバーの管理も不要なため、コーディングに集中できます。また、トラフィックが急増した場合も App Engine が自動的にスケーリングしてサポートします。

App Engine にデプロイする際の構成ファイルには、主に app.yaml ファイルを使います。

runtime: php72

env_variables:
  APP_DEBUG: true
  LOG_CHANNEL: stderr
  APP_STORAGE: /tmp
  1. ターミナル ウィンドウで、gcloud ツールを使用してアプリを App Engine にデプロイします。

    # on the command-line
    gcloud app deploy
    

  2. ウェブブラウザに次の URL を入力します。

    https://PROJECT_ID.REGION_ID.r.appspot.com

    以下を置き換えます。

    Bookshelf アプリのホームページ

App Engine へのデプロイの詳細については、PHP 7 ランタイム環境をご覧ください。

Firestore でデータを永続化する

App Engine インスタンスに情報を保存することはできません。これは、インスタンスの再起動時に情報が失われ、新しいインスタンスを作成するときに情報が存在しないためです。情報を保存するには、すべてのインスタンスが読み取りおよび書き込みするデータベースを使用します。

Google Cloud には、データを保存するためのいくつかのオプションが用意されています。この例では、Firestore を使用して各書籍のデータを保存します。Firestore はフルマネージドでサーバーレスの NoSQL ドキュメント データベースで、データを保存および照会できます。Firestore はアプリのニーズを満たすために自動でスケーリングし、使用しない場合はゼロにスケーリングします。最初の書籍を追加しましょう。

  1. ウェブブラウザに次の URL を入力します。

    https://PROJECT_ID.REGION_ID.r.appspot.com

    以下を置き換えます。

  2. デプロイしたアプリ用の書籍を作成するには、[Add book] をクリックします。

    Bookshelf アプリに書籍を追加する
  3. [Title] フィールドに「Moby Dick」と入力します。
  4. [Author] フィールドに「Herman Melville」と入力します。
  5. [Save] をクリックします。Bookshelf アプリにエントリが追加されました。

    Moby Dick の Bookshelf アプリのエントリ
  6. Cloud Console で Firestore ページを更新するには、[更新] をクリックします。データが Firestore に表示されます。Bookshelf アプリが各書籍を Firestore ドキュメントとして一意の ID を付けて保存します。すべてのドキュメントは Firestore コレクション内に保存されます。このチュートリアルでは、ドキュメントが保存されているコレクションのことを書籍と呼びます。Firestore ドキュメントの例。

Firestore は Firestore クライアント ライブラリを使用して書籍を保存します。Firestore ドキュメントを取得する例を次に示します。

// Use the client library to call Firestore
use Google\Cloud\Firestore\FirestoreClient;

$firestore = new FirestoreClient([
    'projectId' => $projectId,
]);
$collection =  $firestore->collection($collectionName);
$bookRef = $collection->document($bookId);
$snapshot = $bookRef->snapshot();

Firestore の使用の詳細については、Firestore にデータを追加するをご覧ください。

Cloud Storage にアップロードしたファイルを保存する

書籍を追加したところで、次に書籍の表紙の画像を追加します。ファイルをインスタンスに保存することはできません。データベースは画像ファイルの保存に適していません。そこで、画像は Cloud Storage に保存します。

Cloud Storage は Google Cloud 向けのメインの blob ストアです。Cloud Storage を使用して、Google Cloud で共有するアプリのアセットをホストできます。Cloud Storage を使用するには、データを保存する基本的なコンテナである Cloud Storage バケットを作成する必要があります。

  1. Cloud Console で、[Cloud Storage ブラウザ] ページに移動します。

    Cloud Storage ブラウザページに移動

  2. [バケットを作成] をクリックします。
  3. [バケットを作成] ダイアログでバケット名を入力します。バケット名は、Google Cloud のプロジェクト ID に _bucket という文字列に付け加えて YOUR_PROJECT_ID_bucket のようにします。この名前はバケット名の要件を満たしている必要があります。他のすべてのフィールドはデフォルト値のままにします。
  4. [作成] をクリックします。
  5. バケットの作成後、[Edit book] をクリックして、書籍の表紙としてアップロードする画像を選択します。たとえば、このパブリック ドメインの画像を使用できます。
    Moby Dick の書籍の表紙
  6. [Save] をクリックします。Bookshelf アプリのエントリがあるホームページにリダイレクトされます。
    Moby Dick の Bookshelf アプリのエントリ

Bookshelf アプリは、Cloud Storage クライアント ライブラリを使用して、アップロードされたファイルを Cloud Storage に送信します。

// Use the client library to call Cloud Storage
use Google\Cloud\Storage\StorageClient;

$storage = new StorageClient([
    'projectId' => $projectId,
]);
$bucketId = $projectId . '_bucket';
$gcsBucket = $storage->bucket($bucketId);

Cloud Storage の使用の詳細については、入門ガイドのリストをご覧ください。

Google Cloud のオペレーション スイートを使用したアプリをモニタリングする

アプリをデプロイし、書籍を作成して修正しました。ユーザーのためにこのようなイベントをモニタリングするには、アプリケーション パフォーマンス管理を使用します。

Cloud Logging でログをモニタリング

Cloud Console

  1. ブラウザで、アプリの /logs URL にアクセスします。

    https://PROJECT_ID.REGION_ID.r.appspot.com/logs

    これにより、Cloud Logging にカスタムのエントリが送信されます。エントリには、NOTICEログの重大度と「Hey, you triggered a custom log entry. Good job!」というメッセージが含まれます。

  2. アプリをリアルタイムでモニタリングできるログビューアに移動します。これは、問題が発生した場合にまず確認すべき場所です。
    Cloud Logging ログビューア
  3. [リソース] プルダウン リストで、GAE Application を選択します。
  4. [ログ] プルダウン リストで、[すべてのログ] を選択します。

    カスタムのログエントリが表示されている行があります。

    ログビューアのエントリ

gcloud

  1. ターミナル ウィンドウで、gcloud コマンドライン ツールを使用して、新しいログエントリをリッスンしてアプリのログをモニタリングします。

    gcloud app logs tail

  2. ブラウザで、アプリの /logs URL にアクセスします。

    https://PROJECT_ID.REGION_ID.r.appspot.com/logs

    これにより、Cloud Logging にカスタムのエントリが送信されます。エントリには、NOTICEログの重大度と「Hey, you triggered a custom log entry. Good job!」というメッセージが含まれます。

    gcloud コマンドの出力に新しいログエントリが表示されます。

    Waiting for new log entries...
    2019-03-27 22:17:01 default[20190327t151430]  "Hey, you triggered a custom log entry. Good job!"
    

Error Reporting でエラーをモニタリング

  1. Cloud Console で、[Error Reporting] ページに移動します。
    [Error Reporting] ページに移動
    Error Reporting にはアプリ内のエラーと例外が一覧表示されます。新しいエラーや例外が発生したことを知らせる通知をオンにすることもできます。
  2. ブラウザで、アプリの /errors URL にアクセスします。
    https://PROJECT_ID.REGION_ID.r.appspot.com/errors

    これにより、新しいテストの例外が生成され、Google Cloud のオペレーション スイートに送信されます。

  3. Cloud Console の [Error Reporting] ページに戻り、しばらくすると新しいエラーが表示されます。[自動再読み込み] をクリックすると、ページを手動で更新する必要がなくなります。

    Error Reporting のエラー メッセージ。

クリーンアップ

このチュートリアルで使用したリソースについて、Google Cloud Platform アカウントに課金されないようにする手順は次のとおりです。

プロジェクトの削除

  1. Cloud Console で [リソースの管理] ページに移動します。

    [リソースの管理] ページに移動

  2. プロジェクト リストで、削除するプロジェクトを選択し、[削除] をクリックします。
  3. ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。

次のステップ