Создание и запуск проекта FacturaScripts на ServBay

FacturaScripts — это мощное и гибкое открытое 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:

• Интегрированная среда: ServBay предустанавливает и настраивает все необходимые компоненты (веб-сервер, PHP, БД), избавляя от необходимости ручной установки и сложной настройки каждого из них.
• Управление версиями: Легко переключайтесь между разными версиями PHP для соответствия требованиям FacturaScripts или для тестирования совместимости.
• Управление базой данных: Встроенные инструменты вроде phpMyAdmin или Adminer позволяют быстро создать и управлять базой данных и пользователями для FacturaScripts.
• Упрощенная настройка сайта: С помощью графического интерфейса ServBay можно быстро создать локальный сайт, настроить домен, корневую папку и версию PHP.
• Автоматизация файла Hosts: ServBay автоматически обновляет локальный hosts-файл, позволяя использовать кастомное доменное имя (например, facturascripts.servbay.demo) для доступа к локальному сайту.
• Поддержка SSL: Встроенный CA или публичные ACME-сервисы для настройки SSL/HTTPS — моделирование боевого (production) окружения.

Основные шаги по запуску 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. Распакуйте архив:

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

Начальная настройка (конфигурация базы данных MySQL)

FacturaScripts для хранения данных, пользователей и настроек требует подключения к базе данных. Мы будем использовать управление БД MySQL или MariaDB через ServBay. Эти СУБД полностью поддерживаются ServBay.

1. Убедитесь, что пакет БД работает:

   • Откройте приложение ServBay.
   • В левом меню выберите «Пакеты» — «MySQL» или «MariaDB» (в зависимости от необходимого варианта).
   • Убедитесь, что выбранный пакет запущен. Если не запущен — нажмите тумблер для запуска.

2. Создайте БД и пользователя:

   • Используйте встроенный менеджер БД, например, phpMyAdmin (обычно идет в комплекте с MySQL/MariaDB) или терминал (ServBay предоставляет консольный доступ). Для новичков рекомендуется phpMyAdmin.
   • Использование phpMyAdmin (рекомендуется):
     • В окне ServBay найдите раздел «База данных» и кликните на иконку phpMyAdmin справа от текущего пакета (MySQL/MariaDB) — страница для входа откроется в браузере.
     • Войдите в систему используя логин root и пароль, который вы задали при первичной настройке ServBay. Если забыли — на странице пакета можно сбросить пароль root.
     • После входа перейдите на вкладку «Базы данных».
     • Введите название новой БД (рекомендуем использовать что-то связанное с проектом, например, facturascripts_servbay_db).
     • Выберите соответствующую кодировку — рекомендуется utf8mb4_general_ci или utf8mb4_unicode_ci для поддержки широкого набора символов и эмодзи.
     • Кликните «Создать».
     • Создание пользователя БД (не обязательно, но очень рекомендуется):
       • Перейдите на главную страницу phpMyAdmin и выберите вкладку «Учетные записи пользователей».
       • Нажмите «Добавить пользователя».
       • Укажите имя пользователя (например, facturascripts_servbay_user).
       • В поле «Хозяин» выберите localhost или 127.0.0.1.
       • Придумайте надежный пароль и обязательно сохраните его.
       • Ниже можно сразу выдать все права для новой БД: или выберите «Создать БД с таким же именем и предоставить все права», либо выберите свою БД facturascripts_servbay_db и назначьте права (ALL PRIVILEGES).
       • Нажмите «Продолжить» или «Выполнить» для сохранения.

3. Сохраните данные подключения к БД: На этапе установки FacturaScripts вам потребуется:

   • Имя базы данных (например, facturascripts_servbay_db)
   • Имя пользователя БД (например, facturascripts_servbay_user)
   • Пароль пользователя БД (сохранили на предыдущем шаге)
   • Хост базы данных (обычно localhost или 127.0.0.1)
   • Порт БД (по умолчанию 3306 для MySQL/MariaDB; можно уточнить в ServBay)

Настройка веб-сервера (Apache или Nginx)

Теперь необходимо привязать проект FacturaScripts к веб-серверу (Apache или Nginx) через ServBay. Оба варианта полностью поддерживаются.

1. Убедитесь, что веб-сервер работает:

   • В разделе «Пакеты» левой панели проверьте, что сервер Apache или Nginx запущен.

2. Добавьте сайт:

   • В левом меню ServBay откройте «Сайты» (Site).
   • Кликните по кнопке «+» над списком сайтов для добавления новой конфигурации.
   • В открывшемся окне укажите:
     • Имя (Name): Дайте понятное название сайту, например, FacturaScripts Demo Site.
     • Домен (Domain): Введите желаемое доменное имя для локального сайта, например, facturascripts.servbay.demo (категорически рекомендуется использовать суффикс .servbay.demo).
     • Тип сайта (Website Type): Выберите PHP — это динамический PHP-проект.
     • Корневая директория (Root Directory): Кликните «Обзор»/«Выбрать» и укажите папку, куда распакован FacturaScripts (/Applications/ServBay/www/facturascripts_project).
       Обратите внимание: Для большинства фреймворков корень проекта — основная директория, но для некоторых нужны вложенные папки (например, public или web). Для FacturaScripts обычно достаточно указывать корень проекта.
     • Версия PHP (PHP Version): Выберите подходящую версию PHP, совместимую с вашей сборкой FacturaScripts (рекомендуется PHP 8.1, 8.2 или выше). ServBay поддерживает выбор и смену версий PHP.
     • Прочие настройки: Обычно оставьте по умолчанию. Вы можете при необходимости включить SSL/HTTPS (через User CA ServBay или ACME), CORS и пр.

3. Сохраните настройки и обновите Hosts:

   • Заполнив форму, нажмите «Добавить» или «Сохранить».
   • ServBay автоматически создаст виртуальный хост на выбранном сервере и предложит административный доступ для изменения системного файла hosts. Это добавит соответствующую запись для вашего домена (facturascripts.servbay.demo → 127.0.0.1), что позволит открывать сайт по имени в браузере, не редактируя hosts вручную.

4. Проверьте и включите нужные расширения PHP:

   • Для стабильной работы FacturaScripts могут понадобиться определённые PHP-расширения, например: pdo_mysql, gd (обработка изображений), intl (международнизация), zip (архивирование), xml, curl (сетевые запросы) и т.д. ServBay по умолчанию включает большинство популярных расширений, но если веб-приложение запросит дополнительные — их можно включить вручную.
   • Включение расширений в ServBay:
     • В меню слева выберите «Языки» — «PHP».
     • Выберите ту версию PHP, которая используется вашим сайтом (facturascripts.servbay.demo).
     • Откройте вкладку «Расширения».
     • В списке найдите необходимое расширение (например, opcache), отметьте чекбокс слева.
     • Нажмите «Применить»/«Сохранить» внизу. Для ряда расширений потребуется перезапустить PHP-сервис — это можно сделать в меню «Языки» — «PHP», кнопка «Перезапустить» рядом с нужной версией.

Пример интерфейса настроек сайта в ServBay

Доступ к сайту и мастер установки FacturaScripts

Ваша среда готова к запуску онлайн-установщика FacturaScripts.

1. Откройте браузер: Запустите привычный браузер (Chrome, Firefox, Safari и др.).

2. Введите адрес: В адресную строку введите домен, указанный при конфигурации, например, http://facturascripts.servbay.demo. Если сайт настроен с SSL (через ServBay CA или ACME), используйте https://facturascripts.servbay.demo. Нажмите Enter.

3. Мастер установки FacturaScripts:

   • При корректной настройке сайтов, файла hosts, запуске веб-сервера и PHP в браузере появится приветственная страница или мастер установки FacturaScripts.
   • Выбор языка: Выберите язык интерфейса.
   • Проверка системы: Программа автоматически проверит PHP-окружение (версия, необходимые расширения, права на запись и пр.). При правильных настройках все пункты будут отмечены зелёным. Если есть ошибки или предупреждения — убедитесь, что версия PHP и расширения соответствуют требованиям, а директории проекта (/Applications/ServBay/www/facturascripts_project) доступны на запись для пользователя веб-сервера.
   • Настройка БД:
     Введите информацию о БД, которую вы создали:
     • Тип БД: Выберите MySQL.
     • Хост: localhost или 127.0.0.1.
     • Порт: 3306 (или порт, показанный в ServBay).
     • Имя БД: facturascripts_servbay_db.
     • Пользователь: facturascripts_servbay_user.
     • Пароль: соответствующий пароль.
     • Префикс таблиц: Можно оставить по умолчанию fs_ либо установить свой.
   • Учетная запись администратора:
     Задайте имя пользователя, пароль и email администратора FacturaScripts. Пароль должен быть надёжным, сохраните эти данные — они потребуются для входа в админку.
   • Установка: После проверки всех данных нажмите кнопку установки. FacturaScripts подключится к БД, создаст таблицы и запишет настройки.

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

   • Если всё прошло успешно, мастер установки может предложить удалить каталог install в корне проекта. Обязательно выполните это для безопасности.
   • Теперь сайт будет открыт по адресу http://facturascripts.servbay.demo (или HTTPS). Войдите в админку под своими данными администратора и начните работу с FacturaScripts!

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

• Вопрос: Мастер установки FacturaScripts пишет о недостающих PHP-расширениях?
  • Откройте ServBay, выберите «Языки» — «PHP», перейдите на вкладку расширений и отметьте недостающие расширения (например, opcache). Нажмите «Применить» и перезапустите PHP-сервис.
• Вопрос: При переходе на facturascripts.servbay.demo отображается Forbidden или пустая страница?
  • Проверьте, запущены ли веб-сервер (Apache/Nginx) и PHP в ServBay. Убедитесь, что корень сайта в настройках указывает на папку проекта (/Applications/ServBay/www/facturascripts_project).
    Пустая страница может свидетельствовать о PHP-ошибке — смотрите логи веб-сервера или PHP.
    Forbidden — скорее всего, проблема с правами на файлы и папки: предоставьте разрешения пользователю веб-сервера на чтение и запись в каталогах проекта, особенно в Dinamic и похожих.
• Вопрос: Не удается подключиться к базе данных FacturaScripts?
  • Проверьте, запущен ли MySQL/MariaDB в ServBay и используете ли правильный порт (3306 по умолчанию). Проверьте корректность данных подключения (хост, порт, имя БД, пользователь, пароль) в мастере установки FacturaScripts.

Заключение

С помощью мощной среды локальной разработки ServBay процесс установки и запуска FacturaScripts на macOS становится быстрым и простым. ServBay позволяет автоматически установить все зависимости (веб-сервер, PHP, база данных) и упростить настройку через удобный интерфейс. Следуя шагам этого руководства, вы сможете легко развернуть локальное тестовое или рабочее окружение FacturaScripts и сосредоточиться непосредственно на бизнес-процессах и возможностях самой системы. Гибкость и удобство ServBay значительно ускоряют и облегчают разработку локальных проектов.