标签: 教程

在线翻译复制而成！

安装

安装文件应用程序非常简单，因为它只是一个文件。只需下载最新的文件index.php，将其放入您要查看或管理的文件夹中并加载到浏览器中。

下载

下载最新的文件应用index.php
放入您要查看或管理的文件夹。
将您的浏览器指向它上传的位置。

重命名 index.php

您可能已经有一个文件index.php，或者您只是想通过不同的 url 访问 Files 应用程序。只需重命名并加载到浏览器中index.php。anythingyouwant.php

存放`_files`

首次运行后，Files 应用程序将创建一个文件夹_files，用于存储缓存、配置和可选的包含文件。阅读更多

服务器

?check=1您可以通过附加到 URL来测试您的 PHP 和服务器的各种功能[参见演示]

配置

可选配置

尽管有许多配置选项，但除非您确实需要，否则无需进行更改。在大多数情况下，您只需将文件应用程序放入任何文件夹并使用默认选项即可。

还有高级javascript 配置选项和CSS 样式选项。

首次运行文件应用程序后，_files/config/config.php将创建配置文件，并注释掉所有默认配置选项。

_files/config/config.php

<?php // Uncomment the parameters you want to edit. return array ( //'root' => '', //'start_path' => false, //'username' => '', //'password' => '', //'load_images' => true, //'load_files_proxy_php' => false, //'load_images_max_filesize' => 1000000, //'image_resize_enabled' => true, //'image_resize_cache' => true, //'image_resize_dimensions' => 320, //'image_resize_dimensions_retina' => 480, //'image_resize_dimensions_allowed' => '', //'image_resize_types' => 'jpeg, png, gif, webp, bmp', //'image_resize_quality' => 85, //'image_resize_function' => 'imagecopyresampled', //'image_resize_sharpen' => true, //'image_resize_memory_limit' => 128, //'image_resize_max_pixels' => 30000000, //'image_resize_min_ratio' => 1.5, //'image_resize_cache_direct' => false, //'folder_preview_image' => true, //'folder_preview_default' => '_filespreview.jpg', //'menu_enabled' => true, //'menu_show' => true, //'menu_max_depth' => 5, //'menu_sort' => 'name_asc', //'menu_cache_validate' => true, //'menu_load_all' => false, //'menu_recursive_symlinks' => true, //'layout' => 'rows', //'sort' => 'name_asc', //'sort_dirs_first' => true, //'sort_function' => 'locale', //'cache' => true, //'cache_key' => 0, //'storage_path' => '_files', //'files_exclude' => '', //'dirs_exclude' => '', //'allow_symlinks' => true, //'title' => '%name% [%count%]', //'history' => true, //'transitions' => true, //'click' => 'popup', //'click_window' => '', //'click_window_popup' => true, //'code_max_load' => 100000, //'topbar_sticky' => 'scroll', //'check_updates' => false, //'allow_tasks' => false, //'get_mime_type' => false, //'context_menu' => true, //'prevent_right_click' => false, //'license_key' => '', //'filter_live' => true, //'filter_props' => 'name, filetype, mime, features, title', //'download_dir' => 'zip', //'download_dir_cache' => 'dir', //'allow_upload' => false, //'allow_delete' => false, //'allow_rename' => false, //'allow_new_folder' => false, //'allow_new_file' => false, //'allow_duplicate' => false, //'allow_text_edit' => false, //'demo_mode' => false, //'upload_allowed_file_types' => '', //'upload_max_filesize' => 0, //'upload_exists' => 'increment', //'popup_video' => true, //'video_thumbs' => true, //'video_ffmpeg_path' => 'ffmpeg', //'video_autoplay' => true, //'lang_default' => 'en', //'lang_auto' => true, );

编辑

要编辑选项，请在任何编辑器中打开 config.php 文件并找到要更改的属性。

//'root' => '',

通过删除取消注释选项//，更改值并保存：

'root' => '../different/path',

我可以直接在 index.php 中编辑配置选项吗？

您可以直接在 index.php 中编辑配置选项，但如果/当您升级 Files 应用程序时，更改将会丢失。仅当您的文件应用程序是临时/非持久性时才执行此操作。

配置

`root`

分配加载文件和目录的根路径。使用默认空''值，root 是当前目录。路径可以是相对的或绝对的。例子：

'root' => '', // default current directory, same as './' 'root' => 'content', // sub-directory 'content', same as './content' 'root' => '../', // parent directory 'root' => '/var/user/eddie/', // absolute path from server root

`start_path`

分配加载到视图中的第一个目录，默认为根目录。它可以是相对路径或绝对路径，但目录必须在root目录内。

'start_path' => '', // start path is same as root 'start_path' => 'galleries/birds', // custom start path relative to app

`username`

添加用户名和密码以通过登录保护您的文件应用程序。

'username' => 'myusername',

`password`

添加用户名和密码以通过登录保护您的文件应用程序。如果您不希望密码在 PHP 文件中暴露，您可以使用我们的md5() 哈希工具来加密您的密码。

'password' => 'mypassword', // non-encrypted 'password' => '$2y$10$KGVfb/j9GyxQYha6bQtYEuredsqfEMs7FQEyuoEFEgIRQAdb9gQES', // encrypted

`load_images`

加载预览图像。如果禁用，图标将代替图像显示。

'load_images' => true, // true | false

`load_files_proxy_php`

如果无法通过 URL 访问图像和文件，则强制通过 PHP 代理加载。

'load_files_proxy_php' => false, // true | false

`load_images_max_filesize`

直接加载到画廊的最大图像文件大小。如果图像文件大小超过此值，则会显示文件图标。此选项可用于防止大量图像直接加载到布局中，并且仅在您禁用image_resize_enabled.

'load_images_max_filesize' => 1000000, // 1000000 bytes ~ 1mb

`image_resize_enabled`

允许调整加载到画廊中的图像大小，强烈建议这样做。通常应与image_resize_cache启用一起使用。如果禁用，将加载原始源图像，这可能会很慢

'image_resize_enabled' => true, // true | false

`image_resize_cache`

允许缓存调整大小的图像，以显着提高连续访问的加载速度。调整大小的图像通常会缓存在您的storage_pathat 中_files/cache/images/*。

'image_resize_cache' => true, // true | false

`image_resize_dimensions`

默认调整大小的图像尺寸。默认 320 是可见质量和文件大小之间的良好平衡。

'image_resize_dimensions' => 320,

`image_resize_dimensions_retina`

调整高密度（视网膜）屏幕的图像尺寸。这使您可以为 HiDPI 屏幕提供更高质量的图像，但代价是文件大小稍大，缓存文件更多。如果要禁用它，请将此选项设置为 0。

'image_resize_dimensions_retina' => 480,

`image_resize_dimensions_allowed`

除了两个默认值之外，允许的调整大小尺寸的逗号分隔列表。不直接在文件应用程序中使用，但如果您想为使用文件的其他应用程序（例如嵌入应用程序）配置额外的图像大小，则很有用。例如“640、800、1024”。

'image_resize_dimensions_allowed' => '', // empty, only image_resize_dimensions and image_resize_dimensions allowed 'image_resize_dimensions_allowed' => '640, 800, 1024', // additional resize dimensions [640, 800, 1024] allowed

`image_resize_types`

要调整大小的图像类型的逗号分隔列表。例如，如果您想排除 PNG/GIF 图像以保留透明度和动画，这很有用。

'image_resize_types' => 'jpeg, png, gif, webp, bmp',

`image_resize_quality`

调整大小图像的 JPG 压缩级别。

'image_resize_quality' => 85,

`image_resize_function`

在imagecopyresampled（更平滑）和imagecopyresized（更快）之间进行选择。差异很小，但是如果您想在不使用图像调整大小缓存时更快地调整大小，则可以使用 imagecopyresized。

'image_resize_function' => 'imagecopyresampled',

`image_resize_sharpen`

创建更清晰（不太模糊）的预览图像。

'image_resize_sharpen' => true,

`image_resize_memory_limit`

调整大图像大小时临时增加 PHP 内存限制（如果需要）。默认值设置为 128 MB，这允许将图像大小调整到 ~ 6000 像素。如果您的默认 PHPmemory_limit已经高于指定的值，则它将无效。

'image_resize_memory_limit' => 128, // number

`image_resize_max_pixels`

设置调整图像大小时允许的最大像素（尺寸）。默认值为 30000000（30 兆像素），它允许将图像大小调整到大约 6000 x 5000 像素。此选项可防止服务器尝试调整图像大小超出功能和/或防止性能下降。

'image_resize_max_pixels' => 30000000, // number

`image_resize_min_ratio`

图像调整大小目标尺寸与源图像尺寸之间的最小比率差异。如果源图像仅比调整大小目标大 X 倍，则将使用源图像。如果源仅比调整大小的目标稍大，则创建调整大小的图像是没有意义的。

'image_resize_min_ratio' => 1.5, // number

`image_resize_cache_direct`

将尝试绕过 PHP 代理将缓存的调整大小图像的直接路径加载到图库中。可能会导致更快的图像加载和浏览器缓存。但是，如果启用此选项并删除图像缓存，则最终可能会丢失图像文件，因为您绕过了检查缓存调整大小图像是否存在的 PHP 代理。如果启用此选项并且您删除了图像缓存，您可能需要增加cache_key.

'image_resize_cache_direct' => false,

`folder_preview_image`

尝试为所有文件夹加载预览图像。这在大型文件夹和/或慢速服务器上可能会很慢。

'folder_preview_image' => true,

`folder_preview_default`

如果文件夹中存在此文件名，请始终将此文件名优先作为文件夹预览图像。如果您想为某些文件夹分配特定图像，或者如果您想分配隐藏的预览图像，或者如果您只是想避免扫描每个目录以将第一张图像用作预览的性能损失，这很有用。

'folder_preview_default' => '_filespreview.jpg',

`menu_enabled`

打开或关闭左侧文件夹菜单。您仍然可以在主视图区域内导航文件夹。* 如果根目录不包含任何文件夹，菜单将始终被禁用。

'menu_enabled' => true,

`menu_show`

切换左侧文件夹菜单默认展开或折叠。此选项对小屏幕（移动设备）无效，默认情况下菜单始终折叠。浏览器在切换时会记住该值，并且始终默认为菜单所处的最后状态。

'menu_show' => true,

`menu_max_depth`

分配递归文件夹的最大深度以加载到左侧菜单中。这是防止将无限级别的文件夹加载到菜单中的预防措施，这对于大型目录结构可能会很慢且效率低下。用户仍然可以直接从视图区域导航到更深的文件夹级别。

'menu_max_depth' => 5,

`menu_sort`

name_asc使用选项、name_desc和决定左侧文件夹菜单的排序date_asc方式date_desc。

'menu_sort' => 'name_asc', // name_asc, name_desc, date_asc, date_desc

`menu_cache_validate`

启用后，将验证菜单缓存以确保它与实际文件夹结构匹配。这种机制通常是必要的，以确保您所做的任何更改（新文件夹等）与菜单缓存文件相比得到验证。如果禁用，菜单将加载更快，但缓存仅针对根和根子文件夹进行验证。如果您有一个沉重但持久（不变）的文件夹结构，并且希望菜单快速加载，此功能可能很有用。如果启用并且您在子文件夹（新文件夹）中进行了更改，您将需要删除菜单缓存_files/cache/menu/*或增加选项cache_key。

'menu_cache_validate' => true,

`menu_load_all`

启用后，菜单中的所有文件夹都将预加载。单击菜单中的项目时，页面将立即显示而无需加载。此功能对于持久画廊和/或简单的根文件夹结构很有用。

'menu_load_all' => false,

`menu_recursive_symlinks`

在主菜单中列出符号链接的子目录。可能会导致无害的菜单循环或菜单中的重复项。

'menu_recursive_symlinks' => true,

`layout`

选项列表、图像列表、块、网格、行或列的默认画廊布局。布局还通过顶部栏布局下拉菜单进行控制，在这种情况下，它将覆盖默认布局。

'layout' => 'rows', // list, imagelist, blocks, grid, rows, columns

`sort`

根据选项名称、日期、文件大小和种类（文件类型）按升序或降序对文件进行默认排序。排序还通过顶部栏排序下拉菜单进行控制，在这种情况下，它将覆盖默认排序。

'sort' => 'name_asc', // name_asc, name_desc, date_asc, date_desc, filesize_asc, filesize_desc, kind_asc, kind_desc

`sort_dirs_first`

启用后，文件夹与文件混合时总是首先显示。

'sort_dirs_first' => true,

`sort_function`

分配用于对文件名进行排序的排序函数。使用默认locale选项，排序由 Javascript localeCompare()处理，它对 cAsE 不敏感的编号名称[2name<10name]进行排序，并根据浏览器区域设置解析 unicode [èáø] 。或者，basic排序稍微快一些，但可能无法正确解析编号名称和 unicode。您还可以指定一个locale，它决定了用于localeCompare()排序的语言。

'sort_function' => 'locale', // 'locale', 'basic', '[locale]'

`cache`

启用后，将为菜单和文件夹创建 JSON 缓存文件。强烈建议这样做，因为它允许菜单和文件夹在首次访问后加载得更快。缓存通常在_files/cache/*. 如果您不希望“文件”应用创建和缓存文件，可以禁用此选项。

'cache' => true,

`cache_key`

缓存数据与 cache_key 进行了验证。虽然缓存通常会自动更新，但是如果你想强制缓存刷新，你可以增加cache_key的数量。

'cache_key' => 0,

`storage_path`

定义 Files 应用程序将在何处存储缓存、配置和其他应用程序数据。默认设置为_files，这意味着所有数据都将存储在_files/*相对于应用程序的文件夹中。您通常不需要更改此值，除非您想将数据存储在不同的位置，或者如果您有多个共享同一存储的文件应用程序。存储路径可以是绝对的，也可以是相对于应用程序的。

'storage_path' => '_files',

`files_exclude`

PHP 正则表达式通常用于排除或仅包含某些文件类型和文件夹。正则表达式应用于不带路径的文件名 (basename)。您可以在phpliveregex.com测试正则表达式。

'files_exclude' => '', // empty default, no files are excluded 'files_exclude' => '/\.(pdf|jpe?g)$/i', // excludes all files that end with .pdf, .jpeg and .jpg / case insensitive

`dirs_exclude`

用于排除某些路径和文件夹的 PHP 正则表达式。正则表达式应用于相对于根目录的文件夹路径。

'dirs_exclude' => '', // empty default, no folders are excluded 'dirs_exclude' => '/\/eleph|\/football(\/|$)/i', // exclude dirs that start with "eleph" and dirs that match /football/*

`allow_symlinks`

允许“文件”应用显示和遵循符号链接。大多数情况下都可以正常工作，但是如果您的符号链接指向具有不同权限的磁盘上的位置或指向不在网站文档根目录中的位置，您可能会遇到问题。

'allow_symlinks' => true,

`title`

分配自定义页面<title>。您可以包含变量%name%和。如果您需要高级行为，则可以使用高级 javascript中的函数。%path%%count%_c.config.title

'title' => '%name% [%count%]', // 'title' => 'My website name › %name% [%count%]', // example with custom string prepended

`history`

启用后，浏览器将在您浏览文件夹时更改 URL ?path/to/folder。这也允许在共享 URL 时直接深度链接到文件和文件夹。

'history' => true,

`transitions`

在页面之间导航时启用转换。

'transitions' => true,

`click`

选择单击列表中的项目时触发的方法。默认值“popup”将适用于所有图像/视频文件，对于非图像文件回退到“modal”。

'click' => 'popup', // popup, modal, download, window or menu

`click_window`

单击时要在新窗口中直接打开的文件扩展名的逗号分隔列表。用于轻松查看 PDF、HTML 和文本文件，而不是先在文件应用程序中打开预览。

'click' => '', // empty, all file types open in click default 'click' => 'pdf, html', // Opens PDF and html in new browser window, allowing them to be previewed

`click_window_popup`

从click_window弹出式浏览器窗口中打开浏览器窗口，覆盖当前窗口。在预览 PDF、html 和文本类型文档时很有用。* 不适用于移动设备，新窗口将正常打开。

'click_window_popup' => true,

`code_max_load`

在代码查看器/编辑器中加载和预览的文本/代码文件的最大文件大小。这样做的目的是防止大量文本文件导致代码语法高亮显示界面迟钝。

'click_window_popup' => 100000, // default 100000 ~ 100kb

`topbar_sticky`

选择顶栏如何将自己附加到屏幕。默认值scroll将在向上滚动时将顶部栏附加到屏幕顶部，true将导致顶部栏始终保持固定，同时false将禁用固定顶部栏并恢复正常行为。

'topbar_sticky' => 'scroll', // 'scroll', true, false

`check_updates`

检查文件应用程序更新，如果有可用更新，则在顶部栏中显示铃铛图标，允许用户“更新”、“下载”或“阅读更多”。

'check_updates' => false,

`allow_tasks`

用于管理缓存的任务插件。* 尚未记录。

'allow_tasks' => null,

`get_mime_type`

设置为 true 以从服务器/PHP（慢）而不是从文件扩展名（更快）检测文件 mime 类型。这应该不是必需的，除非您的文件类型具有不正确的文件扩展名，或者出于安全原因您想要验证服务器上的文件类型。

'get_mime_type' => false,

`context_menu`

启用上下文菜单按钮和带有选项的右键单击菜单。

'context_menu' => true,

`prevent_right_click`

启用以阻止敏感项目（图像、列表项、菜单）上的浏览器右键单击菜单。

'prevent_right_click' => false,

`license_key`

在此处插入许可证密钥以解锁功能并删除许可证弹出窗口。

'license_key' => 'XX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX',

`filter_live`

对键盘输入进行实时搜索过滤。如果禁用，输入过滤器需要键盘返回或取消聚焦才能触发，如果您在文件夹中有 1000 个文件并希望防止不必要地触发慢速过滤，这可能很有用* 不适用于移动设备，它总是在“搜索”时触发或键盘隐藏。

'filter_live' => true,

`filter_props`

过滤时要使用的文件属性，属性越多处理越慢。属性名称、文件类型和 mime 适用于所有文件类型，而特征、标题、标题、描述、创建者、信用、版权、关键字、城市、子位置和省州可用于具有 IPTC 元的图像文件。

'filter_props' => 'name, filetype, mime, features, title', // default 'filter_props' => 'name, filetype, mime, features, title, headline, description, creator, credit, copyright, keywords, city, sub-location, province-state', // all

`download_dir`

设置为zip添加一个选项以将文件夹中的所有文件下载为 zip 文件。此选项需要PHP ZipArchive，并且要求服务器在提供之前先将所有文件压缩到 zip 中（这可能会很慢，直到它被缓存download_dir_cache）。或者，设置files为直接在浏览器中下载多文件，这在桌面上可以很好地工作，而不必先在服务器上压缩文件，但在移动设备上不起作用。

'download_dir' => 'zip', // 'zip', 'files', '' (disabled)

`download_dir_cache`

download_dir设置选项时，启用了创建ZIP文件的缓存zip。出于性能考虑，建议这样做，这样就无需在每次访问者点击下载时都创建 zip 文件。设置为直接dir存储_files.zip在当前文件夹或设置storage为存储在里面_files/zip/*。默认dir选项最有效，因为它允许文件应用程序检查 zip 缓存是否有效和更新，即使您更改文件夹名称也是如此。

'download_dir_cache' => 'dir', // 'dir' / 'storage' / '' /

`allow_upload`

允许上传文件。

'allow_upload' => false, // true | false

`allow_delete`

允许删除文件。

'allow_delete' => false, // true | false

`allow_rename`

允许重命名文件。

'allow_rename' => false, // true | false

`allow_new_folder`

允许创建新文件夹。

'allow_new_folder' => false, // true | false

`allow_new_file`

允许创建新文件。

'allow_new_file' => false, // true | false

`allow_duplicate`

允许复制文件。

'allow_duplicate' => false, // true | false

`allow_text_edit`

允许编辑文本和代码文件。

'allow_text_edit' => false, // true | false

`demo_mode`

启用后，将阻止所有文件管理器操作。主要用于 Files 应用演示。

'demo_mode' => false, // true | false

`upload_allowed_file_types`

允许上传文件类型的逗号分隔列表。列表可能包含部分匹配的扩展名或 mime 类型，例如pdf, doc, image/*. 如果为空（默认），则允许所有文件类型。

'upload_allowed_file_types' => '', // default, all file types are allowed 'upload_allowed_file_types' => 'pdf, doc, image/*', // *.pdf, *.doc and all image types are allowed

`upload_max_filesize`

设置允许上传的最大文件大小（字节）。默认值 0 表示没有限制，但最大文件大小将始终受到服务器的 PHPupload_max_filesize值的限制。

'upload_max_filesize' => 0, // default, no limit 'upload_max_filesize' => 1000000, // maximum file size 1000000 ~ 1MB

`upload_exists`

如果上传的文件名已存在于上传目标文件夹中，则决定如何处理。默认 'increment' 将通过附加一个数字重命名上传的文件，'overwrite' 将覆盖现有文件，而 'fail' 将导致上传失败。

'upload_exists' => 'increment', // increment filename, for example filename.jpg => filename-2.jpg 'upload_exists' => 'overwrite', // overwrite existing file if filename exists 'upload_exists' => 'fail', // upload fail of filename exists

`popup_video`

启用后，在弹出窗口中打开视频格式，允许用户在其他弹出项目之间导航。如果禁用，视频将以简单模式打开。

'popup_video' => true,

`video_thumbs`

为视频文件创建缩略图。此选项需要启用FFmpeg和 PHP exec() 。处理视频缩略图很慢，但它们会像调整大小的图像一样被缓存

'video_thumbs' => true, // true | false

`video_ffmpeg_path`

用于创建视频缩略图的FFmpeg命令行路径。通常只是“ffmpeg”，但有些服务器需要FFmpeg应用程序的完整路径。

'video_ffmpeg_path' => 'ffmpeg',

`video_autoplay`

当用户单击以在弹出窗口中打开视频时自动播放视频。

'video_autoplay' => true,

`lang_default`

如果浏览器语言不受支持或被lang_auto禁用，则默认界面语言。

'lang_default' => 'en',

`lang_auto`

根据检测到的浏览器语言自动分配界面语言。

'lang_auto' => true,

CSS 样式

多亏了CSS 变量，您可以轻松更改文件应用程序中的许多样式，而无需付出太多努力。只需创建一个文件_files/css/custom.css，并包含您自己的 CSS 变量。例如，要从 seagreen 更改主要原色：

:root { --primary-color: deeppink; }

结果将如下所示： --primary-color=deeppink

CSS

您将在下面找到所有现有自定义属性的列表。

:root { --primary-color: seagreen; --popup-bg: #000; --popup-placeholder-bg: #222; --popup-timer-color: white; --popup-caption-max-width: 640px; --popup-caption-font-size: .9rem; --popup-caption-font-weight: 300; --popup-caption-line-height: 135%; --popup-caption-color --popup-caption-item-space: .35em; --popup-caption-line-clamp: 3; --files-data-top: 0; --files-data-display: none; --files-data-display-hover: block; --files-data-animation: opacity .2s; --grid-height: 100%; --grid-font-size: 14px; --list-max-width: 1040px; --rows-height: auto; --rows-justify-content: space-evenly; --rows-flex-grow: 1; --sidebar-width: calc(10vw + 180px); --sidebar-width-small: 85vw; --sidebar-width-hover: 480px; --menu-font-size: 16px; --menu-line-height: 30px; --menu-folder-icon-size: 22px; --menu-text-indent: 6px; --menu-icon-toggle-opacity: 0; }

自定义 CSS

也可以包含您自己的 CSS 样式。但是，这需要对 CSS 和 HTML 有很好的理解，因为您最终可能会破坏界面。

FFmpeg 视频预览

视频预览图像需要在服务器上安装 FFmpeg。
ffmpeg.org

如果它是您自己的服务器或者您具有命令行访问权限，则可以安装此工具。如果您在共享主机上，您不太可能访问 FFmpeg，但您可以随时询问您的托管服务。

视频预览

创建视频预览图像可能会很慢，这可能是因为打开视频和导航帧以提取预览图像帧的内部过程。首次创建预览后，它将被缓存，因此在连续访问时加载速度会更快。

文件管理器

文件管理器选项包括上传、删除、重命名、复制、编辑文本、创建新文件夹和创建新文件的功能。

安全

启用文件管理器功能时应该小心，因为您基本上允许用户在服务器上创建和修改文件。分配登录名是个好主意，否则您应该确保没有不受欢迎的客人可以访问。

文件管理器

在 config.php 中，您会发现以下选项，默认情况下全部禁用。

'allow_upload' => false, 'allow_delete' => false, 'allow_rename' => false, 'allow_new_folder' => false, 'allow_new_file' => false, 'allow_duplicate' => false, 'allow_text_edit' => false,

上传器

此外，您会在 config.php 中找到以下选项，专门用于上传器。

'upload_allowed_file_types' => '', // comma-separated list of allowed upload file types / empty = allow any / 'jpeg, jpg, image/*' 'upload_max_filesize' => 0, // [bytes] / 0 = unlimited (but limited by server PHP upload_max_filesize) 'upload_note' => '', // include a small text note at bottom of uploader / 'Max file size %upload_max_filesize%' 'upload_exists' => 'increment', // 'increment' / 'overwrite' / 'fail'

自定义包括

如果您希望包含自定义元标记、html、css 或 Javascript，文件应用程序将从您的_files存储路径中查找要包含的以下文件：

include/head.html css/custom.css include/footer.html js/custom.js

include/head.html

用于添加计数器、统计信息（如 Google Analytics）和进入文档标签的元<head>标签。

css/custom.css

使用 CSS 变量自定义 CSS 样式阅读更多

include/footer.html

</body>就在结束标签的上方。用于触发自定义 javascript。

js/custom.js

加载自定义 javascript 文件。

高级 Javascript 配置

尽管主文件配置部分包含最有用的选项，但也有一些高级 Javascript 选项可供希望调整界面的人使用。

这些选项与主配置分开的原因：

避免使用大多数用户不需要的高级选项使主配置混乱。
仅限 Javascript 选项的高级嵌套配置逻辑。
许多 Javascript 选项都是函数，需要直接从 Javascript 中声明。

首先，_files/js/custom.js在您的storage_path.

_files/js/custom.js

打开文件并包含您的自定义选项。在下面的示例中，我们将弹出图像分配给图像click，zoom而不是导航到上一个/下一个。

_files/js/custom.js

_c.config = { popup: { click: 'zoom', // prev_next, next, zoom } }

以下是具有默认值的所有当前选项的列表：

_c.config = { // custom context menu (dropdown) options contextmenu: { rotate: { text: 'rotate', icon: 'rotate_right', condition: (item) => item.browser_image, // href: (item) => {}, action: (item) => _h.popup(null, null, null, item.url_path) } } // download_dir options download_dir: { javascript: true, // Use the Javascript downloads API to download zip files current_dir_only: true // Only assign download dir button to current directory }, // favicon // Add your own encoded inline favicon or false to disable / SVG https://yoksel.github.io/url-encoder/ favicon: "<link rel=\"icon\" href=\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='%2337474F' d='M20,18H4V8H20M20,6H12L10,4H4C2.89,4 2,4.89 2,6V18A2,2 0 0,0 4,20H20A2,2 0 0,0 22,18V8C22,6.89 21.1,6 20,6Z' /%3E%3C/svg%3E\" type=\"image/svg+xml\" />", // history_scroll / attempts to restore scroll position on browser history navigation history_scroll: true, // custom language options lang: { // assign language menu in topbar / true = all / false = no menu (default) menu: ['pt', 'en', 'zh'], // Portuguese, English, Chinese // override or create new languages langs: { fr: { logout: 'déconnexion' }, no: { date: 'dato', flag: 'no' } } }, // load_svg_max_filesize 100kb / because complex SVG vector files will slow down rendering in browser load_svg_max_filesize: 100000, // panorama options panorama: { // function to detect panorama equirectangular source file is_pano: (item) => { var d = item.dimensions; // >=2048px && ratio 2:1 with 1% pixel margin return d[0] >= 2048 && Math.abs(d[0]/d[1] - 2) < 0.01; } }, // popup options popup: { captionEl: true, // show popup caption caption_hide: true, // Auto-hide popup caption on mouse inactivity caption_style: 'block', // caption style: block, box, subtitles, gradient, topbar, none caption_align: 'center-left', // caption align: left, center-left, center, right click: 'prev_next', // popup click: prev_next, next, zoom zoomEl: false, // show zoom button playEl: false, // show slideshow play button transition: 'glide', // slideshow transition: none, slide, glide, fade, zoom, pop, elastic play_transition: null, // assign transition for slideshow (same as above). Inherits main transition by default bgOpacity: .95, // background opacity play_interval: 5000, // slideshow play interval loop: false, // loop slideshow transitions: { // custom transitions Object mytransition: function(dir){ return { translateX: [10 * dir, 0], opacity: [.1, 1], duration: 1000, easing: 'easeOutQuart' } } } }, // custom page <title> function / below is default title: (path, name, error, count) => { return (name || '/') + (error ? '' : ' [' + count + ']'); }, // uppy uploader interface options uppy: { note: 'Upload images only, maximum %upload_max_filesize%', locale: '' // https://github.com/transloadit/uppy/tree/main/packages/%40uppy/locales/src DropTarget: false, Webcam: false, // https://uppy.io/docs/webcam/ ImageEditor: { // https://uppy.io/docs/image-editor/ quality: 0.8, cropperOptions: {}, actions: {} } }, }

语

默认情况下，界面语言将根据检测到的浏览器语言自动加载。

工作正在进行中

翻译工作正在进行中。随着我们添加新功能，一些文本仍为英文。

来自

如果需要，访问者可以通过将参数附加到浏览器中的 url 来覆盖语言选项。

指定特定

如果访问者希望覆盖指定的语言，只需?lang={code}在浏览器中附加即可。

https://demo.files.gallery/?lang=fr

重置

如果访问者想要重置任何以前分配的语言，只需?lang=reset在浏览器中附加即可。

https://demo.files.gallery/?lang=reset

lang_menu可以通过附加来启用语言菜单（配置选项） lang_menu=1。

https://demo.files.gallery/?lang_menu=1

看演示

语言配置

中可用的语言配置选项config.php。

`lang_default`

如果浏览器语言不受支持或被lang_auto禁用，则默认界面语言。

'lang_default' => 'en'

`lang_auto`

根据检测到的浏览器语言自动分配界面语言。

'lang_auto' => true

添加新的自定义

如果您要使用的语言不存在或者您只是想添加自己的语言，您可以添加语言文件_files/lang/{code}.json。如果您希望语言根据浏览器语言自动加载，则需要按照语言代码约定命名[参见 ref]。如果您希望您的新语言作为默认语言，请更改选项'lang_default' => '{code}'，并设置'lang_auto' => false是否不希望从浏览器自动分配语言。添加翻译时使用以下默认语言模板：

{ "blocks": "", "columns": "", "copy link": "", "copy text": "", "date": "", "delete": "", "directory is empty": "", "download": "", "duplicate": "", "error": "", "fail": "", "files": "", "filter": "", "folders": "", "google maps": "", "grid": "", "imagelist": "", "images": "", "kind": "", "language": "", "layout": "", "list": "", "loading": "", "login": "", "logout": "", "matches found for": "", "name": "", "new file": "", "new folder": "", "open in new tab": "", "rename": "", "rows": "", "save": "", "show info": "", "size": "", "sort": "", "space": "", "uniform": "", "upload": "", "zoom": "" }

语言 javascript

您还可以从javascript config扩展语言并分配语言选项。

_c.config = { // custom language options lang: { // assign language menu items in topbar / true = all / false = no menu (default) menu: ['pt', 'en', 'zh'], // Portuguese, English, Chinese // override or create new languages langs: { fr: { logout: 'déconnexion' }, no: { date: 'dato', flag: 'no' } } }, }

提交语言

随时提交新语言或对现有翻译的改进。我们将在官方版本中包含改进。

故障排除

如果遇到问题，您要做的第一件事是检查“文件”应用程序的内置诊断程序。此操作将专门检查文件应用程序对某些功能所需的服务器/PHP 功能。?check=1通过附加到您的文件应用程序 url在浏览器中访问您的诊断。

https://yourwebsite.com/?check=1

见演示： demo.files.gallery/?check=1

如需支持，请在forum.files.gallery中发布问题

更新

更新文件

更新文件应用程序就像安装. 只需下载最新的文件应用程序index.php并替换您现有的文件应用程序 index.php。您的配置设置将保留在_files/config/config.php.

索引.php

如果您出于某种原因index.php直接进行了编辑，则这些更改将丢失。

在文件

如果您在configcheck_updates中启用了该选项，当有可用更新时，您将直接在 Files 应用程序中收到通知。此外，您可以直接从界面选择“更新”、“下载”或“阅读更多”。默认情况下禁用此选项，因为您可能不希望此选项公开可用。

上一篇
cdn.jsdelivr.net无法访问解决方法

下一篇
CloudFlare Workers 设置使用自定义域名

版权声明：《 files.photo.gallery安装配置》为吐司猫原创文章，转载请注明出处！
最后编辑:2022-6-5 17:06:14

files.photo.gallery安装配置

重命名 index.php

存放_files路径

服务器诊断

可选配置

编辑配置

我可以直接在 index.php 中编辑配置选项吗？

配置选项

root

start_path

username

password

load_images

load_files_proxy_php

load_images_max_filesize

image_resize_enabled

image_resize_cache

image_resize_dimensions

image_resize_dimensions_retina

image_resize_dimensions_allowed

image_resize_types

image_resize_quality

image_resize_function

image_resize_sharpen

image_resize_memory_limit

image_resize_max_pixels

image_resize_min_ratio

image_resize_cache_direct

folder_preview_image

folder_preview_default

menu_enabled

menu_show

menu_max_depth

menu_sort

menu_cache_validate

menu_load_all

menu_recursive_symlinks

layout

sort

sort_dirs_first

sort_function

cache

cache_key

storage_path

files_exclude

dirs_exclude

allow_symlinks

title

history

transitions

click

click_window

click_window_popup

code_max_load

topbar_sticky

check_updates

allow_tasks

get_mime_type

context_menu

prevent_right_click

license_key

filter_live

filter_props

download_dir

download_dir_cache

allow_upload

allow_delete

allow_rename

allow_new_folder

allow_new_file

allow_duplicate

allow_text_edit

demo_mode

upload_allowed_file_types

upload_max_filesize

upload_exists

popup_video

video_thumbs

video_ffmpeg_path

video_autoplay

存放`_files`

服务器

编辑

配置

`root`

`start_path`

`username`

`password`

`load_images`

`load_files_proxy_php`

`load_images_max_filesize`

`image_resize_enabled`

`image_resize_cache`

`image_resize_dimensions`

`image_resize_dimensions_retina`

`image_resize_dimensions_allowed`

`image_resize_types`

`image_resize_quality`

`image_resize_function`

`image_resize_sharpen`

`image_resize_memory_limit`

`image_resize_max_pixels`

`image_resize_min_ratio`

`image_resize_cache_direct`

`folder_preview_image`

`folder_preview_default`

`menu_enabled`

`menu_show`

`menu_max_depth`

`menu_sort`

`menu_cache_validate`

`menu_load_all`

`menu_recursive_symlinks`

`layout`

`sort`

`sort_dirs_first`

`sort_function`

`cache`

`cache_key`

`storage_path`

`files_exclude`

`dirs_exclude`

`allow_symlinks`

`title`

`history`

`transitions`

`click`

`click_window`

`click_window_popup`

`code_max_load`

`topbar_sticky`

`check_updates`

`allow_tasks`

`get_mime_type`

`context_menu`

`prevent_right_click`

`license_key`

`filter_live`

`filter_props`

`download_dir`

`download_dir_cache`

`allow_upload`

`allow_delete`

`allow_rename`

`allow_new_folder`

`allow_new_file`

`allow_duplicate`

`allow_text_edit`

`demo_mode`

`upload_allowed_file_types`

`upload_max_filesize`

`upload_exists`

`popup_video`

`video_thumbs`

`video_ffmpeg_path`

`video_autoplay`

`lang_default`

`lang_auto`

CSS

自定义 CSS