Включение высокопроизводительного модуля Phalcon PHP-фреймворка в ServBay

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

Обзор фреймворка Phalcon

Phalcon — это open source PHP-фреймворк с полным функционалом, который славится чрезвычайно высокой скоростью и минимальным использованием ресурсов. В отличие от большинства фреймворков, реализованных на чистом PHP, Phalcon написан на C и загружается как расширение PHP. Такая архитектура обеспечивает значительное преимущество по производительности, при этом предоставляя широкий набор возможностей для построения приложений.

Основные преимущества

Высокая производительность: Благодаря работе на уровне C-расширения Phalcon обрабатывает запросы существенно быстрее и с меньшими затратами памяти и CPU по сравнению с фреймворками на чистом PHP.
Минимальная нагрузка: Оптимизация работы с ресурсами позволяет поддерживать высокую производительность даже при большом количестве одновременных запросов.
Богатый функционал: Включает в себя полноценную поддержку архитектуры MVC, мощный ORM, шаблонизатор, гибкую маршрутизацию, кэширование, очереди и другие возможности для проектов любого уровня сложности.
Простота использования: Несмотря на низкоуровневую реализацию на C, разработка ведётся привычным синтаксисом PHP. Хорошая документация и понятный API делают Phalcon доступным даже для новичков.
Модульная архитектура: Компоненты Phalcon максимально разделены — вы можете использовать только нужные модули и подменять их под требования проекта.

Версии модуля Phalcon, предустановленные в ServBay

ServBay поддерживает несколько актуальных версий PHP и для каждой из них содержит предварительно собранный подходящий модуль Phalcon. Система и дальше будет получать обновления PHP и соответствующих пакетов. Совместимость по версиям можно узнать в интерфейсе управления пакетами — ниже приведены наиболее типовые комбинации (обратите внимание: ServBay может поддерживать и более свежие версии):

PHP 5.6, 7.0, 7.1: Phalcon 3.4.5
PHP 7.2, 7.3, 7.4: Phalcon 4.1.2
PHP 8.0, 8.1, 8.2, 8.3: Phalcon 5.7.0
PHP 8.4, 8.5-dev: Phalcon 5.8.0

Как включить модуль Phalcon

В ServBay активация модуля Phalcon происходит максимально интуитивно. По умолчанию модуль может быть отключён ради оптимальной легкости среды. Включить Phalcon можно буквально несколькими щелчками через графический интерфейс ServBay.

Рекомендуемый способ: активация через графический интерфейс ServBay

Самый простой и удобный путь:

Откройте приложение ServBay.
Перейдите в меню Языки (Languages) в левой части окна.
В списке пакетов найдите и выберите версию PHP, для которой нужно включить Phalcon, например PHP 8.3 или PHP 8.4.
Справа от выбранной версии щёлкните на кнопку Расширения (Extensions).
В появившемся списке найдите модуль Phalcon.
Переведите переключатель перед Phalcon в положение «включено».
Нажмите Сохранить (Save) внизу окна.
ServBay попросит подтвердить перезапуск PHP. Согласитесь и дождитесь завершения.

После перезапуска выбранного PHP-окружения Phalcon будет успешно подключён.

Включение вручную через конфигурационный файл (для опытных пользователей)

Тем, кто хочет автоматизации или гибкой настройки, доступно ручное изменение конфигов для активации модуля.

Шаг 1: Найдите нужный конфиг

Определите версию PHP и перейдите в её папку conf.d — здесь хранятся настройки расширений. Например, для PHP 8.3 путь будет выглядеть так:

bash

/Applications/ServBay/etc/php/8.3/conf.d/phalcon.ini

Откройте этот файл в редакторе.

Шаг 2: Отредактируйте Phalcon-конфиг

Чтобы включить расширение, найдите строку с extension = phalcon.so и уберите точку с запятой ;, раскомментировав её:

ini

[Phalcon]
; Uncomment the following line to enable Phalcon
extension = phalcon.so

Должно получиться так:

ini

[Phalcon]
extension = phalcon.so

Шаг 3: Включение расширения PSR (только для PHP 7.2 - 7.4)

Если вы использовали интерфейс ServBay — этот шаг пропускайте.

Для версий PHP с 7.2 по 7.4 фреймворку Phalcon требуется расширение PSR. В ServBay оно уже предустановлено, останется только убедиться, что загружается. Проверьте, что в phalcon.ini или аналогичном psr.ini строки раскомментированы:

ini

; Uncomment both Psr & Phalcon to enable Phalcon
[Psr]
extension = psr.so

[Phalcon]
extension = phalcon.so

Шаг 4: Перезапустите PHP

После любых изменений — будь то через интерфейс или вручную — нужно обязательно перезапустить соответствующий PHP-сервис.

Зайдите в главное окно ServBay или в раздел Пакеты (Packages), найдите настроенную версию PHP и щёлкните по иконке перезапуска (обычно это стрелка по кругу).

Проверка успешного подключения Phalcon

Наиболее распространенный способ проверки — посмотреть информацию о PHP через phpinfo().

В корне любого вашего сайта, настроенного в ServBay, создайте файл phpinfo.php. Например, если корень сайта servbay.demo — /Applications/ServBay/www/servbay.demo, размещайте файл там.
Заполните файл следующим кодом:
php
```
<?php
phpinfo();
?>
```
1
2
3
Откройте такой адрес в браузере: https://servbay.demo/phpinfo.php.
На открывшейся странице найдите блок о расширении "Phalcon". Если видна информация о версии и настройках — расширение успешно активировано.

Рис. Поиска сведений о Phalcon в phpinfo

Пример использования

После активации модуля можно сразу приступить к разработке приложения на Phalcon. Вот минимальный пример проекта и инструкции по запуску под ServBay.

Пусть проект находится в /Applications/ServBay/www/phalcon-demo.

Шаг 1: Структура проекта

Создайте папки и файлы по стандартной структуре Phalcon:

/Applications/ServBay/www/phalcon-demo/
├── app/
│   ├── controllers/
│   │   └── IndexController.php
│   └── views/
│       └── index/
│           └── index.phtml
└── public/
    └── index.php

Шаг 2: Создание сайта в ServBay

Добавьте новый Сайт (Website), укажите домен phalcon-demo.servbay.demo, а корень сайта — папка public вашего проекта. Убедитесь, что на выбранном сайте используется версия PHP с включённым Phalcon.

Шаг 3: Пример кода

Фронт-контроллер: public/index.php Главный вход в приложение.

php

<?php

use Phalcon\Autoload\Loader;
use Phalcon\Di\FactoryDefault;
use Phalcon\Mvc\View;
use Phalcon\Mvc\Url;
use Phalcon\Mvc\Application;

// Определяем основные пути
define('BASE_PATH', dirname(__DIR__)); // Указывает на /Applications/ServBay/www/phalcon-demo
define('APP_PATH', BASE_PATH . '/app'); // Указывает на /Applications/ServBay/www/phalcon-demo/app

// Регистрируем автозагрузчик контроллеров и моделей
$loader = new Loader();
$loader->setDirectories(
    [
        APP_PATH . '/controllers/',
        APP_PATH . '/models/', // Добавьте здесь путь к моделям при их наличии
    ]
);
$loader->register();

// Создаём контейнер DI
$container = new FactoryDefault();

// Регистрируем сервис View в контейнере
$container->set(
    'view',
    function () {
        $view = new View();
        $view->setViewsDir(APP_PATH . '/views/'); // Папка с шаблонами
        return $view;
    }
);

// Регистрируем сервис URL
$container->set(
    'url',
    function () {
        $url = new Url();
        $url->setBaseUri('/'); // Базовый URL
        return $url;
    }
);

// Создаём экземпляр приложения Phalcon
$application = new Application($container);

try {
    // Обрабатываем и отправляем ответ
    $response = $application->handle(
        $_SERVER["REQUEST_URI"]
    );

    $response->send();

} catch (\Exception $e) {
    // Перехват ошибки и вывод сообщения
    echo 'Exception: ', $e->getMessage();
}

?>

Контроллер: app/controllers/IndexController.php Обрабатывает запрос главной страницы.

php

<?php

use Phalcon\Mvc\Controller;
use Phalcon\Support\Version; // Класс для получения версии Phalcon

class IndexController extends Controller
{
    // Действие по умолчанию
    public function indexAction()
    {
        // Получаем текущую версию Phalcon
        $phalconVersion = new Version();
        $versionString = $phalconVersion->get();

        // Передаём номер версии в шаблон
        $this->view->phalconVersion = $versionString;

        // Рендер вида app/views/index/index.phtml
    }
}

Вид: app/views/index/index.phtml Шаблон с приветствием и номером версии Phalcon.

html

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <title>Hello ServBay with Phalcon</title>
        <style>
            body { font-family: sans-serif; margin: 40px; text-align: center; }
            h1 { color: #333; }
            p { color: #666; }
        </style>
    </head>
    <body>
        <h1>Hello ServBay!</h1>
        <p>Вы успешно запустили приложение Phalcon в ServBay.</p>
        <p>Текущая версия Phalcon: **<?= $phalconVersion ?>**</p>
    </body>
</html>

Шаг 4: Откройте приложение в браузере

Проверьте, что Nginx/Caddy и требуемая версия PHP в ServBay работают. Перейдите через браузер по адресу, указанному для сайта, например: https://phalcon-demo.servbay.demo. Вы должны увидеть страницу с приветствием “Hello ServBay!” и номером текущей версии Phalcon.

Рис. Успешное выполнение демо-приложения Phalcon

Важные примечания

Следите за совместимостью между используемой версией PHP и вашими проектами на Phalcon.
После ручного редактирования конфигов всегда перезапускайте PHP.
В случае проблем — проверьте журналы ошибок PHP и веб-сервера (Nginx/Caddy) в каталоге /Applications/ServBay/var/log/.

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

Вопрос 1: Включил Phalcon по инструкции, но не вижу его в выводе phpinfo(). Что делать?

Ответ:

Проверьте, что редактировали конфиг именно используемой версии PHP (особенно при ручной настройке).
Убедитесь, что убрали точку с запятой перед extension = phalcon.so.
Перезапустите именно ту версию PHP, где активировали расширение.
Домен сайта должен использовать ту же версию PHP с подключённым Phalcon.
Загляните в логи ошибок PHP в ServBay на предмет проблем с подключением расширения.

Вопрос 2: При запуске приложения Phalcon выходит ошибка Class 'Phalcon\...' not found. Почему?

Ответ: Обычно это значит, что модуль Phalcon не был успешно активирован в вашей рабочей версии PHP. Повторите шаги по включению и сверке через phpinfo(). Если видно, что расширение подключено, проверьте корректность autoload-настроек и соответствие namespace в вашем коде.

Вопрос 3: Требуются ли дополнительные зависимости для Phalcon?

Ответ: Для версий PHP 7.2–7.4 нужен дополнительный модуль PSR, который уже предустановлен в ServBay — просто проверьте, что раскомментированы обе строки в phalcon.ini: extension = psr.so и extension = phalcon.so. Для PHP 8.0+ (Phalcon 5.x) отдельно активировать PSR не требуется — стандарт уже интегрирован во фреймворк.

Заключение

ServBay позволяет буквально за считанные минуты развернуть у себя высокопроизводительный Phalcon-фреймворк для локальной разработки. Простое и интуитивное управление через графический интерфейс либо привычное ручное изменение конфигов — и мощный модуль Phalcon готов к работе с различными версиями PHP. Добавьте к этому поддержку других популярных вэб-технологий в ServBay — и вы получаете удобное, гибкое окружение для быстрой и эффективной разработки приложений на Phalcon. Используйте все преимущества Phalcon для создания молниеносных, лёгких и современных вэб-сервисов!

Включение высокопроизводительного модуля Phalcon PHP-фреймворка в ServBay ​

Обзор фреймворка Phalcon ​

Основные преимущества ​

Версии модуля Phalcon, предустановленные в ServBay ​

Как включить модуль Phalcon ​

Рекомендуемый способ: активация через графический интерфейс ServBay ​

Включение вручную через конфигурационный файл (для опытных пользователей) ​

Шаг 1: Найдите нужный конфиг ​

Шаг 2: Отредактируйте Phalcon-конфиг ​

Шаг 3: Включение расширения PSR (только для PHP 7.2 - 7.4) ​

Шаг 4: Перезапустите PHP ​

Проверка успешного подключения Phalcon ​

Пример использования ​

Шаг 1: Структура проекта ​

Шаг 2: Создание сайта в ServBay ​

Шаг 3: Пример кода ​

Шаг 4: Откройте приложение в браузере ​

Важные примечания ​

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

Заключение ​