兰空图床的安装注意事项

安装环境要求：

Nginx 1.21+

Redis 7.0+

Supervisor

PHP8.0+

BCMath PHP 扩展
Ctype PHP 扩展
DOM PHP 拓展
Fileinfo PHP 扩展
JSON PHP 扩展
Mbstring PHP 扩展
OpenSSL PHP 扩展
PDO PHP 扩展
Tokenizer PHP 扩展
XML PHP 扩展
Imagick 拓展
Redis 拓展

如果是使用宝塔面板，需要关掉网站目录防跨站，并且需要删除以下PHP的函数：

exec、shell_exec 函数
readlink、symlink 函数
putenv、getenv 函数

数据库：

Mysql5.7+
PostgreSQL 9.6+
SQLite 3.8.8+
SQL Server 2017+
MariaDB 10.X+

数据库格式不能是MyISAM，否则安装时会出现错误，SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error…

静态化代码：

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last; break;
    }
}

安装时出现错误，SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error…

不支持的数据库版本

为什么配置完了以后，访问站点显示 404？

请检查伪静态、站点运行目录是否设置正确，如果确认正确请尝试重启。

为什么不支持 svg 格式的图片？

严格来说，svg 不是图片，是通过 xml 标记语言实现的矢量图形，也就是说 svg 不支持加水印、生成缩略图、获取宽高能一系列操作，这破坏了系统中很多业务流程。

能不能上传图片以外格式的文件，例如 mp4？

不可以，程序定位就是管理图片，未做任何图片以外格式的文件支持。

为什么不支持客户端直传

其一，由于第三方储存的多样性，有些第三方储存通过客户端直传后程序拿不到需要的数据，其二，太麻烦了。

我多次上传了相同的照片，图片管理中也出现了图片，这是 bug 还是 feature?

是 feature，在同一个储存策略下，上传相同的图片，程序不会重复的写入文件，但会创建文件记录，多条记录指向同一个物理文件。

我的图片中，「复制图片」出错，显示 复制失败, ClipboardItem is not defined

这与浏览器限制有关，站点必须以 https 的方式访问。了解更多 https://w3c.github.io/clipboard-apis/#dom-navigator-clipboardopen in new window

原图保护功能是什么？

原图保护功能指的是开启后，上传后图片返回的 url 中不是图片的真实路径，而是一串随机字符串。开启后将会消耗更多的内存。

开启原图保护功能后访问图片 404

这种情况是因为运行环境接管图片资源导致的，请更改 nginx 或 apache 的配置，例如 nginx：

# ...

location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
{
    expires      30d;
    error_log /dev/null;
    access_log /dev/null;
}

# ...

将这段代码注释掉即可。

更新后出现样式异常、按钮不起作用？

如果你使用了 cdn，请检查是否未刷新 cdn 的缓存。

上传出现失败，请稍后重试？

上传失败有很多原因，比如配置错误、文件较大返回 423 Request Entity Too Large、生成缩略图时图片较大导致超时被强行断开连接等等，出现错误通常情况下可以在storage/logs文件夹下找到错误日志，如果没有则表示错误并不是发生在程序中，而是外在原因。

使用反向代理并且域名使用了 https 的情况下，程序请求静态资源、生成的链接却是 http ？

这种情况通常是因为你的程序正在从 80 端口进行转发流量，详细解释和解决方法：https://laravel.com/docs/9.x/requests#configuring-trusted-proxiesopen in new window 请尝试增加反向代理配置：

proxy_set_header X-Forwarded-Proto $scheme;

能不能支持 xxxx 、xxxx 储存？

市面上各种厂家的产品层出不穷，兰空图床只会对主流的、具备相应接口的产品作适配，兰空图床的储存是由 flysystemopen in new window 实现，欢迎你提交 PR！

缩略图文件夹可以改名字吗？

可以，编辑 .env 文件，增加一项配置：
THUMBNAIL_PATH=your folder
然后删除 public 目录下的缩略图符号连接，然后执行 php artisan lsky:symlinks 但是请注意，此操作影响所以图片的缩略图地址，包括已上传的图片。

可以关闭缩略图功能吗？

可以，编辑 .env 文件，增加一项配置： ENABLE_THUMBNAIL=false

缩略图文件夹、文件被我删掉了怎么办？

你可以通过执行命令 php artisan lsky:thumbnails 来重新生成所有图片的缩略图，但是注意，这个操作等待时间可能会比较漫长，取决于图片数量。

如何增加统计代码？

在 public/js 目录下新建 custom.js 文件，程序会自动加载该 js 文件，如果单个js文件不满足需求，还可以在 resources/views/layouts 目录新建 custom.blade.php 文件，在里面可以添加任何代码。

如何修改 Redis 库？

你可以通过在 .env 文件中增加配置 REDIS_DB=0 和 REDIS_CACHE_DB=1 来指定库。