config inc php modx
Правильно редактируем config.inc.php MODx
Я использую для своего сайта cms MODx Evolution. При этом мой сайт уже размещен в интернете, а его копия хранится у меня на домашнем компьютере, на локальном сервере Denwer. Все настройки конфигурации этой cms хранятся в файле config.inc.php (путь manager\includes). И я решил написать небольшую статью про этот файл и заодно порекомендовать бесплатный редактор Notepad++.
С упоминанием файла config.inc.php сталкивается каждый, кто установил CMS MODx Evolution на Денвер. На вкладке конфигурация панели администратора сайта нас встречает запись:
Ошибка конфигурации: ‘Файл конфигурации все еще доступен для записи’. Что это значит? Злоумышленники потенциально могут нанести вред вашему сайту. Серьёзно. Пожалуйста, установите права доступа к файлу конфигурации (/manager/includes/config.inc.php) в режим ‘Только для чтения’.
После переноса MODx сайта на хостинг обратите на это внимание. Права доступа ко всем файлам должны быть – 0644. Это обязательно. Например, файл config.inc.php содержит жизненно важные настройки для вашей CMS MODx. Если посторонние получат право его изменять, то они смогут нанести вашему сайту вред и нарушить его работоспособность. Если права доступа не проставятся сами, проставьте их вручную.
В файле config.inc.php содержатся настройки подключения к базе данных MySQL. В частности:
$database_type = ‘mysql’;
$database_server = ‘localhost’;
$database_user = ‘mod’; имя пользователя БД
$database_password = ‘123’; пароль к БД
$database_connection_charset = ‘utf8’; кодировка БД
$database_connection_method = ‘SET NAMES’;
$dbase = ‘`mod`’; название БД
$table_prefix = ‘mod1x_’;
Программное обеспечение на хостинге профессиональное, и поэтому после внесения изменений в файл config.inc.php все должно отлично работать.
А если мы захотим внести изменения в файл config.inc.php на домашнем компьютере? Например, с помощью windows блокнот. Тогда мы получим следующее:
Наш сайт в Денвере перестанет работать, и накроется панель управления MODx сайтом. Виной всему windows блокнот. С помощью него нельзя редактировать системные файлы типа config.inc.php.
Для данных целей используйте специальные программы. Например, Notepad++. Этот редактор распространяется бесплатно и является отличной альтернативой блокноту windows. Скачать Notepad++.
Программа Notepad++ очень полезна, если требуется на компьютере под управлением ОС Windows создать файл с нестандартным расширением, например .htaccess. Файл типа .htaccess также лучше редактировать с помощью этой программы.
Открываем файл с помощью Notepad++. Вкладка Кодировки:
Выбираем нужную кодировку файла и жмем кнопку сохранить. Все кодировка изменена.
Обращайте внимание на кодировку файлов, если не хотите, чтобы вместо осмысленного текста на ваших веб-страницах появлялись каракули и прочие непотребные элементы. Например, для корректной работы cms MODx необходимо, чтобы все используемые ею файлы имели кодировку только UTF-8.
Урок 5. Перенос сайта под управлением MODX на другой сервер
Необходимость переносить сайты, не только работающие под управлением CMS MODX Revolution, но и все прочие, на новое место возникает очень часто. Изначально сайт мог разрабатываться на локальном сервере, нынешний хостинг по ряду причин перестал вас устраивать, владелец проекта решил сменить доменное имя – во всех случаях без знаний особенностей переноса не обойтись.
Залог успешной смены месторасположения вашего интернет-ресурса – четкое соблюдение инструкции разработчиков, внимательность, аккуратность и немного удачи. На официальном сайте MODX процедура переноса расписана очень подробно, но на английском языке. Исправим сей недостаток, хотя без знания английского заниматься веб-разработкой будет очень-очень сложно.
Система управления контентом MODX, как и большинство других CMS, хранит данные в базе данных. Это значит, что недостаточно просто скопировать файлы, находящиеся на сервере. Необходим также перенос информации, хранящейся в БД. И выполнение нескольких сопутствующих переносу операций.
Процедура переноса сайта состоит из нескольких шагов:
1. Очистка кэша
Прежде чем начинать процедуру переноса сайта с локального сервера на рабочий хостинг или с одного сервера на другой, необходимо полностью очистить кэш сайта. Для этого пройдите авторизацию для входа в административную часть. Затем выполните следующие действия:
Отключите сайт: «Системные настройки – Сайт – Статус сайта: Нет»
В панели управления выберите «Управление – Очистить кэш сайта».
После очиcтки кэша завершите все сеансы: «Управление – Завершить все сеансы»
Далее удалите содержимое папки /core/cache (на изображении интерфейс файлового менеджера панели управления, хостинг Бегет). Саму папку cache не трогайте!
2. Копирование файлов
Теперь необходимо скопировать все файлы рабочего проекта на новый сервер. Если разработка сайта велась на локальном сервере, все файлы имеются на компьютере. Если перенос выполняется с одного хостинга на другой (или с сервера на сервер в пределах одного хостинга), файлы предварительно придется скопировать на компьютер.
Делается это с помощью ftp-менеджера или файлового менеджера панели управления на хостинге. Процесс копирования можно ускорить, если предварительно упаковать файлы в архив.
При загрузке файлов на хостинг будьте внимательны, выбирая каталог назначения. Если вы перенесете файлы не в ту папку, сайт не откроется, что бы вы ни делали.
3. Перенос базы данных
Сделайте копию базы данных сайта (экспорт структуры и данных), который вы переносите.
Через инструмент phpMyAdmin это делается так:
откройте нужную базу, нажмите «Export», далее выберите способ экспорта «Обычный – отображать все возможные настройки». Нажмите «OK» и сохраняем SQL файл.
Создайте пустую базу данных на новом хостинге, затем импортируйте в нее базу данных, сохранённую на предыдущем шаге. Создание базы данных осуществляется инструментами хостинга.
Для импорта данных в новую базу можно воспользоваться инструментом phpMyAdmin:
Выберите базу, в которую будет производиться перенос, нажмите «Import». Затем укажите сохраненный ранее sql-файл и нажмите «ОК».
База данных перенесена.
4. Редактирование конфигурационных файлов
После переноса всей информации на новый сервер, необходимо изменить главный конфигурационный файл MODX под названием config.inc.php, который расположен здесь:
В файле необходимо указать новые правильные пути к ресурсам MODX и настроить подключение к базе данных. Открываем файл и вносим в него изменения:
Изменения необходимо внести ещё в три конфигурационные файла:
В них следует указать полный путь до директории сайта MODX Revolution core :
5. Запуск повторной установки
Переместив сайт и внеся изменения в конфигурационные файлы, запустите повторную установку MODX. Для этого загрузите на сервер папку setup из установочного пакета нужной версии MODX (той, которая установлена на вашем сайте). Перейдите по адресу site.ru/setup и следуйте инструкциям установщика, не забыв убедиться, что выбран режим обновления.
Не удаляйте резервную копию вашего сайта со старого сервера, пока не убедитесь, что после переноса ваш проект функционирует на все 100. При возникновении проблем с переносом проекта можете обратиться к нам, поможем.
Перенос локального сайта на удаленный сервер
Многие разработчики создают сайты локально, поэтому одной из часто решаемых задач по конфигурированию MODX является перенос созданного на локальной машине сайта на удаленный сервер. Это несложный процесс и вот его шаги :
Давайте рассмотрим эти шаги более детально.
Очистка MODX
По большому счету этот шаг не является строго обязательным, но он позволяет предотвратить передачу бесполезной информации и устанавливает MODX в относительно «чистое» состояние перед передачей данных. Выполняйте шаги в следующем порядке :
 | Наиболее безопасным способом очистки кэша является его очистка вручную. Выполните это путем стирания всего содержимого из папки core/cache. |
Создание дампа базы данных
Поскольку большая часть сайта MODX содержится в базе данных, недостаточно просто перенести на удаленный сервер файлы. Необходимо также перенести содержимое базы данных.
Используйте для этого PhpMyAdmin. Выполните следующие шаги для экспорта данных :
Импорт базы данных
После того, как вы экспортировали содержимое базы данных, вам нужно выполнить ее импорт на новый сайт. Вначале на удаленном сервере вам нужно создать базу данных и присвоить ей пользователя со всеми правами. Выполняемые при этом действия зависят от вашей платформы и хостинга. Важно : убедитесь, что в создаваемой базе данных вы указали ту же кодировку/сопоставление в новой создаваемой базе, что и использовались на вашей локальной машине.
После того, как вы создали базу данных на удаленном сервере, вам нужно, используя PhpMyAdmin, импортировать в нее данные MODX (обычно это происходит через панель управления хостинга).
Хорошей идеей является заглянуть в ваш файл SQL и проверить кодировку, используемую для базы данных и каждой таблицы.
Кодировка базы данных должна быть указана в начале файла, а кодировка для каждой таблицы в начальном разделе каждой таблицы. Если вы все сделали правильно, везде должна быть указана кодировка utf-8.
Отредактируйте файл корневой директории .htaccess согласно параметрам удаленного сервера. Обычно это означает изменение строки RewriteBase, чтобы она отражала новое местоположение сайта. В случае, если сайт, например, находится не в корневой папке, а в папке modx, эта строка будет выглядеть как :
RewriteBase /modx/
Пересылка файлов
Используя программу FTP, выполните пересылку всех файлов с локальной установки MODX на удаленный сервер.
Корректировка ваших файлов Config
После того, как вы разместили ваши файлы на удаленном сервере, вам потребуется обновить главный конфигурационный файл : core/config/config.inc.php. Вам нужно обновить данные для доступа к базе данных и пути к 6 различным ресурсам. Вот как должен выглядеть, например, код для пути к папке core :
Все остальные замены выполняйте по аналогии, заменяя путь_к_корневому_каталогу_на_сервере на используемый для удаленного сервера.
Также скорректируйте в config.inc.php URL вашего сайта (url_вашего_сайта), если он отличается от локального значения вот здесь :
Кроме того потребуется заменить пути для следующих файлов :
Вот по этому образцу :
Установка прав доступа и размеров памяти
Сайт на удаленном хостинге обычно требует установки прав доступа, которые не нужны на локальном хостинге.
Возможно для установки MODX вам также потребуется увеличить размеры памяти для удаленного сайта. Проконсультируйтесь с вашим хостинг-провайдером как это сделать. Признаком того, что MODX не хватает памяти, может быть ситуация, когда Setup работает без видимых ошибок, но при попытке зайти в панель управления вы получаете пустую страницу, или же сайт не работает надлежащим образом. Это говорит о возможной нехватке памяти во время работы программы Setup.
Запуск программы установки Setup
Запустите Setup, как вы делали это ранее при начальной (новой) установке MODX. Введите в адресной панели вашего браузера что-то подобное :
http://your_new_site.ru/setup
В начале установки нужно выбрать чекбокс «Обновление существующей установки». При этом будут сохранены данные базы данных вашего локального сайта. Если вам не удается выбрать чекбокс «Обновление существующей установки», это означает, что вы не выполнили надлежащим образом один из предыдущих шагов.
Статья, в которой рассмотрим, как осуществляется перенос сайта, работающего под управлением CMS MODX, в новое место (на новый сервер или из одной директории в другую).
Перемещение сайта MODX на новое место
Совет: Перед тем как переходить к покупке хостинга и переносу на него сайта, работающего под управлением MODX Revolution, убедитесь в том, что с ним не возникнет никаких проблем (например, он не поддерживает PDO или что-то другое). Проверит этот момент очень просто, т.к. любой хостинг предоставляет демонстрационный период для бесплатного тестирования. Всё что вам нужно, это поставить новую сборку MODX Revolution и проверить её работоспособность.
Очистка кэша MODX
Прежде чем переходить к переносу сайта на другой хостинг или в какое-то иное место (например, на локальный сервер), его сначала необходимо полностью очистить от кэша. Для этого необходимо войти в админку (менеджер) MODX и выполнить в ней следующие действия:
Копирование файлов
Если вы хотите перенести сайт MODX с одного хостинга на другой, то в этом случае можно воспользоваться готовыми инструментами специально предназначенными для этого.
Например, на хостинге SpaceWeb можно воспользоваться файловым менеджером, в котором выбрать ссылку «Создать архив всех файлов» или в разделе «Backup» с помощью элемента «Сохранить архив всех файлов в домашней директории».
Создание дампа базы данных
В MySQL, например, это осуществляется с помощью клиенткой утилиты mysqldump :
Если вы хотите сделать резервную копию базы данных сайта, находящего на хостинге, то это наиболее просто выполнить через панель управления:
Перенос файлов и данных на новое место
Выполняем обратные действия, т.е.:
Если размер базы не большой, то для импортирования базы данных можно использовать инструмент phpmyadmin.
Настройка конфигурационного файла MODX
В этом файле необходимо указать правильные пути к различным ресурсам MODX, а также настройки для подключения к базе данных. Для того чтобы данные действия выполнить на хостинге необходимо сначала узнать его домашнюю директорию. Выполнить это можно, например, можно с помощью SSH. Для этого в SSH-клиенте необходимо будет ввести следующие команды:
Открываем файл config.inc.php и вносим в него следующие изменения:
Внимание: В процессе редактирования файла config.inc.php возможно потребуется изменить его разрешения. После правки этого файла установите ему права только на чтение.
Изменения также необходимо ещё произвести в 3 дополнительных файлах php:
В этих файлах необходимо указать правильный полный путь до директории сайта MODX Revolution core :
Повторный запуск программы установки
После перемещения сайта и внесения изменений в конфигурационные файлы необходимо повторно запустить установочный скрипт ( site.ru/setup ).
Для этого необходимо, если у вас нет установочной сборки, скачать её. При этом следует скачать версию MODX Revoution, которая была у вас установлена на сайте. После этого распаковать полученный архив и загрузить каталог setup в корень вашего сайта. Запустить процесс установки и выбрать режим обновления.
Рекомендация после установки: Для того чтобы кэш браузера не влиял на работоспособность проверяемого сайта, страницы лучше открывать в режиме инкогнито или после очистки его от кэша.
Если в результате переноса у сайта не работает админка, например, отображается пустая страница (белый экран), то попробуйте воспользоваться советами и рекомендациями, приведёнными в статье.
Бэкап и перенос сайта MODX Revolution
В заметке расскажу, как делать бэкапы сайта на MODX Revolution и как перенести его на другой хостинг или сервер.
Бэкап должен включать в себя файлы сайта и базу данных. Сделать его можно через панель хостинга, SSH консоль сервера или используя дополнение BackupMODX.
Не забывайте периодически скачивать актуальную версию бэкапов к себе на компьютер.
Подготовка
Перед каждым бэкапом желательно выполнить несколько подготовительных шагов.
Подготовка завершена, сайт готов к бэкапу.
Бэкап MODX через панель хостинга
Панели управления хостингов разные, но принцип один:
Скачайте архив с файлами сайта и дамп базы данных к себе на компьютер.
Бэкап MODX через консоль
Запакуйте файлы сайта в архив. В системах UNIX архив создаётся с помощью команды tar:
Хорошей мнемоникой для опции «-czf» является Create Zip File.
Выполните экспорт базы данных.
Бэкап с помощью дополнения BackupMODX
Дополнение BackupMODX упростит и ускорит создание бэкапов сайта на MODX, но сначала его нужно установить.
В админке перейдите в Приложения — Установщик, а затем найдите и установите там дополнение BackupMODX.
Далее нужно вынести виджет установленного дополнения на главную страницу админки, для этого:
Если всё сделали правильно, на главной странице админки появится виджет BackupMODX, позволяющий делать бэкапы.
Теперь, когда потребуется сделать бэкап, отметьте галочками, что нужно забэкапить — файлы, базу данных или все сразу, а затем нажмите кнопку Backup Site. После того как бэкап будет создан, скачайте архив с файлами сайта и SQL-дамп к себе на компьютер.
По умолчанию файлы с бэкапами хранятся в папке /core/components/backupmodx/backups/, но путь можно изменить в настройках BackupMODX.
Восстановление бэкапа и перенос MODX на другой сервер
Восстановление сайта из бэкапа практически не отличается от переноса на другой хостинг или сервер. Однако при переносе на другой хостинг или сервер нужно будет внести изменения в конфигурационные файлы MODX.
Для восстановления бэкапа разархивируйте архив с файлами в папку сайта и импортируйте SQL-дамп в базу данных. Сделать, как и случае создания бэкапа это можно либо через панель управления хостингом, либо через SSH консоль сервера.
Распаковать файлы из консоли:
Импортировать дамп базы данных через консоль (для MySQL):
Если из бэкапа восстанавливается сайт на том же месте, где он находился ранее, то после распаковки файлов и импорта базы сайт должен заработать.
Если же сайт переносится на новое место, хостинг или сервер, необходимо внести изменения в конфигурационные файлы MODX. Нужно указать новые доступы к базе данных и обновлённые пути к ядру и папкам сайта. Для этого, откройте файл core/config/config.inc.php и обновите значения следующих переменных через поиск и замену:
Если сайт перемещается из или в поддиректорию (относительно корневой папки привязанной к домену), убедитесь что константы с урлами указаны верно и на конце у них есть косая черта ( / ):
Для сайта в корневой папке привязанной к домену:
Кроме того, нужно указать новые пути к ядру MODX ещё в 3 файлах:
Решение проблем
Если сайт не работает после восстановления из бэкапа или переноса на новый сервер, попробуйте воспользоваться рекомендациями ниже.
Очистите кэш, для этого удалите содержимое папки /core/cache вашего сайта. Саму папку cache удалять не нужно.
Проверьте права на папки и файлы, в большинстве случаев они должны быть установлены в 755 для папок и 644 для файлов. Изменить права можно через файловый менеджер в панели вашего хостинга или через FTP-клиент, но из-за большого количества файлов, процесс может растянуться по времени. Поэтому лучше всего это сделать через консоль SSH.
Для смены прав можно так же воспользоваться bash скриптом приведённым ниже. Не забудьте изменить в нём путь до вашего сайта и пользователя, использовать пользователя root небезопасно.
Если с правами все в порядке, перепроверьте, что в конфигурационном файле /core/config/config.inc.php указаны правильные данные — доступы к базе данных и пути к ядру и папкам сайта. Чаще всего проблема именно в этом.
Так же убедитесь, что в файлах указан правильный путь к ядру MODX.
Если выключали сайт на этапе подготовки к бэкапу, убедитесь, что включили его: Системные настройки – Сайт – Статус сайта: Да.
Попробуйте провести повторную установку, для этого:
Полезные ссылки
На этом всё. Но вы можете поддержать проект. Даже небольшая сумма поможет нам писать больше полезных статей.
Если статья помогла или понравилась, пожалуйста поделитесь ей в соцсетях.