基于Rangine框架的开源Markdown文档系统常见问题解决方案

基于Rangine框架的开源Markdown文档系统常见问题解决方案

w7-rangine-project-document 基于Rangine(软擎框架)的一款开源Markdown文档系统 项目地址: https://gitcode.com/gh_mirrors/w7/w7-rangine-project-document

一、项目基础介绍

本项目是基于Rangine框架（软擎框架）的开源Markdown文档系统。该系统不需要依赖传统的Nginx/Apache和PHP-FPM，采用全异步非阻塞、协程实现，旨在提供一个高效、稳定的Markdown文档服务。项目主要使用的编程语言是PHP，同时也包含少量JavaScript和其它语言代码。

二、新手常见问题及解决步骤

问题一：环境要求不满足导致项目无法运行

问题描述： 项目对PHP版本和环境有特定要求，若环境不符合要求，可能导致项目无法正常运行。

解决步骤：

1. 确认PHP版本大于等于7.2.0。
2. 安装并启用PHP Swoole扩展，版本大于等于4.3.0。
3. 安装并启用PHP Mbstring和PHP Pdo MySql扩展。
4. 根据需要安装PHP Redis扩展（如果项目需要用到Redis功能）。

问题二：项目安装后无法访问

问题描述： 安装完项目后，通过浏览器访问时无法打开页面。

解决步骤：

1. 确认项目已经正确解压到服务器目录。
2. 进入项目目录，执行composer install安装依赖包。
3. 检查config/server.php中的SERVER_HTTP_PORT设置，确保端口没有被占用，且符合服务器实际情况。
4. 在项目根目录下执行bin/server start命令启动服务。
5. 确认防火墙设置，允许对应端口访问。

问题三：安装界面打不开或安装失败

问题描述： 访问安装界面时出现错误，或者按照提示操作后安装失败。

解决步骤：

1. 确认安装目录有可写权限。
2. 如果安装界面打不开，检查runtime/install.lock文件是否存在，如果存在，删除该文件。
3. 按照安装页面提示逐步操作，确保输入正确的数据库信息。
4. 安装完成后，根据提示重启服务，并执行数据迁移命令：bin/gerent migrate:migrate --force。
5. 如果安装失败，检查安装日志文件，根据错误提示进行排查。

以上是新手在使用基于Rangine框架的开源Markdown文档系统时可能遇到的三个常见问题及其解决步骤，希望能帮助到您顺利搭建和运行项目。

w7-rangine-project-document 基于Rangine(软擎框架)的一款开源Markdown文档系统 项目地址: https://gitcode.com/gh_mirrors/w7/w7-rangine-project-document