README

⚠️ 请注意：Sunrise php商店前端实现现在已被弃用，并将于2020年停止运行。 如果您仍然希望在自己的开发中使用它，请根据所给许可协议在此存储库中创建分支并继续开发您的版本，但请注意，将不再为此框架提供更新和支持。

SUNRISE PHP是一个模板商店前端实现，它使用以下组件在commercetools电子商务平台上实现完整的在线商店：

commercetools PHP SDK及其相应的commons库
commercetools SUNRISE响应式HTML模板（handlebars语法）
symfony框架（使用MicrokernelTrait）

它旨在关注精简、易于理解和快速，将可重用性委托给commons和symfony-components库。

在任何情况下更新之前，请务必阅读变更日志。

先决条件

PHP（请参阅SDK以获取详细要求）
composer

运行

要运行，您需要在commercetools平台上有一个包含一些必需内容的项目（例如示例数据）。然后从商家中心获取项目密钥、客户端ID和客户端密钥，并以以下方式之一提供它们

创建一个具有以下格式的文件 app/config/parameters.yml

parameters:
    env(SECRET_TOKEN): Secr3tT0ken
    env(CTP_CLIENT_ID): client-id
    env(CTP_CLIENT_SECRET): client-secret
    env(CTP_PROJECT): project-key

出于本地开发目的，您可以在php内置的web服务器上运行应用程序。The web文件夹包含静态资源和index.php作为唯一的PHP文件。

生产站点

php bin/console server:run --env prod

开发站点

php bin/console server:run

打开 https://:8000/

开发

为了改进模板，我们乐意接受改进和错误修复的pull请求。如果您想进行较大的更改或添加功能，最好先在github问题中讨论该想法。

重要：composer配置将在vendor目录中克隆PHP.commons库和sunrise设计。因此，在对此类文件进行git操作时请注意。

使用命令行

可用的控制台命令

php bin/console list

缓存预热

php bin/console cache:warmup

部署

Heroku

为了轻松快速地部署您的应用程序，我们推荐使用heroku

Docker

Sunrise 应用程序附带 Docker Compose 配置。

docker run -v $PWD:/var/www/symfony -w /var/www/symfony --rm=true jaysde/symfony-php-fpm composer install --prefer-dist
docker-compose up

这将启动一个 nginx 和一个 php-fpm Docker 容器来提供服务。

创建您的商店

从它开始创建您自己的电子商务解决方案。

更具体地说

分叉项目或只需复制代码（此代码的 MIT 许可和 SUNRISE 设计允许无限制的商业使用和修改）
您可能想要将某些事物的命名空间更改为您自己的项目名称（待办事项：模板可以从一开始就使用通用的命名空间）
要么在项目文件夹中创建一个 templates 目录并覆盖您在 vendor/commercetools/sunrise-design/templates 中找到的 *.hbs 文件名，以覆盖和更改 SUNRISE 设计
要么从头开始创建自己的 HTML 和模板结构，使用您喜欢的工具和模板语言
按需添加和更改内容
保持友好，并将有用的通用助手贡献回开源公共库。

commercetools / sunrise

维护者

详情