В этой статье я расскажу о самом главном файле OpenCart, файле с которого начинается загрузка всего OpenCart, файле в котором подключаются все основные классы и настройки системы. Если вы хотите понять как работает OpenCart то вам обязательно нужно знать что происходит в этом файле. Встречайте, index.php.
 
Далее я приведу все строки index.php с комментариями 
 
С самого начала определяется версия системы, это нужно для некоторых модулей - знать, на какой версии их запустили
define('VERSION', '2.0.0.0');
 
Загружается конфигурационный файл, в котором определятся все рабочие папки OpenCart и настройки базы данных 
 
if (is_file('config.php')) {
  require_once('config.php');
}

Если папка приложения не определена, значит система еще не установлена - запускаем установку, выходим с этого файла

if (!defined('DIR_APPLICATION')) {
  header('Location: install/index.php');
  exit;
}
 
Загружаются основные классы, библиотеки, хелперы и проверяется версия PHP, для OpenCart 2.0 нужна версия PHP не ниже 5.3, устанавливается временная зона, глобальные переменные, если они не установлены: DOCUMENT_ROOT, REQUEST_URI, HTTP_HOST, HTTPS.
require_once(DIR_SYSTEM . 'startup.php');
 
Создается реестр - здесь будет храниться все: все основные классы и настройки (класс config). Этот класс есть в каждом контроллере, модели, представлении, поэтому благодаря этому классу мы получаем возможность обратиться к любому классу или настройке с любого места.
 
$registry = new Registry();
 
Создается загрузчик - с помощью него будут загружаться другие контроллеры, модели, библиотеки итд. После создания он стразу добавляется в реестр, как и все другие классы, чтобы быть доступным в любом месте из этого реестра.
$loader = new Loader($registry);
$registry->set('load', $loader);

 

Конфигурационный класс, с помощью него можно добавлять и получать конфигурационные настройки

 

$config = new Config();
$registry->set('config', $config);

 

Класс базы данных, с помощью него можно посылать запросы базе данных и получать ответы.

 

$db = new DB(DB_DRIVER, DB_HOSTNAME, DB_USERNAME, DB_PASSWORD, DB_DATABASE);
$registry->set('db', $db);

 

Определяем магазин, это нужно для мультимагазина, когда на 1 движке может работать несколько магазинов и у каждого свои настройки

 

if (isset($_SERVER['HTTPS']) && (($_SERVER['HTTPS'] == 'on') || ($_SERVER['HTTPS'] == '1'))) {
  $store_query = $db->query("SELECT * FROM " . DB_PREFIX . "store WHERE REPLACE(`ssl`, 'www.', '') = '" . 
			       $db->escape('https://' . str_replace('www.', '', $_SERVER['HTTP_HOST']) . 
				rtrim(dirname($_SERVER['PHP_SELF']), '/.\\') . '/') . "'");
} else {
  $store_query = $db->query("SELECT * FROM " . DB_PREFIX . 
				"store WHERE REPLACE(`url`, 'www.', '') = '" . 
				$db->escape('http://' . str_replace('www.', '', $_SERVER['HTTP_HOST']) . 
				rtrim(dirname($_SERVER['PHP_SELF']), '/.\\') . '/') . "'");
}
 
if ($store_query->num_rows) {
  $config->set('config_store_id', $store_query->row['store_id']);
} else {
  $config->set('config_store_id', 0);
}

Теперь зная магазин получаем настройки для него..

$query = $db->query(
		"SELECT * FROM `" . DB_PREFIX . "setting` WHERE store_id = '0' OR store_id = '" . 
		(int)$config->get('config_store_id') . "' ORDER BY store_id ASC");

.. и записываем в конфиг каждую настройку. OpenCart при старте получает ВСЕ настройки.

foreach ($query->rows as $result) {
  if (!$result['serialized']) {
    $config->set($result['key'], $result['value']);
  } else {
    $config->set($result['key'], unserialize($result['value']));
  }
}
 
if (!$store_query->num_rows) {
  $config->set('config_url', HTTP_SERVER);
  $config->set('config_ssl', HTTPS_SERVER);
}

 

Класс для URL адресов, отвечает за создание ссылок

$url = new Url($config->get('config_url'), 
			$config->get('config_secure') ? 
			$config->get('config_ssl') : 
			$config->get('config_url'));
$registry->set('url', $url);

 

Класс для записи ошибок и сообщений в лог журнал.

$log = new Log($config->get('config_error_filename'));
$registry->set('log', $log);

 

Определяется обработчик ошибок - что нужно делать если появилась ошибка? Выводить ее на екран или писать в лог?

function error_handler($errno, $errstr, $errfile, $errline) {
  global $log, $config;
 
  // error suppressed with @
  if (error_reporting() === 0) {
    return false;
  }
 
  switch ($errno) {
    case E_NOTICE:
    case E_USER_NOTICE:
      $error = 'Notice';
      break;
    case E_WARNING:
    case E_USER_WARNING:
      $error = 'Warning';
      break;
    case E_ERROR:
    case E_USER_ERROR:
      $error = 'Fatal Error';
      break;
    default:
      $error = 'Unknown';
      break;
  }
 
  if ($config->get('config_error_display')) {
    echo '<b>' . $error . '</b>: ' . $errstr . ' in <b>' . 
	$errfile . '</b> on line <b>' . $errline . '</b>';
  }
 
  if ($config->get('config_error_log')) {
    $log->write('PHP ' . $error . ':  ' . $errstr . ' in ' . 
	$errfile . ' on line ' . $errline);
  }
 
  return true;

 

Регистрируется обработчик ошибок

set_error_handler('error_handler');
 
Класс для получения данных из $_GET, $_POST, $_REQUEST, $_COOKIE, $_FILE, $_SERVER
 
$request = new Request();
$registry->set('request', $request);

 

Класс для отдачи данных пользователю

$response = new Response();
$response->addHeader('Content-Type: text/html; charset=utf-8');
$response->setCompression($config->get('config_compression'));
$registry->set('response', $response);
 
Класс кеширования. При создании сразу жестко прописан тип кеширования - с использованием файлов, но OpenCart из коробки также поддерживает кешированеи APC и memcache, но в настройках магазина их выбрать нельзя, нужно прописать в index.php, не очень удобно.
$cache = new Cache('file');
$registry->set('cache', $cache);

 

Класс для работы с сессиями

 

$session = new Session();
$registry->set('session', $session);

Определения языка пользователя через куки, сессии, язык браузера.

 

$languages = array();
 
$query = $db->query("SELECT * FROM `" . DB_PREFIX . "language` WHERE status = '1'");
 
foreach ($query->rows as $result) {
  $languages[$result['code']] = $result;
}
 
$detect = '';
 
if (isset($request->server['HTTP_ACCEPT_LANGUAGE']) && $request->server['HTTP_ACCEPT_LANGUAGE']) {
  $browser_languages = explode(',', $request->server['HTTP_ACCEPT_LANGUAGE']);
 
  foreach ($browser_languages as $browser_language) {
    foreach ($languages as $key => $value) {
      if ($value['status']) {
        $locale = explode(',', $value['locale']);
 
        if (in_array($browser_language, $locale)) {
          $detect = $key;
          break 2;
        }
      }
    }
  }
}
 
if (
		isset($session->data['language']) && 
		array_key_exists($session->data['language'], $languages) && 
		$languages[$session->data['language']]['status']
	) 
{
  $code = $session->data['language'];
} 
elseif (
			isset($request->cookie['language']) && 
			array_key_exists($request->cookie['language'], $languages) && 
			$languages[$request->cookie['language']]['status']
		) 
{
  $code = $request->cookie['language'];
} 
elseif ($detect) 
{
  $code = $detect;
} 
else 
{
  $code = $config->get('config_language');
}
 
if (!isset($session->data['language']) || $session->data['language'] != $code) {
  $session->data['language'] = $code;
}

 

Класс для языков, с его помощью можно загружать языковые файлы. Сразу загружается главный языковый файл.

 

$language = new Language($languages[$code]['directory']);
$language->load($languages[$code]['filename']);
$registry->set('language', $language);

 

Класс для документа, он может устанавливать заголовок, описание, ключевые слова для страницы, а также добавлять javascript и css файлы на страницу.

 

$registry->set('document', new Document());

 

Класс пользователя

 

$customer = new Customer($registry);
$registry->set('customer', $customer);

 

Определяется група пользователя, это важно так как для разных групп пользователей могут быть разные цены для товаров, скидки итд. это также нужно для OpenCart API системы

 

if ($customer->isLogged()) {
  $config->set('config_customer_group_id', $customer->getGroupId());
} elseif (isset($session->data['customer'])) {
  // For API calls
  $config->set('config_customer_group_id', $session->data['customer']['customer_group_id']);
} elseif (isset($session->data['guest'])) {
  $config->set('config_customer_group_id', $session->data['guest']['customer_group_id']);
}

 

Трекинг код, новшество OpenCart 2.0, можно присваивать трекинг коды и вести статистику сколько раз открыли страницу с этим кодом

 

if (isset($request->get['tracking'])) {
  setcookie('tracking', $request->get['tracking'], time() + 3600 * 24 * 1000, '/');
  $db->query("UPDATE `" . DB_PREFIX . 
  "marketing` SET clicks = (clicks + 1) WHERE code = '" . 
  $db->escape($request->get['tracking']) . "'");
}
 
if (!isset($request->cookie['language']) || $request->cookie['language'] != $code) {
  setcookie('language', $code, time() + 60 * 60 * 24 * 30, '/', $request->server['HTTP_HOST']);
}
 
$config->set('config_language_id', $languages[$code]['language_id']);
$config->set('config_language', $languages[$code]['code']);

 

Партнерская программа

 

$registry->set('affiliate', new Affiliate($registry));

 

Валюта

 

$registry->set('currency', new Currency($registry));

 

Налоги

 

$registry->set('tax', new Tax($registry));

 

Класс веса

 

$registry->set('weight', new Weight($registry));

 

Класс длины

$registry->set('length', new Length($registry));

 

Класс корзины

$registry->set('cart', new Cart($registry));

 

Класс кодировщика

$registry->set('encryption', new Encryption($config->get('config_encryption')));

 

OpenBay Pro

$registry->set('openbay', new Openbay($registry));

 

Система событий, писал уже о ней
 

$event = new Event($registry);
$registry->set('event', $event);
 
$query = $db->query("SELECT * FROM " . DB_PREFIX . "event");
 
foreach ($query->rows as $result) {
  $event->register($result['trigger'], $result['action']);

 

Фронт контроллер

$controller = new Front($registry);

 

Режим разработки, добавляется через предварительное действие, то есть выполняется раньше любых действий

$controller->addPreAction(new Action('common/maintenance'));

 

СЕО ссылки или ЧПУ так же добавляются через предварительное действие

$controller->addPreAction(new Action('common/seo_url'));

 

Определяется главный путь, если он есть то создается действие для этого пути, если его нет, то действие создается для домашней страницы

if (isset($request->get['route'])) {
  $action = new Action($request->get['route']);
} else {
  $action = new Action('common/home');
}

 

Действие, созданное перед этим, запускается на выполнение, если контроллер для него не будет найден то запуститься действие "страница не найдена"

 

$controller->dispatch($action, new Action('error/not_found'));

 

Результат выполнения отдается пользователю, обычно выводится на экран

$response->output();