Saleor 开源电商项目的安装与使用指南

2024-08-10 11:41:12作者：秋阔奎Evelyn

目录结构及介绍

在成功克隆了 https://github.com/saleor/saleor.git 这个仓库之后, Saleor 的项目目录主要结构如下:

.
├── README.md          # 项目说明文件
├── CONTRIBUTING.md    # 贡献者指南
├── .github            # 包含贡献指南和其他Github相关文件
│   ├── ISSUE_TEMPLATE # Github Issue模板
└── saleor             # Saleor核心代码所在的目录
    ├── api            # Saleor RESTful API的实现
    ├── graphql        # GraphQL API的实现
    ├── dashboard     # 商家管理后台的前端代码
    └── migrations    # 数据库迁移脚本

其中关键目录如saleor包含了所有的核心代码。

启动文件介绍

为了运行Saleor, 需要确保你的环境中已安装以下工具和软件包：

Docker >= 1.12.6
docker-compose >= 1.6.0
Python >= 3.8.x
Pipenv

使用Docker来快速搭建环境是最推荐的方式。首先将Saleor平台的所有组件下载到本地并构建容器镜像，然后使用docker-compose up命令启动所有服务。这其中包括数据库、缓存服务器、邮件服务器等。

对于非Docker方式的启动，则可以通过以下步骤完成:

在项目根目录下创建一个虚拟环境并激活它（虚拟环境不是必需的但建议这样做以避免与其他Python项目产生冲突）。
```
python -m venv my_env
source my_env/bin/activate
```
安装依赖项。在Saleor的主目录中执行以下命令:
```
pip install -r requirements.txt
```
执行数据库迁移:
```
alembic upgrade head
```
最后，在终端中输入以下命令以启动Saleor应用程序:
```
python manage.py runserver
```

此时，你应能够在本地开发环境中访问Saleor。

配置文件介绍

settings.py 文件位于 saleor/saleor/settings.py 目录，是Saleor的关键配置文件，用于定制不同环境下的应用行为。它包含了诸如数据库连接、日志记录、安全设置、第三方集成（例如电子邮件和支付处理程序）等大量配置参数。

这个文件中的主要部分包括:

1. Database settings

定义了默认的数据存储引擎以及其对应的数据库名、用户名和密码。如果你使用的是PostgreSQL，该文件可能看起来像这样:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'saleor',
        'USER': 'saleor',
        'PASSWORD': 'password',
        'HOST': 'localhost',
        'PORT': '',
    }
}