PHPackages                             thelia/thelia - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. thelia/thelia

ActiveLibrary[Framework](/categories/framework)

thelia/thelia
=============

Thelia is an ecommerce CMS.

2.6.0(6mo ago)8715.1k313[80 issues](https://github.com/thelia/thelia/issues)[10 PRs](https://github.com/thelia/thelia/pulls)GPL-3.0-or-laterPHPPHP &gt;= 8.2CI failing

Since Oct 25Pushed 1mo ago65 watchersCompare

[ Source](https://github.com/thelia/thelia)[ Packagist](https://packagist.org/packages/thelia/thelia)[ Docs](http://thelia.net/)[ RSS](/packages/thelia-thelia/feed)WikiDiscussions main Synced 2mo ago

READMEChangelog (10)Dependencies (85)Versions (90)Used By (0)Security (2)

Readme
======

[](#readme)

Warning
-------

[](#warning)

### This is the development repository of Thelia. If you want to create a project, please take a look at [thelia/thelia-project](https://github.com/thelia/thelia-project)

[](#this-is-the-development-repository-of-thelia-if-you-want-to-create-a-project-please-take-a-look-at-theliathelia-project)

If you want to download a packaged, ready-to-use distribution of the most recent version of Thelia please download [thelia.zip](https://thelia.net/download/thelia.zip)

Thelia
------

[](#thelia)

[![Actions Status: test](https://github.com/thelia/thelia/workflows/test/badge.svg?branch=main)](https://github.com/thelia/thelia/actions?query=workflow%3A%22test%22)[![Scrutinizer Quality Score](https://camo.githubusercontent.com/871e662ae946cf12f39433b586aa882b91ed3bbf3fac186cfc02e5c3fdab98b8/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7468656c69612f7468656c69612f6261646765732f7175616c6974792d73636f72652e706e673f733d36316533653034613639626666643731633239623038653533393230383033313761353436373136)](https://scrutinizer-ci.com/g/thelia/thelia/)[![Discord Shield](https://camo.githubusercontent.com/9795e75305f33b15df7da19ad1a25da03634fdfe9bf7c47805b9b7eae5f7ffd0/68747470733a2f2f646973636f72646170702e636f6d2f6170692f6775696c64732f313036373833363936383638393438373837322f7769646765742e706e673f7374796c653d736869656c64)](https://camo.githubusercontent.com/9795e75305f33b15df7da19ad1a25da03634fdfe9bf7c47805b9b7eae5f7ffd0/68747470733a2f2f646973636f72646170702e636f6d2f6170692f6775696c64732f313036373833363936383638393438373837322f7769646765742e706e673f7374796c653d736869656c64)

[Thelia](https://thelia.net/) is an open source tool for creating e-business websites and managing online content. This software is published under GNU General Public License v3.0.

A repository containing all thelia modules is available at this address :

Compatibility
-------------

[](#compatibility)

Thelia 2.3Thelia 2.4Thelia 2.5Thelia 2.6PHP5.5 5.6 7.0 7.17.0 7.1 7.2 7.38.2 8.38.2 8.3MySQL5.5 5.65.5 5.6 5.75.6 5.7 8.05.6 5.7 8.0Symfony2.82.86.46.4Requirements
------------

[](#requirements)

- PHP
    - Required extensions :
        - PDO\_Mysql
        - openssl
        - intl
        - gd
        - curl
        - dom
    - safe\_mode off
    - memory\_limit at least 128M, preferably 256.
    - post\_max\_size 20M
    - upload\_max\_filesize 2M
    - date.timezone must be defined
- Web Server Apache 2 or Nginx

### MySQL 5.6

[](#mysql-56)

As of MySQL 5.6, default configuration sets the sql\_mode value to

```
STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

```

This 'STRICT\_TRANS\_TABLES' configuration results in SQL errors when no default value is defined on NOT NULL columns and the value is empty or invalid.

You can edit this default config in `/etc/my.cnf` and change the sql\_mode to remove the STRICT\_TRANS\_TABLES part

```
[mysqld]
sql_mode=NO_ENGINE_SUBSTITUTION

```

Assuming your sql\_mode is the default one, you can change the value directly on the run by running the following SQL Command

```
SET @@GLOBAL.sql_mode='NO_ENGINE_SUBSTITUTION', @@SESSION.sql_mode='NO_ENGINE_SUBSTITUTION'
```

For more information on sql\_mode you can consult the [MySQL doc](https://dev.mysql.com/doc/refman/5.0/fr/server-sql-mode.html "sql Mode")

Archive builders
----------------

[](#archive-builders)

Thelia's archive builder's needs external libraries. For zip archives, you need PECL zip. See [PHP Doc](https://php.net/manual/en/zip.installation.php)

For tar archives, you need PECL phar. Moreover, you need to deactivate php.ini option "phar.readonly":

```
phar.readonly = Off
```

For tar.bz2 archives, you need tar's dependencies and the extension "bzip2". See [PHP Doc](https://php.net/manual/fr/book.bzip2.php)

For tar.gz archives, you need tar's dependencies and the extension "zlib". See [PHP Doc](https://fr2.php.net/manual/fr/book.zlib.php)

Download Thelia 2 and install its dependencies
----------------------------------------------

[](#download-thelia-2-and-install-its-dependencies)

You can get the sources from git and then let composer install dependencies, or use composer to install the whole thelia project into a specific directory

### Using git for download and composer for dependencies

[](#using-git-for-download-and-composer-for-dependencies)

```
$ git clone --recursive https://github.com/thelia/thelia path
$ cd path
$ git checkout 2.6.0
$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar install
```

### Using composer for both download and dependencies

[](#using-composer-for-both-download-and-dependencies)

```
$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar create-project thelia/thelia path/ 2.6.0
```

If something goes wrong during the install process, you can restart Thelia install wizard with the following command : `php composer.phar run-script post-create-project-cmd`

Install it
----------

[](#install-it)

You can install Thelia by different way

### Using install wizard

[](#using-install-wizard)

Installing thelia with the web install wizard allow to create an administrator, add some informations about your shop, etc

First of all, you have to configure a vhost as describe in [configuration](https://doc.thelia.net/en/documentation/configuration.html) section.

The install wizard in accessible with your favorite browser :

```
https://yourdomain.tld/[/subdomain_if_needed]/install
```

For example, I have thelia downloaded at  and my vhost is correctly configured, I have to reach this address :

```
https://thelia.net/install
```

### Using cli tools

[](#using-cli-tools)

```
$ php Thelia thelia:install
```

You just have to follow all instructions.

### Docker and docker compose

[](#docker-and-docker-compose)

This repo contains all the configuration needed to run Thelia with docker and docker-compose. Warning, this docker configuration is not ready for production.

It requires obviously [docker](https://docker.com/) and [docker-compose](https://docs.docker.com/compose/)

Please, follow the official documentation to install docker and docker-compose on your system : [https://doc.thelia.net/docs/getting\_started/docker](https://doc.thelia.net/docs/getting_started/docker)

Contribute
----------

[](#contribute)

See the documentation :

If you submit modifications that adds new data or change the structure of the database, take a look to

Community
---------

[](#community)

Join the conversation and help the community :

[Twitter](https://github.com/thelia/thelia)[Discord](https://discord.gg/YgwpYEE3y3)[StackOverflow](https://stackoverflow.com/questions/tagged/thelia)[Forum](https://forum.thelia.net/)

###  Health Score

66

—

FairBetter than 99% of packages

Maintenance78

Regular maintenance activity

Popularity45

Moderate usage in the ecosystem

Community37

Small or concentrated contributor base

Maturity91

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~55 days

Recently: every ~174 days

Total

81

Last Release

182d ago

PHP version history (9 changes)2.0.0-beta1PHP &gt;=5.4

2.4.0-alpha1PHP &gt;=5.5

2.4.0PHP &gt;=5.6 &lt;7.4

2.4.4PHP &gt;=7.0 &lt;8.0

2.5.0-alpha1PHP &gt;=7.3 &lt;8.1

2.5.0-alpha2PHP &gt;=7.4 &lt;8.1

2.5.0PHP &gt;= 8.0.2

2.5.4PHP &gt;= 8.1

2.6.0PHP &gt;= 8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2196919?v=4)[thelia](/maintainers/thelia)[@thelia](https://github.com/thelia)

![](https://www.gravatar.com/avatar/f89451228a2a7327c0ef34a4eba622e51ff0f2e8ec58dedea6f31c4c7b77f336?d=identicon)[lopes-vincent](/maintainers/lopes-vincent)

---

Top Contributors

[![lunika](https://avatars.githubusercontent.com/u/767834?v=4)](https://github.com/lunika "lunika (2629 commits)")[![roadster31](https://avatars.githubusercontent.com/u/2197734?v=4)](https://github.com/roadster31 "roadster31 (1811 commits)")[![gillesbourgeat](https://avatars.githubusercontent.com/u/7335734?v=4)](https://github.com/gillesbourgeat "gillesbourgeat (782 commits)")[![etienneroudeix](https://avatars.githubusercontent.com/u/2012682?v=4)](https://github.com/etienneroudeix "etienneroudeix (497 commits)")[![bibich](https://avatars.githubusercontent.com/u/1215555?v=4)](https://github.com/bibich "bibich (432 commits)")[![lovenunu](https://avatars.githubusercontent.com/u/6106094?v=4)](https://github.com/lovenunu "lovenunu (405 commits)")[![lopes-vincent](https://avatars.githubusercontent.com/u/6057206?v=4)](https://github.com/lopes-vincent "lopes-vincent (381 commits)")[![touffies](https://avatars.githubusercontent.com/u/205560?v=4)](https://github.com/touffies "touffies (263 commits)")[![Lucanis](https://avatars.githubusercontent.com/u/6052481?v=4)](https://github.com/Lucanis "Lucanis (121 commits)")[![bilhackmac](https://avatars.githubusercontent.com/u/3740078?v=4)](https://github.com/bilhackmac "bilhackmac (94 commits)")[![InformatiqueProg](https://avatars.githubusercontent.com/u/7933327?v=4)](https://github.com/InformatiqueProg "InformatiqueProg (81 commits)")[![gmorel](https://avatars.githubusercontent.com/u/2279794?v=4)](https://github.com/gmorel "gmorel (81 commits)")[![mespeche](https://avatars.githubusercontent.com/u/2156044?v=4)](https://github.com/mespeche "mespeche (64 commits)")[![Yochima](https://avatars.githubusercontent.com/u/7498669?v=4)](https://github.com/Yochima "Yochima (58 commits)")[![zzuutt](https://avatars.githubusercontent.com/u/7439945?v=4)](https://github.com/zzuutt "zzuutt (54 commits)")[![badsuricate](https://avatars.githubusercontent.com/u/4679401?v=4)](https://github.com/badsuricate "badsuricate (47 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (34 commits)")[![ThomasArnaud](https://avatars.githubusercontent.com/u/10884519?v=4)](https://github.com/ThomasArnaud "ThomasArnaud (30 commits)")[![Asenar](https://avatars.githubusercontent.com/u/1180301?v=4)](https://github.com/Asenar "Asenar (29 commits)")[![enurit](https://avatars.githubusercontent.com/u/6229611?v=4)](https://github.com/enurit "enurit (29 commits)")

---

Tags

e-commercehacktoberfestmysqlphpsymfonytheliacmsecommercecms ecommerceecommerce cms

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/thelia-thelia/health.svg)

```
[![Health](https://phpackages.com/badges/thelia-thelia/health.svg)](https://phpackages.com/packages/thelia-thelia)
```

###  Alternatives

[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
