dd/evolutioncms-snippets-ddgetfileinfo

此包的最新版本（2.5.0）没有提供许可证信息。

显示有关文件的信息：类型、MIME、可读格式的大小、路径、名称、扩展名等。

维护者

详细信息

github.com/DivanDesign/EvolutionCMS.snippets.ddGetFileInfo

主页

源代码

问题

聊天

安装: 1

依赖关系: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 0

开放问题: 0

类型:modxevo-snippet

2.5.0 2021-04-25 20:05 UTC

Requires

Unknown License 2d5e28f6e8ab9ad1e45fa80ef96338b3d85d0a24

file extensionmodxMODX Evofile typeevofile infomodx evolutionfile mimefile sizehuman readable file sizeevo cmsevolutioncmsevolution cmsdivandesigndd studiodd groupddgetfileinfoget file infofile size in human formatreadable file sizefile size in mb

This package is auto-updated.

Last update: 2024-09-06 07:34:35 UTC

README

显示有关文件的信息：类型、MIME、可读格式的大小、路径、名称、扩展名等。

要求

文档

安装

手动

1. 元素 → 片段：创建一个新片段，以下数据
  1. 片段名称：ddGetFileInfo。
  2. 描述：<b>2.5</b> 显示文件信息：类型、MIME、可读格式的大小、路径、名称、扩展名等。
  3. 类别：核心。
  4. 解析 DocBlock：否。
  5. 片段代码（PHP）：从存档中插入 ddGetFileInfo_snippet.php 文件的内容。
2. 元素 → 管理文件
  1. 创建一个新文件夹 assets/snippets/ddGetFileInfo/。
  2. 将存档提取到文件夹中（除了 ddGetFileInfo_snippet.php）。

使用 (MODX)EvolutionCMS.libraries.ddInstaller

只需在您的源中运行以下 PHP 代码或在 控制台

//Include (MODX)EvolutionCMS.libraries.ddInstaller
require_once(
	$modx->getConfig('base_path') .
	'assets/libs/ddInstaller/require.php'
);

//Install (MODX)EvolutionCMS.snippets.ddGetFileInfo
\DDInstaller::install([
	'url' => 'https://github.com/DivanDesign/EvolutionCMS.snippets.ddGetFileInfo',
	'type' => 'snippet'
]);
  • 如果您的站点上不存在 ddGetFileInfo，则 ddInstaller 将仅安装它。
  • 如果您的站点上已经存在 ddGetFileInfo，则 ddInstaller 将检查其版本并在需要时更新它。

参数描述

  • file

    • 描述：文件名（路径）。
    • 有效值
      • stringFilePath — 文件路径可以是相对于网站根目录的（开头不包含 / 不重要，两种变体都受支持），或完整路径（包括 $modx->config['base_path']）
      • stringUrl — 您不仅可以指定本地文件，还可以指定互联网地址，但出于客观原因，在这种情况下，并非所有功能都受支持
    • 必需

  • file_docField

    • 描述：包含文件路径的文档字段（包括 TV）（如果要从文档字段获取片段的文件地址）。
    • 有效值：string
    • 默认值：—

  • file_docId

    • 描述：资源 ID，从该字段中获取文件地址。
    • 有效值：integerDocId
    • 默认值：—

  • sizeUnitFormat

    • 描述：文件大小单位的格式。
      值不区分大小写（以下名称相同：'enshort'、'EnShort'、'ENSHORT' 等）。
    • 有效值
      • 'none'
      • 'EnShort' — 例如 MB
      • 'EnFull' — e. g. Megabyte
      • 'RuShort' — 例如 Мб
      • 'RuFull' — e. g. Мегабайт
    • 默认值：'EnShort'

  • sizePrecision

    • 描述：要四舍五入到的十进制位数。
    • 有效值：integer
    • 默认值：2

  • output

    • 描述：要输出的文件信息（如果未设置 tpl）。
    • 有效值
      • 'size'
      • 'extension'
      • 'type'
      • 'typeMime'
      • 'name'
      • 'path'
    • 默认值：'size'

  • tpl

    • 描述：输出模板（如果参数不存在，则返回与 output 对应的文件数据）。
      可用占位符
      • [+file+] — 完整文件地址
      • [+name+] — 文件名
      • [+path+] — 文件路径
      • [+size+] — 以人类可读格式带有单位的文件大小
      • [+extension+] — 文件扩展名
      • [+type+] — 文件类型
        • 'archive'
        • 'image'
        • 'video'
        • 'audio'
        • 'text'
        • ‘pdf’
        • ‘word’
        • ‘excel’
        • ‘powerpoint’
      • [+typeMime+] —— MIME格式的内容类型（仅用于本地文件，不用于URL）
    • 有效值
      • stringChunkName
      • string —— 使用以@CODE:开头的内联模板
    • 默认值：—

  • tpl_placeholders

    • 描述：需要将附加数据传递给tpl。
      也支持嵌套对象和数组
      • {"someOne": "1", "someTwo": "test" } ——> [+someOne+], [+someTwo+]。
      • {"some": {"a": "one", "b": "two"} } ——> [+some.a+]，[+some.b+]。
      • {"some": ["one", "two"] } ——> [+some.0+]，[+some.1+]。
    • 有效值
      • stringJsonObject —— 作为JSON
      • stringHjsonObject —— 作为HJSON
      • stringQueryFormated —— 作为查询字符串
      • 也可以将其设置为原生PHP对象或数组（例如，通过$modx->runSnippet调用）
        • 关联数组
        • 对象
    • 默认值：—

示例

通过\DDTools\Snippet::runSnippet运行片段，不使用数据库和eval

//Include (MODX)EvolutionCMS.libraries.ddTools
require_once(
	$modx->getConfig('base_path') .
	'assets/libs/ddTools/modx.ddtools.class.php'
);

//Run (MODX)EvolutionCMS.snippets.ddGetFileInfo
\DDTools\Snippet::runSnippet([
	'name' => 'ddGetFileInfo',
	'params' => [
		'file' => 'assets/images/evo-logo.png',
		'output' => 'size'
	]
]);

链接