README

此组件旨在提供有关当前eShop安装的基本信息/事实。信息以两种方式提供

• 打印到STDOUT（通过设置VERBOSE=1环境变量触发）；
• 作为环境变量暴露给子进程。

输出

在执行脚本后提供以下信息

• ESHOP_PHP_BIN_PATH - 运行脚本时使用的PHP二进制文件的完整路径；
• ESHOP_FACT_BIN_PATH - 正在执行的当前oe-eshop-facts脚本的完整路径；
• ESHOP_FACT_BASEDIR - 可找到其他相关脚本的目录的完整路径；
• ESHOP_SOURCE_PATH - eShop运行时源代码和前端控制器的完整路径；
• ESHOP_BOOTSTRAP_PATH - eShop bootstrap.php文件的完整路径；
• ESHOP_CONFIG_PATH - eShop config.inc.php文件的完整路径；
• ESHOP_VENDOR_PATH - composer的vendor目录的完整路径；
• ESHOP_VENDOR_BIN_PATH - 由composer.json文件中定义的依赖项安装的二进制文件的完整路径；
• ESHOP_VENDOR_NAME - 用于OXID eSales AG标识符的composer供应商名称；
• ESHOP_OXID_VENDOR_PATH - 包含OXID eSales AG所有包/组件的目录的完整路径。

请注意，可以通过提供环境变量来覆盖上述列表中的任何变量，例如，为了更改PHP二进制文件的路径：

ESHOP_PHP_BIN_PATH=/usr/local/bin/php ./vendor/bin/oe-eshop-facts

输入

以下环境变量被接受

• VERBOSE - 启用详细模式，将所有事实打印到STDOUT；
• ESHOP_VERBOSE_FACTS - 仅对当前脚本启用详细模式。

脚本执行

当前的oe-eshop-facts脚本可用于执行由composer包/组件安装的其他脚本。给定的脚本将包含从输出部分上方可访问的所有事实，并提供为环境变量。要执行其他脚本，只需将其作为命令行参数提供，例如：

./vendor/bin/oe-eshop-facts my_custom_script

请注意，提供的脚本必须位于与oe-eshop-facts文件相同的目录中。

自定义composer命令

事实脚本可以用来为composer提供附加命令，因为它提供了访问eShop文件所需的所有必要信息，例如：

要使以下命令有效composer my_custom_script，只需添加

...
"require": {
  ...
  "oxid-esales/eshop-facts": "dev-master"
},
scripts: {
  "my_custom_script": "oe-eshop-facts my_custom_script"
}
...

潜在用途

为了更好地了解此组件的使用方式，以下是一些示例来探索

• 集成第三方数据库迁移工具
• 通过CLI执行eShop内部方法
  • 重新生成数据库视图
  • 清除eShop特定的缓存
• 通过CLI帮助修改eShop的配置
• 通过CLI导入/导出eShop数据
• 通过CLI执行各种批量操作