Управление версиями PHP в ServBay: руководство по настройке командной строки и окружения сайтов

ServBay — это мощный инструмент локальной среды веб-разработки, созданный специально для macOS и поддерживающий множество языков программирования и баз данных. В этом материале вы узнаете, как гибко управлять версиями PHP для разных проектов в ServBay — будь то выполнение скриптов из командной строки или обслуживание конкретных сайтов. Освоив систему управления версиями PHP в ServBay, вы существенно повысите свою производительность и обеспечите изоляцию и стабильность окружения для проектов.

1. Окружение командной строки: управление версией PHP на уровне проекта с помощью .servbay.config

Создавая файл конфигурации .servbay.config в корне проекта, разработчик может указать уникальную версию PHP для каждого проекта. ServBay автоматически подгружает соответствующую версию PHP, ориентируясь на текущую директорию терминала, что позволяет изолировать окружения проектов и избегать конфликтов глобальных настроек.

1. Назначение и принцип работы .servbay.config

• Версионный контроль на уровне проекта: ServBay поддерживает одновременную установку и запуск нескольких версий PHP — от 5.6 до последних стабильных и тестовых релизов. С помощью .servbay.config вы можете точно указать, какая версия PHP требуется вашему проекту.
• Бесшовное переключение версий: При переходе в каталог проекта, содержащий файл .servbay.config, командами cd в терминале, ServBay автоматически обнаруживает этот файл и временно изменяет переменные окружения для текущей сессии (в первую очередь PATH). Таким образом, команды php, composer и т.п. будут ссылаться на исполняемые файлы указанной версии PHP. После выхода из каталога переменные окружения сбрасываются к глобальным настройкам ServBay; такой подход не влияет на системное окружение и не оставляет побочных эффектов.

2. Как настроить

Создайте файл .servbay.config в корневой папке вашего проекта и добавьте следующее:

# Указать версию PHP для текущего проекта (пример: PHP 8.3)
PHP_VERSION=8.3

# Если вашему проекту требуется определённая версия Node.js, её тоже можно указать (пример: Node.js 20)
# NODE_VERSION=20

• Значение PHP_VERSION должно соответствовать идентификатору версии PHP, установленной и включённой в ServBay (например, 7.4, 8.1, 8.3, 8.5 и т.д.).
• Аналогично настраивается NODE_VERSION — для указания нужной версии Node.js для проекта.

Проверка работы:

Откройте терминал в каталоге с файлом .servbay.config и выполните:

$ pwd # Убедитесь, что вы находитесь в корне проекта
$ php -v  # Выведет версию PHP — она должна соответствовать настройке (например, PHP 8.3.x)
$ composer install  # Установка зависимостей будет работать с выбранной версией PHP

Если после изменения .servbay.config версия PHP не переключилась, попробуйте закрыть и открыть терминал заново или выполните cd . для принудительной перезагрузки настроек ServBay.

3. Важные моменты и продвинутые советы

• Совместимость версий: Если при выполнении команд проекта появляются ошибки вроде "Class not found" или "Call to undefined function", проверьте требуемый диапазон версий PHP в зависимостях (например, в composer.json) и убедитесь, что выбранная версия совместима с проектом и его зависимостями. Некоторые старые проекты могут использовать функции или расширения, удалённые в новых версиях (например, в PHP 7.2 был удалён mcrypt).
• Глобальные значения по умолчанию: Если в текущей или родительских папках нет файла .servbay.config, ServBay будет использовать установленную в графическом интерфейсе версию PHP по умолчанию.
• Совместная работа с несколькими сервисами: Помимо управления версией PHP, через .servbay.config можно указать версию Node.js (NODE_VERSION). Это особенно удобно для проектов, где PHP используется для бэкенда, а Node.js — как инструмент сборки фронтенда (Webpack, Vite и др.).

4. Пример работы

Вот наглядный пример, как .servbay.config обеспечивает автоматическую смену версии PHP в разных директориях проектов:

Описание изображения: В ServBay переход в каталог с разным .servbay.config и выполнение php -v автоматически активирует требуемую версию PHP.

2. Окружение сайтов: управление версиями PHP через графический интерфейс ServBay

Графический интерфейс ServBay позволяет настраивать независимую версию PHP для каждого сайта. Окружения сайтов и командной строки полностью независимы, и вы можете подобрать оптимальный вариант для каждой задачи.

1. Пошаговая инструкция по настройке

1. Запустите графический интерфейс ServBay: Откройте приложение ServBay.
2. Перейдите к управлению сайтами: Кликните по вкладке Сайты (Websites) на левой панели.
3. Добавьте или измените сайт:
   • Используйте кнопку + в левом нижнем углу для добавления нового сайта.
   • Либо выберите существующий сайт для редактирования.
4. Настройте параметры сайта:
   • Root Directory (корневая папка): Укажите директорию, в которой размещаются файлы сайта. Рекомендуется использовать стандартный путь ServBay: подпапку в /Applications/ServBay/www/, например /Applications/ServBay/www/your-website-name/public (для проектов Laravel или Symfony).
   • Domain (домен): Задайте локальное доменное имя, например your-website-name.servbay.demo. ServBay автоматически настраивает локальный DNS и выдаёт HTTPS-сертификаты (через ServBay User CA или ServBay Public CA), что облегчает разработку и тестирование.
   • PHP Version (версия PHP): В выпадающем меню выберите нужную версию PHP для этого сайта. ServBay покажет все установленные и включённые версии (7.4, 8.1, 8.3, 8.5 и т.д.).
5. Сохраните настройки: После изменения параметров нажмите "Сохранить". ServBay применит изменения автоматически — может потребоваться перезапуск или обновление соответствующих процессов веб-сервера и PHP-FPM.

2. Технические детали и преимущества

• Изоляция процессов: Для каждого сайта ServBay запускает отдельный пул процессов PHP-FPM требуемой версии, что полностью изолирует окружения — сбои или утечки памяти одной площадки не повлияют на другие.
• Оптимизация под железо: Все сборки, включая PHP, оптимизированы для ARM64 (Apple Silicon) и X86_64, что обеспечивает стабильную и быструю работу на любом современном Mac.
• Отладка и диагностика:
  • Проверяйте ошибки PHP в файле /Applications/ServBay/var/log/php/php_error.log.
  • Статус процессов PHP-FPM для любой версии можно узнать командой servbayctl status php 8.3.

3. Интеграция с веб-серверами и базами данных

ServBay предоставляет максимальную гибкость: настраивайте серверы и базы данных под нужды проекта.

• Поддержка разных веб-серверов: C версии 1.7.0 и новее можно изменить веб-сервер для сайта одним кликом — доступны Apache, Nginx и Caddy. Они интегрированы с процессами PHP-FPM под управлением ServBay.
• Работа с различными базами данных: ServBay поддерживает установку и управление несколькими версиями MySQL, MariaDB, PostgreSQL, MongoDB, Redis. В настройках сайта или в проектном коде вы подключаетесь к одному из инстансов, чтобы соответствовать требованиям (например, Laravel-проекты часто работают с MariaDB 11.x).

3. Совместная работа окружений и лучшие практики

Осознав отличие и настройку версий PHP для командной строки и сайтов, вы сможете наиболее эффективно организовать среду разработки:

Сценарий	Настройка в командной строке (.servbay.config)	Настройка для сайта (через GUI ServBay)	Примечания
Обслуживание легаси-проектов	В корне проекта: PHP_VERSION=5.6	Для сайта выбрать PHP 5.6	Проверьте, что необходимая версия и расширения установлены в ServBay.
Разработка нового проекта (например, Laravel 11)	PHP_VERSION=8.3 (или выше) и, возможно, NODE_VERSION=20	Добавьте сайт, корневая папка — public, PHP 8.3+, настройте домен, включите HTTPS	Следите за совпадением версии PHP для инструментов CLI и веб-окружения.
Тестирование будущих версий PHP	В тестовом проекте: PHP_VERSION=8.5	Для тестового сайта выбрать PHP 8.5	Для проверки совместимости с будущими релизами PHP.
Запуск команд Composer	.servbay.config (в текущей или верхней папке) должна указывать корректную версию PHP	N/A (Composer работает в CLI)	Composer использует активную версию PHP в текущей сессии терминала.

Важные замечания

• Различия CLI и Web-окружения: Даже при совпадении версии PHP, параметры по умолчанию и расширения могут отличаться между CLI и веб-режимом (PHP-FPM). Например, расширение opcache обычно по умолчанию включено в PHP-FPM, но для CLI — нет. При диагностике различий изучайте свой php.ini (для каждой версии — свой!) и список активных расширений.
• Обновление ServBay Runtime: Всегда используйте свежую версию приложения ServBay и его Runtime. Команда разработчиков регулярно обновляет пакеты (в том числе новые версии PHP и патчи безопасности), установка обновлений обновляет и Runtime, что приносит новейшие функции и исправления.

Часто задаваемые вопросы (FAQ)

В: Что делать при конфликте версий PHP между командной строкой и сайтом?

О: Окружение командной строки (управляется через .servbay.config) и окружение сайта (настраивается в интерфейсе ServBay) полностью независимы. Файл .servbay.config влияет только на то, какая версия PHP будет использоваться в терминале при работе команд типа php, composer и др.; настройка сайта определяет, через какую версию PHP-FPM веб-сервер (Apache/Nginx/Caddy) исполняет запросы. Прямого конфликта между ними нет. Для одного и того же проекта технически можно использовать разные версии PHP в CLI и вебе (например, для запуска Composer или Artisan и для работы сайта), но, чтобы избежать недопонимания и ошибок, рекомендуется держать версии одинаковыми.

Вывод

ServBay предоставляет разработчикам мощные и гибкие инструменты управления версиями PHP: через файл .servbay.config для терминала и простой визуальный интерфейс для сайтов. Будь то поддержка старых систем или разработка новых проектов на последних версиях PHP, вы сможете без труда создавать подходящую локальную среду. Разумная организация этих возможностей поможет максимально приблизить локальную разработку к условиям продакшн, повысить производительность и стабильность ваших проектов.