Typecho 部署踩坑

in Tutorials with 0 comment
在下近期用 Typecho 搭建了博客平台,但是其中真的太过艰辛,尤其作为一个对 PHP 丁点儿不懂的菜🐔开发,更是难受,耗时将近两天。而且网上资料太少,在此稍微记录下过程中遇到的坑,希望对后人能有些许帮助。

用 Docker 部署

如果你想用 Docker 部署,却对 Docker 不太懂,推荐你从 Docker Practice 入门,并且我也有一篇 Docker 新手踩坑,希望能够有点帮助。

而且我这里有一份 docker-compose.yml 可以供你参考。

部署好了以后访问 File not found

这个解决方案的前提是使用 nginx 转发 fpm 伪静态部署方案,而不是 nginx 代理 Apache 。既然 nginx 也能当服务器为什么要多开一个 Apache 呢?

首先要确定你的路径真的正确,怎么确定呢?其实去看 nginx 的 error.log 就可以初步确认了。

如果 error.log 里有这么一行:

FastCGI sent in stderr: "Primary script unknown" while reading response header from upstream,....

那么基本可以确定,就是你的路径有问题,或者环境变量没有设置好,导致 fpm 找不到 php 文件。

解决方案添加或修改如下配置:

fastcgi_param  SCRIPT_FILENAME  /[your index.php path]/$fastcgi_script_name;

比如:

location ~ .*\.php(\/.*)*$ {
  include fastcgi.conf;
  include fastcgi_params;
  fastcgi_param  SCRIPT_FILENAME  /www/$fastcgi_script_name;

  fastcgi_pass   blog:9000;
}

相信配置过 nginx 的一看就懂吧。

啥都弄好了,就是安装的时候数据库只有 SQLite,没有 MySQL

这个可能是 PHP 环境的问题,我开始一直用的官方的 PHP 镜像,就是这个原因,其实也安装了 MySQL 扩展,但是就是不行,整的人很懵逼。后面换镜像了,换成 hteen/php 后,并且配置上 php.ini 配置文件后,终于看到 MySQL 了。

我对 PHP 也不懂,不能给什么建设性建议,只能附上我的 php.ini 希望能帮助你。

对了,配置文件的映射路径上面的 docker-compose.yml 里有。

安装的时候显示无法连接数据库

这个问题其实千奇百怪的原因都有,这里吐槽一下 Typecho 的报错机制,简直就是 Java 中的 catch(Exception e) {return "error"},除了知道出错了其他啥信息都不知道。

这个问题的排查思路:

检查数据库配置是否正确

[x] 数据库地址是否正确
[x] 数据库端口是否正确(这两项如果是 Docker 那么就是容器别名和容器内部端口,当然你也可以上公网 IP 和公网端口)
[x] 数据库用户名和密码是否正确

如果这些都没问题,进入下一步

数据库中是否已经建立了 typecho 数据库

因为 Typecho 不会自动键库的,需要你自己手动建库,名字在安装页可以配置。当然我并没有配置,用的默认的。因为我也不知道配置后有没有 Bug,懒。

如果你数据已经建了,还是报无法连接数据库,那么往下走。

PHP 低版本无法和 mysql 8.0 连接

如果你的 mysql 是 8.0 版本的(含以上),那么有可能是这个原因,因为 mysql 8.0 默认是使用caching_sha2_password 加密插件的, PHP 有的版本是不兼容这个加密插件的。

怎么整呢?两个选择:

  1. 更新 PHP 版本到兼容的版本
  2. mysql 改成旧版本的加密插件。

虽然方法 2 会降低安全性,但是我还是选择了方法 2。真的快让 Typecho 逼疯了。当然,如果你也选择了方法 2,那么建议给 Typecho 单独开一个数据库账号,并且限定权限,我对于每个项目都是这么干的。然后还要定期备份数据(就算不降级也要这么干)。

怎么降级加密插件呢?进入 mysql,如果新增用户则执行:

CREATE USER 'username'@'localhost' identified with mysql_native_password by 'password'

如果改变已有用户则执行:

ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';

你问我一个对 PHP 什么都不懂的人怎么发现这个问题的?当然是改源码了。

修改源码打印具体错误

修改 install.php,通过搜索 对不起,无法连接数据库,请先检查数据库配置再继续进行安装 可以找到如下代码:

try {
    $installDb->query('SELECT 1=1');
} catch (Typecho_Db_Adapter_Exception $e) {
    $success = false;
    echo '<p class="message error">'
    . $e
    . _t('对不起,无法连接数据库,请先检查数据库配置再继续进行安装') . '</p>';
} catch (Typecho_Db_Exception $e) {
    $success = false;
    echo '<p class="message error">'
    . _t('安装程序捕捉到以下错误: " %s ". 程序被终止, 请检查您的配置信息.',$e->getMessage()) . '</p>';
}

看到第 6 行了嘛?那个 . $e 就是我添加的打印,会把错误直接打印在网页上,然后根据具体的异常去搜索解决方案吧,事半功倍!

文章比较长保存的时候报错

报错内容如下:

Notice: Unknown: file created in the system's temporary directory in Unknown on line 0
Warning: Cannot modify header information - headers already sent in Unknown on line 0
Warning: Cannot modify header information - headers already sent in /www/var/Typecho/Response.php on line 199
Warning: Cannot modify header information - headers already sent in /www/var/Typecho/Response.php on line 290

看报错大意就是创建缓存文件的时候出错了,导致后续的请求出错了。

去看一下 nginx 的 error.log

2019/11/04 05:23:09 [warn] 6#6: *1 a client request body is buffered to a temporary file /var/cache/nginx/client_temp/0000000001, client: 113.139.106.150, server: blog.fxcdev.com, request: "POST /action/contents-post-edit?_=e04cbf759e3580d455f81551cb8bbed5 HTTP/1.1", host: "blog.fxcdev.com", referrer: "https://blog.fxcdev.com/admin/write-post.php?cid=55"
2019/11/04 05:23:09 [error] 6#6: *1 FastCGI sent in stderr: "PHP message: PHP Notice:  Unknown: file created in the system's temporary directory in Unknown on line 0" while reading response header from upstream, client: 113.139.106.150, server: blog.fxcdev.com, request: "POST /action/contents-post-edit?_=e04cbf759e3580d455f81551cb8bbed5 HTTP/1.1", upstream: "fastcgi://172.19.0.2:9000", host: "blog.fxcdev.com", referrer: "https://blog.fxcdev.com/admin/write-post.php?cid=55"
2019/11/04 05:23:09 [error] 6#6: *1 FastCGI sent in stderr: "PHP message: PHP Warning:  Cannot modify header information - headers already sent in Unknown on line 0" while reading upstream, client: 113.139.106.150, server: blog.fxcdev.com, request: "POST /action/contents-post-edit?_=e04cbf759e3580d455f81551cb8bbed5 HTTP/1.1", upstream: "fastcgi://172.19.0.2:9000", host: "blog.fxcdev.com", referrer: "https://blog.fxcdev.com/admin/write-post.php?cid=55"
2019/11/04 05:23:09 [error] 6#6: *1 FastCGI sent in stderr: "PHP message: PHP Warning:  Cannot modify header information - headers already sent in /www/var/Typecho/Response.php on line 199PHP message: PHP Warning:  Cannot modify header information - headers already sent in /www/var/Typecho/Response.php on line 290" while reading upstream, client: 113.139.106.150, server: blog.fxcdev.com, request: "POST /action/contents-post-edit?_=e04cbf759e3580d455f81551cb8bbed5 HTTP/1.1", upstream: "fastcgi://172.19.0.2:9000", host: "blog.fxcdev.com", referrer: "https://blog.fxcdev.com/admin/write-post.php?cid=55"

error.log 证实此次请求的时候发生了缓存现象。

尝试了增加 nginx 的缓存仍旧失败,于是从将矛头转移到 PHP 的配置上面。看了一下 php.ini 文件,发现配置了 upload_tmp_dir 属性,注释掉该属性后报错消失。可能是权限问题导致的缓存文件创建失败导致的问题。

总结这个问题:是因为缓存文件创建失败导致的请求失败,检查修正缓存路径即可解决问题。

结语

总算折腾够了,真的累人,不过生命不止,折腾不息嘛~希望可以帮助到后面的人,别再无头苍蝇到处乱撞,净做些无用功了。

Responses