如何正确的下载安装使用别人的laravel项目？

laravel作为最流行的php框架;
自然少不了很多基于laravel开发的项目;
不过很多项目因为还处于开发中;
或者其他原因并没有写安装文档;
举个反面栗子;
比如说我的laravel-bjyadmin ;
这种一般就是面向laravel开发者的;
需要有laravel的基础才能顺利的安装使用;

还有很多已经比较成熟的项目;
一般都是有比较详细的安装文档的;
举个正面的栗子;
比如说我的laravel-bjyblog ;直接
按照安装文档基本都能成功;
但是可能总有这样那样的问题;
也可能甚至对laravel更甚至对PHP都不是很了解;
就是单纯的想使用某个项目;
最近就有做Android开发的童鞋;
历经了千辛万苦才顺利的搞定了我开源的博客程序;
于是我决定写个稍微详细通用点的laravel项目的下载安装使用说明;

先说准备工作;
首先是需要有php的环境;
windows本地我之前已经写过相关的文章可以直接参考;
phpstudy配置虚拟主机及开启扩展 ;
linux下的针对小白用户我计划下篇文章也详细的写下;
然后需要作曲家;
这个我也写过文章作曲家的初级使用 ;
最后还需要git;
这个我暂时没有写基础使用文章;
可以参考前辈廖雪峰老师的基础教程Git教程
不过git bash的使用还是有的插播一篇windows下git bash命令行使用的文章

当我们想用
某个项目的时候; 我们首先就要下载它了;
下面都以我的博客项目laravel-bjyblog作为示例讲解;
如何正确的下载安装使用别人的laravel项目？
我们可以通过两种方式下载;
可以直接下载ZIP下载zip压缩包;
这种方式是只下载项目文件比较快;
或者使用命令行把项目clone到本地;

git clone https://github.com/baijunyao/laravel-bjyblog.git

巴什

复制

这种方式可以将项目的历史开发记录也都克隆下来;
以后也可以方便的使用git pull拉取最新的代码;

不管使用哪种方式;
把一个laravel下载下来后目录结构基本都这样;
如何正确的下载安装使用别人的laravel项目？
刚下载下来的laravel跟正常使用的相比差个.env文件和供应商文件夹;
我们需要复制跟目录下的.env.example文件并重命名为.env;
这个是项目的示例配置文件;
我们需要改成自己的实际配置;
如何正确的下载安装使用别人的laravel项目？
APP_NAME就是自己的项目名称比如我的白俊遥博客;
APP_URL就是我们的项目链接比如说我的https://baijunyao.com ;
本地的话就是我们配置的虚拟主机自定义的本地
域名; DB_DATABASE就是我们的数据库名比如说test;
DB_USERNAME数据库用户名比如说root;
DB_PASSWORD数据库密码比如说123456;

供应商目录则不用我们手动创建;
我们在根目录下执行composer install命令;
然后界面一阵滚动最后就完了;
我们会发现根目录下多了个供应商;另外
使用composer update也会生成供应商;
同时会改变composer.lock文件;
这里简单的讲解下安装和更新这两个方法;
项目的开发者在开发的时候会生成composer.lock文件;
它记录了开发者开发的时候使用的各扩展包的版本号;
比如说某个扩展包开发者使用的是1.0.1版本;
我们使用composer install就是安装跟开发者一样版本的扩展包;
而作曲家更新则是更新各扩展包;
这样的话可能我们某个扩展包更新到了1.0.2;
但是因为开发者还没测过1.0.2的兼容而产生错误;
而且因为改变了composer.lock文件我们在git pull拉取新代码的时候也会冲突;
简单点说个原则就是;
如果我们是开发者我们是需要经常composer update更新各扩展包;
如果我们是使用者则使用composer 安装即可;另外
很多童鞋可能并不能顺利的安装完;
大多是
缺少某个php扩展; 出门左转再回顾下我上面给过的phpstudy文章链接;
里面说了需要开启的扩展;
还有一些是因为php的版本比较低;
安装的时候报错的话看下报错的提示;
实在不行百度翻译再搜索下也都能找到原因了;

接着我们需要执行下php artisan key:generate;
这个是生成APP_KEY并自动写入到.env文件中的;
它是laravel用来加密cookie等的;
如何正确的下载安装使用别人的laravel项目？

再接着我们需要执行php artisan migrate;
这个是生成数据表的;
关于表迁移可以参考文章最适合入门的Laravel初级教程（七）表迁移迁移 ;
这时候我们查看数据库会发现创建了一大堆表;
如果报错的话;
大多是因为.env中的数据库账号密码配置的有问题;
使用客户端或者其他项目连下数据库检查下;

数据库表有了;
但是表都是空的;
这时候我们需要执行php artisan db:seed;
这个是用来生成测试数据或者其他的一些基础数据的;
一般到这就没啥错误了;

至于就可以愉快的访问项目了;
浏览器访问APP_URL链接;
一般项目首页起码是不会空的;
如果首页并不能访问;
我们可以查看routes / web.php文件里面定义的路由;
如果需要登录;
一般可以通过查看填充文件database / seeds / UsersTableSeeder.php;
如何正确的下载安装使用别人的laravel项目？
查看初始账号密码;