PHP 快速入門

這個專案說明如何實作簡單的 Glassware 功能,並示範 Google Mirror API 的主要功能。

如要查看快速入門專案的完整運作範例,請前往 https://glass-python-starter-demo.appspot.com。否則,請繼續閱讀如何部署自己的版本。

前往 GitHub 下載

必要條件

  • PHP 5.3.x 以上版本
  • 網路伺服器:您需要存放代管檔案的位置。 Apache httpdkube 工作十分出色。
  • 如要使用訂閱項目,您還需要可使用可信任的憑證授權單位所簽署的有效 SSL 憑證的網際網路存取主機。

建立 Google API 控制台專案

接著,請啟用 Google Mirror API 的存取權:

  1. 前往 Google API 主控台,建立新的 API 專案。
  2. 按一下「Service」,然後為新專案啟用 Google Mirror API。 Google API 控制台中的 Google Mirror API
  3. 按一下 [API Access] (API 存取權),然後為網路應用程式建立 OAuth 2.0 用戶端 ID。 Google API 控制台的「API 存取」區段
  4. 指定 Glassware 的產品名稱與圖示。這些欄位會顯示在向使用者顯示的 OAuth 授權畫面上。 指定品牌資訊
  5. 選取「Web Application」,然後指定主機名稱的任何值,例如 localhost 選取應用程式類型
  6. 針對用戶端 ID 按一下 [Edit settings...],即可指定重新導向 URI。指定本機開發網路伺服器 (例如 http://localhost:8080/oauth2callback) 和已部署網路伺服器的回呼網址 (例如 https://example.com/oauth2callback)。Google API 主控台重新導向 URI 設定面板
  7. 在 Google API 控制台中記下用戶端 ID 和密鑰。您需要這個金鑰來設定快速入門專案。Google API 控制台中的用戶端 ID 和密鑰

設定專案

輸入您的用戶端 ID、密鑰、簡易 API 金鑰、基本網址,以及可在 config.php 建立 SQLite 資料庫的位置:

$api_client_id = "1234.apps.googleusercontent.com";
$api_client_secret = "ITS_A_SECRET_TO_EVERYBODY";
$api_simple_key = "AIzaSyCCbHcqDeb0oycQ9niV8P3n0F0qM";

$base_url = "http://example.com/starter-project";

$sqlite_database = "/tmp/database.sqlite";

部署專案

將快速入門專案部署到您的主機伺服器:

  1. 將 PHP 快速入門目錄複製到 HTTP 網路伺服器的文件目錄。
  2. 視您的系統設定而定,您可能需要預先為 SQLite 資料庫建立可寫入的檔案:

    $ touch /tmp/database.sqlite
    $ chmod 777 /tmp/database.sqlite