Как отделить версии API на сервере?

Question

[Алексей Коновалов]

Всем привет! Пишу API на php. Довольно объемное, но не совсем понимаю как сделать, несколько его версий...
Например запрос может поступать с параметром v1.0.0, но вдруг мне понадобилось создать версию v1.0.1, для того, чтобы, например, при отдаче постов добавить еще один параметр...
было:

{
"id": 1,
"title": "заголовок"
}

стало:

{
"id": 1,
"title": "заголовок",
"descr": "текст"
}

На ум приходит взять папку, в которой лежит API с версией 1.0.0, и скопировать в другую, переименовав в 1.0.1 и уже в новой папке работать с новой версией...
Но получается глупо дублировать весь код, ради одного параметра...
На ум снова приходит вариант с использованием условия IF. Вроде: если обращение к версии 1.0.0, то отдаем первый вариант, если 1.0.1 - второй.
Но опять же... через какое-то время этих IF станет столько много, что я просто не смогу их контролировать....

Подскажите, как отделить эти версии на сервере с меньшими проблемами...

Answer 1

[Andrey Tsvetkov]

через какое-то время этих IF станет столько много

Зачем много? Мне кажется достаточно одного. Прям на входе проверяете наличие контроллера для версии, указанной в запросе, если её нет понижаете версию и сново проверяете наличие контроллера, и так далее.

Comments

[Алексей Коновалов]

Не совсем понял о чем вы...
Мы получили запрос с версией 1.0.1
Обратились к контроллеру 1.0.1 модуля "posts"... получается нам нужно сделать вторую копию этого модуля на сервере?
Или вы имеете ввиду мы в такос случае запускайм один и тот же файл отвечающий за модуль "posts"
, там обращаемся к модели, которая достает данные из базы и проверяет какая у нас версия запрошена...
Но тогда IF нужен уже в модели, потому что именно ей нужно указать какие данные вернуть контроллеру...

[Andrey Tsvetkov]

получается нам нужно сделать вторую копию этого модуля на сервере?

Это не копия, это новая версия

[Алексей Коновалов]

Andrey Tsvetkov, Да, но она отличается от предыдущей, скажем, одной строкой... получается весь остальной код - это просто копия...
Или это правильное и используемое повсеместно решение?

[Andrey Tsvetkov]

Не знаю кто как делает, но вариантов может быть много. Однажды мы вообще поднимали отдельный сервис под каждую версию api и на уровне nginx проксировали запросы в нужный сервис.