Блог о Joomla 3. Joomla 3 от "А" до "Я"

Файл configuration.php

В статье «Joomla 3 Структура каталогов» упоминался файл configuration.php. Это очень важный файл - без него сайт на Joomla работать не будет. Этот файл в основном содержит параметры общих настроек сайта и не только. Некоторые настройки можно изменить только в файле configuration.php. В некоторых случаях вообще невозможно попасть в админку и исправлять ситуацию приходится, редактируя этот файл. Поэтому написана отдельная статья. Она может использоваться в качестве шпаргалки или памятки по configuration.php.

Файл configuration.php расположен в корневой директории сайта. Предполагается, что читатель блога уже имеет понятия о том, что такое корневая директория сайта и что такое корневая директория сервера. Файл configuration.php представляет собой объявление глобальных переменных на языке PHP. В нём содержится 89 переменных, соответствующих такому же количеству настроек. Кодировка файла UTF-8. Большая часть из общего количества настроек соответствуют общим настройкам сайта. В этой статье намеренно изменен порядок строк файла. Это сделано для того, чтобы читателю было легче ориентироваться в таком количестве настроек, легче их сопоставлять по группам. В качестве примера используется файл configuration.php сайта, который получился у меня в результате чтения предыдущих статей. Ниже строки с параметром даётся некоторое описание. На общих настройках сайта не будем особо останавливаться, т. к. о них можно прочитать в предыдущих статьях.

Настройки сайта

public $sitename = 'Путешествие по Хорватии и Черногории';

Название сайта. Оно изначально задается на этапе установки Joomla.

public $offline = '0';

Сайт выключен (offline). Если установлено '0', то сайт включен. Если установлено '1', то сайт выключен. По умолчанию '0'.

public $display_offline_message = '1';

Показывать offline-сообщение. '0' – выключено. '1' – включено, показывается пользовательское сообщение. '2' - показывается сообщение из языкового файла. По умолчанию - '1'.

public $offline_message = 'В настоящее время сайт закрыт на техническое обслуживание.
Приносим свои извинения за доставленные неудобства.
Пожалуйста, зайдите позже.

Сообщение при выключенном сайте.

public $offline_image = 'images/offline-pic.png';

Изображение при выключенном сайте. Если установлен этот параметр, то здесь, как в примере, будет указан относительный путь к файлу изображения.

public $frontediting = '2';

Иконки быстрого редактирования. '0' – нет, '1' – модули, '2' – модули и меню. По умолчанию '1'.

public $editor = 'tinymce';

Редактор по умолчанию. Значение по умолчанию 'tinymce'.

public $captcha = 'recaptcha';

CAPTCHA (по умолчанию). Если настроен этот параметр, то здесь указывается тип captcha. Если не выбран тип, то значение '0'. По умолчанию '0'.

public $access = '1';

Уровень доступа по умолчанию. '1' – публичный доступ, '2' – для зарегистрированных, '3' – специальный, '5' – гостевой, '6' – только суперпользователи. По умолчанию - '1'.

public $list_limit = '20';

Длина списка по умолчанию. По умолчанию '20'.

public $feed_limit = '10';

Ограничение ленты новостей. По умолчанию '10'.

public $feed_email = 'author';

E-mail ленты новостей. 'none' – e-mail не используется, 'site' – используется e-mail сайта, 'author' –используется e-mail автора материала. По умолчанию 'author'.

Настройки метаданных

public $MetaDesc = '';

Мета-тег Description для сайта.

public $MetaKeys = '';

Мета-тег Keywords.

public $robots = '';

Мета-тег Robots. '' – соответствует index, follow – индексировать и переходить по ссылкам. 'noindex, follow' – не индексировать, но переходить по ссылкам. 'index, nofollow' – индексировать, но не переходить по ссылкам. 'noindex, nofollow' – не индексировать и не переходить по ссылкам. По умолчанию ''.

public $MetaRights = '';

Авторские права

public $MetaAuthor = '1';

Показывать мета-тег Author. '0' - выключено; '1' – включено. По умолчанию '1'.

public $MetaVersion = '0';

Показывать версию Joomla! '0' - выключено; '1' – включено. По умолчанию '0'.

public $MetaTitle = '1';

Использовать заголовок материала в тэге. Под таким названием эта настройка существовала в админке Joomla 1.5. Её задача была отображать или нет мета-тег title. '0' - выключено; '1' – включено. На данный момент используется только в компоненте Weblinks. По умолчанию '1'. В современной админке такого переключателя нет.

Настройки SEO

public $sef = '0';

Включить SEF (ЧПУ). '0' – выключено, '1' – включено. По умолчанию '1'.

public $sef_rewrite = '0';

Перенаправление URL. '0' – выключено, '1' – включено. По умолчанию '0'.

public $sef_suffix = '0';

Добавлять суффикс к URL. '0' – выключено, '1' – включено. По умолчанию '0' - выключено.

public $unicodeslugs = '0';

Алиасы в Unicode. '0' – выключено, '1' – включено. По умолчанию '0'.

public $sitename_pagetitles = '0';

Включать название сайта в заголовок страницы. '0' – нет, '1' – включать до заголовка, '2' – включать после заголовка. По умолчанию - '0'.

Настройки cookie

public $cookie_domain = '';

Cookie домена.

public $cookie_path = '';

Путь для Cookie.

Настройки системы

public $log_path = 'C:\\xampp\\htdocs\\travel/logs';

Путь к каталогу логов. Обратите внимание на разделители. Последний разделитель даже на локальном хостинге – слэш.

public $helpurl = 'https://help.joomla.org/proxy/index.php?option=com_help&keyref=Help{major}{minor}:{keyref}';

Сервер справки.

Параметры отладки

public $debug = '0';

Отладка системы. '0' – отладка выключена, '1' – отладка включена. По умолчанию '0'.

public $debug_lang = '0';

Отладка языка. '0' – отладка выключена, '1' – отладка включена. По умолчанию '0'.

Настройки кэша

public $caching = '0';

Кэш. '0' – кэш выключен, '1' – включено стандартное кэширование, '2' – включено прогрессивное кэширование. По умолчанию '0'.

public $cache_handler = 'file';

Обработчик кэширования. 'file' – обработчик на основе файла, 'cachelite' – используется Cache_Lite. Вообще здесь могут находиться и другие значения, например 'memcached'. Об этом читайте ниже.

public $cachetime = '15';

Время кэширования в минутах.

Следующие двенадцать настроек сразу не видны в общих настройках сервера. Это настройки для работы Joomla с системой memcached. Memcached – это сервис кэширования данных в оперативной памяти. Для работы с этим сервисом используются две библиотеки: memcache и memcached. Соответственно, одна половина настроек задействована, если используется библиотека memcache, а другая, если memcached. Узнать подробнее о сервисе memcached, о том как его установить, можно в следующей статье.

Настройки для memcached, когда используется библиотека memcache

public $memcache_persist = '1';

Включить защиту Memcached. '1' – да, '0' – нет. По умолчанию '1'.

public $memcache_compress = '0';

Включить сжатие Memcached. '1' – да, '0' – нет. По умолчанию '0'.

public $memcache_server_host = 'localhost';

Имя memcached сервера.

public $memcache_server_port = '11211';

Порт memcached сервера. По умолчанию '11211'.

Настройки для memcached, когда используется библиотека memcached

public $memcached_persist = '1';

Включить защиту Memcached. '1' – да, '0' – нет. По умолчанию '1' – да.

public $memcached_compress = '0';

Включить сжатие Memcached. '1' – да, '0' – нет. По умолчанию '0' – да.

public $memcached_server_host = 'localhost';

Имя memcached сервера.

public $memcached_server_port = '11211';

Порт memcached сервера. По умолчанию '11211'.

Интеграция с Redis

Поддержка Redis – это новшество в Joomla. Пока информации об интеграции Redis и Joomla очень мало. Временно оставляю без комментариев.

public $redis_persist = '1';
public $redis_server_host = 'localhost';
public $redis_server_port = '6379';
public $redis_server_auth = '';
public $redis_server_db = '0';

Настройки сессии

public $lifetime = '120';

Время жизни сессии в минутах.

public $session_handler = 'database';

Обработчик сессий. 'database' – обработчиком выступает база данных, 'none' – обработчика нет. По умолчанию 'database'.

Настройки сервера

public $tmp_path = 'C:\\xampp\\htdocs\\travel/tmp';

Путь к каталогу временных файлов.

public $gzip = '0';

Gzip-сжатие страниц. '0' – выключено, '1' - включено. По умолчанию '0'.

public $error_reporting = 'default';

Сообщения об ошибках. 'default' - по умолчанию для системы, 'none' - нет, 'simple' - простой, 'maximum' - максимум, 'development' - для разработчиков (все ошибки PHP).

public $force_ssl = '0';

Включить SSL. '0' – нет, '1' – только для панели управления, '2' – для всего сайта.

Настройка расположения

public $offset = 'UTC';

Часовой пояс сервера. Очень много значений для всех часовых поясов и континентов. Например, для Москвы значение будет 'Europe/Moscow'.

Настройка FTP

public $ftp_enable = '0';

Включить FTP. '0' - выключено; '1' – включено. По умолчанию '0'.

public $ftp_host = '';

FTP-хост. На локальном хостинге, например, 'localhost'

public $ftp_port = '';

FTP-порт. Обычно - '21'.

public $ftp_user = '';

Имя пользователя FTP.

public $ftp_pass = '';

Пароль для FTP.

public $ftp_root = '';

Корень FTP.

Настройка прокси-сервера

public $proxy_enable = '0';

Включить прокси-сервер. '0' - выключено; '1' – включено. По умолчанию '0'.

public $proxy_host = '';

Прокси-сервер. Имя прокси-сервера.

public $proxy_port = '';

Порт прокси-сервера.

public $proxy_user = '';

Логин прокси-сервера. Имя пользователя прокси-сервера.

public $proxy_pass = '';

Пароль прокси-сервера

Настройки базы данных

public $dbtype = 'mysqli';

Тип (или тип используемого драйвера) базы данных - 'mysqli' или 'mysql'. По умолчанию 'mysqli'. Но при определённых настройках веб-сервера, здесь могут появиться значения для MSSQL и/или Postgre SQL. Читайте этот блог, статьи об этом могут появиться в ближайшее время!

public $host = 'localhost';

Имя хоста. 'localhost' на многих серверах, но далеко не на всех.

public $user = 'root';

Имя пользователя базы данных.

public $password = 'DvniJ34nsQq';

Пароль, пользователя базы данных. Заметьте, этой настройки нет в административной части Joomla! Этот пароль указывается при установке CMS. А устанавливается он, в данном случае, в СУБД MySQL. Бывает, что нужно изменить пароль к базе данных. Вот как только изменили пароль в СУБД, так сразу же надо изменить пароль в файле configuration.php. В противном случае получите ошибку «Error displaying the error page: Application Instantiation Error: Could not connect to MySQL».

public $db = 'cromont';

Имя базы данных.

public $dbprefix = 'rk32y_';

Префикс таблиц базы данных.

Настройка почты

Ниже представлены настройки электронной почты сайта при использовании способа отправки «SMTP».

public $mailonline = '1';

Отправка почты. '0' – выключена, '1' – включена. По умолчанию '1'.

public $mailer = 'smtp';

Способ отправки. 'mail' - использует способ PHP mail, 'sendmail' использует способ отправки программой Sendmail, 'smtp' – использует способ отправки SMTP.

public $mailfrom = 'my_box@list.ru';

E-mail сайта.

public $fromname = 'Путешествие по Хорватии и Черногории';

Отправитель письма

public $massmailoff = '0';

Disable Mass Mail (Отключить массовую рассылку). '0' – нет, '1' – да. По умолчанию '0'.

public $smtpauth = '1';

Авторизация на SMTP-сервере. '0' – выключена, '1' – включена. По умолчанию '1'.

public $smtpsecure = 'tls';

Защита SMTP. 'none' – нет, 'tls' – уровень TLS, 'ssl' – уровень SSL. По умолчанию 'none'.

public $smtpport = '25';

Порт SMTP-сервера. Обычно smtp-серверы используют порт 25, более защищенные используют порт 465, т. н. smtps. По умолчанию '25'.

public $smtpuser = 'my_box@list.ru';

Имя пользователя SMTP.

public $smtppass = 'JiqCmh2laWB5';

Пароль для SMTP.

public $smtphost = 'smtp.mail.ru';

SMTP-сервер. Пример для ящика на mail.ru.

public $sendmail = 'C:\\usr\\sbin\\sendmail';

Путь к Sendmail. Используется, если $mailer = 'sendmail'.

Дополнительные настройки

public $live_site = '';

Фактический URL сайта. Сейчас эта настройка мало актуальна. Наверное, могут быть случаи, при которых необходимо заполнить это значение, но мне такие ситуации давно не встречались.

public $secret = 'jDuHKwT3bLDCnX6z';

Это значение генерируется в процессе установке Joomla. Оно используется CMS для безопасности. В предыдущих версиях Joomla эта настройка присутствовала в админке, но теперь её решили убрать из админки от греха подальше. Ни в коем случае не изменяйте эту настройку!

Пока всё. Когда появится больше информации о работе с Redis – обновлю статью.

Помните, что у нас вы можете не только купить готовый сайт или заказать его разработку, но и подобрать подходящий тариф поддержки сайта, заказать продвижение сайта в поисковых системах, а так же зарегистрировать домен в одной из двухсот доменных зон и выбрать недорогой тариф хостинга! Айтишник РУ

Задать вопрос

Об авторе:

Меня зовут Андрей Золкин. Из более, чем пятнадцати лет работы в сфере информационных технологий, десять лет работаю с системами, базирующимися на открытом исходном коде. На страницах сайта Aitishnik.Ru веду блоги по CMC Joomla и Debian GNU/Linux.

Ещё статьи о Joomla 3

- Joomla 3. Настройка электронной почты сайта...
  
  Предыдущая статья закончилась тем, что о настройках почты сайта будет рассказано отдельно. В этой статье и поговорим о том, как настроить электронную почту сайта. Электронная почта сайта, в первую очередь нужна для автоматической...
- Локальный хостинг на XAMPP
  
  В предыдущих статьях мы разобрались с тем, что такое CMS Joomla, какие возможности она имеет, где её скачать и каковы системные требования Joomla. Теперь для установки и изучения этой системы управления содержимым мы организуем локальный хостинг. Конечно, можно установить Joomla сразу на...
- Установка memcached на XAMPP в Windows 7
  
  Из статьи «Joomla 3. (часть 2)» вы узнали, что в новой версии Joomla появилась поддержка memcached, а в процессе рассмотрения статьи «Файл configuration.php» вкратце познакомились с настройками этого сервиса. В этой статье описывается установка и настройка memcached на локальном...
- Персональные данные в Joomla! ч.1
  
  Начиная с версии 3.9, в Joomla появился набор расширений для обеспечения конфиденциальности и соответствия таким законам, как GDPR (для Европейского Союза) и ФЗ-152 (для России). Суть этих законов в том, чтобы усилить и стандартизировать...
- Joomla 3. Общие настройки. Система и сервер...
  
  В одной из предыдущих статей мы рассмотрели часть общих настроек сайта на Joomla 3, объединенных в группу «Сайт». В этой статье рассказывается о следующих двух группах настроек, размещённых на вкладках «Система» и «Сервер». Это очень важные настройки. Их изменение критично для сайта.
- Joomla 3. (часть 2)
  
  В первой части мы говорили о том, что такое Joomla и как работает эта CMS. Во второй части поговорим о том, какие сайты можно сделать на Joomla, каковы её возможности, чем отличается Joomla 3 от предыдущих версий и как в этих версиях не запутаться.Если говорить о возможностях, то на Joomla можно сделать...