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

====AMH====
References： 
  * [[https://amh.sh|AMH官方网站]]
===AMH 查看默认密码===
使用以下命令则可以查看：
<code bash>
cat /root/amh.log
</code>

===MySQL无法自动启动===

MYSQL 在重启服务器时不能启动，尝试以下方法：
\\
\\
删除 ''my.inf''。

<code bash>
cd /etc/
rm my.inf
</code>
==PID file not found==
<code bash>
#error msg
ERROR! MySQL server PID file could not be found!
</code>
这种情况多半是硬盘空间满了导致系统强制结束了 mysql 的进程。用下面的命令之后再重启一下 mysql 进系统看看。
<code bash>
rm -f /tmp/mysql-5.6.sock tmp/mysql-5.6.sock.lock
</code>

===SSL 配置===
==SSL多虚拟主机==
单IP的多个虚拟主机只需要一个 SSL证书即可。配置步骤：
  - 在 ''amh.sh/ssl.htm'' 上申请证书，申请的时候将所有虚拟主机的域名输入。
  - 将得到的证书在 ''amhssl'' 中添加。
  - 制定自动更新的策略。
====Dokuwiki====
Rreferences：
  * [[https://www.nginx.com/resources/wiki/start/topics/recipes/dokuwiki/|Nginx Official guide for Dokuwiki]]

===Dokuwiki Nginx Rewrite 规则===

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

<code nginx>
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;
    }
</code>
==Dokuwiki 重写后图片显示不正常(Nginx&AMH)==
Dokuwiki URL Rewrite 与以下代码冲突：
<code nginx>
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|flv|mp3|wma)$ {
    expires      30d;
}
</code>
而 AMH 的 ''nginx.conf'' 需要到所建立的环境下的 ''vhost'' 目录下找对应虚拟主机的文件（一般是以 ''域名.conf'' 格式的 ''conf'' 文件）。找到以后然后将里面的该段代码注释掉。如果用了 Https, 则同时需要注释掉 HTTPS 版本的 ''conf'' 文件。

===Dokuwiki Nginx 安全规则===

该段代码用于防止除 ''conf'' 和 ''data'' 以外的重要文件本下载。
\\
使用：添加以下代码到 ''rewrite'' 模块中：
<code nginx>
# Block access to data folders
location ~ /(data|conf|bin|inc)/ {
    deny all;
}
# Block access to .htaccess files
location ~ /\.ht {
    deny all;
}
</code>
===所有 MIMe 类型===
[[https://gist.github.com/AlekseiCherkes/690551fafa3a939c54ed|Link]]
===Dokuwiki 使用===

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

==常用插件==

  * Add New Page：可以直接在没有创建页面的位置直接创建页面，非常方便。
  * Code Prettifier：非常好用的代码高亮。
  * Edittable ：图形化界面的表格创建，比较方便，但有自适应问题。
  * Fastwiki ：优化 Dokuwiki 的访问速度（预加载）。
  * Google Document Viewer ：可以直接在 Dokuwiki 中查看 Google 文档。
  * MathJax ：数学公式插件。
  * Pure SVG Insert：使 Dokuwiki 支持 SVG 的显示。
  * DokuWiki Upgrade：一键升级 Dokuwiki，必备插件。
  * Wrap：很好用的内容排版插件。
===Dokuwiki 相关问题===
==Dokuwiki 上传附件显示 "Failed"==
解决方法：进入服务器的 ''php.ini'' 配置文件，添加或修改以下设置：
<code php>
always_populate_raw_post_data = -1
</code>
==Igor 版本 svg 缩放不正确==
<WRAP center round important 100%>
官方 issue 中解释该设置是一个 guard，不应修改。推荐对指定插件进行修改。
</WRAP>
将 ''/lib/styles/all.css'' 中 ''svg'' 的
<code css>
width: 1.2em;
</code>
替换为
<code css>
width: auto;
</code>

====服务器通用前端优化====

===Leverage browser caching===

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

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

<WRAP  round tip100%>
解决方法：使用新版本的重写规则，请参见前面。
</WRAP>


\\
\\
**Nginx** 版本的通用优化代码如下：
<code nginx>
location ~*  \.(jpg|jpeg|png|gif|ico|css|js)$ {
    expires 365d;
}

location ~*  \.(pdf)$ {
    expires 30d;
}
</code>

====Typecho====

一些 Typecho 的改造 / 使用 问题收集。
===后台 Access Denied===

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

===Typecho 改造指南===

==评论：添加额外样式给管理员==
Typecho 可以针对当前用户是否是管理员来添加额外的样式。一个简单的应用例子如下：
\\
\\
首先我们需要官方帮助文档中的自定义函数。该函数用于判断当前评论用户是否为管理员，通过 ''AuthorId'' 和 ''ownerid'' 是否相等来判断：
<code php>
<?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 } ?>
</code>
\\
接下来会通过一段函数将增加的样式表打印出来，结果是 ''comment-by-author'' 或者 ''comment-by-user''：
<code 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;
?>">
</code>
\\
有了这两段函数以后，剩下的工作就很简单了。以我要替换管理员在评论中名字的背景为例。首先将打印出来的字段应用到 HTML 的调用中：
<code php>
<span class="comment-author<?php echo $commentClass; ?>"><?php $comments->author(); ?></span>
</code>

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

<code css>
.comment-author.comment-by-author {background: #636363;padding: 5px;}
</code>
==评论：重写发表评论时间==
Typecho 默认的时间输出格式是 PHP 的格式。如果我们希望将其转换为“发表于多久多久之前” 的格式，可以通过以下的手段来实现：
\\
\\
首先我们需要往 ''function.php'' 中添加一个时间重写函数：
<code 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;
}
</code>
这个函数会获取以前的时间作为参数，并转换成相应的字段，我们只需要拿到 ''comments.php'' 中使用即可。使用方法如下：
<code php>
<?php echo timesince($comments->created);?>
</code>
==评论：回复评论自带@跳转==
首先到 ''function.php'' 中添加如下两个函数：
<code 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;
}
?>
</code>
\\
再到 ''comments.php'' 中使用如下代码调用即可:
<code linenums:1>
<?php get_comment_at($comments->coid)?>
</code>
==添加自定义html标签到文章内容==
找到文件夹 ''/var'' 下的文件 ''HyperDown.php'' 第十七行，添加需要使用的标签即可。
===Typecho 升级指南===

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

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

===Typecho URL重写===

==Apache 重写规则==
添加如下代码到 ''.htaccess'' 文件中即可。注意：''RewriteBase'' 后是网站的目录。
<code apache>
<IfModule mod_rewrite.c >
    RewriteEngine On
    RewriteBase /
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
</IfModule>
</code>

===InstantClick===

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

==安装InstantClick==

下载 [[http://instantclick.io/download|InstantClick]]
\\
\\
在 ''footer.php'' 的 ''</body>'' 标签之前插入以下代码：
<code js>
...
<script src="instantclick.min.js" data-no-instant></script>
<script data-no-instant>InstantClick.init();</script>
</body>
</html>
</code>

==点击时候的预加载==

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

==修改预加载条的颜色==

在样式表中加入如下代码即可：
<code css>
#instantclick-bar { background: gray; }
</code>

==与 PrismJS兼容==

先对 ''Prismjs'' 中需要预加载的部分进行设置：
\\
\\
打开 ''Plugin.php'' 文件，找到 ''58'' 行：
<code html js>
<script>var pres = document.getElementsByTagName('pre');
</code>
改为：
<code html>
<script data-no-instant>var pres = document.getElementsByTagName('pre');
</code>
找到 ''64'' 行：
<code html>
<script src="' . $jsUrl . '"></script>
</code>
改为：
<code html>
<script src="' . $jsUrl . '" data-no-instant></script>
</code>
找到 ''66'' 行：
<code html>
<script defer="defer" src="' . Helper::options()->pluginUrl . '/Prismjs/line-number-wrap-fix.js' . '"></script>
</code>
改为：
<code html js>
<script defer="defer" src="' . Helper::options()->pluginUrl . '/Prismjs/line-number-wrap-fix.js' . '" data-no-instant></script>
</code>
\\
再修改位于 ''footer.php'' 中 ''instantclick'' 的白名单部分，添加属于 ''prismjs'' 的规则：
<code js>
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);}
</code>
PHP 部分：
<code php>
{<?php  if (Helper::options()->plugin('Prismjs')->showln): ?>'' 
</code>
对判断插件是否使用了行号。如果没启用插件，会导致网站 **505** 错误。
\\
\\
如果不使用行号，直接使用以下代码：
<code php>
 if (typeof Prism !== 'undefined') { Prism.highlightAll(true,null); }
</code>

===Mathjax===
==mathjax 3 简单配置==
<code js>
MathJax = {
        showProcessingMessages: false,
        messageStyle: "none",    
    tex: {
        inlineMath: [ ["$","$"], ["\\\\(","\\\\)"] ],
        displayMath: [ ["$$","$$"], ["\\\\[","\\\\]"] ],
        processEscapes: true
    },
    svg: {
        fontCache: "global"
    }
}
</code>
==igor 版本的缩放问题==
添加以下代码到 ''/lib/styles/all.css''：
<code cpp>
mjx-container[jax="SVG"] > svg {
    height: auto;
    width: auto;
}
</code>
==Mathjax与InstantClick不兼容==

在 ''footer.php'' 中找到 ''InstantClick.on('change', function(isInitialLoad)'' 部分，加入以下规则：
<code>
if (typeof MathJax !== 'undefined'){MathJax.Hub.Queue(["Typeset",MathJax.Hub]);}
</code>
==Mathjax的直接添加==

在 ''header.php'' 中的 ''<head>'' 之间加入如下代码：
<code html>
<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>
</code>
<WRAP center round info 100%>
近日 //MathJax// 自营 CDN 已经停止服务，需自行寻找相关 CDN。
</WRAP>
\\
==Mathjax按需加载==
首先在 ''post.php'' 中添加一个全局变量用于检测页面是否有数学公式：
<code php>
<?php $GLOBALS['mathjax'] = strpos($this->content, '[') || strpos($this->content, '('); ?>
</code>
接着到 Mathjax.js 调用的地方设置条件（我的是''footer.php''）：
<code php>
<?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;?>
</code>

==Mathjax不显示加载信息==
在 ''MathJax.Hub.Config'' 中添加如下代码：
<code js>
showProcessingMessages: false, //关闭js加载过程信息
messageStyle: "none", //不显示信息
</code>

===Disqus===

==Disqus loading on scroll==

<del>本实现需要 ''jquery'' 支持，并编辑  ''comments.php''。</del>
\\
<WRAP round tip 60%>
新版本不再使用 jquery。
</WRAP>

\\
\\
在 ''comments.php'' 中加入 如下 JS 代码：
<code 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>
</code>
\\
注意替换 ''embed.js'' 的地址为自己的 Disqus地址（直接替换 shortname 即可）。
\\
\\
html 调用：
<code html>
<div id="disqus_thread"></div>
</code>

====Flarum====
===解决 nginx 重写的问题===
Flarum 自己带一个子目录 ''public'' 作为论坛的首页目录。很多网上的教程建议直接重写 vhost 中的 root 路径，但 AMH 对此似乎并不友好。另外一种办法是通过面板建立**子域主机**来重新定向域名的根目录到 ''public''。举个例子，如果需要指定域名 domain.com 到该目录，需要修改的如下：
  -  绑定 ''127.0.0.1'' 到**父主机**
  - 绑定 domain.com 到子域主机
  - 绑定子目录中填写 ''/public''
  - 在子主机中包含 ''.nginx.conf''（位于父主机网站根目录下），可参考官方安装帮助。 

===Flarum 目录权限===
<code bash>
$chown www:www -R /home/wwwroot/环境/domain/域名/web/
</code>
===InnodB===
如果遇到以下的错误：
>flarum Something went wrong: SQLSTATE[42000]: Syntax error or access violation: 1286 Unknown storage engine 'InnoDB'
需要到 ''MAadmin'' - ''参数设置'' 中打开 ''InnoDB'' 的开关。
===https 403===
如果出现 http 访问正常 而 https 访问 403 的情况，需要到 ''config.php'' 做如下修改：
<code cpp>
//default
http://yourdomain.com 
//change to
https://yourdomain.com 
</code>