CCENOTE

快速上手

依赖环境

安装

使用本程序之前，你需要下载对应的程序，如果你是开发者，请点击这里跳转到开发者文档 开发者文档

后端Api:

后台管理:

博客前台:

此时如果你已经下载好了程序，那么接下来跟着本文档完成接下来的安装步骤。

ccenote-api

首先将你下载好的ccenote-api程序，上传到服务器站点根目录并解压，并且将网站运行目录绑定到项目根目录的 public 文件夹。

ccenote-api-install1

如果你使用的是 Nginx 服务器环境，那么你需要在配置文件中加入以下代码:

	location / {
		index  index.html index.htm index.php l.php,server.php; 
		autoindex  off;
		try_files $uri $uri/ /index.php?$query_string;  
	}

如下:

ccenote-api-install1

再次确定你的php开启了redis模块，接下来打开站点根目录，找到并打开.env文件，来配置网站的基本信息：

  • DEFAULT_USERNAME 安装时管理员用户名
  • DEFAULT_PASSWORD 安装时管理员密码
  • APP_URL 程序的地址，此处不需要修改，默认就好
  • ASSET_URL 资源的的根目录，需要改成你的 api网址
  • CROSS_URL 允许跨域的地址，多个用 || 隔开
  • DB_CONNECTION 使用的数据库，默认mysql即可
  • DB_HOST 数据库地址
  • DB_PORT 数据库端口号，默认为 3306
  • DB_DATABASE 数据库名
  • DB_USERNAME 数据库用户名
  • DB_PASSWORD 数据库密码
  • REDIS_HOST redis地址，默认为 127.0.0.1
  • REDIS_PASSWORD redis密码，默认为 6379
  • REDIS_PORT redis端口号
  • MAIL_MAILER 邮箱服务
  • MAIL_HOST 邮箱服务器地址
  • MAIL_PORT 邮箱服务器端口
  • MAIL_USERNAME 邮箱用户名
  • MAIL_PASSWORD 邮箱密钥，此处的密钥需要邮箱开启POP3/SMTP/IMAP来生成
  • MAIL_ENCRYPTION 邮箱加密方式
  • MAIL_FROM_ADDRESS 邮箱发送地址
  • MAIL_FROM_NAME 邮箱发送名称
  • JWT_SECRET 令牌密钥，此处先不写，等接下来生成之后再回来填写
  • JWT_SHOW_BLACKLIST_EXCEPTION 令牌显示黑名单异常，不需要修改
  • JWT_ALGO 令牌算法，不需要修改

邮箱配置需要开启邮箱的POP3/SMTP/IMAP服务，请在邮箱设置中找到POP3/SMTP/IMAP来开启服务，并生成密钥

此时你离安装成功只需要在执行一些命令：

php artisan config:clear
php artisan route:clear
#如果你使用的linux服务器请使用 `sudo` 来执行
php artisan cache:clear / sudo php artisan cache:clear 
php artisan storage:link / sudo php artisan storage:link
php artisan migrate:fresh --seed
#执行下面命令会生成jwt密钥，你需要回到项目根目录下的.env文件中进行补充设置
php artisan jwt:secret / sudo php artisan jwt:secret

jwt:secret

如果到这里，你依然顺利，那么恭喜你，你已经成功的安装了ccenote-api程序，接下来，你可以试着访问 http://你的域名/api/back/admin/getVerifyCode 来查看是否有验证码的数据内容

ccenote- admin / blog

将下载好的ccenote-admin或者ccenote-blog程序上传到服务器站点根目录并解压

图片

根据不同的服务器环境来配置信息:

  • Apache

    RewriteEngine On
RewriteBase /
RewriteRule ^index\.html$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.html [L]

  • Nginx

    location / {
	  try_files $uri $uri/ /index.html;
}

配置成功之后在你的站点根目录找到 config.js 文件来配置你的后端api地址:

{
  "dev": "http://localhost/api",
  "prod": "http://localhost/api",//此处需要修改成你的后端api地址
  "env": "prod"
}

如果你在配置后端api地址之前就打开了网址，那么你打开会收到报错信息的，此时你只需要按 ctrl+shift+del 来清除你的浏览器缓存并重新打开网页即可