OpenCart

OpenCart is a free open source ecommerce platform for online merchants. OpenCart provides a professional and reliable foundation to build a successful online store. Please read the installation instructions included in the repository or download file. Please read the upgrading instructions included in the repository or download file. Important! If your bug report is not related to the core code (such as a 3rd party module or your server configuration) then the issue will be closed without a reason. You must contact the extension developer, use the forum or find a commercial partner to resolve a 3rd party code issue. If you would like to report a serious security bug please PM an OpenCart moderator/administrator on the forum. Please do not report concept/ideas/unproven security flaws - all security reports are taken seriously but you must include the EXACT details steps to reproduce it. Please DO NOT post security flaws in a public location. Read the full CONTRIBUTING guide for environment setup, coding standards, and pull-request expectations. Fork the repository, make your changes, and submit a pull request. Please be explicit in commit and PR descriptions—empty or unclear messages may be rejected. Your code must follow the OpenCart coding standards. Our automated scanners (syntax lint, PHPStan, php-cs-fixer) must pass before a PR can be merged. You must have Docker and Docker Compose installed on your machine. If you're installing Composer separately from Docker, make sure to install docker-compose-v2 . Using the older docker-compose version may cause the build process (specifically the make build step) to fail. Docker Desktop is the easiest way to get them. You must have make installed on your system (usually pre-installed on macOS and Linux distributions). For Windows Users: It is strongly recommended to use the WSL 2 (Windows Subsystem for Linux) backend for Docker Desktop. You should clone this project inside your WSL distribution (e.g., Ubuntu 24.04) for best performance. Access your project via wsl$ Ubuntu-24.04 home youruser opencart from Windows Explorer if needed. Without WSL 2, file system performance will be extremely slow, making the application nearly unusable. Docker Desktop will typically prompt you to enable WSL 2 during installation. OpenCart itself does not use any .env file for its configuration. The provided .env.docker file is only for configuring the Docker Compose environment. To avoid confusion with classic development workflows, this file is named .env.docker and placed inside the docker directory. 1. Clone the repository to your local machine. 2. Initialize the project: The environment uses PHP 8.4 by default. You can easily switch to a different version by editing the PHP VERSION variable in the docker/.env.docker file. A MAJOR is very rare, it would only be considered if the source was effectively re-written or a clean break was desired for other reasons. This increment would likely break most 3rd party modules. A MINOR is when there are significant changes that affect core structures. This increment would likely break some 3rd party modules. OpenCart will announce to developers 1 week prior to public release of FEATURE versions, this is to allow for testing of their own modules for compatibility. For bigger releases (ones that contain many core changes, features and fixes) an extended period will be considered following an announced release candidate (RC). Patch versions (which are considered safe to update with) may have a significantly reduced developer release period.