常见运维问题

一些个人网站环境配置及常见问题记录。

References：

• AMH官方网站

使用以下命令则可以查看：

cat /root/amh.log

MYSQL 在重启服务器时不能启动，尝试以下方法：

删除 my.inf。

cd /etc/
rm my.inf

#error msg
ERROR! MySQL server PID file could not be found!

rm -f /tmp/mysql-5.6.sock tmp/mysql-5.6.sock.lock

单IP的多个虚拟主机只需要一个 SSL证书即可。配置步骤：

1. 在 amh.sh/ssl.htm 上申请证书，申请的时候将所有虚拟主机的域名输入。
2. 将得到的证书在 amhssl 中添加。
3. 制定自动更新的策略。

Rreferences：

• Nginx Official guide for Dokuwiki

将下列规则添加到 AMH 的 rewrite 模块中：

location / {
    index doku.php;
    try_files $uri $uri/ @dokuwiki;
}

#caching: warning: will cause picture 404 problem if your wiki is running in rewrite mode 1.
  location ~ ^/lib.*\.(gif|png|ico|jpg)$ {
    expires 30d;
}

#dir safety
location ^~ /conf/ { return 403; }
location ^~ /data/ { return 403; }

#rewrite
Location @dokuwiki {
        # rewrites "doku.php/" out of the URLs if you set the userewrite setting to .htaccess in dokuwiki config page
        rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
        rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
        rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
        rewrite ^/(.*) /doku.php?id=$1&$args last;
    }

Dokuwiki URL Rewrite 与以下代码冲突：

location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|flv|mp3|wma)$ {
    expires      30d;
}

该段代码用于防止除 conf 和 data 以外的重要文件本下载。
使用：添加以下代码到 rewrite 模块中：

# Block access to data folders
location ~ /(data|conf|bin|inc)/ {
    deny all;
}
# Block access to .htaccess files
location ~ /\.ht {
    deny all;
}

Link

• 插件的安装：直接到后台的插件管理器中寻找指定的插件下载安装即可。

• Add New Page：可以直接在没有创建页面的位置直接创建页面，非常方便。
• Code Prettifier：非常好用的代码高亮。
• Edittable ：图形化界面的表格创建，比较方便，但有自适应问题。
• Fastwiki ：优化 Dokuwiki 的访问速度（预加载）。
• Google Document Viewer ：可以直接在 Dokuwiki 中查看 Google 文档。
• MathJax ：数学公式插件。
• Pure SVG Insert：使 Dokuwiki 支持 SVG 的显示。
• DokuWiki Upgrade：一键升级 Dokuwiki，必备插件。
• Wrap：很好用的内容排版插件。

解决方法：进入服务器的 php.ini 配置文件，添加或修改以下设置：

always_populate_raw_post_data = -1

将 /lib/styles/all.css 中 svg 的

width: 1.2em;

width: auto;

如果使用 Nginx 对 Dokuwiki 进行 Leverage browser caching，会导致被缓存的图片无法在媒体管理器以及正文中显示。该问题出现在从 Apache 迁移到 Nginx 的过程中，怀疑是 Nginx 本身对 Dokuwiki 的支持不佳。

解决方法（过时）：由于 AMH 的 Nginx.conf 自带 caching，需要手动去 /yourwebdir/vhost/yourweb.conf 将如下的缓存规则删除。

Nginx 版本的通用优化代码如下：

location ~*  \.(jpg|jpeg|png|gif|ico|css|js)$ {
    expires 365d;
}

location ~*  \.(pdf)$ {
    expires 30d;
}

一些 Typecho 的改造 / 使用 问题收集。

在 AMH 中开启 pathinfo 插件的支持即可。

Typecho 可以针对当前用户是否是管理员来添加额外的样式。一个简单的应用例子如下：

首先我们需要官方帮助文档中的自定义函数。该函数用于判断当前评论用户是否为管理员，通过 AuthorId 和 ownerid 是否相等来判断：

<?php function threadedComments($comments, $options) {
    $commentClass = '';
    if ($comments->authorId) {
        if ($comments->authorId == $comments->ownerId) {
            $commentClass .= ' comment-by-author';  //如果是文章作者的评论添加 .comment-by-author 样式
        } else {
            $commentClass .= ' comment-by-user';  //如果是评论作者的添加 .comment-by-user 样式
        }
    } 
    $commentLevelClass = $comments->_levels > 0 ? ' comment-child' : ' comment-parent';  //评论层数大于0为子级，否则是父级
?>
/* 自定义评论的代码结构 */
<?php } ?>

<li id="li-<?php $comments->theId(); ?>" class="comment-body<?php 
if ($comments->levels > 0) {
    echo ' comment-child';
    $comments->levelsAlt(' comment-level-odd', ' comment-level-even');
} else {
    echo ' comment-parent';
}
$comments->alt(' comment-odd', ' comment-even');
echo $commentClass;
?>">

<span class="comment-author<?php echo $commentClass; ?>"><?php $comments->author(); ?></span>

上面的代码直接把 $commentClass，也就是我们要额外附加的样式表加入了 comment-author 这个样式里。如果是管理员，那么调用的样式表就是 .comment-author.comment-by-author，否则就是 .comment-author.comment-by-user。

最后去 CSS 里添加样式表即可：

.comment-author.comment-by-author {background: #636363;padding: 5px;}

Typecho 默认的时间输出格式是 PHP 的格式。如果我们希望将其转换为“发表于多久多久之前” 的格式，可以通过以下的手段来实现：

首先我们需要往 function.php 中添加一个时间重写函数：

//时间转换输出
function timesince($older_date,$comment_date = false) {
$chunks = array(
array(86400 , 'Day'),
array(3600 , 'Hour'),
array(60 , 'Minute'),
array(1 , 'Second'),
);
$newer_date = time();
$since = abs($newer_date - $older_date);

for ($i = 0, $j = count($chunks); $i < $j; $i++){
$seconds = $chunks[$i][0];
$name = $chunks[$i][1];
if (($count = floor($since / $seconds)) != 0) break;
}
/*如果是中文则不需要 count 的判断，并且也不需要空格*/
if ($count == 1) {
$output = $count.' '.$name.' '.'ago';
}
else {$output = $count.' '.$name.'s'.' '.'ago'; }
return $output;
}

<?php echo timesince($comments->created);?>

首先到 function.php 中添加如下两个函数：

//获取评论的锚点链接
function get_comment_at($coid)
{
    $db   = Typecho_Db::get();
    $prow = $db->fetchRow($db->select('parent')->from('table.comments')
                                 ->where('coid = ? AND status = ?', $coid, 'approved'));
    $parent = $prow['parent'];
    if ($parent != "0") {
        $arow = $db->fetchRow($db->select('author')->from('table.comments')
                                     ->where('coid = ? AND status = ?', $parent, 'approved'));
        $author = $arow['author'];
        $href   = '<a href="#comment-' . $parent . '">@' . $author . '</a>';
        echo $href;
    } else {
        echo '';
    }
}
//输出评论内容
function get_filtered_comment($coid){
    $db   = Typecho_Db::get();
    $rs=$db->fetchRow($db->select('text')->from('table.comments')
                                 ->where('coid = ? AND status = ?', $coid, 'approved'));
    $content=$rs['text'];
    echo $content;
}
?>

<?php get_comment_at($comments->coid)?>

找到文件夹 /var 下的文件 HyperDown.php 第十七行，添加需要使用的标签即可。

Typecho 可以通过以下方式来进行升级：

1. 下载最新的版本：Typecho On Github
2. 删除服务器上三个目录的文件，如果修改了源代码可以使用 Github 的对比工具来进行合并。三个目录分别是：/admin, /var, 和根目录下的 index.php。
3. 上传最新的对应文件即可。

添加如下代码到 .htaccess 文件中即可。注意：RewriteBase 后是网站的目录。

<IfModule mod_rewrite.c >
    RewriteEngine On
    RewriteBase /
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
</IfModule>

instantclick.js 是一种ajax无刷新和预加载页面的技术，对于普通博客程序，有着明显的加速作用。instantclick.js ≈ pjax 加上预加载页面，而且，使用方法也十分的简单。

下载 InstantClick

在 footer.php 的 </body> 标签之前插入以下代码：

...
<script src="instantclick.min.js" data-no-instant></script>
<script data-no-instant>InstantClick.init();</script>
</body>
</html>

默认情况下是在鼠标悬停到链接上方即开始加载，有时候这样会带来服务器的额外开销问题。将 init 函数的参数设置为 mousedown 则可以通过点击的一瞬间进行预加载：

InstantClick.init('mousedown');

在样式表中加入如下代码即可：

#instantclick-bar { background: gray; }

先对 Prismjs 中需要预加载的部分进行设置：

打开 Plugin.php 文件，找到 58 行：

<script>var pres = document.getElementsByTagName('pre');

<script data-no-instant>var pres = document.getElementsByTagName('pre');

<script src="' . $jsUrl . '"></script>

<script src="' . $jsUrl . '" data-no-instant></script>

<script defer="defer" src="' . Helper::options()->pluginUrl . '/Prismjs/line-number-wrap-fix.js' . '"></script>

<script defer="defer" src="' . Helper::options()->pluginUrl . '/Prismjs/line-number-wrap-fix.js' . '" data-no-instant></script>

if (typeof Prism !== 'undefined') {<?php  if (Helper::options()->plugin('Prismjs')->showln): ?>
var pres = document.getElementsByTagName('pre');
    for (var i = 0; i < pres.length; i++){
        if (pres[i].getElementsByTagName('code').length > 0)
            pres[i].className  = 'line-numbers';} <?php endif; ?>
Prism.highlightAll(true,null);}

{<?php  if (Helper::options()->plugin('Prismjs')->showln): ?>''

if (typeof Prism !== 'undefined') { Prism.highlightAll(true,null); }

MathJax = {
        showProcessingMessages: false,
        messageStyle: "none",    
    tex: {
        inlineMath: [ ["$","$"], ["\\\\(","\\\\)"] ],
        displayMath: [ ["$$","$$"], ["\\\\[","\\\\]"] ],
        processEscapes: true
    },
    svg: {
        fontCache: "global"
    }
}

添加以下代码到 /lib/styles/all.css：

mjx-container[jax="SVG"] > svg {
    height: auto;
    width: auto;
}

在 footer.php 中找到 InstantClick.on('change', function(isInitialLoad) 部分，加入以下规则：

if (typeof MathJax !== 'undefined'){MathJax.Hub.Queue(["Typeset",MathJax.Hub]);}

在 header.php 中的 <head> 之间加入如下代码：

<script type="text/x-mathjax-config">
  MathJax.Hub.Config({
    extensions: ["tex2jax.js"],
    jax: ["input/TeX", "output/HTML-CSS"],
    tex2jax: {
      inlineMath: [ ['$','$'], ["\\(","\\)"] ],
      displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
      processEscapes: true
    },
    
    "HTML-CSS": { availableFonts: ["TeX"] }
  });
</script>
<script type="text/javascript"
   src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

首先在 post.php 中添加一个全局变量用于检测页面是否有数学公式：

<?php $GLOBALS['mathjax'] = strpos($this->content, '[') || strpos($this->content, '('); ?>

<?php if($GLOBALS['mathjax']):?>
  <!--mathjax-->
  <script type="text/javascript" src="https://cdn.staticfile.org/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML"></script>
<?php endif;?>

在 MathJax.Hub.Config 中添加如下代码：

showProcessingMessages: false, //关闭js加载过程信息
messageStyle: "none", //不显示信息

本实现需要 jquery 支持，并编辑 comments.php。

在 comments.php 中加入 如下 JS 代码：

<script>
var disqus_loaded = false;

function load_disqus()
{
  disqus_loaded = true;
  var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
  dsq.src = "https://codinghare.disqus.com/embed.js";
  (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
}

window.onscroll = function(e) {
    if ((window.innerHeight + window.scrollY) >= document.body.offsetHeight) {
        //hit bottom of page
        if (disqus_loaded==false){ load_disqus() };
    }
};
</script>

<div id="disqus_thread"></div>

Flarum 自己带一个子目录 public 作为论坛的首页目录。很多网上的教程建议直接重写 vhost 中的 root 路径，但 AMH 对此似乎并不友好。另外一种办法是通过面板建立子域主机来重新定向域名的根目录到 public。举个例子，如果需要指定域名 domain.com 到该目录，需要修改的如下：

1. 绑定 127.0.0.1 到父主机
2. 绑定 domain.com 到子域主机
3. 绑定子目录中填写 /public
4. 在子主机中包含 .nginx.conf（位于父主机网站根目录下），可参考官方安装帮助。

$chown www:www -R /home/wwwroot/环境/domain/域名/web/

如果遇到以下的错误：

flarum Something went wrong: SQLSTATE[42000]: Syntax error or access violation: 1286 Unknown storage engine 'InnoDB'

需要到 MAadmin - 参数设置 中打开 InnoDB 的开关。

如果出现 http 访问正常 而 https 访问 403 的情况，需要到 config.php 做如下修改：

//default
http://yourdomain.com 
//change to
https://yourdomain.com