GAEの準備から開発開始まで (2/4)
作成:2013-06-03 07:51
更新:2013-06-03 07:51
更新:2013-06-03 07:51
■GAEアプリケーションとapp.yaml
では、GAEのアプリケーションというのは、どのように作成するのでしょうか。これは、実は非常に単純です。フォルダを作成し、その中に必要なファイルを配置するだけなのです。
必要なファイルというのは、実は1つだけです。それは「app.yaml」というファイルです。このファイルを用意することで、そのフォルダをGAEのアプリケーションとして実行したりデプロイしたりできるようになります。
このapp.yamlというファイルは、アプリケーションに関する詳細情報を記述したテキストファイルです。YAMLと呼ばれる半角スペースでインデントをつけた形式でデータを記述します。これは以下のような形になります。
最初の4行は、必須項目です。application:には、公開するアプリケーション名を指定します。これは、GAEのサーバーに用意されているアプリケーション名でなければいけません。GAEはデプロイ時に、このapplication:に指定されたアプリケーションにファイルをアップロードするようになっています。
version:は、このWebアプリのバージョンです。これは任意の値で構いません。runtime:は、PHPを使う場合には必ず「php」を指定します。またapi_version:も現時点では「1」にしておきます。
まず、「-url:」というところにアドレスを指定し、その後にある「script:」でファイルを指定します。これにより、-url:にアクセスするとscript:のスクリプトが実行されるようになります。この-url:とscript:のセットは、必要なだけ記述できます。
注意して欲しいのは、「script:の前には半角スペース2つがつく」という点です。YAMLでは、半角スペースによるインデントでデータの構造を保っているのです。
Webでは、スクリプトファイルだけでなく、静的なファイル(JavaScriptのスクリプトファイルやスタイルシートファイル、イメージファイルなど)も多数利用されます。こうした静的ファイルは、このstatic_dir:で指定したフォルダの中に配置することで、-url:のアドレス下に配置されているものとしてアクセスできるようになります。
このapp.yamlファイルと共に、script:で指定したスクリプトファイルを用意するだけで、Webアプリケーションとして扱えるようになります。では、実際に簡単なサンプルを作ってみましょう。
適当な場所にフォルダを作成し(ここでは例として「php-app」というフォルダをデスクトップに用意しました)、その中に「app.yaml」ファイルを作成してください。そして、下のリスト欄のように中身を記述しましょう。今回は静的ファイルはないので、スクリプトファイルのマッピングのみ記述してあります。
必要なファイルというのは、実は1つだけです。それは「app.yaml」というファイルです。このファイルを用意することで、そのフォルダをGAEのアプリケーションとして実行したりデプロイしたりできるようになります。
このapp.yamlというファイルは、アプリケーションに関する詳細情報を記述したテキストファイルです。YAMLと呼ばれる半角スペースでインデントをつけた形式でデータを記述します。これは以下のような形になります。
application: アプリケーション名
version: バージョン番号
runtime: php
api_version: 1
handlers:
- url: 公開アドレス
script: スクリプトファイル
- url: 公開アドレス
static_dir: フォルダ
最初の4行は、必須項目です。application:には、公開するアプリケーション名を指定します。これは、GAEのサーバーに用意されているアプリケーション名でなければいけません。GAEはデプロイ時に、このapplication:に指定されたアプリケーションにファイルをアップロードするようになっています。
version:は、このWebアプリのバージョンです。これは任意の値で構いません。runtime:は、PHPを使う場合には必ず「php」を指定します。またapi_version:も現時点では「1」にしておきます。
url:とscript:について
その後にある「handlers:」というのは、設置したPHPのスクリプトファイルと、それの公開アドレスを記述するものです。このhandlers:の後に、ファイルのアドレスへのマッピング情報を記述していきます。まず、「-url:」というところにアドレスを指定し、その後にある「script:」でファイルを指定します。これにより、-url:にアクセスするとscript:のスクリプトが実行されるようになります。この-url:とscript:のセットは、必要なだけ記述できます。
注意して欲しいのは、「script:の前には半角スペース2つがつく」という点です。YAMLでは、半角スペースによるインデントでデータの構造を保っているのです。
-url:とstatic_dir:について
もう1つ、「-url:」の後に「static_dir:」というものを記述することもできます。これは「静的ファイルの設置フォルダ」を示すものです。Webでは、スクリプトファイルだけでなく、静的なファイル(JavaScriptのスクリプトファイルやスタイルシートファイル、イメージファイルなど)も多数利用されます。こうした静的ファイルは、このstatic_dir:で指定したフォルダの中に配置することで、-url:のアドレス下に配置されているものとしてアクセスできるようになります。
このapp.yamlファイルと共に、script:で指定したスクリプトファイルを用意するだけで、Webアプリケーションとして扱えるようになります。では、実際に簡単なサンプルを作ってみましょう。
適当な場所にフォルダを作成し(ここでは例として「php-app」というフォルダをデスクトップに用意しました)、その中に「app.yaml」ファイルを作成してください。そして、下のリスト欄のように中身を記述しましょう。今回は静的ファイルはないので、スクリプトファイルのマッピングのみ記述してあります。
(by. SYODA-Tuyano.)
※プログラムリストが表示されない場合
AddBlockなどの広告ブロックツールがONになっていると、プログラムリスト等が表示されない場合があります。これらのツールをOFFにしてみてください。
●プログラム・リスト●
※app.yaml application: tuyano-php-app version: 1 runtime: php api_version: 1 handlers: - url: / script: helo.php
※関連コンテンツ
「PHPで始めるGoogle App Engine (GAE)入門」に戻る