mhariri/docker-google-appengine-php repository overview

⁠Docker: Google App Engine for PHP

Google App Engine⁠ Docker⁠ container http://github.com/mhariri/docker-google-appengine-php⁠

Available through docker hub: https://hub.docker.com/r/mhariri/docker-google-appengine-php/⁠

⁠The Idea

Easily set up and run Google App Engine PHP web applications through Docker, without needing to install the Google App Engine SDK, or set up the development environment locally. The project was originally taken from: https://github.com/RobLoach/docker-google-appengine⁠

⁠Usage

⁠Install

Pull mhariri/docker-google-appengine-php from the Docker repository:

docker pull mhariri/docker-google-appengine-php

Or build from source:

git clone https://github.com/mhariri/docker-google-appengine-php.git
docker build -t mhariri/docker-google-appengine-php docker-google-appengine-php

⁠Run

Run the image, binding associated ports, and mounting the application directory:

docker run -v $(pwd):/app -p 8080:8080 -p 8000:8000 mhariri/docker-google-appengine-php

If you need access to Google API authentication, you should also map the well known application_default_credentials.json. Don't forget to run gcloud auth login first.

docker run -v $HOME/.config/gcloud:/root/.config/gcloud \
           -v $(pwd):/app -p 8080:8080 -p 8000:8000 mhariri/docker-google-appengine-php

⁠Services

⁠Volumes

⁠Extra Extensions

To be able to use other extensions, you should create a php.ini file in your project and load those extensions. For example for sending email:

extension=mailparse.so

The list of supported PHP extensions on app engine is here: https://cloud.google.com/appengine/docs/standard/php/runtime⁠

⁠Debugging

You can debug your app locally by following these steps:

• adding a php.ini into your project with following contents:

zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20121212/xdebug.so

xdebug.idekey=x

• On IntelliJ (or any IDE you are using for debugging), set up a PHP debugging session with the address of the docker host, and set idekey to x.

• Forward port 9000 of the host machine to the docker instance by running the following commands (assuming you have open ssh server on the host):

  docker exec -it <DOCKER INSTANCE> /bin/bash
  apt update
  apt install -y ssh
  # get the address of the docker host
  HOST=$(/sbin/ip route|awk '/default/ { print $3 }')
  ssh $HOST -L9000:localhost:9000
  

  Copy

• (Optional) Install google cloud sdk with PHP additions on the host, and for path mappings to work, make /opt/google-cloud-sdk link to where you installed google-cloud-sdk

  gcloud components install app-engine-php
  cd /opt
  sudo ln -s ~/google-cloud-sdk/
  

  Copy