PHPackages                             thelia/thelia-project - 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-project

ActiveLibrary[Framework](/categories/framework)

thelia/thelia-project
=====================

Thelia is an ecommerce CMS.

2.6.0(6mo ago)638.5k19[3 issues](https://github.com/thelia/thelia-project/issues)LGPL-3.0+PHP

Since Dec 29Pushed 6mo ago11 watchersCompare

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

READMEChangelog (10)Dependencies (17)Versions (61)Used By (0)

Readme
======

[](#readme)

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

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

Thelia
------

[](#thelia)

[![Actions Status: test](https://github.com/thelia/thelia/workflows/test/badge.svg)](https://github.com/thelia/thelia/actions?query=workflow%3A%22test%22) [![License](https://camo.githubusercontent.com/1629fcf6aba0751ecc0371a29f44877e04e54103a39cb287f9f145a98bdbcc2b/68747470733a2f2f706f7365722e707567782e6f72672f7468656c69612f7468656c69612f6c6963656e73652e706e67)](https://packagist.org/packages/thelia/thelia) [![Scrutinizer Quality Score](https://camo.githubusercontent.com/871e662ae946cf12f39433b586aa882b91ed3bbf3fac186cfc02e5c3fdab98b8/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7468656c69612f7468656c69612f6261646765732f7175616c6974792d73636f72652e706e673f733d36316533653034613639626666643731633239623038653533393230383033313761353436373136)](https://scrutinizer-ci.com/g/thelia/thelia/)

[Thelia](http://thelia.net/) is an open source tool for creating e-business websites and managing online content. This software is published under LGPL.

This is the new major version of Thelia.

You can download this version and have a try or take a look at the source code (or anything you wish, respecting LGPL). See  web site for more information.

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 or 8

Create a Thelia project
-----------------------

[](#create-a-thelia-project)

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

Install it with your own environment
------------------------------------

[](#install-it-with-your-own-environment)

You can install Thelia using the cli tool and the scripts provided by thelia/setup

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

Consult the page :

You can create a virtual host and choose web folder for root directory.

Quick start with DDEV
---------------------

[](#quick-start-with-ddev)

To quickly set up your local environment, we recommend using [DDEV](https://ddev.com/get-started/). On macOS, we also suggest using [OrbStack](https://orbstack.dev/) instead of the classic Docker Desktop for noticeably better performance.

Initialize your project with a single command:

```
ddev config --project-type=php --docroot=web --php-version=8.3
```

DDEV will automatically generate everything required (vhosts, database, etc.).

You can then manage your environment with the following commands:

```
# Start the project
ddev start

# Stop it
ddev stop

# Display environment details
ddev describe

# Open a shell inside the container
ddev ssh
```

Then, just run previous Thelia commands to install your project.

Documentation
-------------

[](#documentation)

Thelia documentation is available at

Contribute
----------

[](#contribute)

See the documentation :

### Mac OSX

[](#mac-osx)

If you use Mac OSX, it still doesn't use php 5.4 as default php version... There are many solutions for you :

- use [phpbrew](https://github.com/c9s/phpbrew)
- use last MAMP version and put the php bin directory in your path:

```
export PATH=/Applications/MAMP/bin/php/php5.5.x/bin/:$PATH
```

- configure a complete development environment :
- use a virtual machine with vagrant and puppet :

### 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](http://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](http://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](http://php.net/manual/fr/book.bzip2.php)

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

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance68

Regular maintenance activity

Popularity37

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity77

Established project with proven stability

 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 ~72 days

Recently: every ~170 days

Total

56

Last Release

182d ago

### Community

Maintainers

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

---

Top Contributors

[![lopes-vincent](https://avatars.githubusercontent.com/u/6057206?v=4)](https://github.com/lopes-vincent "lopes-vincent (39 commits)")[![gillesbourgeat](https://avatars.githubusercontent.com/u/7335734?v=4)](https://github.com/gillesbourgeat "gillesbourgeat (25 commits)")[![lunika](https://avatars.githubusercontent.com/u/767834?v=4)](https://github.com/lunika "lunika (19 commits)")[![anoziere](https://avatars.githubusercontent.com/u/118798868?v=4)](https://github.com/anoziere "anoziere (13 commits)")[![lovenunu](https://avatars.githubusercontent.com/u/6106094?v=4)](https://github.com/lovenunu "lovenunu (10 commits)")[![bibich](https://avatars.githubusercontent.com/u/1215555?v=4)](https://github.com/bibich "bibich (3 commits)")[![bilhackmac](https://avatars.githubusercontent.com/u/3740078?v=4)](https://github.com/bilhackmac "bilhackmac (1 commits)")

### Embed Badge

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

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

###  Alternatives

[thelia/thelia

Thelia is an ecommerce CMS.

8715.1k](/packages/thelia-thelia)[symfony/skeleton

A minimal Symfony project recommended to create bare bones applications

6034.5M2](/packages/symfony-skeleton)[symfony/symfony-demo

Symfony Demo Application

2.6k238.8k](/packages/symfony-symfony-demo)[ec-cube/ec-cube

EC-CUBE EC open platform.

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

Business Application Platform (BAP)

644134.8k84](/packages/oro-platform)[sylius/sylius-standard

Starting point for projects powered by Sylius eCommerce.

271291.3k](/packages/sylius-sylius-standard)

PHPackages © 2026

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