2019-08-27 20:10:56 +08:00
# 常见问题解答
2019-08-20 23:15:52 +08:00
提问之前请先看看你的问题是否在以下列表中：
2019-08-27 20:10:56 +08:00
::: tip 提示：
2019-08-21 00:55:45 +08:00
请善用浏览器的 Ctrl + F 页内查找功能。
:::
2019-08-20 23:15:52 +08:00
[[toc]]
## 配置文件 `.env` 在哪？
请仔细阅读 [配置文件介绍 ](/env.md )
2019-09-12 18:48:39 +08:00
## 出现 "No application encryption key has been specified."
请在 Blessing Skin 根目录下（不是 Web 根目录）下执行以下命令：
```
php artisan key:generate
```
2019-08-20 23:15:52 +08:00
## 目录下没有 `setup` 这个文件夹啊，怎么访问？
Blessing Skin 使用了 URL 重写来实现路由功能（即俗称的伪静态），具体请自行搜索。
一般来说，只要你按照 [安装指南 ](/setup.md#配置-url-重写规则（伪静态） ) 正确配置了 URL 重写之后，你就能正常安装和使用 Blessing Skin。
## 提示「根目录下没有 `vendor` 文件夹」？
嗯，有两种解决方法：
1. 给我认认真真地再看一遍 [安装指南 ](/setup.md )
2. 自己使用 Composer 安装依赖库
2019-09-12 18:48:39 +08:00
## 出现 500 Internal Server Error 而且页面空白
2019-08-20 23:15:52 +08:00
**如果服务器报错 500，
请查看 `/storage/logs` 目录下是否有日志文件，如果没有，说明是你文件权限设置错误。
2019-08-21 00:55:45 +08:00
::: tip 解决方法：
请在皮肤站根目录下运行 `chown -R www ./` 。（`www` 换成你的服务器上相应的用户，如 `apache` 等）
:::
2019-08-20 23:15:52 +08:00
如果有，就不会只显示 500 错误了，除非你自行修改了文件。
## 404 Not Found
如果你可以访问首页，其他页面都是 404， **是否生效** 。
如果所有页面（包括 `/index.php` ）都是 404，
2019-08-26 00:30:55 +08:00
## require: open_basedir restriction in effect. File is not within the allow path(s).
如果你的站点出现了如下错误：
2019-10-08 00:02:30 +08:00
```text
2019-08-26 00:30:55 +08:00
require: open_basedir restriction in effect. File is not within the allow path(s).
```
**这是你的 PHP 设置出了问题，需要修改 php.ini 文件。**
基本上你搜索一下就能找到解决方案。这里再复述一遍：
1. 打开你的 php.ini 文件（不知道 php.ini 文件在哪儿？随便去哪里下载个 PHP 探针（搜索引擎是你的好朋友），打开 `phpinfo()` 就可以看到你目前的 php.ini 配置文件所在目录了）；
2. 搜索 `open_basedir` 字样；
3. 找到了吗？
2019-10-08 00:02:30 +08:00
1. 如果找到了，在 `=` 等于符号后面加上你的皮肤站根目录的**完整的绝对路径**，然后保存并退出编辑；
2019-08-26 00:30:55 +08:00
- 多个路径中间用 `:` 英文半角分号隔开。
2. 如果没找到，那么抱歉爱莫能助。
4. 如果你使用的是 Nginx， ，
5. 如果一切运转正常，你应该可以正常使用 Blessing Skin 了。
## XXX() has been disabled for security reasons
如果你的遇到了类似如下的错误：
2019-10-08 00:02:30 +08:00
```text
2019-08-26 00:30:55 +08:00
XXX() has been disabled for security reasons
```
看到这条报错说明 Blessing Skin 所使用的一些函数在你的 PHP 中被禁用了，你需要在 php.ini 文件中解除这些函数的禁用。
2019-08-26 13:44:30 +08:00
基本上你搜索一下就能找到很详细的解决方案（所以说在提问前先自己搜索一遍是多么有必要）。这里再复述一遍：
2019-08-26 00:30:55 +08:00
1. 打开你的 php.ini 文件（不知道你的 php.ini 文件在哪儿？看上一条）；
2. 搜索 `disable_functions` 字样；
3. 找到之后，把 `=` 等于符号右边一长串字母和逗号组成的字符串里的 `XXX,` 字样删除；
4. 记得在退出编辑前要保存！
5. Nginx 用户请重启 PHP-FPM，
6. 好了，你可以正常使用 Blessing Skin 了。
2019-08-20 23:15:52 +08:00
## Deprecated $HTTP_RAW_POST_DATA
如果你的站点出现了如下错误（一般只会发生在你点了某个按钮之后）：
```text
Deprecated: Automatically populating $HTTP_RAW_POST_DATA is deprecated and will be removed in a future version. To avoid this warning set 'always_populate_raw_post_data' to '-1' in php.ini and use the php://input stream instead. in Unknown on line 0
```
2019-08-26 00:30:55 +08:00
**这是你 PHP 设置出了问题，需要修改 php.ini 文件。**
2019-08-20 23:15:52 +08:00
基本上你把这个报错拿去翻译一下，就可以很清晰地知道如何操作了。我这里再复述一遍：
2019-08-26 00:30:55 +08:00
1. 打开 php.ini 文件（不知道 php.ini 文件在哪儿？看上一条）；
2019-08-20 23:15:52 +08:00
2. 搜索 `always_populate_raw_post_data` 字样；
2019-08-26 00:30:55 +08:00
3. 找到之后，把 `=` 等于符号右边的数字设置为 `-1` （如果已经是 `-1` 了，请把行首的分号 `;` 删掉）；
2019-08-20 23:15:52 +08:00
4. 如果你用的是 Nginx， ，
5. 只要命运的齿轮没有出差错，你不会再看到类似的报错了。
## Maximum function nesting level of '100' reached
如果出现了类似这样的错误信息：
```text
PHP Fatal error: Maximum function nesting level of '100' reached, aborting! in /opt/app-root/src/vendor/composer/ClassLoader.php on line 344, referer: http://domain.com/setup/info
```
请修改 PHP 配置，关闭 XDebug 或修改其设置（具体操作请自行搜索）。
## getdate(): It is not safe to rely on the system's timezone settings
如果出现了类似这样的错误信息：
```text
Warning: getdate(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone.
```
2019-08-26 00:30:55 +08:00
请打开你的 php.ini 文件（不知道在哪的话请看上上条），找到 `date.timezone` 项的值并设置为 `Asia/Shanghai` 。
2019-08-20 23:15:52 +08:00
如果 `date.timezone` 这一项的最前面有一个半角分号 `;` 的话，请务必去掉。
## 只有图片无法显示，其他都正常
请参考：[printempw/blessing-skin-server#46 - 图片无法显示](https://github.com/printempw/blessing-skin-server/issues/46)
## 如何对接 AuthMe / CrazyLogin / Discuz？
AuthMe / Discuz：
CrazyLogin： ， ， ，
## 上传的皮肤跑哪里去了？
皮肤文件都被重命名为文件的 SHA256 Hash 并保存至 `/storage/textures` 文件夹下。你可以直接使用图片查看软件打开它们。
## 我要怎么直接访问皮肤文件？
皮肤站提供了各种 API 让你能够获取指定的皮肤文件。当然如果你只是想要在游戏内显示皮肤的话，直接给 Mod 提供一个 JSON Profile 的地址即可，其他操作 Mod 会替你自动完成：[配置皮肤 Mod](/mod.md)
```
# 获取指定角色的皮肤/披风
example.com/{skin|cape}/{username}.png
# 获取指定角色的头像
2019-10-08 00:02:30 +08:00
example.com/avatar/player/{size}/{username}.png
2019-08-20 23:15:52 +08:00
# 通过材质 ID 获取皮肤
example.com/raw/{tid}.png
# 通过材质 Hash 获取皮肤
example.com/textures/{hash}
```
## 游戏中不显示皮肤？
2019-08-21 00:55:45 +08:00
::: warning 注意：
这里只讨论使用 _皮肤 Mod_ 时的问题。使用自定义 Yggdrasil API 外置登录系统出现的皮肤不加载问题不在本文的讨论范围之内。
:::
2019-08-20 23:15:52 +08:00
### 检查皮肤站是否配置正确
2019-08-26 00:30:55 +08:00
怎么检查？访问 `http://你的皮肤站地址/你的游戏角色名.json` （此处以 CSL API 为例，
2019-08-20 23:15:52 +08:00
```json
{
"username": "621sama",
"skins": {
"default": "834cbd848f0a29008bf5b1d59d02ecb1cf25dfd21fc88be1c183c9261f5fdd69",
"slim": "3d82f454ceeb30f2546283e08ab060a45d450dc6042c9077f638f10ca51205d4"
},
"cape": "2911438e8282d40e6d64fbefd076eef0a901cb90d3deae4057fec60c66eb93d2"
}
```
2019-08-26 00:30:55 +08:00
然后把那几串长长的字符串复制出来，分别访问 `http://你的皮肤站地址/textures/那一串字符串` ，如果一切正常，你会看到你的皮肤图片：
2019-08-20 23:15:52 +08:00
确保这一步一切正常后，你可以继续往下排查了。
### 检查皮肤 Mod 是否正确加载
去看看你游戏主菜单中 Forge Mod List 里有没有正确加载皮肤 Mod（
### 检查皮肤 Mod 是否配置正确
请参阅 [配置皮肤 Mod ](/mod.md )，再检查一遍你有没有配置出错的地方。
### 查看皮肤 Mod 的日志
日志是开发者的好朋友，有了它可以快速定位问题原因。
- CSL 的日志位于 `.minecraft/CustomSkinLoader/CustomSkinLoader.log`
- USM 的日志直接输出至游戏日志中
在日志里看看有没有什么 `ERROR` 打头的记录，把错误信息拿去翻译一下基本上就能知道原因了。
## 如何上传 鞘翅/翅膀/Elytra 的材质？
鞘翅的材质是画在披风上的，自己设置一个带鞘翅材质的披风就可以了。
具体请参考 Minecraft Wiki：
- https://minecraft-zh.gamepedia.com/index.php?title=%E9%9E%98%E7%BF%85& variant=zh
- https://minecraft-zh.gamepedia.com/index.php?title=%E6%8A%AB%E9%A3%8E& variant=zh
### 如何在皮肤库中查看一个披风是否带有鞘翅材质？
访问 `/raw/{tid}.png` 或者 `/textures/{hash}` 查看披风原图。
2019-12-30 16:58:46 +08:00
## 忘了密码怎么办
2019-08-20 23:15:52 +08:00
1. 使用皮肤站自带的「找回密码功能」
2. 使用一个「新密码」注册一个新用户，然后在数据库 `users` 表中用新注册用户的 `password` 字段内容替换掉你原来那个用户的 `password` 字段。替换完成后你就可以使用「新密码」登录你原来的账户了。
## 如何开启皮肤库评论区？
2019-12-30 16:58:46 +08:00
请安装「嵌入第三方评论」插件并在插件配置中填入您的评论代码即可。
2019-08-20 23:15:52 +08:00
2019-08-27 11:06:28 +08:00
评论代码是什么？请搜索「第三方评论系统」。
2019-08-20 23:15:52 +08:00
## 如何设置第二个超级管理员？
去皮肤站数据库 `users` 表那个用户记录的 `permission` 字段设置为 `2` 。
2019-08-21 00:55:45 +08:00
:::tip Permission 字段说明：
2019-12-25 16:14:27 +08:00
0：
-1：
1：
2019-08-21 00:55:45 +08:00
2：
:::
2019-08-20 23:15:52 +08:00
## 如何同时对接论坛和登录插件？
皮肤站对接至论坛，登录插件也对接至论坛即可。
## 启用数据对接后如何修改玩家角色名？
第一步：打开 `users` 数据表，找到你要修改的用户记录，修改这一条记录的 `username` 字段（注意，不是 `nickname` ）为你想要修改的【新角色名】；
第二步：打开 `players` 数据表，找到【原来的角色名】对应的数据记录，将该记录的 `name` 字段修改为【新角色名】
完成。
2019-08-27 20:10:56 +08:00
::: tip 注意:
如果你对接的是 Discuz、PHPWind 等论坛程序，而且在「数据对接」插件配置页面中将「重复处理」选项配置为「用目标程序上的用户数据覆盖皮肤站」的话，那么【皮肤站】上用户的【昵称】与【绑定的角色名】会被自动同步为该用户在【目标程序（论坛）】上具有【相同邮箱】账户的【用户名】。不愿意这样的话，请同时更改数据对接【目标程序】上的用户名或修改数据对接插件的「重复处理」配置项。
:::
2019-08-20 23:15:52 +08:00
2019-08-27 20:10:56 +08:00
参考链接：[printempw/blessing-skin-server#61](https://github.com/printempw/blessing-skin-server/issues/61)
2019-12-25 16:14:27 +08:00
## Target class [App\Services\Cipher\xxx] does not exist.
站点的密码算法设置不正确，请确保使用 Blessing Skin 支持的算法并且算法名没有拼写错误（区分大小写）。
2019-12-31 15:43:03 +08:00
## MySQL 错误码：
出错消息会像这样：无法连接至 MySQL/MariaDB 服务器， ：
MySQL 8 默认使用了新的密码验证插件： ，
解决方法：新建一个使用 mysql_native_password 方式的账户，并给予权限；或将现有账户验证方式改为 mysql_native_password 。
