README

PrestaShop 是一个开源的电子商务网络应用程序，致力于为商家和顾客提供最佳的购物车体验。它使用 PHP 编写，高度可定制，支持所有主要支付服务，支持多种语言翻译并针对许多国家本地化，拥有全响应式设计（前后端），等等。 查看所有可用功能。

此存储库包含 PrestaShop 的源代码，仅供开发和预览使用。要下载 PrestaShop 最新稳定公共版本（目前版本 8.1），请访问 版本页面。

PrestaShop 8.0 的首个稳定版本于 2022 年 10 月 26 日发布。
PrestaShop 8.1 的首个稳定版本于 2023 年 6 月 26 日发布。此后已发布更多更新。更多信息请参阅 Build 开发博客。

关于 develop 分支

此存储库的 develop 分支包含 PrestaShop 下一个版本的正在进行中的源代码。目前，下一个版本将是 PrestaShop 9.0。

有关我们分支系统的更多信息，请参阅我们关于 为开发安装 PrestaShop 的指南。

服务器配置

要安装 PrestaShop 9.0 的最新版本，您需要一个运行 PHP 8.1+ 和 MySQL 5.6+ 任何版本的 Web 服务器（MySQL、MariaDB、Percona Server 等）。

您还需要一个数据库管理工具，例如 phpMyAdmin，以便为 PrestaShop 创建数据库。我们推荐使用 Apache 或 Nginx Web 服务器（查看我们的 示例 Nginx 配置文件）。

有关更多信息，请参阅我们的 系统要求 页面和 系统管理员指南。

安装

如果您从 GitHub 下载了源代码，请参阅我们关于 为开发安装 PrestaShop 的指南。如果您打算安装生产商店，请确保从 我们的版本页面 下载最新版本，然后阅读 用户安装指南。

Docker compose

PrestaShop 也可以与 Docker 及其工具 Docker compose 部署。

要运行软件，请使用

docker compose up

然后通过此 URL 访问您的商店： https://:8001

Docker会将您的端口8001绑定到Web服务器。如果您想使用其他端口，请打开并修改文件docker-compose.yml。如果需要，MySQL凭据也可以在此文件中找到和修改。

注意：在自动安装PrestaShop之前，该容器会在启动时检查文件config/settings.inc.php是否存在。如果您希望容器（重新）安装您的商店，如果存在请删除此文件。并确保容器用户www-data对整个工作区有写权限。

要完全重置您的仓库并从头开始，请运行（请注意：这将删除所有您的额外文件）

# clean everything that is not part of the original repository (node_modules, etc.)
git fetch origin
git reset --hard origin/develop
git clean -dfx

# inform build scripts to reinstall shop
rm config/settings.inc.php

# clear all docker caches and rebuild everything
docker compose down -v
docker compose build --no-cache
docker compose up --build --force-recreate

PHPMyAdmin

要将PHPMyAdmin服务添加到您的Docker Compose设置中，可以将现有的docker-compose.override.yml.dist复制到docker-compose.override.yml，然后启动您的Docker Compose设置（覆盖文件将按照惯例包含在内）

cp docker-compose.override.yml.dist docker-compose.override.yml
docker compose up

BLACKFIRE

默认情况下，Blackfire不会安装。在安装过程中，Blackfire的安装基于3个环境变量

BLACKFIRE_ENABLE: 1
BLACKFIRE_SERVER_ID: "your_server_id"
BLACKFIRE_SERVER_TOKEN: "your_blackfire_server_token"

这些环境变量是自解释的，您可以自行设置它们或覆盖docker-compose的默认值

打开文件docker-compose.override.yml（如果尚未完成，请从docker-compose.override.yml.dist复制它，请参阅上述PHPMyadmin部分中的命令）。然后取消注释3条docker行，并用您账户的服务器ID和令牌填充BLACKFIRE_SERVER_ID和BLACKFIRE_SERVER_TOKEN。

文档

有关技术信息（核心、模块和主题开发、性能等），请访问PrestaShop DevDocs

如果您想了解如何使用PrestaShop 8，请阅读我们的用户文档。

对于初学者来说，以下指南特别有趣

• 入门：如何安装PrestaShop以及您需要知道的信息。
• 用户指南：如何充分利用PrestaShop。
• 更新指南：切换到最新版本并非易事。请确保您正确操作。
• 商家指南：初上网店的技巧和窍门。
• FAQ页面也应对您有很大帮助。FAQ

贡献

PrestaShop是一个开源项目，没有数百名贡献者的帮助是不可能的，他们多年来提交了改进和错误修复。感谢大家！

如果您想向PrestaShop贡献代码，请阅读此存储库中的CONTRIBUTING.md文件，或阅读文档网站上关于贡献的教程。

不知道从哪里开始？查看good first issue标签，看看所有适合初学者的改进和错误修复。

如果您想帮助将PrestaShop翻译成您的语言，请加入我们！

报告问题

我们的错误跟踪器在GitHub上。我们鼓励您在发现问题后立即创建详细的问题。

有关详细信息和建议，请阅读我们的通过报告问题进行贡献指南。

报告安全问题

负责（且私下）公开是一个在发现安全问题时遵循的标准做法：在公开之前，发现者会通知核心团队，以便准备修复措施，从而最大限度地减少潜在损害。

PrestaShop 团队努力在防止安全问题时保持高度积极主动。即便如此，关键问题可能在没有通知的情况下出现。

因此，我们设立了漏洞赏金计划，任何人都可以私下联系我们，提供影响 PrestaShop 商家或客户安全问题的所有详细信息。我们的安全团队将回复您，并讨论发布细节的时间表。

理解安全问题的关键在于知道攻击者是如何入侵并攻击网站的。如果您有这些细节，请私下联系我们（并且在收到我们的回复之前请不要公开这些细节）。如果您不知道攻击者是如何入侵的，请寻求帮助。

PrestaShop 扩展

PrestaShop 是一个非常灵活的电子商务平台，可以通过模块和主题进行扩展。开发者甚至可以覆盖默认组件和行为。有关更多信息，请参阅模块文档和主题文档。

社区论坛

您可以在 PrestaShop Slack 频道、GitHub 上的项目讨论或PrestaShop 论坛上讨论电子商务、帮助其他商家、获取帮助，并与 PrestaShop 社区一起共同改进 PrestaShop。

感谢您下载和使用 PrestaShop 开源电子商务解决方案！