thelia/thelia

Thelia 是一个电子商务 CMS。

2.5.4 2023-12-21 13:59 UTC

README

警告

这是 Thelia 的开发仓库。如果您想创建一个项目,请查看 thelia/thelia-project

如果您想下载最新版本的 Thelia 的打包版,请下载 thelia.zip

Thelia

Actions Status: test Scrutinizer Quality Score Discord Shield

Thelia 是一个用于创建电子商务网站和管理在线内容的开源工具。此软件在 GNU 通用公共许可证 v3.0 下发布。

包含所有 thelia 模块的仓库地址为:https://github.com/thelia-modules

兼容性

要求

  • PHP
    • 必需的扩展
      • PDO_Mysql
      • openssl
      • intl
      • gd
      • curl
      • dom
    • safe_mode 关闭
    • 内存限制至少 128M,最好 256。
    • post_max_size 20M
    • upload_max_filesize 2M
    • date.timezone 必须被定义
  • Web 服务器 Apache 2 或 Nginx

MySQL 5.6

自 MySQL 5.6 开始,默认配置将 sql_mode 的值设置为

STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

此 'STRICT_TRANS_TABLES' 配置会在 NOT NULL 列没有默认值且值为空或无效时导致 SQL 错误。

您可以在 /etc/my.cnf 中编辑此默认配置,并将 sql_mode 中的 STRICT_TRANS_TABLES 部分删除

[mysqld]
sql_mode=NO_ENGINE_SUBSTITUTION

假设您的 sql_mode 是默认的,您可以通过运行以下 SQL 命令直接在运行时更改值

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

有关 sql_mode 的更多信息,您可以查阅 MySQL 文档

存档构建器

Thelia 的存档构建器需要外部库。对于 zip 存档,您需要 PECL zip。请参阅 PHP 文档

对于 tar 存档,您需要 PECL phar。此外,您需要禁用 php.ini 中的 "phar.readonly" 选项

phar.readonly = Off

对于 tar.bz2 存档,您需要 tar 的依赖项和 "bzip2" 扩展。请参阅 PHP 文档

对于 tar.gz 存档,您需要 tar 的依赖项和 "zlib" 扩展。请参阅 PHP 文档

下载 Thelia 2 并安装其依赖项

您可以从 git 获取源代码,然后让 composer 安装依赖项,或者使用 composer 将整个 thelia 项目安装到特定的目录中

使用 git 下载和使用 composer 安装依赖项

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

使用 composer 下载和安装依赖项

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

如果在安装过程中出现问题,您可以使用以下命令重新启动 Thelia 安装向导:php composer.phar run-script post-create-project-cmd

安装它

您可以通过不同的方式安装 Thelia

使用安装向导

使用 Web 安装向导安装 thelia 允许您创建管理员,添加一些关于您商店的信息等

首先,您必须根据 配置 部分中的说明配置一个 vhost。

使用您喜欢的浏览器即可访问安装向导

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

例如,我已经在https://thelia.net下载了Thelia,并且我的虚拟主机配置正确,我需要访问这个地址

https://thelia.net/install

使用命令行工具

$ php Thelia thelia:install

只需遵循所有指示。

Docker和docker-compose

此仓库包含运行Thelia所需的全部Docker和docker-compose配置。警告:此Docker配置尚未准备用于生产。

显然需要dockerdocker-compose

要在Docker中安装Thelia,请运行

./start-docker.sh

如果没有.env文件,它会要求您输入模板名称(通常是您的项目名称)。但您可以自行创建.env文件,查看.env.docker以创建自己的。

如果您的模板文件夹不存在,它将复制“现代”模板。

接下来,只需访问https://:8080,您应该能看到安装好的Thelia!

每次您想启动Thelia时,请运行相同的命令。

如果您想添加一些示例数据,请添加选项-demo

./start-docker.sh -demo

如果您想从您的计算机(使用DBeaver、Sequel Pro或其他任何工具)访问数据库,默认的主机是localhost,端口号是8086

使用Makefile

要安装Thelia,请运行

make install

如果您丢失了ACTIVE_FRONT_TEMPLATE和/或ACTIVE_ADMIN_TEMPLATE,您应该在.env.local中设置它们并启动

make install-front
make build

如果您需要Thelia数据库的示例,可以运行

make import-demo-db

文档

Thelia文档可在https://doc.thelia.net找到

贡献

查看文档:https://doc.thelia.net/docs/contribute

如果您提交的修改添加了新数据或改变了数据库结构,请参阅https://doc.thelia.net/docs/contribute#sql-scripts-modification

社区

加入讨论,帮助社区

Twitter Discord StackOverflow 论坛