voyager是the control group开发的一个基于laravel的后台管理系统,可以帮助开发人员快速搭建一个带授权的后台。以下是教程和注意事项,官方文档地址是:https://voyager.readme.io/docs/installation
安装前准备:
需要安装好php7以上和composer。
第一步:使用composer全局安装laravel
composer global require "laravel/installer"
第二步:创建一个laravel的新项目your-project-name
composer create-project --prefer-dist laravel/laravel your-project-name
这个命令会创建一个最新版本的laravel项目,目前最新版本为laravel5.5.13。
第三步:通过composer添加voyager
composer require tcg/voyager
第四步:安装可能出现的问题
如果你的mysql数据库版本低于5.7.7,可能会出现 “specified key was too long error.”的报错。这是一个laravel5.4就有的一个问题,解决方法如下:修改app/providers/appserviceprovider.php文件,代码如下;
use illuminatesupportfacadesschema; public function boot() { schema::defaultstringlength(191); }
第五步:安装voyager,附带数据
php artisan voyager:install --with-dummy
第六步:创建一个管理员
如果您使用php artisan voyager:install --with-dummy命令安装voyager,voyager会创建一个默认的管理员。
email: admin@admin.com password: password
否则可以使用php artisan voyager:admin your@email.com –create命令创建一个管理员。
第七步:symlink(): protocol error报错的解决方法
在widows下,通过vagrant启动的虚拟机里安装voyager可能会出现这个报错信息,造成问题是因为你用的终端命令行工具,没有使用windows的管理员权限执行。
你执行php artisan voyager:install --with-dummy的cmd需要使用管理员权限执行;
然后再在命令行执行php artisan storage:link 命令。