The Laravel Framework, lightly optimized for use with Google App Engine
composer create-project ajessup/laravel your-project-name -s dev
This will create a default project shell including the necessary configuration files. You can start the project the App Engine launcher or via the
dev_appserver.py command included in the App Engine SDK:
This will run your project on your local machine within the App Engine development server, with all necessary production services such as memcache emulated.
Now you just need to build your application! If you're looking for inspiration, try the official Laravel Quickstart.
To deploy to Google App Engine, you must first:
- Have created a project in the Google Cloud Console, and have enabled billing.
- Within the project, have created a Google Cloud Storage bucket, and made the app engine service account an owner. This bucket will be used to store files useful to Laravel such as compiled blade templates.
Before deploying the first time:
- Open up
app.yamlin your project, and change the
application:attribute to match the name of your project (which is also the ID of your App Engine application)
- Open up
php.iniin your project, and change the value for the ini setting
google_app_engine.allow_include_gs_bucketsto the name of the bucket you created above. When running on App Engine, Laravel will use this bucket by default to write to storage
To deploy your application, you can either use the App Engine launcher or via the
appcfg.py command included in the App Engine SDK:
This fork of the Laravel framework has been lightly customized to work well with Google App Engine out of the box. This includes the following changes from the default Laravel configuration:
- Session and cache storage defaults to memcached. App Engine provides free shared memcache to all applications, which can be upgraded to dedicated memcache if necessary.
- Monolog is configured to log everything to syslog() by default. PHP calls logged to syslog() are then consolidated and available on App Engine's log viewer
- Two environments are explicitly defined -
local(when running on the Development Server) and
appengine(when running on App Engine itself)
- When running in the
localenvironment, Laravel uses it's normal storage directory. When running in the
appengineenvironment, Laravel will use a Cloud Storage bucket.
php.iniconfiguration files for App Engine are included
Documentation for the entire framework can be found on the Laravel website.
Unless you are reporting/fixing an issue that relates to Laravel on App Engine specifically, issues and pull requests should be filed on the laravel/framework repository.
This derivative of the Laravel framework is open-sourced software licensed under the MIT license