PHP Bookshelf app

The Bookshelf app is a sample web app written in PHP that shows how to use various Google Cloud Platform (GCP) products, including:

  • App Engine flexible environment
  • Cloud Datastore
  • Cloud Storage
  • Cloud Pub/Sub

This tutorial explores the Bookshelf sample app and discusses how each feature of the app is implemented using technologies and services that GCP provides.

Screenshot of the Bookshelf app showing controls and book covers

The Bookshelf sample app stores a collection of book titles. Anyone with access to the app can modify the list. The sample app lets users:

  • View the list of books.
  • Add books to the list.
  • Remove books from the list.
  • Edit book details.
  • Upload cover images for books.
  • Sign in with a Google Account and view the books that they added to the list.

Objectives

  • Clone or download the sample app.
  • Build the app and run it on your local machine.
  • Deploy the app to App Engine.
  • Walk through the sample code.
  • Learn how the app stores structured data.
  • Learn how the app stores binary data in Cloud Storage.
  • Learn how the app authenticates users.
  • Learn how the app creates event logs that are visible in the Google Cloud Platform Console.

Costs

This tutorial uses billable components of GCP, including Compute Engine.

This tutorial has several steps, and each step is documented on its own page. The final page of the tutorial includes instructions for cleaning up resources so you won't continue to be billed for GCP services. If you decide not to complete all the steps of the tutorial, see the cleanup instructions on the final page.

Before you begin

  1. To set up your Google Cloud Platform project, use the GCP Console:
    1. Create a GCP project, create an App Engine app, and then enable billing in that project.
      Go to App Engine

      When prompted, select the region where you want your App Engine app located, and then enable billing. After your GCP project is created, the Dashboard opens.

    2. Enable the Cloud Datastore API, Cloud Pub/Sub API, Cloud Storage API JSON, Stackdriver Logging API, and Cloud SQL APIs.

      Enable the APIs

  2. Download, install, and initialize the Cloud SDK.
    Download the Cloud SDK
  3. Acquire local credentials for authenticating with GCP services.
    gcloud auth application-default login
  4. Verify that your default project is correct.
    gcloud config list
    If the project ID listed in the output isn't the project that you intended to use for this tutorial, set the project.
    gcloud config set project [YOUR_PROJECT_ID]
    where [YOUR_PROJECT_ID] is the ID of the project that you created or chose to use for this tutorial.
  5. Clone the sample repository.

    git clone https://github.com/GoogleCloudPlatform/getting-started-php.git

    Alternatively, you can download the sample as a zip file and extract it.

This tutorial assumes that you are familiar with PHP and that you have PHP 5.6, 7.0, or 7.1 installed. You also need to download Composer. This tutorial assumes the Composer executable is installed globally.

Tutorial structure

The Bookshelf tutorial has several parts that demonstrate how the sample app uses various GCP services.

The structured data part of the tutorial demonstrates how the sample app stores book information in a SQL or NoSQL database.

The sample app's web page displays a form where the user enters the title, author, description, and publication date of a book. The app stores this information in a database so it can be retrieved later for viewing or editing. For this step of the tutorial, you have your choice of three databases: Cloud SQL, Cloud Datastore, or MongoDB. After you complete this step with one of the databases, you can move on to the next step.

The Cloud Storage part of this tutorial demonstrates how the sample app stores binary data in Cloud Storage. On the app's web page, the user can specify a cover image for each book. The app stores the cover images in a Cloud Storage bucket.

The authorization part of this tutorial demonstrates how the sample app provides a sign-in flow for the user. When a user is signed in, any books that the user enters are associated with the user. Signed-in users see their own books and books that are created by anonymous users. Other users can't see books that are created by a signed-in user.

The logging part of this tutorial demonstrates how the sample app writes logs that are visible in the Google Cloud Platform Console. Logs of this type can provide diagnostic information during app development.

Was this page helpful? Let us know how we did:

Send feedback about...