Laravel is a free, open source PHP web application framework, designed for the development of model–view–controller (MVC) web applications.
This QuickStart was created to make it easy to get started with Laravel 5.0 on OpenShift.
The simplest way to install this application is to use the OpenShift QuickStart. If you'd like to install it manually, follow these directions.
These are some special considerations you may need to keep in mind when running your application on OpenShift.
This Laravel QuickStart provides separate .env
configuration files for both local and
remote development, found at .env
and .openshift/.env
respectively. When the local
repo is pushed to OpenShift .env
is overwritten with the .openshift/.env
file.
Your application is configured to automatically use your OpenShift MySQL or PostgreSQL database in when deployed on OpenShift using OpenShift Environment Variables.
Additionally, your APP_ENV
, APP_URL
, and APP_KEY
will be set automatically in
production on OpenShift.
The Laravel CACHE_DRIVER
is set to use APC opcode caching
and the SESSION_DRIVER
is set to use the local file system for storage. Feel
free to update these settings in .openshift/.env
.
When the application is pushed to OpenShift, php artisan migrate --force
is automatically executed.
When the application is pushed, composer install
is automatically executed over the root directory. See PHP Markers for more details on the 'use_composer' marker.
When you develop your Laravel application in OpenShift, you can also enable the
'development' environment by setting the APPLICATION_ENV
environment variable,
using the rhc
client, like:
$ rhc env set APPLICATION_ENV=development -a <app-name>
Then, restart your application:
$ rhc app restart -a <app-name>
If you do so, OpenShift will run your application under 'development' mode. In development mode, your application will:
- Set Laravel's
APP_ENV
to 'development' andAPP_DEBUG
to 'true' - Ignore your composer.lock file
- Show more detailed errors in browser
- Display startup errors
- Enable the Xdebug PECL extension
- Enable APC stat check
Set the variable to 'production' and restart your app to deactivate error reporting and resume production PHP settings.
Using the development environment can help you debug problems in your application in the same way as you do when developing on your local machine. However, we strongly advise you not to run your application in this mode in production.
Your application is configured to use the OpenShift log directory. You can use the
rhc tail
command to stream the latest log file entries:
rhc tail -a <APP_NAME>
To stop tailing the logs, press Ctrl + c.
-
Create an account at https://www.openshift.com/
-
Create a Laravel application:
rhc app create laravelapp php-5.4 mysql-5.5 --from-code=https://github.com/luciddreamz/laravel
or
rhc app create laravelapp php-5.4 postgresql-9.2 --from-code=https://github.com/luciddreamz/laravel
Documentation for the Laravel framework can be found on the Laravel website. Also check out OpenShift's Developer Portal for help running PHP on OpenShift.