README

MonkeyData XML库文档

感谢您选择我们的库进行实施。该库已准备好轻松实现MonkeyData的XML数据。我们已尝试纠正所有可能的错误，以确保最大可靠性、数据和时间的复杂性。

该库旨在简化使用您在线商店的订单创建XML文件，其中包含从特定日期到订单日期的参数。它还实现了两种基本的身份验证方式，这些方式可以在MonkeyData库本身中设置。如果您不想关心输出的XML结构、正确的标题或安全问题，那么您不必担心。

库安装

注意：PHP的最低版本要求为5.3.0

1. Composer

使用以下命令使用Composer要求此包

composer require monkey-data/online-store-xml-feed-generator

2. 直接

https://github.com/MonkeyData/php-online-store-xml-feed-generator/archive/master.zip

在“资源”部分下载库，然后将其解压缩到您的项目中的任何位置。通常，外部库放置在“libs”、“vendor”或类似的位置。一切取决于您的在线商店解决方案。还可以独立于项目运行库。为了实现，只需创建一个Web空间并在其中编写库代码。

快速实施示例

有一个“example”文件夹，其中包含3个示例实现文件，不使用composer自动加载。这些文件应复制到可以从您的Web浏览器访问的文件夹中。
根据您的数据库结构编辑模型'MonkeyDataXmlModel'，以从数据库中获取所有所需的数据。

安全性

出于安全考虑，使用哈希。安装后，将生成一个随机哈希，但建议您在'config.hash'中设置自己的哈希。

哈希是必需的

例如（请勿使用此示例）

b6eb6a84aeac1f937c354dc3b826c83e

您的数据源URL必须包含哈希参数。例如

https://{domain}/{path_to_generator_script}/?hash={hash}
https://domain.com/monkeydata-generator/?hash=b6eb6a84aeac1f937c354dc3b826c83e

实施示例

我们已准备了快速且易于实施的示例。在浏览器中打开您的库地址。例如：https:///vas-eshop/vendor/MonkeyData/?hash=123456。如果此Web空间可访问（不是通过 .htaccess 禁止），则窗口中将出现示例XML（index.php的开始）。如果您在应用程序中有用于脚本的脚本空间，该空间不是公开可访问的，请将index.php文件放入应用程序的公共部分，并在require函数中重写文件跟踪。

index.php文件包含以下行

// MonkeyDataExampleXmlGenerator should be loaded via autoload

$xmlGenerator = new MonkeyDataExampleXmlGenerator();
$xmlGenerator->run();

如果您一切操作正确，示例XML将在浏览器中打开。

现在，是时候解释这些文件的意义以及如何确保您的输出XML正确显示实际订单而不是示例订单了。

autoloader.php文件负责加载所有必需的类。它包含MyAutoloud函数，该函数放入所有自动加载器队列中（如果自动加载器队列不活动，则自动激活）并打开整个MonkeyData库供您的在线商店使用。当然，您可以使用自己的自动加载器。在这种情况下，库位置在命名空间MonkeyData/XmlGenerator/...中。命名空间完全符合目录结构，这应该使实施更容易。

MonkeyDataXmlModel.php 是基本 XmlModel 的具体实现，包括 7 个基本功能（您将实现这些功能）以及输出示例，它还包括通过 PDO 连接到 MySQL 数据库的连接设置和安全设置（详情请见特定部分）。

MonkeyDataExampleXmlGenerator.php 是一个类，用于将我们的 MonkeyDataXmlModel 连接到生成 XML 输出的库。

实现

您的任务是使用预定义的接口（CurrentXmlModelInterface）实现该模型。该接口定义了 7 个基本功能，您将在这 7 个功能中编程从您的电子商务数据库中选取数据。

getOrdersItems()
getPaymentsItems()
getShippingsItems()
getProductsItems()
getOrderStatusesItems()
getCustomersItems()
getCategoriesItems()

特定功能的详细描述在各自的章节中，其中描述了每个行为方面以及与其他库部分的链接。

为了便于安装，我们已经通过 PDO 准备了一个 MySQL 数据库连接（在模型类的 $this->connection 变量中）。如果您决定使用预处理 PDO，请在模型的标题中设置您的数据库登录信息。

protected $config = array(
        'database' => array(
            'use' => true,
            'host' => "localhost",
            'name' => "db_name",
            'user' => "db_user",
            'pass' => "db_pass"
        )
    );

反馈

请随时提交问题，发送您的反馈和建议。

如果您需要帮助，请通过电子邮件联系 MonkeyData 开发者，邮箱地址为 api@monkeydata.com。

monkey-data / 在线商店XML数据生成器

维护者

详细信息