Shopper is a Laravel package and shares the same server requirements as Laravel itself. To manipulate images (resize, crop, etc), you will also need the GD Library or ImageMagick.
Server Requirements
- PHP 8.3+
- MySQL 8+ / MariaDB 10.2+ / PostgreSQL 15+
PHP Extensions
The following PHP extensions are required:
| Extension | Purpose |
|---|
intl | Currency formatting, locale support, and internationalization |
gd or imagick | Image manipulation for product, category, and brand media |
soap | Carrier API calls (UPS, FedEx, USPS) for shipping rate calculation |
Most PHP installations include intl and gd by default. The soap extension may need to be installed separately depending on your hosting environment.
Package Requirements
| Package | Version |
|---|
| Laravel | 11.28+ / 12.x / 13.x |
| Filament | 4.9+ |
Development Environments
Laravel Herd
Laravel Herd is the recommended development environment for both macOS and Windows. It provides PHP, Nginx, and database services with zero configuration. Herd includes all required PHP extensions out of the box.
Laravel Valet
Laravel Valet is a lightweight development environment for macOS. It maps all subdirectories in a directory (such as ~/Sites) to .test domains. You can share your sites publicly using local tunnels.
Docker
Any Docker setup that satisfies the PHP and database requirements will work. The Shopper demo store uses Docker with FrankenPHP (Laravel Octane) as a reference. 