简约精致的目录浏览程序：Files Photo Gallery

文章	评论	标签
143	296	6

引言

灵均说尽孤高事，全与逍遥意不同。 ——勿埋我心

该程序给勿埋我心的感觉就是特别的简单，从头到尾就是一个php文件。但是它能够实现的功能却不容小觑。它用作在线相册是个不错的选择。

简单介绍一下

Files是一个单文件的PHP应用程序，可以拖放到任何目录中，从而可以浏览其中的文件和目录。它支持所有文件类型，并允许您预览图像、视频、音频和代码。

单个文件。只需将它放入服务器上的任何目录中即可。
实时搜索和排序文件。
可实时切换的高级列表和库布局。
预览照片的 IPTC、EXIF 和 GPS 地图。
使用缓存机制和 CDN 快速加载。
高级树菜单导航显示整个目录结构。
美丽的代码荧光笔，用于查看和编辑代码格式。
可选登录以保护访问。
上传，移动，复制和删除文件即将推出！

🔗Demo地址：https://files.photo.gallery/demo/

如何安装？

这里以宝塔为例吧，这个比较简单直接。

一、下载源码

下载地址（已破解成品，可以直接使用）：https://github.com/wusuov/files.photo.gallery

二、放入恰当的目录

可以将文件名改成你想要的名字，比如：qiantigers.php

三、安装PHP拓展

需要的PHP拓展：GD、mbstring、fileinfo、exif

宝塔已经默认安装了GD和mbstring，只需要安装：fileinfo、exif

可以额外安装：imagemagick

四、重启PHP

配置相关参数

路径

参数	解释说明
'root' => ' '	可以填写相对路径或者绝对路径，不填代表当前目录
'start_path' => false	分配加载到视图中的第一个目录，默认情况下，该目录与root目录相同。它可以是相对路径，也可以是绝对路径，但是该路径必须在根目录下。

参数	解释说明
'username' => ' '	添加用户名，以通过登录保护您的“文件”应用程序。
'password' => ' '	添加密码，以通过登录保护您的“文件”应用程序。需要使用该工具进行加密

图片

参数	解释说明
'load_images' => true	如果禁用，则不显示缩略图。
'load_files_proxy_php' => false	如果无法通过URL（由于任何原因）访问图像，则强制通过PHP代理加载图像。
'load_images_max_filesize' => 1000000	可直接加载到图库中的最大图像文件大小。如果文件大小超过此值，它将被文件图标代替。不会影响有效调整尺寸的图像。这样做的目的是防止大量图像直接加载到图库布局中，从而导致加载缓慢和界面呆滞卡顿，这样会很影响体验。
'load_svg_max_filesize' => 100000	最大SVG文件大小，可直接加载到图库中。如果文件超过该值，它将被文件图标代替。这样做的目的是防止复杂的SVG形状缓慢渲染并导致缓慢的界面。
'image_resize_enabled' => true	允许调整加载到图库中的图像的大小。
'image_resize_cache' => true	允许缓存调整大小的图像以提高加载速度。调整大小的图像通常会缓存在`_files/cache/images/*`的`storage_path`中。
'image_resize_dimensions' => 320	默认图像调整尺寸。适合调整大小的图像的图像宽度，因此它们在所有“文件”库布局中看起来都不错。
'image_resize_dimensions_retina' => 480	服务器用于高密度屏幕（视网膜）的较大图像调整尺寸。这将为视网膜屏幕生成更高质量的图像，但最终将导致图像缓存大小增加一倍。如果不需要，设置为false。
'image_resize_quality' => 85	JPG压缩级别，用于调整大小的图像。
'image_resize_function' => 'imagecopyresampled'	PHP图像调整大小函数。之间选择 imagecopyresampled（平滑）和 imagecopyresized（快点）。质量差异很小，但是imagecopyresampled的质量更高，而imagecopyresize的速度则快两倍。例如，如果要在不使用缓存时更快地调整大小，则可以使用imagecopyresize。这是勿埋我心的参考，具体可以自己比较一下。
'image_resize_sharpen' => true	创建更清晰（模糊程度较小）的预览图像。
'image_resize_memory_limit' => 128	在调整大图像大小时，临时增加PHP内存限制（如果需要）。默认值设置为128 MB，这可以将图像调整为最大〜6000 px。如果您的PHP `memory_limit`已经高于该值，则将无效。
'image_resize_max_pixels' => 30000000	设置调整图像大小的最大允许尺寸。默认值为30000000（30兆像素），它允许将图像的大小调整为大约6000 x 5000像素。可以使用此选项来防止服务器尝试将图像大小调整为超出功能范围和/或防止性能降低。勿埋我心建议这个也调大，默认值是超过大约6000 x 5000像素的图片就不进行缩略生成。
'image_resize_min_ratio' => 1.5	图像调整大小目标尺寸和原始图像尺寸之间的最小比率差。如果原始图像仅比调整大小目标大X倍，则将使用原始图像。在大多数情况下，如果原始图像仅比调整大小的目标稍大，则创建调整大小的版本是没有意义的。
'image_resize_cache_direct' => false	将尝试绕过Files PHP应用程序将缓存的调整大小后的图像直接加载到图库中。由于图像文件直接加载到浏览器中，因此可能会导致更快的加载和改进的浏览器缓存。但是，如果启用此选项并删除图像缓存，则可能会丢失图像文件，因为“文件”应用程序不用于检测是否存在缓存的请求。如果启用此选项，并且您确实要删除图像缓存，则需要将`cache_key`设置增加+1。勿埋我心建议：将此项设置为true，可以使缩略图使用真实路径，有利于CDN缓存，如果你没有CDN，那么没太大关系。

菜单

参数	解释说明
'menu_enabled' => true	启用或禁用左侧文件夹菜单。您仍然可以从主视图区域中浏览文件夹。如果根目录不包含任何文件夹，则该菜单将始终被禁用。
'menu_show' => true	默认情况下，切换左文件夹菜单已展开或折叠。如果根目录中没有文件夹或禁用了菜单，则此设置无效。同样，该值由浏览器“记住”，并且将始终默认为每个浏览器菜单所处的最后状态。
'menu_max_depth' => 5	作为预防措施，左侧菜单的深度限制为5个子文件夹级别。在许多情况下，将无限数量的子文件夹加载到菜单中是没有用的，因为它会很慢，并且在菜单界面中可能无法很好地显示。勿埋我心建议您可以轻松地将该值增加到更高的值，但是请注意，如果要加载巨大的根目录，则加载整个树的速度可能很慢。例如，如果要加载服务器的整个根，那么加载整个树将是一项艰巨的任务。您仍然可以直接从查看区域导航到更深的文件夹级别。
'menu_sort' => 'name_asc'	选择如何使用选项name_asc，name_desc，date_asc和date_desc对文件夹菜单项进行排序。
'menu_cache_validate' => true	启用时（默认），将验证菜单缓存以确保其与实际的文件夹结构匹配。通常，此机制是必需的，以确保对您所做的任何更改（新文件夹等）与菜单缓存文件进行验证。如果禁用，则仅针对根文件夹和1级文件夹验证缓存。如果您的永久文件库具有较重的文件夹结构，则禁用此功能可能很有用，在这种情况下，菜单的加载速度会更快。请记住，如果您禁用此功能然后在子文件夹中进行更改，则需要删除菜单缓存或增加`cache_key`值。
'menu_load_all' => false	将导致菜单预加载所有页面，包括所有文件数据。这意味着菜单加载后，您可以立即浏览所有文件夹，而无需进行任何加载。此功能对于永久画廊或简单的根文件夹结构很有用。
'menu_recursive_symlinks' => true	在主菜单中列出符号链接的子目录。可能会导致无害的菜单循环或重复的菜单项。

布局

参数	解释说明
'layout' => 'rows'	默认画廊布局，包括选项列表，块，网格，行和列。该值由浏览器“记住”，并且将始终默认为访问者选择的最后一个状态。
'image_cover' => true	在其容器内缩放图像以进行某些布局，以填充整个网格区域。某些作物会发生。该值由浏览器“记住”，并且将始终默认为访问者选择的最后一个状态。
'sort' => 'name_asc'	在主视图区域中对文件的默认排序，带有选项 name，date，filesize和k i nd。该值由浏览器“记住”，并且将始终默认为访问者选择的最后一个状态。
'sort_dirs_first' => true	启用后，总会在最上方列出目录，这通常是最直观的。

缓存

参数	解释说明
'cache' => true	启用后，将为文件夹和菜单创建缓存。缓存是在`storage_path`中创建的，通常是`_files/cache/folders`和`_files/cache/menu`。如果您不希望“文件”应用程序创建任何缓存文件，请禁用此选项。例如，如果您只打算使用它一次并删除它。请记住，启用缓存后，“文件”应用程序加载速度会更快。
'cache_key' => 0	菜单缓存和文件夹缓存与cache_key。如果您出于任何原因要强制刷新缓存，可以将cache_key增加+1。
'storage_path' => '_files'	storage_path定义“文件”应用将在何处创建缓存文件夹，配置和插件。在大多数情况下，应始终使用默认值“ `_files`”。在某些情况下，如果您不想将数据写入当前目录，或者有多个共享相同存储路径（和缓存）的“文件”应用程序，则可能需要使用不同的`storage_path`。存储路径可以是相对的或绝对的。

排除显示文件

参数	解释说明
'files_exclude' => ' '	一个PHP正则表达式，用于排除或包含文件。通常用于排除某些文件类型，或仅包括某些扩展名。适用于所有文件的基本名称。
'dirs_exclude' => ' '	一个PHP正则表达式来排除目录。适用于所有目录和文件的根相对路径。
'allow_symlinks' => true	允许“文件”应用显示和跟随列表和菜单中的符号链接。

其它

参数	解释说明
'history' => true	启用历史记录后，浏览器将在导航目录时更改`URL?path/to/folder`。这还允许您在共享URL时直接直接深链接到文件和目录。如果禁用，则导航时URL永远不会改变。
'breadcrumbs' => true	启用顶部栏中的“ breadcrumbs”界面元素，使用户可以轻松导航至父目录。如果root不包含任何文件夹，则将始终禁用。
'transitions' => true	启用前端的各种转换。
'click' => 'popup'	单击主视图区域中的项目时，选择触发弹出窗口，模式，下载，窗口或菜单(popup, modal, download, window or menu)的方法。默认值“popup”将适用于所有图像文件，但对于非图像文件将回退为“modal”。
'code_max_load' => 100000	直接在“文件”代码编辑器中加载和显示的代码文件（PHP，JS，CSS等）的最大文件大小。对于大型文件，代码编辑器可能会比较迟钝，并且自动将它们加载到编辑器中并没有用。
'code_allow_edit' => false	允许直接从“文件”应用程序代码编辑器编辑代码文件。
'popup_interval' => 5000	设置弹出幻灯片的时间间隔。
'topbar_sticky' => 'scroll'	选择topbar 如何使用true，false和'scroll'选项将其自身附加到屏幕上。
'check_updates' => true	检查“文件”应用程序更新。如果“文件”应用程序有更新，则在右上方显示“钟形”图标。
'allow_tasks' => true	尚未记录或可公开使用。
'get_mime_type' => false	从服务器（慢）而不是扩展名（快速）获取文件mime类型。
'context_menu' => true	禁用上下文菜单按钮和右键单击菜单。
'prevent_right_click' => false	阻止浏览器右键单击敏感项目（图像，列表项，菜单）上的菜单。
'license_key' => ' '	在此处插入许可证密钥以防止许可证弹出和解锁功能。