gougucms安装使用教程以及常见问题的处理

安装教程

一、服务器。

服务器最低配置：

1核CPU (建议2核+)

1G内存 (建议4G+)

1M带宽 (建议3M+)

服务器运行环境要求：

PHP >= 7.4

Mysql >= 5.5.0 (需支持innodb引擎)

Apache 或 Nginx

PDO PHP Extension

MBstring PHP Extension

CURL PHP Extension

Composer (用于管理第三方扩展包)

二、系统安装

推荐使用命令行安装，因为采用命令行安装的方式可以和勾股CMS随时保持更新同步。使用命令行安装请提前准备好Git、Composer。

勾股CMS的安装步骤，以下加粗的内容需要特别留意：

第一步：克隆勾股CMS到你本地 (如果不用git的可以在代码仓库上角打包下载代码，然后解压上传到服务器)

git clone https://gitee.com/gougucms/gougucms.git

第二步：进入目录

cd gougucms

第三步：下载PHP依赖包

composer install

第四步：添加虚拟主机并绑定到项目的public目录， 实际部署中，确保绑定域名访问到的是public目录 。

第五步：配置伪静态规则，使用的是thinkphp的伪静态规则，具体看下面的第三点的伪静态配置内容。

第六步：访问 http://www.你的域名.com/install/index 进行安装

注意：安装过程中，系统会自动创建数据库，请确保填写的数据库用户的权限可创建数据库，如果权限不足，请先手动创建空的数据库，然后填写刚创建的数据库名称和用户名也可完成安装。

提醒：安装过程中，如果进度条卡住，一般都是数据库写入权限或者安装环境配置问题，请注意检查。遇到问题请到QQ群：24641076(群一满)，46924914(群二名额不多) 反馈。

PS：如需要重新安装，请删除目录里面 config/install.lock 的文件，即可重新安装。

三、伪静态配置

Nginx 修改nginx.conf 配置文件 加入下面的语句。

location / {
if (!-e $request_filename){
rewrite ^(.*)$ /index.php?s=$1 last; break;
}
}

Apache 把下面的内容保存为.htaccess文件放到应用入 public 文件的同级目录下。

Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]

常见问题

安装失败，可能存在php配置文件禁止了putenv 和 proc_open函数。解决方法，查找php.ini文件位置，打开php.ini，搜索 disable_functions 项，看是否禁用了putenv 和 proc_open函数。如果在禁用列表里，移除putenv proc_open然后退出，重启php即可。

如果安装后打开页面提示404错误，请检查服务器伪静态配置，如果是宝塔面板，网站伪静态请配置使用thinkphp规则。

如果提示当前权限不足，无法写入配置文件config/database.php，请检查database.php是否可读，还有可能是当前安装程序无法访问父目录，请检查PHP的open_basedir配置。

如果composer install失败，请尝试在命令行进行切换配置到国内源，命令如下composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。

访问 http://www.你的域名.com/install/index 前，请注意查看伪静态请配置是否设置了thinkphp规则。

出现访问报错一般是服务器环境配置问题 比如：伪静态配置，网站的访问入口是否绑定public目录，放配置文件的目录是否有可写权限，放缓存的目录是否有可写权限，数据库连接确认无误等。

开启debug的方式请查看链接：https://blog.gougucms.com/home/book/detail/bid/3/id/77.html

开启debug后，看具体的报错信息，然后沿着这些思路去一个个排查基本解决。

如果是composer的安装，composer install报错，可以百度得到具体解决方案的。

安装过程中，如果进度条卡住(99%)，一般都是数据库写入权限或者安装环境配置config目录无法写入问题，请注意检查权限。

如果安装成功后，无法显示图形验证码的，请看是否已安装(开启)了PHP的GD库。

如果安装成功后，无法上传文件的，请看是否已安装(开启)了PHP的fileinfo扩展。

遇到解决不了的问题请到QQ群反馈：24641076(群一满)，46924914(群二名额不多) 。

勾股CMS官方网站：gougucms.com