应用商店APP模板

简介：

应用商店APP模板

此应用程序使用mysql数据库来存储由BigCommerce API生成的注册商店的访问令牌。正如最新的Laravel文档中所建议的那样，设置本地开发环境的最快和最简单的方法是使用Docker和Laravel Sail。请参考官方 Laravel 文档，让您的本地机器为 Laravel 做好准备。

如何在本地计算机上运行

1. 下载存储库并在代码编辑器中打开。
   一个。如果你在一台没有php的新电脑上，Laravel或Sail配置以前做过;使用以下命令起床并可用。Sail

   docker run --rm \
   -u "$(id -u):$(id -g)" \
   -v $(pwd):/opt \
   -w /opt \
   laravelsail/php80-composer:latest \
   composer install --ignore-platform-reqs
   

   参考

2. 制作副本并重命名.env.example.env

3. 添加并启动 ngrok。注意：使用端口 80 匹配 Laravel 应用程序。 - - - 记下您的安全转发地址（例如 https://7865ec2cf4de.ngrok.io）。 是您的会话持续时间。npm install ngrokngrok http 807865ec2cf4dengrok_id

   始终保持 ngrok 打开，因为每次启动应用程序时，如果使用的是未注册或免费，您的ngrok_id都会更改。

4. 使用 ngrok 安全转发地址注册草稿应用。

   • 对于步骤 5-7，将回调输入为 。'https://{ngrok_id}.ngrok.io/auth/{install||load||uninstall}'
   • 从正在运行的终端获取。ngrok_idngrok http 80
   • 例如，身份验证回调 URL：https://12345.ngrok.io/auth/install
   • 例如，加载回调网址：https://12345.ngrok.io/auth/load
   • 例如，卸载回调 URL：https://12345.ngrok.io/auth/uninstall
   • 对于选项卡中的 OAuth 范围，选择“订单和产品为”和“信息和设置”作为现在。TechnicalModifyRead-Only

5. 将 ngrok 安全转发地址复制到以下密钥.env

   • APP_URL
   • AUTH_CALLBACK

6. 替换 client_id 并client_secret 中的 。您的 BigCommerce 开发人员门户（来自开发人员门户）。.envView Client ID

7. 运行，然后使用 Laravel Mix 编译前端 React 代码。npm installnpm run dev

8. 运行以下载并安装 laravel 软件包。composer install

9. 在单独的终端中，运行 。之后，您的 docker 应用程序将与应用程序、数据库等的多个容器一起配置和运行。./vendor/bin/sail up

10. 在单独的终端中，运行以初始化数据库表。./vendor/bin/sail artisan migrate

11. 转到您的 ，您将在页面上看到您的应用程序。安装应用程序。Store Dashboard -> Apps -> My Apps -> My Draft Apps

12. 如果由于某种原因（例如新的 ngrok 转发地址等）您需要更改 env 变量，请使用单独终端上的命令清除 env 缓存：./vendor/bin/sail artisan config:cache

13. 应用程序使用基于 cookie 的会话来传递一些数据，也是在 laravel sail 项目中配置的 mysql 数据库，用于存储注册商店的访问令牌。访问令牌当前未在数据库中进行哈希处理。

故障 排除

如果您在使用Laravel Docker配置时遇到问题，可以按照以下步骤从头开始：

1. 删除所有映像和容器

./vendor/bin/sail down --rmi all -v

2. 重新创建容器并启动每个容器

./vendor/bin/sail up

3. 初始化数据库

./vendor/bin/sail artisan migrate

关于地方发展的说明

• 如果要拉取新的营销更新（这需要数据库上的板载表），请不要忘记迁移。或者更好的是，从新开始设置 mysql 数据库：（在 sail 启动时使用命令）

./vendor/bin/sail artisan migrate:fresh

• 为了在本地计算机中更快地进行开发，可以使用本地凭据。为此，应将以下环境变量设置为 .这将导致应用使用本地 API 凭据：
  例如APP_ENVlocalAPP_ENV=local

• 为了在本地工作，您还应该在 .env 中设置存储 API 凭据。可以在应用商店仪表板中生成 API 凭据（需要选择“信息&设置”范围只读以及应用功能所需的其他范围）Advanced Settings->API Accounts->Create V2/V3 API Token

下面是这些环境变量的外观示例。

# LOCAL
L_ACCESS_TOKEN=5ves21xef52y7kttyd0gm8c50yjy2zx
L_API_PATH=https://api.bigcommerce.com/stores/lrtom86d1e/v3/
L_CLIENT_ID=mbfav830kuwwr0toh07p4kppog5cco9
L_CLIENT_SECRET=b8d4c1ab541dee283b6871e96f2f96e6dc0610073acec6d650e4eeb197ad5a3f
L_STORE_HASH=stores/lrtom86d1e

云盘：

http://zijieyunpan.cn/vXsOCLb1dMG

阅览：