Skip to content

Requirements

The PHP version, PHP extensions, databases and Laravel versions Shopper 3 needs, and the local environments that provide them.

Shopper is a Laravel package: a server that runs Laravel 12 or 13 runs Shopper once a few more PHP extensions are installed. Composer checks every requirement on this page when you install Shopper, and stops with the name of anything that is missing.

Server Requirements

  • PHP 8.3 or higher. The continuous integration runs on PHP 8.3, 8.4 and 8.5.
  • MySQL 8+, PostgreSQL 15+ or SQLite.

The test suite runs on these three databases. MariaDB is not part of it.

PHP Extensions

Shopper needs the extensions listed in Laravel's server requirements, plus these:

ExtensionWhy Shopper needs it
intlCurrency, number and locale formatting in shopper/core and Filament
gdRequired by milon/barcode, which draws the barcode on the variant page. GD is also the default image driver of Spatie Media Library, which builds the thumbnails of product, category and brand images
exifRequired by Spatie Media Library, which reads the metadata of uploaded images
zip, xmlreaderRequired by OpenSpout, the spreadsheet library of Filament's actions package
iconvRequired by bacon/bacon-qr-code, which draws the QR code a user scans to set up two-factor authentication

The soap extension that Shopper 2 needed is no longer required.

GD stays required even if you prefer ImageMagick for your images. To build the thumbnails with ImageMagick, install the imagick extension and set the image driver of Spatie Media Library in your .env file:

.env
IMAGE_DRIVER=imagick

Laravel and Package Versions

PackageVersion
Laravel12.68+ or 13.27+
Filament5.11+
Livewire4.1+

Composer installs Filament and Livewire as dependencies of Shopper, so you do not require them in your application. Shopper 3 does not run on Laravel 11: upgrade your application to Laravel 12 or 13 first. If your store runs Shopper 2, follow the upgrade guide.

Development Environments

Laravel Herd

Laravel Herd is the recommended development environment for macOS and Windows. It provides PHP, Nginx and database services with no configuration, and its PHP builds include every extension listed on this page.

Laravel Valet

Laravel Valet is a lightweight development environment for macOS. It maps every subdirectory of a directory (such as ~/Sites) to a .test domain, and can share your sites publicly through local tunnels.

Docker

Any Docker setup that provides the PHP version, the extensions and one of the databases above works with Shopper.

Last updated on

Edit on GitHub