安装 MDClub记录

结合官方的安装教程以及过程中出现的问题，记录一下。

MDClub 的安装非常便捷。在大多数情况下，只需不到 30 秒就能完成安装。

服务器要求

在安装 MDClub 之前，请检查你的服务器是否满足要求。如果你不了解你的服务器是否满足要求，也没关系，MDClub 的安装脚本会自动帮你完成检查。服务器要求如下：

1.从 MDClub 官网下载最新版本的 MDClub 安装包并解压。

2.在你的 Web 服务器上为 MDClub 创建数据库，数据库编码建议设置为 utf8mb4_general_ci。

3.将解压缩后的 MDClub 文件上传到服务器。默认下载的文件中已经包含依赖库，如果没有vendor文件夹，说明需要安装依赖库，重新安装依赖库要删除composer.lock文件以重新安装，宝塔面板后台可以使用composer对话框install，也可以采用命令执行。

4.按下文的”文件夹权限“说明设置 MDClub 的文件夹权限。

5.配置你的 Web 服务器，将网站根目录设置为”MDClub路径/public“，并按照下文说明设置 URL 重写。在宝塔面板后台运行目录选择为/public目录。未正确配置nginx服务器MDClub安装路径会报错。

6.在浏览器中访问 URL 来运行 MDClub 的安装脚本。

Apache

MDClub 在 public 目录中附带了一个 .htaccess 文件。如果没有启用 mod_rewrite 模块，或禁用了 .htaccess，MDClub 将无法正常运行。

启用 mod_rewrite 的方法会根据操作系统的不同而不同。在 Ubuntu 上，您可以通过运行 sudo a2enmod rewrite 命令来启用它，而在 CentOS 上 mod_rewrite 是默认启用的。请不要忘记在修改配置后重启 Apache！

启用 .htaccess 文件，你可能需要在 Apache 的配置文件中添加以下内容：

<Directory "/MDClub路径/public">
  AllowOverride All
</Directory>

Nginx

MDClub 附带了一个 .nginx.conf 文件。你需要在 Nginx 的站点配置文件中添加以下内容（配置文件一般是：/www/server/panel/vhost/nginx），以导入默认的重写规则，宝塔面板“配置文件”末位大括号前一行添加如下代码：

 include /www/wwwroot/joojencom/k/.nginx.conf;

若服务器使用 Windows 系统，则无需设置权限。

若服务器使用 Linux 系统，则需将以下文件夹设置为 755 权限：

./config
./var
./public/sitemap
./public/upload

如果在安装或使用过程遇到“服务器错误”，请按先开启调试模式，以输出详细的错误信息。

 'APP_DEBUG' => false,    //改为true即可开启调试模式。

上传图片文件太大会导致错误，务必控制上传文件大小，php配置中post_max_size应该大于upload_max_filesize （一般控制在20M为宜），过大的附件上传会导致系统错误甚至系统崩溃报错。