README

Magento 示例数据包括一个示例商店，包含超过 250 个产品（其中约 200 个是可配置产品），类别，促销价格规则，CMS 页面，横幅等。示例数据在商店前端使用 Luma 主题。

安装示例数据是可选的。

技术上，示例数据是一组常规 Magento 模块，可以与 Magento 实例一起部署和安装，或者在升级的范围内稍后安装。

部署示例数据

您可以从以下来源之一部署示例数据

• 从 Magento Composer 仓库，可选地使用 Magento CLI
• 从 Magento GitHub 仓库

如果您的 Magento 代码库是从主线分支克隆的，您可以使用示例数据的任何来源。如果是从 develop 分支克隆的，请使用 GitHub 仓库，并选择从 develop 分支获取示例数据模块。

从 Composer 仓库部署示例数据

要使用 Magento CLI 从 Magento Composer 仓库部署示例数据

1. 如果您的 Magento 实例已经安装，请跳过此步骤。否则，在 Magento 根目录下运行：# composer install。
2. 在 Magento 根目录下运行：# bin/magento sampledata:deploy。此命令从模块的 suggest 部分的 composer.json 文件收集依赖项，这些部分建议安装示例数据（如 Magento_Catalog，Magento_Sales 等）。

不使用 Magento CLI 从 Magento Composer 仓库部署示例数据

1. 在根 composer.json 文件的 require 部分指定示例数据包，例如

{
    "require": {
        ...
        "magento/module-catalog-sample-data": "{version}",
        "magento/module-configurable-sample-data": "{version}",
        "magento/module-cms-sample-data": "{version}",
        "magento/module-sales-sample-data": "{version}"
        ....
    }
}

其中 <version> 是包的版本；它应该与 Magento 实例的版本相对应。

每个包对应一个示例数据模块。可用模块的完整列表可以在 [示例数据 GitHub 仓库] (https://github.com/magento/magento2-sample-data/tree/develop/app/code/Magento) 中查看

1. 要更新依赖项，在 Magento 根目录下运行：# composer update

从 GitHub 仓库部署示例数据

要从 GitHub 仓库部署示例数据

1. 从 https://github.com/magento/magento2-sample-data 克隆示例数据。如果您的 Magento 实例是从主线分支克隆的，请选择克隆示例数据时选择主线分支；如果 Magento 是从 develop 分支克隆的，请选择 develop 分支。
2. 通过运行以下命令将示例数据和您的 Magento 实例链接起来：# php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"

安装示例数据

一旦部署了示例数据，在您使用命令行安装或升级 Magento 实例时，它将自动安装。

卸载示例数据

要从代码库中删除示例数据模块，从 Magento 根目录运行以下命令之一

• 如果示例数据是从 Composer 仓库部署的，运行：# bin/magento sampledata:remove
• 如果示例数据是从 GitHub 仓库部署的，并将其链接到您的 Magento 实例，运行：# php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php – --command=unlink --ce-source="<path_to_your_magento_instance>"

要删除示例数据模块提供的产品和其他实体，请删除数据库并使用干净数据库重新安装 Magento。

重新安装示例数据

如果您已删除示例数据提供的某些实体并希望恢复它们，请执行以下步骤

1. 从 Magento 根目录运行以下命令：# bin/magento sampledata:reset
2. 如常升级 Magento。

被删除的样本数据实体将得到恢复。那些已更改的实体将保留这些更改，并将不会恢复到默认视图。

文档

您可以在以下链接找到更多关于样本数据操作流程的详细描述：https://devdocs.magento.com/guides/v2.4/install-gde/install/cli/install-cli-sample-data.html。