Створення і запуск проєкту Zend Framework (Laminas) у ServBay

Огляд

Zend Framework (тепер частина проекту Laminas) — це потужний open-source фреймворк для PHP, який містить набір сучасних, об'єктно-орієнтованих компонентів для розробки веб-додатків і сервісів. Він відомий своєю гнучкістю, модульною структурою та високою продуктивністю, що робить його чудовим вибором для розробки як простих сайтів, так і складних корпоративних систем.

ServBay — це локальне середовище розробки для macOS і Windows, яке об'єднує PHP, різні веб-сервери (Caddy, Nginx), бази даних (MySQL, PostgreSQL, MongoDB), кеш-сервіси (Redis, Memcached) та інші інструменти для розробки. Завдяки простому керуванню та налаштуванню всіх пакетів, ServBay дає змогу легко запускати будь-які проєкти на основі PHP.

У цьому документі ви дізнаєтесь, як створити й запустити проєкт Zend Framework (Laminas) у середовищі ServBay, а також як інтегрувати різні бази даних і кеш-сервіси.

Необхідні умови

Перед початком переконайтеся, що виконані наступні кроки:

1. Встановлений ServBay: Ви успішно інсталювали ServBay на macOS або Windows. Якщо ні, перейдіть на офіційний сайт ServBay для інструкцій щодо встановлення.
2. Потрібні пакети ServBay: Переконайтесь, що у ServBay встановлено й запущено необхідні пакети:
   • PHP (рекомендується 8.x або новіше, оскільки сучасні версії Zend Framework/Laminas потребують актуальної версії PHP).
   • Веб-сервер (Caddy або Nginx).
   • Composer (у ServBay, як правило, встановлено за замовчуванням).
   • Вибрані бази даних (MySQL, PostgreSQL) та кеш-сервіси (Memcached, Redis). Активуйте их через панель керування ServBay.

Створення проєкту Zend Framework

ServBay рекомендує зберігати всі сайти у спеціальній папці, що спрощує автоматичне керування сайтами:

• macOS: /Applications/ServBay/www
• Windows: C:\ServBay\www

1. Перейти до папки сайту

   Відкрийте термінал та перейдіть у рекомендовану папку:

   macOS:

   cd /Applications/ServBay/www

   Windows:

   cd C:\ServBay\www

2. Створити проєкт через Composer

   Composer вже інтегровано у ServBay. Використайте команду create-project, щоб створити новий skeleton-app для Zend Framework (Laminas):

   composer create-project laminas/laminas-skeleton-application servbay-zend-app

   Після виконання команди у теці servbay-zend-app з’явиться базовий проєкт.

3. Перейти до проєкту

   cd servbay-zend-app

Налаштування веб-сервера

Щоб отримати доступ до проєкту через браузер, потрібно налаштувати сайт у ServBay.

1. Відкрити панель керування ServBay: Запустіть програму ServBay.
2. Перейти до розділу "Сайти": Виберіть вкладку Websites (Сайти).
3. Додати новий сайт: Натисніть кнопку + знизу, щоб додати новий сайт.
4. Заповнити дані:
   • Назва (Name): Задайте впізнаване ім’я (наприклад, My Zend Dev Site).
   • Домен (Domain): Введіть бажаний домен з закінченням .local або .test (наприклад, servbay-zend-test.local) для локальної роботи. ServBay автоматично зробить DNS-відображення.
   • Тип сайту (Website Type): Оберіть PHP.
   • Версія PHP (PHP Version): Вкажіть потрібну версію PHP (наприклад, 8.3). Переконайтесь, що вона встановлена та активна.
   • Корінь сайту (Document Root): Вкажіть папку public у вашому проєкті: /Applications/ServBay/www/servbay-zend-app/public.
5. Зберегти та перезапустити: Натисніть Save (Зберегти). ServBay застосує зміни та оновить конфігурацію сервера.

Детальну інструкцію дивіться у розділі Додавання першого сайту документації ServBay.

Базовий приклад "Hello ServBay!"

Зараз ми змінимо код так, щоб на головній сторінці відображалось "Hello ServBay!".

1. Налаштування маршруту та контролера (module.config.php)

   Відредагуйте module/Application/config/module.config.php і переконайтесь, що налаштування маршрутизації містить базові налаштування:

   // ... інші use
   // ... інший код
   // ... інші маршрути
   // ... налаштування контролерів
   // ... конфігурація шаблонів
   
   // Коментарі українською:
   // ... інші налаштування

   Зверніть увагу: Фрагмент коду — це частина module.config.php. Об’єднайте його з вже існуючим масивом конфігурації. Переконайтесь, що маршрут 'home' і фабрика для Controller\IndexController::class прописані.

2. Створити/редагувати контролер (IndexController.php)

   У файлі module/Application/src/Controller/IndexController.php:

   <?php
   // Дія indexAction повертає ViewModel з текстом привітання
   // ... інші use
   
   class IndexController extends AbstractActionController
   {
       /**
        * Дія за замовчуванням, показує головну сторінку.
        */
       public function indexAction()
       {
           // Повертаємо ViewModel з передачею змінної 'message' у шаблон
           return new ViewModel([
               'message' => 'Hello ServBay!',
           ]);
       }
   
       // ... інші дії
   }

3. Створити/редагувати файл шаблону (index.phtml)

   У module/Application/view/application/index/index.phtml:

   <h1><?php echo $this->message; ?></h1>

   Використовуйте $this->message для доступу до даних, які передані з контролера.

Відкриття сайту у браузері

Відкрийте браузер і перейдіть за адресою, яку ви налаштували (наприклад, https://servbay-zend-test.local). Якщо все налаштовано коректно, побачите напис Hello ServBay!, що означає успішний запуск.

Приклади інтеграції з базами даних та кешем

ServBay підтримує різні бази даних і кеш-сервіси. Нижче наведено приклади підключення і роботи з Memcached, Redis, MySQL та PostgreSQL у проєкті Zend Framework.

Важливо: Це приклади для ознайомлення. Зазвичай обирається одна база даних та один (або більше) кеш, а підключення реалізується через dependency injection. Для запуску прикладів активуйте відповідні сервіси у ServBay.

Приклад взаємодії з базою даних — створення таблиці

На цьому етапі покажемо як створити таблицю через компонент Laminas DB.

1. Встановити компонент Laminas DB

   У кореневій папці проєкту:

   composer require laminas/laminas-db

2. Створити базу даних вручну

   Перед роботою з базою даних створіть базу servbay_zend_app в обраному сервісі (MySQL/PostgreSQL). Використайте ServBay для запуску phpMyAdmin, pgAdmin, MongoDB Compass тощо. Стандартні логін та пароль у ServBay: root / password.

3. Створити скрипт для створення таблиці (create_users_table.php)

   <?php
   // ukrainian: Створення адаптера підключення до бази даних (MySQL/MariaDB)
   // Вказати параметри підключення до ServBay
   // ...
   // ukrainian: Визначення та виконання SQL для створення таблиці
   // ...
   // ukrainian: Вивести результат створення таблиці

   Запустіть цей скрипт через PHP CLI:

   php create_users_table.php

MySQL: Робота з базою

Підключення та запит даних із MySQL у контролері Zend Framework.

1. Налаштувати підключення до бази

   У config/autoload/global.php:

   <?php
   // ukrainian: Конфігурація для MySQL у ServBay
   return [
       'db' => [
           'driver' => 'Pdo_Mysql',
           'database' => 'servbay_zend_app', // база повинна існувати
           'username' => 'root', // логін за замовчуванням
           'password' => 'password', // пароль за замовчуванням
           'hostname' => '127.0.0.1',
           'port' => 3306,
           'charset' => 'utf8mb4',
       ],
       // ... інші налаштування
   ];

2. Налаштувати фабрику контролера (module.config.php)

   Внесіть зміни для впровадження Adapter у контролер:

   <?php
   // ukrainian: Фабрика контролера для інʼєкції адаптера бази даних
   // ... інші налаштування

   Примітка: Об’єднайте цю частину з існуючою конфігурацією.

3. Додати маршрути для MySQL-прикладу

   <?php
   // ukrainian: Нові маршрути для додавання та перегляду користувачів через MySQL

   Додайте ці маршрути у масив 'routes'.

4. Методи контролера для роботи з MySQL

   Додайте конструктор та дії до IndexController.php:

   <?php
   // ukrainian: Конструктор та дії для роботи з MySQL
   // Додавання користувача та вивід списку у JSON

5. Створити шаблони перегляду

   module/Application/view/application/index/mysql-add.phtml:

   <h1><?php echo $this->message; ?></h1>

   module/Application/view/application/index/mysql.phtml:

   <h1>MySQL Users</h1>
   <pre><?php echo $this->users; ?></pre>

6. Тест

   Перейдіть на https://servbay-zend-test.local/mysql-add для додавання тестового користувача й на https://servbay-zend-test.local/mysql для перегляду всіх користувачів.

PostgreSQL: Робота з базою

Аналогічно до MySQL, тільки параметри підключення змінюються.

1. Налаштувати підключення

   config/autoload/global.php:

   <?php
   // ukrainian: Конфігурація для PostgreSQL у ServBay
   return [
       'db' => [
           'driver' => 'Pdo_Pgsql',
           'database' => 'servbay_zend_app',
           'username' => 'root',
           'password' => 'password',
           'hostname' => '127.0.0.1',
           'port' => 5432,
       ],
       // ... інші налаштування
   ];

2. Інʼєкція адаптера і фабрика (фабрика контролера, як для MySQL)

3. Нові маршрути для PostgreSQL

   <?php
   // ukrainian: Додавання маршрутів для роботи з PostgreSQL

4. Методи контролера для PostgreSQL

   Додайте методи pgsqlAddAction і pgsqlAction до контролера:

   <?php
   // ukrainian: Методи додавання користувача та перегляду списку у PostgreSQL

5. Створити шаблони

   module/Application/view/application/index/pgsql-add.phtml:

   <h1><?php echo $this->message; ?></h1>

   module/Application/view/application/index/pgsql.phtml:

   <h1>PostgreSQL Users</h1>
   <pre><?php echo $this->users; ?></pre>

6. Тест

   Перейдіть на https://servbay-zend-test.local/pgsql-add та https://servbay-zend-test.local/pgsql.

Інтеграція Memcached

Приклад використання Memcached для кешування у контролері.

1. Встановити адаптер Memcached

   У composer.json додайте:

   // require: "laminas/laminas-cache-storage-adapter-memcached": "^2.0"

   Виконайте:

   composer update

   (расширення memcached вже доступне у ServBay.)

2. Маршрут для Memcached

   <?php
   // ukrainian: Додаємо маршрут для Memcached

3. Метод контролера

   Додайте метод memcachedAction у контролер:

   <?php
   // ukrainian: Метод роботи з Memcached
   // Створення кешу, отримання даних та маркування CACHE MISS/HIT

4. Шаблон перегляду

   module/Application/view/application/index/memcached.phtml:

   <h1>Memcached Example</h1>
   <p><?php echo $this->message; ?></p>

5. Тест

   Перейдіть на https://servbay-zend-test.local/memcached.

Інтеграція Redis

Аналогічно Memcached, але для Redis.

1. Встановити адаптер Redis

   У composer.json додайте:

   // require: "laminas/laminas-cache-storage-adapter-redis": "^2.0", "ext-redis": "*"

   Виконайте:

   composer update

   (расширення redis вже доступне у ServBay.)

2. Маршрут для Redis

   <?php
   // ukrainian: Додаємо маршрут для Redis

3. Метод контролера

   Додайте метод redisAction:

   <?php
   // ukrainian: Метод роботи з Redis
   // Створення кешу, отримання даних та маркування CACHE MISS/HIT

4. Шаблон перегляду

   module/Application/view/application/index/redis.phtml:

   <h1>Redis Example</h1>
   <p><?php echo $this->message; ?></p>

5. Тест

   Перейдіть на https://servbay-zend-test.local/redis.

Висновок

Виконавши ці кроки, ви створили, налаштували та запустили Zend Framework (Laminas) проєкт у ServBay. Ви навчилися конфігурувати сайт, налаштовувати веб-сервер для роботи з публічною папкою, інтегрувати та використовувати MySQL, PostgreSQL, Memcached і Redis.

ServBay спрощує розгортання локального середовища розробки, даючи змогу зосередитись на коді й швидко тестувати зміни у проєкті. Завдяки багатому набору пакетів і гнучкій конфігурації, ServBay дозволяє моделювати реальні середовища і значно підвищити вашу продуктивність.