Створення та запуск проєкту FacturaScripts у ServBay

FacturaScripts — це потужне і гнучке open-source рішення для ERP (планування ресурсів підприємства) та CRM (керування взаєминами з клієнтами), ідеально підходить для малого та середнього бізнесу, а також фрілансерів. Завдяки зручному інтерфейсу локального веб-середовища розробки ServBay, ви легко зможете створити, протестувати та запустити проєкт FacturaScripts на macOS — без складних налаштувань і ручної конфігурації.

Цей гайд детально проведе вас через увесь процес локального встановлення та налаштування FacturaScripts у ServBay.

Огляд FacturaScripts

FacturaScripts — це відкрите програмне забезпечення для ERP і CRM, розроблене на PHP та Bootstrap. Його основне призначення — допомогти компаніям керувати ключовими бізнес-процесами, серед яких:

• Виставлення та облік рахунків-фактур
• Бухгалтерський облік
• Контроль складів і запасів
• Управління клієнтами та постачальниками
• Управління проєктами
• А ще більше — завдяки модулям та плагінам...

Як активний open-source проєкт, FacturaScripts має потужну спільноту підтримки та дозволяє розширювати можливості системи завдяки плагінам і кастомізації під різні бізнес-потреби.

Основні можливості та переваги FacturaScripts

• Відкрите ПЗ та безкоштовність: Не потрібно платити дорогі ліцензії — повна свобода використання, модифікації та розповсюдження.
• Функціональна повнота: Включає майже всі ключові інструменти для щоденної роботи малого та середнього бізнесу — універсальне рішення під одним дахом.
• Зручний інтерфейс: Інтуїтивний і простий у використанні, не вимагає тривалого навчання.
• Висока розширюваність: Великий маркет плагінів і відкритий API — легко додати нову функцію чи інтегрувати зовнішній сервіс.
• Доступ з будь-якої платформи: Веб-орієнтована система працює у сучасному браузері на будь-якому пристрої.
• Активна спільнота: На вас чекає підтримка від розробників з усього світу.
• Багатомовність: Підтримується кілька мов для зручності користувачів із різних регіонів.

Переваги запуску FacturaScripts у ServBay

ServBay — це локальне середовище розробки, створене для розробників. Воно ідеально підходить для запуску PHP-додатків, таких як FacturaScripts. У складі: Apache/Nginx веб-сервери, підтримка різних версій PHP, MySQL/MariaDB/PostgreSQL, Redis й інші потрібні сервіси — усе управляється через зручний графічний інтерфейс.

Запуск FacturaScripts у ServBay забезпечує:

• Інтегроване середовище: Усі головні компоненти (веб-сервер, PHP, база даних) вже налаштовані — не потрібно окремо встановлювати й конфігурувати кожну частину.
• Керування версіями: Можливість швидкого перемикання версій PHP, щоби тестувати сумісність чи працювати з різними релізами FacturaScripts.
• Адміністрування бази даних: Вбудовано phpMyAdmin або Adminer для створення/керування базами й користувачами FacturaScripts.
• Просте налаштування сайту: Візуальний інтерфейс для створення нового локального сайту, вибору домену, директорії, сервера та версії PHP.
• Автоматизація hosts: ServBay автоматично керує локальним hosts-файлом — ви можете відкривати сайт за власним доменом (наприклад, facturascripts.servbay.demo).
• Підтримка SSL: Швидка організація HTTPS завдяки вбудованому User CA чи загальнодоступному ACME-сертифікату — як у продакшн-оточенні!

Основні етапи запуску FacturaScripts у ServBay:

1. Завантаження вихідного коду FacturaScripts.
2. Створення папки проєкту у корені локальних сайтів ServBay.
3. Створення бази даних і користувача MySQL під цей проєкт.
4. Налаштування потрібного веб-сервера (Apache або Nginx) через ServBay.
5. Перевірка та вмикання необхідних розширень PHP.
6. Доступ до локального домену через браузер і завантаження майстра встановлення FacturaScripts.

Вимоги до оточення

Перед початком роботи переконайтесь, що:

• Ви вже встановили, завантажили та запустили ServBay на macOS. Останню версію дивіться на офіційному сайті ServBay.
• Основні сервіси ServBay (вибраний вами веб-сервер: Apache чи Nginx; потрібна версія PHP; база даних MySQL або MariaDB) увімкнені та запущені.
• Ви маєте базові знання про веб-розробку й роботу з базами даних.

Створення проєкту FacturaScripts (на основі ZIP архіву)

Цей спосіб є найпростішим і найпоширенішим для локального встановлення FacturaScripts.

1. Завантаження FacturaScripts:

   • Перейдіть на офіційний сайт FacturaScripts: https://facturascripts.com/descargar.
   • Знайдіть останній стабільний .zip-архів й завантажте його на свій Mac.

2. Створення директорії для проєкту:

   • Відкрийте Finder і перейдіть у корінь папки локальних сайтів ServBay. За замовчуванням і рекомендовано використовувати /Applications/ServBay/www/.
   • Створіть там нову папку для вашого проєкту, наприклад, facturascripts_project.
   • Приклад повного шляху: /Applications/ServBay/www/facturascripts_project

3. Розпакування архіву:

   • Відкрийте завантажений архів FacturaScripts (.zip) подвійним кліком для розпакування.
   • Усі отримані файли та папки (наприклад, index.php, Core, Dinamic, Plugins тощо) скопіюйте чи перемістіть у папку /Applications/ServBay/www/facturascripts_project.

Початкове налаштування (База даних MySQL тощо)

FacturaScripts потребує базу даних для збереження всієї бізнес-інформації: користувачів, налаштувань і т.ін. Ми використовуємо MySQL або MariaDB під керуванням ServBay.

1. Перевірка запуску бази даних:

   • Запустіть додаток ServBay.
   • У меню зліва відкрийте “Пакети” (Packages) — виберіть “MySQL” або “MariaDB” (ту СУБД, яку плануєте використовувати).
   • Переконайтесь, що обраний сервіс увімкнено. Якщо ні — натисніть на перемикач, щоб увімкнути.

2. Створення бази даних і користувача:

   • Використовуйте вбудовані інструменти адміністрування (наприклад, phpMyAdmin), або командний рядок (доступно з меню ServBay). Для початківців рекомендується phpMyAdmin.
   • Через phpMyAdmin (рекомендовано):
     • У ServBay знайдіть розділ “База даних”, натисніть іконку phpMyAdmin біля вашої СУБД (MySQL або MariaDB). У браузері відкриється сторінка логіну.
     • Увійдіть у phpMyAdmin. За замовчуванням використовуйте логін root та пароль, який ви задали під час початкового налаштування ServBay. Якщо пароль втрачено — скористайтеся опцією відновлення у деталях пакета бази даних у ServBay.
     • Далі перейдіть на вкладку “Бази даних”.
     • У полі для створення нової бази впишіть ім'я, наприклад facturascripts_servbay_db.
     • Оберіть кодування: рекомендується utf8mb4_general_ci або utf8mb4_unicode_ci — вони найкраще підтримують різні символи та емодзі.
     • Натисніть “Створити”.
     • Створення користувача БД (опціонально, але рекомендовано!): Щоб підвищити безпеку, створіть окремого користувача лише для FacturaScripts (без використання root).
       • Перейдіть на вкладку “Облікові записи користувачів” (User Accounts).
       • Натисніть "Додати обліковий запис".
       • Введіть логін, наприклад facturascripts_servbay_user.
       • В полі “Сервер/Host” оберіть localhost або 127.0.0.1 (тільки локальне підключення).
       • Вигадайте й обов’язково запишіть складний пароль для цього користувача.
       • Під випадаючим списком можна обрати — створити БД з іменем користувача й призначити всі права, або призначити всі права на вже створену базу даних (facturascripts_servbay_db).
       • Натисніть "ОК"/"Виконати" для підтвердження.

3. Запишіть дані для підключення до БД: На етапі встановлення FacturaScripts знадобиться така інформація:

   • Ім’я бази даних (наприклад facturascripts_servbay_db).
   • Ім’я користувача (наприклад facturascripts_servbay_user).
   • Пароль облікового запису.
   • Сервер БД (localhost чи 127.0.0.1).
   • Порт БД (здебільшого 3306, актуальний можна перевірити у ServBay).

Налаштування веб-сервера (Apache або Nginx)

Тепер потрібно повідомити ServBay, як ваш веб-сервер (Apache або Nginx) отримуватиме доступ до файлів FacturaScripts. ServBay підтримує обидва сервери.

1. Перевірте, що веб-сервер увімкнено:

   • У “Пакетах” (Packages) переконайтесь, що обраний сервер (Apache або Nginx) запущено.

2. Додаємо сайт:

   • Виберіть у лівому меню “Сайти” (Sites).
   • Натисніть кнопку “+” праворуч у списку сайтів, щоб додати новий.
   • У вікні налаштувань заповніть:
     • Назва (Name): Наприклад, FacturaScripts Demo Site.
     • Домен (Domain): Оберіть домен для локального доступу, наприклад, facturascripts.servbay.demo (ServBay рекомендує використовувати постфікс .servbay.demo для локальних сайтів).
     • Тип сайту (Website Type): PHP.
     • Коренева директорія (Root Directory): Вкажіть шлях до папки, куди ви розпакували FacturaScripts (/Applications/ServBay/www/facturascripts_project). Примітка: Для FacturaScripts зазвичай коренева директорія — це корінь проєкту, дочірній піддиректорій не потрібний. Перевірте це у документації FacturaScripts.
     • Версія PHP (PHP Version): Виберіть сумісну версію PHP згідно з офіційною документацією FacturaScripts (найчастіше це PHP 8.1, 8.2 або новіше). ServBay дозволяє легко перемикати версії.
     • Інші налаштування: За замовчуванням достатньо. За бажанням — підключити SSL (User CA або ACME), налаштувати CORS тощо.

3. Збережіть і оновіть hosts:

   • Натисніть “Додати” чи “Зберегти” внизу вікна.
   • ServBay автоматично налаштує Virtual Host (Apache) чи Server Block (Nginx). Також система запросить права адміністратора для оновлення системного hosts-файлу: це потрібно, щоби домен (facturascripts.servbay.demo) відкривався локально і відповідав на 127.0.0.1. Вам нічого не треба редагувати вручну!

4. Перевірте й увімкніть розширення PHP:

   • Для коректної роботи FacturaScripts можуть знадобитися додаткові PHP-розширення — наприклад, pdo_mysql, gd (графіка), intl (локалізація), zip (архівування), xml, curl (запити в інтернет) тощо. Багато розширень у ServBay вже активовано за замовчуванням, але якщо майстер встановлення попереджає про відсутність — розширення треба вручну увімкнути.
   • Як увімкнути потрібні розширення:
     • Перейдіть у меню “Мови” (Languages) — “PHP”.
     • Виберіть саме ту версію PHP, що призначена вашому сайту.
     • На сторінці версії PHP відкрийте вкладку “Розширення” (Extensions).
     • Знайдіть потрібне розширення, поставте галочку та натисніть “Застосувати” або “Зберегти”.
     • Для деяких змін може знадобитися перезапуск PHP-сервісу. Просто натисніть “Перезапустити” біля потрібної версії PHP.

Приклад інтерфейсу налаштування сайту в ServBay

Доступ до сайту та майстер встановлення FacturaScripts

Тепер усе готово для онлайн-встановлення FacturaScripts у вашому середовищі ServBay.

1. Запустіть браузер: Відкрийте ваш звичний браузер (Chrome, Firefox, Safari тощо).

2. Перейдіть за адресою: В адресному рядку введіть локальний домен, наприклад http://facturascripts.servbay.demo. Якщо ви активували SSL через ServBay, можна пробувати https://facturascripts.servbay.demo. Натисніть Enter.

3. Майстер встановлення FacturaScripts:

   • Якщо сайт налаштовано вірно (конфіг хоста, веб-сервер і PHP працюють) — з’явиться вітальна сторінка або вікно майстра встановлення FacturaScripts.
   • Вибір мови: Спершу задайте бажану мову інтерфейсу.
   • Системна перевірка: Інсталятор автоматично перевірить відповідність версії PHP, наявність необхідних розширень, правильність прав на папки тощо. Якщо всі налаштування ServBay коректні й розширення доступні — ви побачите зелену "галочку успіху". Якщо трапляються червоні чи жовті повідомлення — перевірте версію PHP, активність розширень та права доступу до папки проєкту.
   • Налаштування БД: Це ключовий етап! Введіть дані, що ви створили раніше:
     • Тип бази даних: MySQL
     • Хост: localhost або 127.0.0.1
     • Порт: 3306 (чи інший, якщо змінено у ServBay)
     • Ім'я БД: facturascripts_servbay_db
     • Логін: facturascripts_servbay_user
     • Пароль: ваш пароль до цього облікового запису
     • Префікс для таблиць: залиште fs_ або відредагуйте
   • Аккаунт адміністратора: Вкажіть логін, пароль і e-mail адміністратора для бек-офісу FacturaScripts. Придумайте надійний пароль — це основні дані для подальшого входу!
   • Інсталяція: Переконавшись у правильності введених даних, натисніть “Встановити”. Програма створить структуру БД, таблиці, налаштує конфігураційні файли.

4. Завершення установки:

   • За успішної інсталяції майстер може запропонувати видалити теку install у корені проєкту — зробіть це, якщо з'явився відповідний запит.
   • Тепер ви можете заходити на сайт за адресою http://facturascripts.servbay.demo (або через HTTPS) — використовуйте щойно створений адмін-акаунт для входу і починайте працювати з FacturaScripts!

Часті запитання (FAQ)

• Питання: Майстер встановлення FacturaScripts скаржиться на відсутність PHP-розширень. Що робити?
  • Відкрийте ServBay, оберіть у меню “Мови” → “PHP”, знайдіть потрібну версію PHP, далі вкладка “Розширення”. Активуйте необхідне розширення (наприклад, opcache), натисніть "Зберегти/Застосувати", перезапустіть службу PHP.
• Питання: Чому при відкритті facturascripts.servbay.demo з’являється "Forbidden" чи порожня сторінка?
  • Перевірте, чи працюють веб-сервер й PHP-сервіси у ServBay, чи вірно вказано “Коренева директорія” у налаштуваннях сайту. Порожня сторінка часто вказує на помилку PHP — перевірте логи ServBay (PHP/Web server error log). "Forbidden" зазвичай означає некоректні права доступу: дайте права на читання проекту та запис до папок на кшталт Dinamic для користувача, під яким працює веб-сервер ServBay.
• Питання: Чому FacturaScripts не може підключитись до бази даних?
  • Переконайтесь, що пакет MySQL/MariaDB у ServBay запущено й його порт співпадає з тим, що ви вказуєте (типово 3306). Звіртеся із налаштуваннями у майстрі — логін, пароль, ім’я БД, хост і порт мають відповідати даним у ServBay.

Висновок

Завдяки функціональному та зручному локальному середовищу ServBay встановлення й запуск FacturaScripts на macOS стає простим і швидким. ServBay містить усі залежності (веб-сервер, PHP, БД) і значно спрощує налаштування через графічний інтерфейс. Слідуйте цим крокам — і ви дуже швидко створите середовище для розробки або тестування FacturaScripts, щоб сфокусуватися на бізнес-логіці та роботі з можливостями ERP/CRM. Гнучкість і простота ServBay допоможе вам стати ефективнішими у локальній розробці!