Встановлення та налаштування Bagisto (Laravel)

Bagisto — потужна e-commerce платформа на Laravel, але її встановлення часто супроводжується помилками через невідповідність версій PHP або конфігурації оточення. Ми розберемо покроково, як уникнути типових проблем та налаштувати магазин під ключ. Наша команда має 5 років досвіду в Laravel та понад 50 успішних проєктів e-commerce. Експертиза — понад 5 років.

Які вимоги до сервера для Bagisto?

Перед встановленням переконайтеся, що сервер відповідає мінімальним вимогам. Bagisto працює на LEMP-стеці (Linux, Nginx, MySQL/MariaDB, PHP). Розглянемо кожен етап детально. Ми пропонуємо встановлення Bagisto під ключ — від вибору хостингу до фінального тестування. Оцініть ваш проєкт безкоштовно — вартість робіт від $500 до $2000 залежно від складності. Ви отримуєте готовий інтернет-магазин з налаштованими каналами, методами оплати та доставки, а також документацію з експлуатації. Гарантуємо, що магазин буде працювати стабільно при очікуваному навантаженні. Всі роботи виконуються в обумовлені терміни. Встановлення займає від 2 до 5 робочих днів залежно від складності кастомізації.

Особливості встановлення Bagisto

Bagisto використовує сучасний стек: Laravel 11, Vue 3, Redis. Це дає гнучкість кастомізації та високу продуктивність. Наприклад, Bagisto працює в 2-3 рази швидше за Magento при однаковому навантаженні. Використання Redis замість файлового кешу прискорює роботу черг у 5-10 разів. Типові помилки встановлення: несумісність версій PHP (потрібен 8.1+), відсутність розширень, неправильне налаштування черг, проблеми з правами доступу. Ми підготували інструкцію, яка допоможе все налаштувати коректно.

Вимоги до сервера

Розширення PHP: BCMath, Ctype, cURL, DOM, Fileinfo, JSON, Mbstring, OpenSSL, PCRE, PDO, Tokenizer, XML, GD або Imagick.

Важливо: Починаючи з етапу встановлення налаштуйте Redis для кешу та черг.

Встановлення через Composer (крок 1)

composer create-project bagisto/bagisto:^2.2 myshop cd myshop cp .env.example .env 

Редагування .env (крок 2)

APP_URL=http://localhost DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=bagisto DB_USERNAME=bagisto_user DB_PASSWORD=secret CACHE_DRIVER=redis QUEUE_CONNECTION=redis SESSION_DRIVER=redis REDIS_HOST=127.0.0.1 REDIS_PORT=6379 

Запуск встановлювача (крок 3)

php artisan bagisto:install 

Команда виконує міграції, сідери, публікує асети та створює першого адміністратора. Після — збирання фронтенду:

npm install npm run build 

Налаштування Nginx (крок 4)

server { listen 80; server_name myshop.example.com; root /var/www/myshop/public; index index.php; add_header X-Frame-Options "SAMEORIGIN"; add_header X-Content-Type-Options "nosniff"; charset utf-8; location / { try_files $uri $uri/ /index.php?$query_string; } location = /favicon.ico { access_log off; log_not_found off; } location = /robots.txt { access_log off; log_not_found off; } error_page 404 /index.php; location ~ \.php$ { fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.(?!well-known).* { deny all; } } 

Після налаштування SSL через Certbot: certbot --nginx -d myshop.example.com.

Як налаштувати черги за допомогою Supervisor?

Bagisto активно використовує черги для відправлення листів, генерації інвойсів та webhook-сповіщень. Конфігурація Supervisor:

[program:bagisto-worker] process_name=%(program_name)s_%(process_num)02d command=php /var/www/myshop/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600 autostart=true autorestart=true stopasgroup=true killasgroup=true user=www-data numprocs=2 redirect_stderr=true stdout_logfile=/var/www/myshop/storage/logs/worker.log stopwaitsecs=3600 

supervisorctl reread supervisorctl update supervisorctl start bagisto-worker:* 

Первинна конфігурація в панелі адміністратора

Після входу по /admin налаштовуються:

Налаштування каналів Bagisto

Канал — це окрема "вітрина" магазину з власним доменом, валютою та мовою. Для багатомовного магазину створюється один канал з кількома локалями.

Податки

Каталог → Податки → Податкові категорії — створюємо категорії (наприклад, ПДВ 20%). Потім прив'язуємо до груп платників податків та регіонів через Податкові ставки.

Методи доставки

Вбудовані: FlatRate, Free Shipping. Для СДЕК чи Укрпошти потрібен пакет або кастомний провайдер — підключається в config/carriers.php.

Методи оплати

Вбудовані: Cash On Delivery, Money Transfer, PayPal. Кастомні шлюзи реєструються в config/paymentmethods.php та реалізують інтерфейс Webkul\Payment\Payment. Наприклад, для інтеграції з ПриватБанком створюється новий клас.

Налаштування пошти

MAIL_MAILER=smtp MAIL_HOST=localhost MAIL_PORT=587 [email protected] MAIL_PASSWORD=secret MAIL_ENCRYPTION=tls [email protected] MAIL_FROM_NAME="Мій Магазин" 

Шаблони листів публікуються командою:

php artisan vendor:publish --tag=bagisto-mail-views 

Після — редагуються в resources/views/vendor/shop/emails/.

Фінальні налаштування

Крон для планувальника

* * * * * cd /var/www/myshop && php artisan schedule:run >> /dev/null 2>&1 

Планувальник відповідає за очищення кошиків, генерацію sitemap та оновлення курсів валют (якщо підключений провайдер).

Права на директорії

chmod -R 775 storage bootstrap/cache chown -R www-data:www-data /var/www/myshop 

Що входить у налаштування Bagisto під ключ?

Після встановлення — чекліст

• [ ] Перевірити php artisan config:cache && php artisan route:cache
• [ ] Налаштувати резервне копіювання БД (cron + mysqldump або spatie/laravel-backup)
• [ ] Встановити Redis та перевірити підключення через php artisan tinker → Redis::ping()
• [ ] Перевірити відправлення пошти через тестове замовлення
• [ ] Налаштувати моніторинг черг — Laravel Horizon (composer require laravel/horizon)
• [ ] Перевірити генерацію sitemap за адресою /sitemap.xml

Додаткові рекомендації

Для підвищення продуктивності використовуйте Redis для кешу та черг. Налаштуйте моніторинг через Laravel Horizon. Докладніше: Laravel Queues documentation.

Якщо виникли помилки: перевірте .env при помилці підключення до БД, оновіть версію PHP при помилці composer, запустіть npm install && npm run build, якщо не завантажуються асети.

Якщо вам потрібне встановлення Bagisto під ключ з гарантією та підтримкою — зв'яжіться з нами для розрахунку термінів та вартості. Оцінимо ваш проєкт безкоштовно. Економія до 30% порівняно з Magento, а встановлення займає вдвічі менше часу.

Приклад налаштування черг Laravel: вказано вище у конфігурації Supervisor.

Ключові фрази: встановлення Bagisto, налаштування Bagisto, конфігурація Bagisto, LEMP стек Bagisto, встановлення e-commerce платформи, черги Bagisto, налаштування каналів Bagisto.