Описание
Утилита PHP CLI GetSimple CMS Installation Tool предназначена для выполнения автоматической установки системы управления контентом GetSimple CMS, используя CLI интерфейс PHP.
Возможности
- удобство работы: утилита PHP CLI GetSimple CMS Installation Tool позволяет упростить и автоматизироать процесс установки чистой копии системы управления контентом GetSimple CMS на веб-сервере или в локальной среде разработки, в соответствие с требованиями пользователя;
- защита от ошибок: утилита PHP CLI GetSimple CMS Installation Tool предотвращает случайную перезапись файлов и поддиректорий в целевой директории установки GetSimple CMS;
- поддержка различных версий GetSimple CMS: утилита PHP CLI GetSimple CMS Installation Tool позволяет установить любую версию системы управления контентом GetSimple CMS, для которой существует ветка в официальном репозитории проекта на GitHub;
- кроссплатформенность: утилита PHP CLI GetSimple CMS Installation Tool написана на языке программирования PHP и не зависит от платформы, на которой запускается. Корректная работа утилиты была проверена на рабочих станциях и серверах, работающих под управлением различных версий операционных систем Microsoft Windows, GNU/Linux и FreeBSD.
Использование
Утилита PHP CLI GetSimple CMS Installation Tool использует интерфейс командной строки, поэтому для её запуска у пользователя должен быть доступ к командной строке, а также права, позволяющие запускать интерпретатор PHP и вносить изменения в файловую систему. Кроме того, в настройках PHP должна быть включена опция allow_url_fopen
.
Для задания и изменения параметров работы утилиты используются следующие ключи:
-b
, --branch
- имя используемой ветки из официального репозитория GetSimple CMS. По умолчанию используется ветка stable
.-d
, --directory
- относительное или полное имя директории, в которую будет выполнена установка GetSimple CMS. По умолчанию используется текущая директория в которой выполняется запуск утилиты;-f
, --force
- разрешение установки GetSimple CMS в не пустую директорию. По умолчанию принимает значение false
.
Для того, чтобы создать новый проект с использованием текущей стабильной версии GetSimple CMS, утилита PHP CLI GetSimple CMS Installation Tool может быть запущена со следующими параметрами:
php gs-install --branch=stable --directory=/var/www/site.local
В результате работы утилиты будет создана директория /var/www/site.local
, в которую будет установлена стабильная версия GetSimple CMS. В случае, если у пользователя, от имени которого выполняется запуск утилиты, нет прав на создание поддиректорий в /var/www/
, утилита завершит выполнение, при этом в командной строке будет выведено информационное сообщение об ошибке работы с целевой директорией.
Следующий пример показывает использование утилиты PHP CLI GetSimple CMS Installation Tool для установки GetSimple CMS 3.4 без задания параметра --directory
, предварительное создание целевой директории и изменение её владельца, с целью предоставления полных прав доступа к ней для текущего пользователя.
sudo mkdir /var/www/site.local
sudo chown $USER:$USER /var/www/site.local
cd /var/www/site.local
php gs-install -b=master
Не смотря на то, что утилита позволяет производить установку GetSimple CMS из любой доступной ветки, я рекомендую использовать ветки:
- stable - стабильная ветка, то есть последняя стабильная версия системы управления контентом. Используется по умолчанию;
- hotfixes - исправления, предназначенные для включения в следующий релиз стабильной версии системы управления контентом;
- master - ветка разработки следующей мажорной версии системы управления контентом. Следует использовать тем, кто хочет познакомиться с будущими возможностями GetSimple CMS.
Следует иметь в виду, что имена веток, задаваемые в параметре --branch
, регистрозависимые. При задании несуществующей ветки, утилита завершит работу, будет выведено сообщение о невозможности получения архива с установочными файлами системы управления контентом GetSimple CMS.
При выполнении установки GetSimple CMS, все существующие в целевой директории файлы и поддиректории, совпадающие по именам с файлами и директориями системы управления контентом, будут перезаписаны, что может привести к порче и потере данных. Для предотвращения этого, утилита PHP CLI GetSimple CMS Installation Tool перед началом работы проверяет наличие любых файлов и поддиректорий в целевой директорий. В случае, если целевая директория не является пустой, утилита завершит работу, при этом в командной строке будет выведено соответствующее информационное сообщение.
Для отключения проверки целевой директории на наличие файлов и поддиректорий, утилита PHP CLI GetSimple CMS Installation Tool должна быть запущена с параметром -f=true
или --force=true
. Этот параметр должен использоваться с осторожностью, только в тех случаях, когда пользователь уверен в своих действиях и понимает их последствия.
php gs-install -d=/var/www/site.local -b=master -f=true
В результате запуска утилиты PHP CLI GetSimple CMS Installation Tool с параметром -f=true
или --f=true
, все файлы и поддиректории целевой директории, совпадающие по имени с файлами и директориями системы управления контентом, будут перезаписаны. Однако остальные файлы и директории останутся без изменений. Поэтому, если требуется выполнить чистую установку GetSimple CMS в целевую директорию, содержащую файлы и поддиректории, не относящиеся к системе управления контентом, её следует предварительно очистить.
rm -rf /var/www/site.local/*
php gs-install -d=/var/www/site.local --branch=master
После завершения установки GetSimple CMS с использованием утилиты PHP CLI GetSimple CMS Installation Tool, как и в случае выполнения установки вручную, перед началом использования необходимо произвести стандартную настройку системы управления контентом при помощи графического пользовательского веб-интерфейса панели управления.