Введение

Это описание покажет вам, как развернуть PHP приложение в течение нескольких минут. Эти инструкции также дадут вам достаточно информации, чтобы использовать Dokkur наилучшим образом.

Убедитесь, что у вас уже есть:

  1. Dokkur аккаунт.
  2. SSH ключи, добавленные в ваш аккаунт.
  3. PHP, установленный локально.
  4. Composer, установленный локально.

Установка

На этом шаге вы должны установить Dokkur Toolbelt, что даст вам доступ к Dokkur Command Line Interface (CLI).

После установки вы сможете использовать команду dokkur login, чтобы авторизоваться с помощью вашей почты и пароля, которые вы вводили при регистрации.

Подготовка приложения

Чтобы опубликовать приложение, это приложение должно быть готово к публикации.

Если у вас нет своего PHP проекта, то вы можете использовать шаблон, который мы подготовили для вас:

$ git clone https://github.com/dokkur/php-getting-started.git
$ cd php-getting-started

Теперь у вас есть действующий git репозиторий, который включает в себя простое приложение и файл composer.json. Убедитесь, что вы установили Composer. Dokkur использует Composer для управления зависимостями любых PHP проектов.

Если у вас все же есть свое PHP приложение, которое вы хотите опубликовать, то вам надо провести небольшую подготовку.

Объявление зависимостей приложения

Как Dokkur понимает, что приложение написано на PHP? Ответ простой - по наличию файла composer.json в корневой директории.

Обычно этот файл выглядит вот так:

{
"require" : {
"silex/silex": "~1.3",
"monolog/monolog": "~1.7",
"twig/twig": "^1.19",
"symfony/twig-bridge": "^2.7"
},
"require-dev": {
"heroku/heroku-buildpack-php": "*"
}
}

Файл composer.json - это спецификация того, какие зависимости должны быть установлены с приложением. Когда приложение опубликовано, Dokkur считывает файл и устанавливает все, что нужно, в директорию vendor.

Ваше PHP приложение может использовать зависимостри после запроса:

require('../vendor/autoload.php');

Выполни следующую команду, чтобы установить зависимости и подготовить систему для локального запуска приложения:

$ composer update
Loading composer repositories with package information
Updating dependencies (including require-dev)
- Installing psr/log (1.0.0)
Loading from cache
...
Writing lock file
Generating autoload files

Вы всегда должны проверять, включены ли файлы composer.json и composer.lock в git репозиторий. Директория vendor должна быть включена в файл .gitignore.

Создание приложения

Следуй инструкции:

  1. Отрой личный кабинет, перейди в раздел Personal apps (левое меню)
  2. Нажми на кнопку ⨁, чтобы открыть интерфейс New App
  3. Введи название приложения (Внимание! Используй только латинские буквы в нижнем регистре и цифры, например, myapp007), выбери доступный и подходящий инстанс для хранения, выбери шаблон Custom App и нажми на кнопку Create App.

Поздравляю! Ваше приложение создано. А сейчас надо его опубликовать. Поехали!

Добавление переменной окружения BUILDPACK_URL

  1. Перейдите в раздел Settings, в секции Environment variables нажмите на кнопку Edit.
  2. Выберите ADD NEW VARIABLE
  3. В поле Name напишите BUILDPACK_URL
  4. В поле VALUE вставьте
    https://github.com/dokkur/buildpack-php
  5. Нажмите Save

Публикация приложения

  1. Перейди в раздел Settings, скопируй git url из секции Git URL.
  2. Перейди в Dokkur Toolbelt и запусти следующую команду:

    git remote add dokkur git_url
    Вместо git_url вставь ссылку, которую скопировал из веб-версии.

  3. Запушь свое приложение:
    git push dokkur master
    Если хочешь опубликовать в другую ветку, то:
    git push dokkur yourbranch:master

Ура! Твое приложение опубликовано! Перейди по ссылке yourappname.dokkurapp.com в браузере.