o3-shop/shop-ce

This package contains O3-Shop CE source code.

v1.5.3-RC2 2025-12-11 12:34 UTC

Requires

• php: ^7.4 || ^8.0
• ext-json: *
• ext-pdo: *
• doctrine/collections: ^1.4.0
• doctrine/dbal: <=2.12.1
• monolog/monolog: ^v2.10
• o3-shop/shop-composer-plugin: ^v1.1.0
• o3-shop/shop-db-views-generator: ^v1.0.0
• o3-shop/shop-demodata-installer: ^v1.0.0
• o3-shop/shop-doctrine-migration-wrapper: ^v1.0.0
• o3-shop/shop-facts: ^v1.0.0
• o3-shop/shop-unified-namespace-generator: ^v1.0.0
• o3-shop/smarty: ~2.6.34
• phpmailer/phpmailer: ^v6.5.0
• psr/container: 1.0.*
• symfony/config: ~3.3 || ~4.0
• symfony/console: ^v3.4.15
• symfony/dependency-injection: ^3.4.26
• symfony/event-dispatcher: ^3.4
• symfony/expression-language: ^4.4.30
• symfony/filesystem: ^4.4.17
• symfony/finder: ^3.4
• symfony/lock: ^3.4
• symfony/yaml: ~3.4 || ~4.0
• vlucas/phpdotenv: ^5.5
• webmozart/path-util: ^2.3

Requires (Dev)

• incenteev/composer-parameter-handler: ~v2.0
• o3-shop/shop-ide-helper: ^v1.0.0
• o3-shop/testing-library: ^v1.1.1
• phpspec/prophecy: ^1.22
• phpspec/prophecy-phpunit: ^2.4
• rector/rector: ^2.1
• squizlabs/php_codesniffer: ^3.5.4

Replaces

• oxid-esales/oxideshop-ce: 6.10.3

GPL-3.0-only

• modules
• eshop
• O3-Shop

README

Shop core package

This package is part of the O3 Shop. For more information, consult the documentation

• License: GNU General Public License 3 https://www.gnu.org/licenses/gpl-3.0.de.html
• Website: https://www.O3-Shop.com

Contribute

If you want to contribute — or just play around with O3 Shop — here's the how-to.

Setting up an environment to work on the O3 core

You need an up-and-running Docker environment. Anything like Docker Desktop or Colima will work.

We mostly work with Colima, so this setup is the most tested one.

How to set up the environment for working on O3 Shop

Follow these three simple steps:

• Clone this repository
• Run ./docker.sh start and it should be up and running.

Aaand: You're ready to go. Just open http://localhost:8080.

And in case you missed the Docker log message:

• Shop URL: http://localhost:8080
• Admin URL: http://localhost:8080/admin/
• Admin login: [e-mail]
• Admin Password: admin123

What else comes with this package

Mailpit

Once the setup is complete, all emails are sent to Mailpit. You reach it at http://localhost:8025.

Adminer

Adminer is included in the standard installation. Try http://localhost:8081.

Testing

To run the tests, you have two choices.

1. Just run ./docker.sh test in your terminal.
   or
2. Run ./run-tests.sh inside the Docker container

This will run all tests in the shop core package.

Coverage HTML report

The code coverage report is located in coverage/html/index.html. You can open it in your browser to see the results.

Coverage PhpStorm report

To view your coverage report directly in PhpStorm:

1. Open the Coverage tab in PhpStorm
2. Select “Import a report collected in CI from disk”
3. Choose coverage/coverage.xml Your coverage report will now display within the IDE.

Bugs and issues

If you experience any bugs or issues, please report them in the section O3-Shop (all versions) of https://github.com/o3-shop/o3-shop/issues.

Even better: Fix them on your own and open a pull request 🥳

Disclaimer

We all work on this amazing product pro bono. There is no sophisticated "runs on every conceivable environment" thing.

What we use - and what works for us as developers working on O3 Shop:

• Mac OS
• PhpStorm
• Colima
• GitHub -- of course

Which means: Other environments most likely will work as well. Maybe they don't.

We're happy if you want to join us to expand the developer's universe to more than what we use on a daily basis.

Just drop us a note — or even better: open a pull request. The latter did not work very well in the past. That will change!