Home

Установка

Для работы Bluz требуется PHP версии 5.6 и выше, MySQL версии 5.4 и выше (пожалуйста, проверьте требования)

С помощью composer

Скачайте composer.phar, это просто:

curl -s https://getcomposer.org/installer | php

Запустите команду create-project (замените %path% ;):

php composer.phar create-project bluzphp/skeleton %path% --stability=dev

С помощью репозитория

Скачайте проект Bluz из репозитория GitHub:

git clone git://github.com/bluzphp/skeleton.git %path%

Скачайте файл composer.phar в папку проекта:

cd %path%
curl -s https://getcomposer.org/installer | php

Установите зависимости composer с помощью команды:

php composer.phar install

C помощью PhpStorm

Для установки понадобится какая-либо сборка веб-сервера (для Windows) и PhpStorm.

Создаем проект в PHPStorm:

1. File -> New project;
2. Указываем имя и расположение проекта;
3. В Project type выбираем Composer project;
4. Проверяем, что переключатель установлен напротив Download composer.phar from getcomposer.org, в поле поиска вводим bluzphp/skeleton, выбираем пакет в окне Available packages, нажимаем OK;
5. Скачается файл composer.phar, начнутся подтягиваться зависимости.

Последний шаг

Импортируйте структуру базы данных из файла structure.ddl (во избежание "Error Code: 1071!" по умолчанию используется движок InnoDB). Импортируйте данные из dump.sql

Вставьте свои данные в конфигурационные файлы /path/to/application/configs/dev/*.php (настройки для окружения разработчиков, подробнее читайте в описании пакета Config)

Запустите внутренний PHP web-server (подробнее в статье Server):

/path/to/bin/server.sh -e dev

Список поддерживаемых флагов:
-h - параметр для запуска сервера в формате host:port, по умолчанию localhost:8000
-e - окружение, по умолчанию production
-d - режим отладки

Либо создайте символическую ссылку на корневой каталог сервера (требуется настройка FollowSymlinks): Для Linux:

ln -s /path/to/public /path/to/web

Для Windows:

mklink /D /path/to/web path/to/public

Модули

Системные:

• acl - раздача прав по ролям
• cache - просмотр статистики memcached и сброс кеша
• system - системные утилиты
• tests - различные тестовые модули, подборка best practice

Функциональные:

• categories - категории UNDER CONSTRUCTION
• comments - комментарии UNDER CONSTRUCTION
• media - медиа-контент
• options - произвольные настройки
• pages - статические страницы
• users - управление пользователями

База данных

• Db Standards
• Db Notes

Фронт-енд

• HTML и CSS
• JavaScript

Настройки

Для настройки используются следующие переменные окружения:

• BLUZ_ENV - отвечает за то, какая именно конфигурация будет подключена (подробнее в Config)
• BLUZ_LOG - отвечает за логирование данных в папку data/logs, используется в функции errorLog()
• BLUZ_DEBUG - включение debug режима, используется в функции dump() и при выводе текста ошибок в шаблонах
• BLUZ_DEBUG_KEY - тут хранится ключ, который отслеживает система в cookies для включение debug режима

Отладка

По умолчанию, все ошибки логируются в папке ./data/logs/ (для отключения удалите строчку SetEnv BLUZ_LOG true из .htaccess файла).

Для включения режима отладки в браузере необходимо добавить куку BLUZ_DEBUG используя закладки из модуля system.

Для включения режима отладки для PHP web-сервера используйте флаг -d (подробнее в статье Server)

Стандарты кодирования

https://github.com/php-fig/fig-standards/tree/master/accepted