README

关于

这是 IDMarinas 版本的模板。它包含了创建自定义和构建工具所需的内容。这个骨架不包括核心文件，它们对于创建自定义内容不是必需的。

IDMarinas 版本

IDMarinas 版本的骨架版本： 7.1.*

第一步

• 您需要安装全局命令 npm、composer 和 gulp。

  Gulp 全局安装，运行命令 npm install gulp-cli -g；Composer 全局安装，请参阅 https://composer.php.ac.cn/download/

创建项目

方法 1

• 运行命令 composer create-project idmarinas/lotgd-skeleton MyCustomLoTGD 以创建 LoTGD 核心的骨架

  它将创建一个包含新 LoTGD 核心应用程序的 MyCustomLoTGD 目录。

• 运行命令 npm install 安装所有节点包。
  • 注意：当 Fomantic Ui 询问您安装时，选择“跳过安装”，然后接受一切。
  • 不需要在项目文件夹中安装。

方法 2

• 在您的目录中克隆仓库。
• 运行命令 composer install 安装所有 composer 包。
• 运行命令 composer lotgd:skeleton:project:create
  • 这将把文件复制到 _core_files/ 文件夹中。
  • 同时还会复制到您的 MyCustomLoTGD 目录中需要的文件。
• 运行命令 php bin/console lotgd:regenerate:app_secret 重新生成 .env 文件的 APP_SECRET。
  • 只需运行一次。
• 运行命令 php bin/console lotgd:regenerate:app_secret --iv 重新生成 .env 文件的 APP_SECRET_IV。
  • 只需运行一次。
• 运行命令 npm install 安装所有节点包。
  • 注意：当 Fomantic Ui 询问您安装时，选择“跳过安装”，然后接受一切。
  • 不需要在项目目录中安装。

从先前版本升级项目（骨架版本 5.2.* 的新功能）

• 在做出任何更改之前，请提交您项目中的所有更改。
  • 这样可以查看所有新更改，您可以根据需要对其进行修改。

对于版本 5.1.* 及以下的项目。

• 需要下载仓库并将文件复制到您的项目目录。
  • 检查所有更改并根据需要进行修改。
• 运行命令 composer lotgd:skeleton:project:upgrade 并等待。

对于版本 5.2.* 及以上的项目。

• 在您的 composer.json 中查找以下包
  • "idmarinas/lotgd" 和 "idmarinas/lotgd-skeleton" 将这些包的版本升级到所需版本，例如 5.2.*
  • 这两个包必须具有相同的次要版本和相同的补丁版本，补丁版本始终为星号。
    • 注意：X.Y.Z：其中 X 是主要版本，Y 是次要版本，Z 是补丁版本。
    • 注意：补丁版本中的 * 下载的是包的补丁，这仅是修复错误，不会破坏您的安装。
• 运行命令 composer update
• 等待完成。
• 运行命令 composer lotgd:skeleton:project:upgrade 并等待。

准备您的自定义 LoTGD

• 使用您的数据配置 .env 文件。
  • 可以创建多个文件，用于不同环境的单独配置
    • .env.prod 包含生产环境的配置数据。
    • .env.dev 包含开发环境的配置数据。
    • .env.test 包含测试环境的配置数据。
  • 可以阅读 .env 中的注释，以了解 .env 文件的工作方式。
• 运行命令 php bin/console lotgd:regenerate:app_secret 重新生成 .env 文件的 APP_SECRET。
  • ⚠️ 仅在首次安装LoTGD时需要。如果您已经有一个在生产中的项目，再次更改可能会破坏您的安装。
• 运行命令 php bin/console lotgd:regenerate:app_secret -iv 以重新生成 .env 文件中的 APP_SECRET_IV。
  • ⚠️ 仅在首次安装LoTGD时需要。如果您已经有一个在生产中的项目，再次更改将会导致之前加密的所有数据变为不可加密。
• 现在只需要准备所有您的自定义化和模块。

准备部署。

• 运行命令 npm run lotgd-dev 为开发服务器构建版本，位于 dist/dev/。
• 运行命令 npm run lotgd-prod 为生产服务器构建版本，位于 dist/prod/。

提示

• Composer和包
  • 您可以根据项目需要添加新的依赖项，但请不要删除任何默认依赖项。
  • 注意：请勿更改依赖项的版本。

其他

阅读Wiki 获取更多信息。