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