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从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实例是从主线分支克隆的，克隆样本数据时请选择主线分支；如果是从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。