145 lines
4.9 KiB
Markdown
145 lines
4.9 KiB
Markdown
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)
|
|
|
|
Thelia
|
|
------
|
|
[](https://github.com/thelia/thelia/actions?query=workflow%3A"test") [](https://packagist.org/packages/thelia/thelia) [](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 http://thelia.net/ web site for more information.
|
|
|
|
A repository containing all thelia modules is available at this address : https://github.com/thelia-modules
|
|
|
|
Requirements
|
|
------------
|
|
|
|
* PHP 7.0
|
|
* Required extensions :
|
|
* PDO_Mysql
|
|
* mcrypt
|
|
* intl
|
|
* gd
|
|
* curl
|
|
* 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
|
|
|
|
## Create a Thelia project
|
|
|
|
``` bash
|
|
$ curl -sS https://getcomposer.org/installer | php
|
|
$ php composer.phar create-project thelia/thelia-project path/ 2.4.4 (or 2.3.5)
|
|
```
|
|
|
|
## Install it with your own environment
|
|
|
|
You can install Thelia using the cli tool and the scripts provided by thelia/setup
|
|
|
|
``` bash
|
|
$ php Thelia thelia:install
|
|
```
|
|
|
|
Consult the page : http://localhost/thelia/web/index_dev.php
|
|
|
|
You can create a virtual host and choose web folder for root directory.
|
|
|
|
## Quick install with 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/)
|
|
|
|
To install Thelia within Docker, run :
|
|
|
|
``` bash
|
|
./start-docker.sh
|
|
```
|
|
|
|
It will ask you for a template name (usually your project name) if you don't have a .env file but you can create the .env by yourself, take a look at .env.docker to make your own.
|
|
|
|
If your folder template does not exist it will copy the "modern" template.
|
|
|
|
Next just go to http://localhost:8080 and you should see your Thelia installed !
|
|
|
|
And run the same command everytime you want launch your Thelia.
|
|
|
|
If you want add some sample data just add the option `-demo`
|
|
``` bash
|
|
./start-docker.sh -demo
|
|
```
|
|
|
|
If you want to access your database from your computer (with DBeaver, Sequel Pro or anything else) by default the host is `localhost` and the port is `8086`
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Thelia documentation is available at http://doc.thelia.net
|
|
|
|
|
|
Contribute
|
|
----------
|
|
|
|
See the documentation : http://doc.thelia.net/en/documentation/contribute.html
|
|
|
|
### 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:
|
|
|
|
```bash
|
|
export PATH=/Applications/MAMP/bin/php/php5.5.x/bin/:$PATH
|
|
```
|
|
|
|
* configure a complete development environment : http://php-osx.liip.ch/
|
|
* use a virtual machine with vagrant and puppet : https://puphpet.com/
|
|
|
|
### MySQL 5.6
|
|
|
|
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
|
|
|
|
```sql
|
|
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
|
|
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":
|
|
```ini
|
|
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)
|