项目安装
1、 获取源码
这一部分,就不详细说了!你可以下载zip,克隆到本地或者下载Release版本(推荐)。
2、 配置服务器环境
项目是基于ThinkPHP v5.0.2构建的,所以基础的环境部署请移步ThinkPHP官方部署文档
3、 服务器环境需求
- PHP >= 5.6
- 磁盘空间 >= 100M
- MySQL >= 5.6
- 注:Linux系统请注意目录权限
4、 资源引入
这里涉及到虚拟主机的域名目录的绑定,我们强烈建议您解析域名到/public/admin
,这里需要说明下,项目为了完美适配多域名,所以采用了目录分离的设计方式。如果您只是本地体验,请做以下配置。
//修改资源配置【配置文件路径为:/application/config.php】 'view_replace_str' => [ 'STATIC'=>'/admin/static', 'CSS'=>'/admin/static/css', 'JS'=>'/admin/static/js', 'IMG'=>'/admin/static/img', 'PLUGIN'=>'/admin/static/plugin', ],
访问地址改为 http://127.0.0.1/public/admin
6、 完成安装,进入体验!
安装常见问题
Q:安装过程中出现CSS、JS或者Image加载不了,怎么办?
请参照安装步骤第四步,由于各个服务器环境的差异,需要用户手动去修改资源目录。
例:你第一次打开的页面地址为:http://localhost/ApiAdmin/public/admin,那么你的资源引入应该修改为:
'STATIC'=>'/ApiAdmin/public/admin/static', 'CSS'=>'/ApiAdmin/public/admin/static/css', 'JS'=>'/ApiAdmin/public/admin/static/js', 'IMG'=>'/ApiAdmin/public/admin/static/img', 'PLUGIN'=>'/ApiAdmin/public/admin/static/plugin',
Q:安装第二步开始出现404,file not found这类错误,应该怎么办?
这个问题的根本原因是因为服务器没有配置URL重写,而框架生成的URL又是省略了index.php这个入口文件,所以导致资源未找到,解决方案有两个:
1、请参考ThinkPHP官方手册,配置服务器重写!
2、在/application/install/controller/index.php
的_initialize
函数首行加入 hinkUrl::root('/index.php');
,修改后的_initialize
函数如下。
protected function _initialize() { hinkUrl::root('/index.php'); $noVerify = ['index', 'complete']; if (in_array($this->request->action(), $noVerify)) { return true; } if (is_file(APP_PATH . 'extra' . DS . 'install.lock')) { $this->error('已经成功安装了本系统,请不要重复安装!', 'http://'.$_SERVER['HTTP_HOST']); } }
3、在/application/admin/controller/base.php
的_initialize
函数首行加入 hinkUrl::root('/index.php');
,修改后的_initialize
函数如下。
public function _initialize(){ hinkUrl::root('/index.php'); $this->primaryKey = config('SQL_PRIMARY_KEY'); //初始化系统 $this->uid = session('uid'); $this->assign('uid',$this->uid); $this->iniSystem(); //控制器初始化 if(method_exists($this,'_myInitialize')){ $this->_myInitialize(); } }
Q:安装成功但是提示菜单未找到,进不去任何页面!
出现这个问题的原因是,数据初始化失败,这是由于V1.1.0安装脚本的BUG造成的。下个版本就会修复,如果想要立刻体验,可以拉取最新代码,或者安装时不填写表前缀
如果您在安装过程中遇到了新的问题,欢迎提交issues,感谢您对ApiAdmin的支持和关注!
更多建议: