How to setup Concrete CMS behind CDN (Amazon CloudFront)

Jul 16, 2016
By hissy for Developers

Issues

The main issue of using Concrete CMS behind CDN is host names.

  • www.example.com
    • CDN (Amazon CloudFront)
    • When guest users access to your site, visit to this host.
  • origin.example.com
    • Origin Web server (concrete5)
    • When you login to concrete5, access to this host. |

When this case, concrete5's canonical URL is origin.example.com, but actual host name for gust users is www.example.com .

The sub issue is cache life time.

CDN stores cache only when the full page cache is enabled, because of Cache-Control header. However, full page cache should be disabled when editing content with concrete because of host name.

How can we solve the issues?

  1. When editing content on origin.example.com, turn off caching.
  2. When viewing content on www.example.com, turn on caching and set www.example.com to canonical URL.

Code

1. Change environment to cdn when HTTP User Agent is 'Amazon CloudFront'.

application/bootstrap/start.php

<?php
use Concrete\Core\Application\Application;

/**
 * -----------------------------------------------------------------
 * Instantiate concrete5
 * -----------------------------------------------------------------
 */
$app = new Application();

/**
 * -----------------------------------------------------------------
 * Detect the environment based on the use agent
 * -----------------------------------------------------------------
 */
$app->detectEnvironment(function(){
    $request = \Concrete\Core\Http\Request::getInstance();
    if ($request->server->get('HTTP_USER_AGENT') == 'Amazon CloudFront') {
        return 'cdn';
    }
});

return $app;

2. Turn off caching on default environment

application/config/concrete.php

<?php

return array(
    'cache' => array(
        'blocks' => false, // turn off block cache
        'pages' => 0, // turn off page cache
    ),
);

3. Turn on caching on cdn environment, and set canonical URLs

application/config/cdn.concrete.php

<?php

return array(
    'cache' => array(
        'blocks' => true, // turn on block cache
        'pages' => 'blocks', // cache page if all blocks support it.
    ),
    'seo' => array(
        'canonical_url' => 'http://www.example.com/',
        'canonical_ssl_url' => 'https://www.example.com/',
    ),
);
Recent Tutorials
How to update Add-Ons if not on the Update Add-Ons Menu item
Jul 4, 2022

How to manually download an add-on and update it when your site's core versions isn't considered compatible with the add-on version.

Generate a report with author information and form summaries in Concrete CMS.
May 9, 2022

In Concrete CMS, you can use a form to initiate contact between logged-in users and then create helpful reports. After form submissions are collected, they can be searched, sorted, and exported as a spreadsheet. This tutorial will detail how to add author information to a report using the advanced search.

How to clone and customize Atomik theme
Feb 14, 2022
By linuxoid.

How to clone and customize Atomik theme

Update jQuery to 3.5 on Concrete CMS version 8.5.x
Dec 1, 2021
By hissy.

If you have to take some time to fix your site to work with version 9 and want to update jQuery immediately, you can override it.

Add-On Developers: Get Your Add-Ons Ready for Concrete CMS 9.0
Aug 6, 2021
By andrew.

Concrete CMS 9.0 is coming! But there are some changes in version 9 that might affected your add-ons and themes. This document aims to answer questions about the most common ways that your add-ons might need to be changed, and common problems you'll run into.

Permissions for editors in a multilingual site
Jun 2, 2021
By myq.

How to set up a multilingual Concrete CMS site for groups of language-specific editors

Was this information useful?
Thank you for your feedback.