Skip to content

Latest commit

 

History

History
109 lines (76 loc) · 3.08 KB

README.md

File metadata and controls

109 lines (76 loc) · 3.08 KB
Raw

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

Service Port Usage
Application 8080 Visit http://localhost:8080 in your browser
Admin server 8000 Visit http://localhost:8000 in your browser

Volumes

Volume Description
/app The location of your Google App Engine application

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

  • (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/