OPENSHIFT Nginx PHP 7 Cartridge

Welcome to the world of PHP-FPM within OPENSHIFT by REDHAT.

What's inside

• Nginx: 1.11.9
• PHP: 7.1.1
• Latest Composer

Installation

Web Console

Click here for installation via web console.
Alternatively, you can use this cartridge definition on application creation page.

Command Line

rhc app create appname http://cartreflect-claytondev.rhcloud.com/github/budisteikul/openshift-cartridge-nginx-php7

Updates

You can update the binaries from the cartridge without reinstalling. To check for updates, SSH to your app and run this command:

update

Make sure to have your backup just in case some things went wrong.

Configuration

Nginx

Nginx will automatically include .openshift/nginx.conf.erb file.

Best nginx configuration for Laravel users

Edit file .openshift/nginx.conf.erb to looks like this

# Enable Gzip
gzip  on;
gzip_http_version 1.0;
gzip_comp_level 2;
gzip_min_length 1100;
gzip_buffers     4 8k;
gzip_proxied any;
gzip_types
# text/html is always compressed by HttpGzipModule
text/css
text/javascript
text/xml
text/plain
text/x-component
application/javascript
application/json
application/xml
application/rss+xml
font/truetype
font/opentype
application/vnd.ms-fontobject
image/svg+xml;
gzip_static on;
gzip_proxied        expired no-cache no-store private auth;
gzip_disable        "MSIE [1-6]\.";
gzip_vary           on;

client_max_body_size 8M;

server {

    	listen  <%= ENV['OPENSHIFT_PHP_IP'] %>:<%= ENV['OPENSHIFT_PHP_PORT'] %>;
    	root    <%= ENV['OPENSHIFT_REPO_DIR'] %>/public;
	
	location ~* ^.+\.(css|js|jpg|jpeg|gif|png|ico|gz|svg|svgz|ttf|otf|woff|eot|mp4|ogg|ogv|webm)$ {
		access_log off;
		log_not_found off;

		# Some basic cache-control for static files to be sent to the browser
		expires max;
		add_header Pragma public;
		add_header Cache-Control "public, must-revalidate, proxy-revalidate";
	}
	
	location @rewrites {
    	rewrite ^(.*)$ /index.php/$1 last;
    }
	
    location / {
    	index index.php  index.html index.htm;
		try_files $uri $uri/ @rewrites;
    }
	
	# pass the PHP scripts to PHP-FPM
	location ~ ^/index\.php(/|$) {
    	fastcgi_pass unix:<%= ENV['OPENSHIFT_PHP_SOCKET'] %>;
    	fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    	fastcgi_param PATH_INFO $fastcgi_script_name;
    	include <%= ENV['OPENSHIFT_PHP_DIR'] %>/usr/conf/fastcgi_params;
	}
}

PHP-FPM

PHP-FPM will automatically load .openshift/php-fpm.ini.erb, .openshift/php-fpm.conf.erb, and .openshift/extension.ini.erb files.

Website

The web root directory is public/. Make changes to your website there, then commit and push.

PECL

To install/uninstall pecl extension just run ssh to your application and run php-pecl install <name> <ver>
Example :

php-pecl install apcu 5.1.5
php-pecl install mongodb 1.1.7
php-pecl uninstall apcu
php-pecl uninstall mongodb

Scripts

This cartridge comes with different scripts for easy management of your app inside SSH.

• version - Get the version of the cartridge binaries.
• service - A psuedo /usr/bin/service to start and stop services. Example:
  • service php-fpm start
  • service php-fpm stop
  • service php-fpm restart
  • service nginx start
  • service nginx stop
  • service nginx restart
• update - Allows automatic update of the cartridge binaries.
  • update check - Check for updates
  • update install - Install updates
• php-pecl - To install/uninstall pecl extension.
  • php-pecl install <name> <ver> - Install pecl extension
  • php-pecl uninstall <name> - Uninstall pecl extension