Google App Engine PHP Runtime Extension

This repository contains the GAE PHP runtime extension, which enables emulation of the App Engine environment for local development.

Building

1. Install Protocol Buffer complier on your platform, following the C++ Installation Instructions.

2. Generate C++ source and header files for remote_api.proto and urlfetch_service.proto.

   protoc --cpp_out=. remote_api.proto
   protoc --cpp_out=. urlfetch_service.proto

3. Familiarize yourself with the PHP extension building process, and run the following commands. Set <include_path> and <lib_path> to the absolute path to the protobuf headers and libraries installed in the previous step, usually /usr/local/include and /usr/local/lib.

   phpize
   ./configure --enable-gae --with-protobuf_inc=<include_path> --with-protobuf_lib=<lib_path>
   make

4. The compiled extension can be found in modules/gae_runtime_module.so. Use the --php_gae_extension_path flag to load the extension when running the development server.

Contributing

Have a patch that will benefit this project? Awesome! Follow these steps to have it accepted.

1. Please sign our Contributor License Agreement.
2. Fork this Git repository and make your changes.
3. Create a Pull Request
4. Incorporate review feedback to your changes.
5. Accepted!

License

All files in this repository are under the Apache v2 unless noted otherwise.