Download the PHP package thelia/thelia-project without Composer
On this page you can find all versions of the php package thelia/thelia-project. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download thelia/thelia-project
More information about thelia/thelia-project
Files in thelia/thelia-project
Package thelia-project
Short Description Thelia is an ecommerce CMS.
License GPL-3.0-or-later
Informations about the package thelia-project
Thelia project skeleton
This is the Composer project skeleton for Thelia, the open-source e-commerce framework. Use it to bootstrap a new Thelia 3 project.
To contribute to Thelia itself, head over to thelia/thelia.
Requirements
- PHP 8.3
- MariaDB 10.11 / MySQL 8
- Composer 2.7+
- Web server (Nginx or Apache)
Required PHP extensions: pdo_mysql, openssl, intl, gd, curl, dom, mbstring, zip.
Quick start
1. Create a new project
Thelia 3.0.0-beta1 is a pre-release. Composer only selects it when the beta stability is allowed, so add --stability=beta to the command above until the first stable version is tagged on Packagist.
2. Start the local environment
The repository does not ship a Docker setup; the recommended path is DDEV, which gives you PHP 8.3 and MariaDB 10.11 with a single command.
If you prefer your own stack (LAMP, Symfony CLI, Docker Compose, etc.), point your web server's docroot at public/ and make sure the PHP binary you use to run bin/install and bin/console is the same major version your web server uses.
3. Install Thelia
bin/install reads its database credentials from the DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER and DATABASE_PASSWORD environment variables. You can also pass them on the command line.
With DDEV, the database is exposed inside the web container as db:3306 with user db / password db:
Outside DDEV, export the matching env vars (or write them to .env.local) and run php bin/install with the same flags minus --database_*.
bin/install creates the database if needed, applies the schema, registers and activates modules, installs the selected templates, optionally imports demo data and creates an admin user. Running it again is idempotent for the credentials part: only the data steps (demo, admin) recreate state.
4. Open the shop
bin/install also builds the theme assets: it runs importmap:install and tailwind:build for the Flexy front office, and sass:build for the default-twig back office. There is no npm step anywhere. To rebuild them later, run the same commands from the application root:
Open https://my-shop.ddev.site for the storefront and https://my-shop.ddev.site/admin for the admin (default credentials: thelia / thelia if you used the snippet above).
Back-office templates
The skeleton installs the Twig back-office (templates/backOffice/default-twig/) by default. It is built with Twig, Symfony UX and Bootstrap 5.
Using the legacy Smarty back-office
The Smarty back-office from Thelia 2 is still available for projects that need it while they migrate. Add it next to the Twig one:
Both back-office templates can cohabit: the active one is controlled by bin/console template:set backOffice <name> (default-twig or default). Third-party modules built against the Smarty back-office keep working. If you maintain a module, the migration guide is in templates/backOffice/default-twig/BREAKING_CHANGES.md.
Documentation
- Project home: https://thelia.net
- Documentation: https://doc.thelia.net
- Source code: thelia/thelia
- Modules: thelia-modules
License
GPL-3.0-or-later. See LICENSE.txt.